Deploying the Reporting Data Services Adapters on WebSphere Application Server

Add the adapter plug-ins to the Reporting data services application by copying the adapter archive files to the library directory of WebSphere® Application Server 7.0 or 8.0.

Before you begin

You must install WebSphere Application Server 7.0 or 8.0 and Rational® Publishing Engine with the Reporting data services application before you can deploy the Reporting Data Services Adapters.

If you have multiple data sources installed on different computers, you must repeat these steps on each computer.

Configure the Generic JVM arguments in the application server:
  1. Open the administrative console in a browser. Example: http://localhost:9043/ibm/console/logon.jsp
  2. Click Servers > Server Types > WebSphere application servers.
  3. Click the ServerName.
  4. In the Server Infrastructure section, expand Java and Process Management and click Process Definition.
  5. Click Java Virtual Machine.
  6. In the Generic JVM arguments field, enter the argument: -DRJCB_IN_MTA_ONLY='RJCB' -Xquickstart
    Attention: The -Xquickstart option must include a hyphen (-) and not an en-dash () or an em-dash (). Copying the code phrase from this topic might convert the hyphen into an en-dash or an em-dash. When this conversion occurs, the error prevents Apache Tomcat from starting.
  7. Click OK.

Procedure

  1. Add the adapter files to the WebSphere Application Server data services directory:
    1. Copy the contents of the %RPE_HOME%\web services\Data Services\product_name\eclipse\plugins directory and paste them into the plugins folder in the WebSphere Application Server data services directory. By default, the location of this directory is <WASInstallDir>\profiles\profile name\installedApps\Node Name\DataServices_war.ear\DataServices.war\WEB-INF\eclipse.
    2. Copy the contents of the %RPE_HOME%\web services\Data Services\product_name\eclipse\features directory and paste them into the features folder in the WebSphere Application Server data services directory. By default, the location of this directory is <WASInstallDir>\profiles\profile name\installedApps\Node Name\DataServices_war.ear\DataServices.war\WEB-INF\features.
    Do not delete any other files contained in the directory. The plug-ins for each adapter must be merged with the plug-ins for the remote application.
    If you cannot locate the features or eclipse folders in the default location <WASInstallDir>\profiles\profile name\installedApps\Node Name\DataServices_war.ear\DataServices.war\WEB-INF\, you can search for the DataServices.war directory.
    To search for the data services directory:
    1. Open the <WASInstallDir> with a files explorer.
    2. Search for the DataServices.war folder.
    3. Copy the plug-ins into the DataServices.war\WEB-INF\plugins directory.
    4. Copy the plug-ins into the DataServices.war\WEB-INF\features directory.
  2. Restart WebSphere Application Server.

What to do next

  1. Verify that the Reporting Data Services Adapters are deployed correctly. Enter http://server:port/DataServices.war_context_path in a browser. If the deployment is correct, the page displays an XML list of each installed adapter.
  2. Configure the Reporting Data Services Adapters for your product, if necessary.

Feedback