Running Rational Team Concert on Mac OS X

Work Item Team
Last modified: May 21, 2012
Build basis: Rational Team Concert 4.0

Summary

Although officially unsupported, the Rational Team Concert 4.0 Eclipse Client runs on Mac OS X 10.6.x and 10.7.x. The Build System Toolkit, while officially unsupported, also works with Mac OS X 10.6.x and 10.7.x. There is currently no OS X version of Jazz Team Server available for download.

More Information

The Rational Team Concert Eclipse Client

A Rational Team Concert client exists for Mac OS X. It works without modification.

• Download the Eclipse Client for Mac OS X ZIP file from the Rational Team Concert 4.0 section of the All Downloads page on Jazz.net.
• Look for a folder named “Jazz” in your downloads folder. If the “Jazz” folder isn’t there you will have to unpack the zip file you downloaded by double clicking on it. This should create a folder named “Jazz”. Move the “Jazz” folder to the location where you want Rational Team Concert installed.
  Note that if you already had a folder named “Jazz” in your downloads folder you will end up with a folder named “Jazz 1”. In this case you can rename the “Jazz 1” folder after you have moved it to where you want it installed.
• If you already have the Jazz Build System Toolkit installed you can copy the contents of the newly downloaded folder into the folder containing the Jazz Build System Toolkit.
• The Rational Team Concert application can be launched from the finder as jazz/client/eclipse/Eclipse.

The Rational Team Concert Web UI

The Rational Team Concert Web UI runs on both the Mozilla Firefox and Apple Safari Web browsers.

Jazz Build System Toolkit

1. Download the Build System Toolkit for OS X from the Rational Team Concert 4.0 section of the All Downloads page on Jazz.net.
2. Look for a folder named “Jazz” in your downloads folder. If it isn’t there you will have to unpack the zip file you downloaded by double clicking on it. This should create a folder named “Jazz”. Move the “Jazz” folder to the location where you want the Build System Toolkit installed.
   Note that if you already had a folder named “Jazz” in your downloads folder you will end up with a folder named “Jazz 1”. In this case you can rename the “Jazz 1” folder after you have moved it to where you want it installed.
3. If you already have the RTC Eclipse Client installed you can copy the contents of the newly downloaded folder into containing the RTC Eclipse Client is installed.
4. To start the build engine, open the Terminal application and navigate to jazz/buildsystem/buildengine/eclipse and run this command:

   ./jbe.sh -repository https://jazzhost:9443/jazz/ -userId build -pass build -engineId junit

   • jazzhost is the name of the server that is hosting your Jazz Team Server.
   • userId, password, and engineId are the values used by the JUnit example project area. If you do not intend to use the JUnit example, adapt the values accordingly.
   • The “build” user must have a Developer Client Access License or a Build System Client Access License.