Deploying the data source adapters on WebSphere Application Server 6.1

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

Before you begin

You must install WebSphere Application Server 6.1 and Rational® Publishing Engine with the data services feature before you can deploy the data source adapters.

If you have more than one computer for the data sources, you must repeat these steps on each computer.

If you are using the Rational RequisitePro® adapter, 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 > 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 and when this conversion occurs, the error prevents Apache Tomcat from starting.
  7. Click OK.

Procedure

  1. Locate the plug-ins for the adapters. By default, the plug-ins are installed in a subdirectory of the %RPE_HOME%\web services\data services directory. For example, the default location for the Rational RequisitePro plug-in is %RPE_HOME%\web services\data services\eclipse\plugins.
  2. Locate the features for the adapters. By default, the features are installed in a subdirectory of the %RPE_HOME%\web services\data services directory. For example, the default location for the Rational RequisitePro feature is located at %RPE_HOME%\web services\data services\eclipse\features.
  3. Locate the file system directory of the web application. By default, the eclipse directories of web applications are located in C:\Program Files\IBM\WebSphere\AppServer\profiles\profile name\installedApps\Node Name\DataServices_war.ear\DataServices.war\WEB-INF\eclipse. To find the location for your installation, you can search the profiles directory of your WebSphere Application Server application server for a folder named DataServices.war.
  4. Copy the adapters of the eclipse directories from steps 1 and 2 to the directory of step 3. Make sure that the contents of the eclipse/features and eclipse/plugins directories are copied to the target location. Do not to delete any files in the deployed web application. The features and plug-ins for each adapter must be merged with the features and plug-ins of the web application.
  5. Restart WebSphere Application Server.

What to do next

Verify that the data services 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.

Feedback