Configuring Rational Asset Manager for Rational ClearQuest integration

Configuring Rational Asset Manager for Rational ClearQuest integration

The following information explains how to integrate Rational^® Asset Manager with Rational ClearQuest^®, and how to set up connections between the two.

In order for Rational Asset Manager to integrate with Rational ClearQuest, the Rational ClearQuest client must be installed on the same machine as Rational Asset Manager server. An administrator must know the ClearQuest Web client URL in order to connect Rational Asset Manager to the correct ClearQuest server location.

The following image outlines the connections that you need to set up ClearQuest.

After ClearQuest has been installed, you must include the dynamic libraries in the path on the Web server.

• Windows
  1. Right-click My Computer and select Properties.
  2. On the Advanced page, click Environment Variables.
  3. Under System Variables, select the Path variable and click Edit.
  4. Append the ClearQuest installation directory to the end of the path string, separated by 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

Finally, the ClearQuest cqini.jar file must be set to be loaded by the base classloader of the Web server.

• 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 WAS 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 username and password.
     • rational-dir is the directory where Rational ClearQuest is installed. Be sure to use the forward slash (/) as the path separator.
     • 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. All three must be provided. By default, these are detected automatically using the process name.
     • library-name is optional. Provide it to make the script use an existing shared library, or to make it create a shared library of that name; the default library name is CQLib
     • force is optional. Provide it to force the creation of a new shared library, even if one already exists.
• Tomcat

  To add the cqjni.jar file to the base classloader in Tomcat, you can either:

  • Copy the cqjni.jar file from the ClearQuest installation directory to the \common\lib folder of the Tomcat installation directory.
    Note: If you upgrade to a new version of ClearQuest in the future, you must perform this step again with the new cqini.jar file.
  • Modify the catalina.bat startup script to include the cqjni.jar file on Tomcat's classpath, to avoid having to copy the file.
    1. Navigate to the \bin folder of the Tomcat installation.
    2. Open the catalina.bat file in a text editor.
    3. Find a line in the file that resembles this line:

       set CLASSPATH=%CLASSPATH%;%CATALINA_HOME%\bin\bootstrap.jar

    4. Add the following to the end of the line:

       ;ClearQuest-dir\cqjni.jar

       where ClearQuest-dir is the full path to the ClearQuest installation.
    5. Save and close the file.