RTCz: Installing the client using the IBM Installation Manager

The client is distributed as a downloadable file via the IBM® Installation Manager.
Note: If you want to install the client into an existing Eclipse package group, use the IBM Installation Manager. The IBM Installation Manager installation prompts you for the package group you want to extend and manages future workbench updates, rollbacks and modifications.
  1. Download an installation package from the Rational Team Concert for System z downloads page on Jazz.net. The package is a .zip file that contains the Installation Manager launchpad program and a local copy of the Rational Team Concert for System z client. The benefit of using the local install package is that it allows the installation to proceed without an Internet connection. This is a .zip file that is not self extracting.
  2. Start the launchpad program.

    If the Installation Manager is not already running, complete the following steps to start it.

    Note: You must have administrator privileges to run the launchpad program.
    Note: The Linux commands to start the launchpad program are only for the Rational Team Concert for System z client for Eclipse IDE.
    Extract the contents of the .zip file into a temporary directory and run the launchpad program.
    • To run the file on Windows, run this command:
      launchpad.exe
    • To run the file on Linux, run this command:
      sh launchpad.sh
  3. To install Rational Team Concert for System z client, click Rational Team Concert for System z client for Eclipse IDE link. The Installation Manager wizard is displayed. The wizard guides you through to install the client.
  4. Start the client by clicking the Rational Team Concert for System z shortcut created by the installation.
  5. Connect to the server. The easiest way to connect to a server is using the Team Invitation. If you do not have an invitation you can connect manually.
    1. Click File > Accept team invitation. The wizard guides you through the process.
      Note: If you do not have an invitation you need the URI or URL from your server admin. (an example format is: https://example.com:9443/jazz). Click on the connecting to an existing project area hyperlink that appears in the bottom right corner of the Accept Team Invitation window.
    2. Follow the instructions in the wizard to set up your connection.
Troubleshooting: Here are some suggested problem management techniques.
  • Start with an empty workspace.
  • The client and the server builds must match. Make sure the build ID's match for both the client and server distributions.
  • Make sure the server is up. Confirm using the status URL: https://example.com:9443/jazz.
  • On Linux, if you want to start the client from outside of the directory JazzInstallDir/client/eclipse you must change each file in JazzInstallDir/client/eclipse/links/ and include the absolute path to the named directory. By default, relative paths are used. For example, JazzInstallDir/client/eclipse/links/build.link contains the text "path=jazz/build". If your client is installed in the directory /home/username/teamconcert, edit the file to look like "path=/home/username/teamconcert/jazz/client/eclipse/build".

Feedback