Deploying generated JAX-RPC web services for InfoSphere® MDM version 11.0

JAX-RPC web services consist of one or more bundles, deployed within a CBA and an EAR.

Before you begin

To use JAX-RPC web services, both of these parts must be deployed in addition to the CBA containing the development project.

Procedure

  1. Deploy the CBA. For more information, see ../com.ibm.mdmhs.wb.tools.models.doc/c_Addition_and_Extension_Deployment_in_OSGi_Framework.html
  2. Uninstall the existing JAX-RPC web services EAR that was installed with the product to allow you to replace it with the newly generated EAR.
    1. Open the IBM® WebSphere® Application Server admin console
    2. Select Application > Application Types > WebSphere enterprise applications.
    3. Select the checkbox next to MDM-old-web-services-xxxx and click Uninstall.
  3. Deploy the JAX-RPC Web Services CBA project (default name WSCBA). For more information, see Deploying a CBA to the operational server from the MDM Workbench or Deploying a CBA to the operational server from IBM WebSphere Application Server admin console
  4. Update the JAX-RPC EAR security settings
    1. Within the JAX-RPC EAR project, open the file META-INF/ibm-application-bnd.xml.
    2. In the Design tab, click Application Bindings > Security Role (ServiceProvider).
    3. Run As (mdmadmin).
    4. In the right-hand panel, set the Password to your mdmadmin password.
    5. Save and close the file.
  5. Right-click on the JAX-RPC EAR project, then click JavaEE > Prepare for Deployment.
  6. Deploy the JAX-RPC EAR project to the server, either through the Servers view in the MDM Workbench or through the IBM WebSphere Application Server admin console.
    Note: When using the MDM Workbench in IBM Rational® Application Developer version 8.5.1, the Prepare for Deployment operation does not generate all of the required artifacts for the web services. In this case, the JAX-RPC web services EAR must be deployed through the IBM WebSphere Application Server admin console. To do this, take the following steps:
    1. Ensure the maximum heap size of the server is set to at least 1GB; otherwise out-of-memory errors are likely to occur during deployment
    2. Export the EAR from the workspace.
    3. Install the EAR through the IBM WebSphere Application Server admin console, enabling the deploy web services in the installation options.
  7. Restart IBM WebSphere Application Server.


Last updated: 23 October 2014