Installing the file agent RSE miner

Perform the steps described in this topic to install and configure the file agent Remote System Explorer (RSE) miner.

Before you begin

Follow the installation and configuration steps for the RSE server and daemon in the Rational® Developer for System z® Host Configuration Guide (SC23-7658-05).

These steps require that you have already installed the Build System Toolkit for System z. If you have not finished the installation, see ../../com.ibm.jazz.install.doc/topics/t_rtcz_install_build_toolkit_smpe.htm for more information.

Because the CLASSPATH environment variable that can be specified on the z/OS® file system has a size limit, you must create symbolic links to the Build System Toolkit .jar files. You can create these symbolic links by following these steps:

Procedure

  1. Configure the sample JCL member BLZCRSYM in hlq SBLZSAMP, where hlq is the high-level qualifier you specified during the SMP/E installation. This job creates a symbolic link directory in your jazz config directory, normally /etc/jazz/ccm, and contains symbolic links to all the .jar files in the buildtoolkit directory. Submit the modified JCL and check the job log to make sure the job finishes with return code 0. The SYSTSPRT portion of the job output lists the .jar file name and the symbolic link you created; for example, one of the lines might look like the following:
    jar.6=com.ibm.team.filesystem.client_2.1.0.v20101021_0811.jar 
    sym.6=jar6.jar
  2. Locate the rsed.envvars file in the RSE configuration directory. See rsed.envvars, RSE in the Rational Developer for System z Host Configuration Guide for instructions.
  3. Save a copy of this file using the following command: cp rsed.envvars rsed.envvars.org
  4. If you use OMVS, edit the rsed.envvars file using the ISPF 3.17 oedit command (oedit rsed.envvars), or the Rational Developer for System z editor if you use RSE.
  5. You must designate class path statements, library path statements, and a working directory location. Find the CLASSPATH assignment, CLASSPATH=.:$CLASSPATH, in the rsed.envvars file. For Java 1.6, immediately ahead of the CLASSPATH assignment, copy the sample member BLZENVAR from hlq.SBLZSAMP. For Java 1.5, following the CLASSPATH assignment, copy the sample member BLZENV15 from hlq.SBLZSAMP. For both members, hlq is the high-level qualifier specified during the SMP/E installation. The members contains lists of Rational Team Concert™ CLASSPATH assignments. For both levels of Java, the sample members also contain stubbed declarations of both the LIB_PATH and SCM_WORK environment variables. For clarification on what to set these environment variables to, review the comments in rsed.envvars file.
    Note: Apply the class path statement additions for Rational Team Concert to every instance of the RSE server for which you want to run Rational Team Concert. After performing the configuration steps, you must recreate any RSE connections that existed previously in your Rational Developer for System z clients.
    The following is an example of the Java 1.6 rsed.envvars file. It includes modification prompts to show you how and where to customize your own rsed.envvars file, according to your build environment.

    #
    # Insert the following Classpath allocation in the rsed.envvars file,
    # just prior to the CLASSPATH=.:$CLASSPATH statement
    #
    # Rational Team Concert
    #
    CLASSPATH=$CLASSPATH:'/etc/jazz/ccm/symlinks/*'

    # Uncomment and update the following statement to reference the install
    # path for RTC
    #LIBPATH=$LIBPATH:@pathPrefix@/usr/lpp/jazz/v3.0/buildsystem/buildtoolkit


    # Uncomment and update the following statement to reference the working
    # directory.
    # Working directories are typically stored in /u/jazz. You can change
    # this directory.
    #SCM_WORK=@workPath@

    The following is an example of the Java 1.5 rsed.envvars file. It includes modification prompts to show you how and where to customize your own rsed.envvars file, according to your build environment.

    #
    # Insert the following Classpath allocation in the rsed.envvars file,
    # just prior to the CLASSPATH=.:$CLASSPATH statement
    #
    # Rational Team Concert
    #
    RTC=/etc/jazz/ccm/symlinks

    CLASSPATH=$CLASSPATH:$RTC/jar1.jar
    CLASSPATH=$CLASSPATH:$RTC/jar2.jar
    CLASSPATH=$CLASSPATH:$RTC/jar3.jar
    CLASSPATH=$CLASSPATH:$RTC/jar4.jar
    CLASSPATH=$CLASSPATH:$RTC/jar5.jar
    CLASSPATH=$CLASSPATH:$RTC/jar6.jar
    CLASSPATH=$CLASSPATH:$RTC/jar7.jar
    CLASSPATH=$CLASSPATH:$RTC/jar8.jar
    CLASSPATH=$CLASSPATH:$RTC/jar9.jar
    CLASSPATH=$CLASSPATH:$RTC/jar10.jar
    CLASSPATH=$CLASSPATH:$RTC/jar11.jar
    CLASSPATH=$CLASSPATH:$RTC/jar12.jar
    CLASSPATH=$CLASSPATH:$RTC/jar13.jar
    CLASSPATH=$CLASSPATH:$RTC/jar14.jar
    CLASSPATH=$CLASSPATH:$RTC/jar15.jar
    CLASSPATH=$CLASSPATH:$RTC/jar16.jar
    CLASSPATH=$CLASSPATH:$RTC/jar17.jar
    CLASSPATH=$CLASSPATH:$RTC/jar18.jar
    CLASSPATH=$CLASSPATH:$RTC/jar19.jar
    CLASSPATH=$CLASSPATH:$RTC/jar20.jar
    CLASSPATH=$CLASSPATH:$RTC/jar21.jar
    CLASSPATH=$CLASSPATH:$RTC/jar22.jar
    CLASSPATH=$CLASSPATH:$RTC/jar23.jar
    CLASSPATH=$CLASSPATH:$RTC/jar24.jar
    CLASSPATH=$CLASSPATH:$RTC/jar25.jar
    CLASSPATH=$CLASSPATH:$RTC/jar26.jar
    CLASSPATH=$CLASSPATH:$RTC/jar27.jar
    CLASSPATH=$CLASSPATH:$RTC/jar28.jar
    CLASSPATH=$CLASSPATH:$RTC/jar29.jar
    CLASSPATH=$CLASSPATH:$RTC/jar30.jar
    CLASSPATH=$CLASSPATH:$RTC/jar31.jar
    CLASSPATH=$CLASSPATH:$RTC/jar32.jar
    CLASSPATH=$CLASSPATH:$RTC/jar33.jar
    CLASSPATH=$CLASSPATH:$RTC/jar34.jar
    CLASSPATH=$CLASSPATH:$RTC/jar35.jar
    CLASSPATH=$CLASSPATH:$RTC/jar36.jar
    CLASSPATH=$CLASSPATH:$RTC/jar37.jar
    CLASSPATH=$CLASSPATH:$RTC/jar38.jar
    CLASSPATH=$CLASSPATH:$RTC/jar39.jar
    CLASSPATH=$CLASSPATH:$RTC/jar40.jar
    CLASSPATH=$CLASSPATH:$RTC/jar41.jar
    CLASSPATH=$CLASSPATH:$RTC/jar42.jar
    CLASSPATH=$CLASSPATH:$RTC/jar43.jar
    CLASSPATH=$CLASSPATH:$RTC/jar44.jar
    CLASSPATH=$CLASSPATH:$RTC/jar45.jar
    CLASSPATH=$CLASSPATH:$RTC/jar46.jar
    CLASSPATH=$CLASSPATH:$RTC/jar47.jar
    CLASSPATH=$CLASSPATH:$RTC/jar48.jar
    CLASSPATH=$CLASSPATH:$RTC/jar49.jar
    CLASSPATH=$CLASSPATH:$RTC/jar50.jar
    CLASSPATH=$CLASSPATH:$RTC/jar51.jar
    CLASSPATH=$CLASSPATH:$RTC/jar52.jar
    CLASSPATH=$CLASSPATH:$RTC/jar53.jar
    CLASSPATH=$CLASSPATH:$RTC/jar54.jar
    CLASSPATH=$CLASSPATH:$RTC/jar55.jar
    CLASSPATH=$CLASSPATH:$RTC/jar56.jar
    CLASSPATH=$CLASSPATH:$RTC/jar57.jar
    CLASSPATH=$CLASSPATH:$RTC/jar58.jar
    CLASSPATH=$CLASSPATH:$RTC/jar59.jar
    CLASSPATH=$CLASSPATH:$RTC/jar60.jar
    CLASSPATH=$CLASSPATH:$RTC/jar61.jar
    CLASSPATH=$CLASSPATH:$RTC/jar62.jar
    CLASSPATH=$CLASSPATH:$RTC/jar63.jar

    # Uncomment and update the following statement to reference the install
    # path for RTC
    #LIBPATH=$LIBPATH:@pathPrefix@/usr/lpp/jazz/v3.0/buildsystem/buildtoolkit

    # Uncomment and update the following statement to reference the working
    # directory.
    # Working directories are typically stored in /u/jazz. You can change
    # this directory.
    #SCM_WORK=@workPath@

  6. Stop and restart the RSE server and daemon.

What to do next

Create a file agent file called FileAgentConfiguration.dat in the same directory where rsed.envvars is saved. This .dat file must contain comma-separated entries that identify a Rational Team Concert for System z Jazz™ repository URL, a file agent user ID you will use to authenticate to the Jazz repository, and either a cleartext password or the full path name of an encrypted password file for that user ID; for example:

https://myexample.jazz.repository.com:9443/jazz, myrepouserid, /pathToMyEncryptedPasswordFile
Note: The repository URL that you specify in the FileAgentConfiguration.dat file must resolve to the same IP address as the repository URLs you specified in the client.

For information about creating an encrypted password file, see ../../com.ibm.team.build.doc/topics/t_rtcz_pw_file.html.


Feedback