Installing the client using a .zip file

The client is distributed as a downloadable .zip file.

About this task

Procedure

  1. Download the client package file.
    You should download the Rational Team Concert™ client .zip file.
    Note: If you want to install the client into an existing Eclipse workbench, use the IBM Installation Manager. The IBM Installation Manager install prompts you for the workbench you want to extend and takes care of managing future workbench updates, rollbacks, and modifications
  2. Install the client distribution. Extract the .zip file to an installation directory of your choice (for example, /opt/IBM/ on Linux® or c:\IBM on Windows®). Relative to the installation directory you choose, the client path is JazzInstallDir/client.
  3. Start the client. On Windows, double-click the eclipse.exe application in the directory JazzInstallDir\client\eclipse . On Linux, execute the eclipse file in the directory JazzInstallDir/client/eclipse.
  4. 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.

Example

Trouble Shooting: 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".

What to do next


Feedback

Did this help? You can provide feedback at Jazz.net (registration required): Comment in the forums or submit a bug