Example: Installing Rational Insight Data Services on a single system

Linux This installation scenario is an example of the manual installation option for installing IBM® Rational® Insight Data Services and the Rational Insight ClearQuest® adapter on a single system that has a Web application server and IBM Rational ClearQuest installed on it. The scenario described in this topic is for the following configuration: Red Hat Enterprise Linux® 5 GA with Update 1, WebSphere® Application Server 6.1.0.21 or later, and Rational ClearQuest 7.1.
Before you begin
About this task
During the installation, a Web archive (WAR) file and the features and plug-ins for the Rational ClearQuest adapter are placed on the system. The WAR file must be deployed and updated with the features and plug-ins for the Rational ClearQuest adapter.

Installing the data service and the adapter

  1. Start the launchpad.sh 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 agreements and if you accept, click I accept the terms in the license agreement, and click Next.
  6. Select Create a new package group, and click Next. By default, the files are placed in the /opt/ibm/RationalInsight directory.
  7. Select Rational ClearQuest adapter, and click Next.
  8. In the Select an application server list, select Manual Installation, specify the installation location, and click Next.
  9. Click Browse, specify the location of the ClearQuest installation, 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 /opt/ibm/RationalInsight/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 (from the command prompt, go to /opt/ibm/RationalInsight/AppServer/bin/ProfileManagement and run the pmt.sh command).
  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. Go to the /opt/ibm/RationalInsight/AppServer/bin directory.
    2. Run the following command:
      startServer.sh RationalInsightServer -profileName RationalInsight
  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 /opt/ibm/RationalInsight/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 /opt/ibm/RationalInsight/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 /opt/ibm/RationalInsight/Data Services/ClearCase directory, the default location for the ClearCase plug-in is /opt/ibm/RationalInsight/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.

Configuring Rational Insight Data Services

  1. Go to the bin directory of the WebSphere Application Server instance of Rational Insight Data Services.
  2. Run the following command:
    wasservice -add DataServices -serverName server1 -profilePath "/opt/IBM/WebSphere/" -startType automatic

Configuring the ClearQuest adapter

  1. Start the administrative console for the Rational Insight Data Services profile (Open a browser and point to http://localhost:port/ibm/console).
  2. Create a shared library for the ClearQuest adapter:
    1. Click Environment > Shared Libraries.
    2. Select the Node=RationalInsightNode01, Server=RationalInsightServer entry. RationalInsightNode01 is the default name of the node and RationalInsightServer is the default name of the server.
    3. Click New.
    4. Enter the values for name, description and class path. The values that can be entered are listed in the topic Configuring the shared libraries. See under the Related reference link at the bottom of the page.
    5. Click OK and click Save.
  3. Associate the shared libraries with the data service profile:
    1. Click Servers > Application Servers.
    2. Click the server on which you have deployed the data service. The default value is RationalInsightServer.
    3. Click Server Infrastructure > Java and Process Management > Class Loader
    4. Click New > OK
    5. Click the new class loader.
    6. Click Shared library references.
    7. For each library that needs to be associated, click Add, select the library, and click OK.
    8. Click Save.
    9. Restart the Rational Insight Data Services profile.

Feedback