Manual installation of Rational Insight Data Services

Windows If you do not want to deploy the IBM® Rational® Insight Data Services automatically to a Web application server through the installer, you can manually deploy the Rational Insight Data Services Web archive (WAR) file to an existing IBM WebSphere® Application Server and install the adapters by adding the plug-ins to the Web application.
About this task
If you choose the manual installation method to install Rational Insight Data Services, you must first install the data service and then deploy the plug-in files for the adapters on the Web application server.
Note: If you have more than one system that hosts the products you want to report on, you must repeat these steps for each system.

Installing the data service

  1. Start the launchpad.exe file.
  2. Read the release information and the installation document.
  3. To begin the installation, click IBM Rational Insight Data Services.
  4. Select IBM Rational Insight Data Services, and click Next.
  5. Read the license agreement, click I accept the terms in the license agreement, and click Next.
  6. Accept the default installation location and click Next. By default, Rational Insight is installed in the C:\Program Files\IBM\Rational Insight directory.
  7. Select the adapters you want to install, and click Next.
  8. In the Select an application server list, select Manual Installation, and click Next.
  9. Specify the installation location of the products that you will be using your adapters for and click Next.
  10. Click Install. The installer places the WAR file DataServices.war on the file system and also places the adapter features and plug-ins in the product directories under the Data Services directory. For example, the Rational ClearCase® adapter is installed in the Data Services\ClearCase directory. The default location is C:\Program Files\IBM\Rational Insight\Data Services.
  11. Click Finish.

Deploying the data source adapters

About this task
Deploy the data service WAR file on WebSphere Application Server.
  1. Start the IBM WebSphere Application Server profile creation tool (click Start > All Programs > IBM WebSphere > Application Server V6.1 > Profile Management Tool).
  2. Create a new profile named RationalInsight.
    1. Click Next twice.
    2. Select Advanced profile creation and click Next.
    3. Select Deploy the administrative console. Make sure that Deploy the default application is not selected. Click Next.
    4. Specify the profile name to be RationalInsight and click Next twice.
    5. Do not activate administrative security. Click Next twice.
    6. Select Run the application server process as a Windows service and click Next twice.
    7. Click Create.
  3. Start WebSphere Application Server:
    1. Click Start > Control Panel > Administrative Tool > Services.
    2. Select the IBM WebSphere Application Server V6.1 service you just created for the server and click Start.
  4. Start the administrative console for the DataServices profile. The default URL for the administrative console is http://localhost:9060/ibm/console.
  5. Create a new Web application using the DataServices.war file.
    1. Select Applications > Install New Application.
    2. Click Browse and locate the WAR file DataServices.war. The default location is C:\Program Files\IBM\Rational Insight\Data Services. Specify the context root to be DataServices and click Next.
    3. On the Select installation options page, click Next.
    4. On the Map modules to servers page, click Next.
    5. On the Map virtual hosts for Web modules page, click Next.
    6. On the Summary page, click Finish.
    7. Click Save.
  6. Start the Web application you created (in the administrative console, click Enterprise Applications, select DataServices.war, and click Start).
  7. Locate the WAR file DataServices.war, which was placed installed on the system through the installer. The default location is C:\Program Files\IBM\Rational Insight\Data Services.
  8. Add the adapter plug-ins to the Web application by copying the adapter archive files to library directory of the Web application.
    1. Locate the plug-ins for the adapters. By default, the plug-ins are installed in the same directory as the DataServices.war file, where each adapter has a separate directory. For example, if the DataServices.war is installed in the C:\Program Files\IBM\Rational Insight\Data Services directory, the default location for the ClearCase plug-in is C:\Program Files\IBM\Rational Insight\Data Services\ClearCase.
    2. Locate the file system directory of the Web application. The default location is WEB-INF\eclipse in two different directories:
      • profiles\RationalInsight\installedApps
      • profiles\RationalInsight\temp
      The location depends on your deployed instance of WebSphere Application Server. 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.
    3. Copy the contents of the eclipse directory of substep (a) to both the directories of substep (b). Make sure the contents of the eclipse\features and eclipse\plugins directories are copied to the target locations. Make sure not to delete any files or folder 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.
  9. Restart the Web application server.

Feedback