Configuring Rational Asset Manager for Rational ClearQuest integration

Integrate IBM® Rational® Asset Manager with IBM Rational ClearQuest® and set up connections between the two products.

About this task

To integrate Rational Asset Manager with Rational ClearQuest, install the Rational ClearQuest client on the same computer as the Rational Asset Manager server. To connect Rational Asset Manager to the correct Rational ClearQuest server location, an administrator must know the Rational ClearQuest web client URL.

The following image outlines the connections to set up Rational ClearQuest.

After you install Rational ClearQuest, include the dynamic libraries in the path on the web server:
  • Windows
    1. Right-click My Computer and click Properties.
    2. On the Advanced page, click Environment Variables.
    3. Under System Variables, select the Path variable and click Edit.
    4. Type the Rational ClearQuest installation directory at the end of the path string; separate the directory and the path with a semicolon. For example, ;C:\Rational\ClearQuest.
    5. Save your changes.
  • Linux and UNIX
    1. Set the following environment variables:
      • In the Bourne-shell (sh)
        export TZ=[local_time_zone] (i.e., EST5EDT)
        export LD_ASSUME_KERNEL=2.4.19
        export LD_LIBRARY_PATH=/opt/rational/clearquest/linux_x86/shlib
      • In the C-Shell (csh)
        setenv TZ=[local_time_zone] (i.e., EST5EDT)
        setenv LD_ASSUME_KERNEL=2.4.19
        setenv LD_LIBRARY_PATH=/opt/rational/clearquest/linux_x86/shlib
    2. Source the cq_setup.sh file:
      • For csh, tcsh, and other csh-compatible shells:
        source cquest-home-dir/cq_setup.csh
      • For sh, ksh, bash, and other Bourne-compatible shells:
        . cquest-home-dir/cq_setup.sh
Set the Rational ClearQuest cqini.jar file to be loaded by the base classloader of the web server:
  • IBM WebSphere® Application Server
    To link the web application to a shared library containing the cqJni.jar file:
    1. Copy the linkscript.py file from <RAM_install_dir>\ram\conf\cq into the \bin folder of your WebSphere Application Server installation directory.
    2. Open a command prompt and navigate to that \bin folder.
    3. Run the following command:
      wsadmin -f linkscript.py -lang jython -conntype SOAP -user user name
      -password password -rInstallPath rational-dir -appName application-name
      -machine machineName -node nodeName -cell cellName -process process-name
      -library library-name -force
      where:
      • user name and password are your WebSphere Application Server administrative user name and password.
      • rational-dir is the root directory in which Rational applications are installed; for example, C:/Rational. Use the forward slash (/) as the path separator, even if you use a Windows operating system. If Rational ClearQuest is installed in C:/Rational/ClearQuest, type C:/Rational for the rational-dir value.
        Note: For Windows operating systems, use folder short names. For example, if the root directory in which Rational applications are installed is C:/Program Files/Rational/ClearQuest, type C:/Progra~1/Rational/ClearQuest for the rational-dir value.
      • application-name is the display name of your Rational Asset Manager application. If you used Installation Manager to install Rational Asset Manager, the display name is RAM1WebApplication. If you installed the web application into your own WebSphere Application Server, the display name is the one you provided during the installation. The default value is RAM1WebApplication.
      • process-name is optional; provide it if you need to specify the process you are connecting to. The default value is server1.
      • machineName, nodeName, and cellName are optional. Provide them if you need to specify the server path that your Rational Asset Manager web application is installed under; for example, Cell:machineNodeCell. Provide all three. By default, these are detected automatically by using the process name.
      • library-name is optional. Provide the library-name to make the script use an existing shared library or to create a shared library of that name. The default library name is CQLib
      • force is optional. Provide it to create a new shared library, even if one already exists.
  • Tomcat

    To add the cqJni.jar file to the base classloader in Tomcat, follow one of these methods:

    • Copy the cqJni.jar file from the Rational ClearQuest installation directory to the \common\lib folder of the Tomcat installation directory.
      Note: If you upgrade to a new version of Rational ClearQuest, you must repeat this step with the new cqini.jar file.
    • To avoid copying the file, modify the catalina.bat startup script to include the cqJni.jar file on the Tomcat classpath:
      1. Navigate to the \bin folder of the Tomcat installation.
      2. In a text editor, open the catalina.bat file.
      3. Find a line in the file that resembles this line:
        set CLASSPATH=%CLASSPATH%;%CATALINA_HOME%\bin\bootstrap.jar
      4. Add the following code to the end of the line:
        ;ClearQuest-dir\cqJni.jar
        where ClearQuest-dir is the full path to the Rational ClearQuest installation.
      5. Save and close the file.

Feedback