Manually deploying the Reporting data services application on WebSphere Application Server

You can install the adapters for the IBM® Rational® Publishing Engine Data Services application on an existing instance of IBM WebSphere® Application Server version 7.0 or 8.0. If you deployed the Reporting data services application onto WebSphere Application Server during Rational Publishing Engine installation, you do not have to complete this task.

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 deploying the Reporting data services application.
Important: The Reporting data services application can be deployed only on a 32-bit version of WebSphere Application Server. You cannot deploy the Reporting data services application on a 64-bit version of WebSphere Application Server.
If you want to create a separate profile for the Reporting data services application:
  1. Start the WebSphere Application Server profile management tool. To launch the profile management tool, select Start > All Programs > IBM WebSphere > Application Server [version] > Profile Management Tool.
  2. Click Next.
  3. Select Advanced profile creation, click Next.
  4. Select Deploy the administrative console and click Next.
    Important: Do not select Deploy the default application.
  5. Specify the profile name as DataServices, click Next. Do not enable administrative security. Click Next.
  6. Select Run the application server process as a Windows service, click Next, and click Create.

About this task

This setup applies to IBM Rational ClearQuest®, IBM Rational RequisitePro®, or IBM Rational ClearCase®. One data adapter provides a communication interface to many Rational Publishing Engine clients. For performance reasons, do not install the Reporting Data Services Adapters on the same server as the database. On the computer where the Reporting Data Services Adapters are installed, you must also install the native client to the database Rational RequisitePro thick client, Rational ClearQuest Eclipse client, and others). On the computer with the Reporting Data Services Adapters installed, the Reporting Data Services Adapters use the native client to communicate with the database. Many Rational Publishing Engine clients, even in different locations, connect to the Reporting Data Services Adapters by using http://server:port/DataServices/Adapter/<data>.

Procedure

To deploy the Reporting data services application on WebSphere Application Server:

  1. Start the WebSphere Application Server administrative console in a browser. Example: http://server:port/ibm/console/logon.jsp
  2. Expand Applications and click New Application.
  3. Click New Enterprise Application.
  4. In the Path to the new application window, select the path to DataServices.war. By default, the archive file is located in RPE_HOME\web services\Data Services\DataServices.war.
    • If you are using a local file, select Local file system. Click Browse and select the DataServices.war file.
    • If you are using a remote file, select Remote file system. Click Browse and select the DataServices.war file.
  5. Select Fast Path - Prompt only when additional information is required and click Next.
  6. Accept the default settings in the following windows and click Next.
    • Select installation options
    • Map modules to servers
    • Map virtual host for web modules
  7. In Map context roots for web modules, enter the context root as /DataServices. This entry is a part of the URL used for configuring the client.
  8. Review the summary and click Finish. Application DataServices.war installed successfully displays in the process log.
  9. Restart the Rational Publishing Engine profile where the DataServices.war application is deployed.
  10. Click Applications > Application Types > WebSphere Enterprise Applications. The DataServices.war application you added is listed as the context path name you entered.
  11. Select the DataServices.war application check box and click Start.

What to do next

Deploy the Reporting Data Services Adapters.

Feedback