Rational Team Concert 3.0 on OS X

Update 4/19/2011: The server zips are back and you no longer have to install on linux and move to OS X.

Rational Team Concert 3.0 is a nice development tool built on Eclipse that runs just fine on Mac OS X even though it’s not officially supported.  This guide will help you install and configure RTC 3.0 on OS X.  The client is very easy to install.  The server used to be easy to install, but some recent changes in the RTC builds has made it much more difficult.  Basically, you install the server on Linux, and transfer it to your OS X box.

Installing RTC 3.0 Server on Linux

Since the RTC Server is no longer available as a zip download, you must install the server on a supported platform such as Linux.  Once the server is installed, you can transfer the content to OS X and it will just work.

• Fire up a Linux box, Parallels, or VMWare (I use Parallels with Ubuntu)
• Head over to https://jazz.net/downloads and select Rational Team Concert
• Select Linux x86-32/64 for your platform and click Download Rational Team Concert
• After logging and accepting the the terms, RTC-Web-Installer-Linux-3.0.zip will be downloaded
• Unzip the archive into a folder and run launchpad.sh
• Uncheck Install in a shared location for multiple users
• Click Jazz Team Server and CCM Application under Install the Server
• The Installation Manager will start – login with your jazz.net id and password
• Click Next
• Agree to the license and click Next
• Keep the default directory locations and click Next
• Keep the default installation directory and click Next
• Select the desired translations and click Next
• Click Next
• Select Not upgrading from previous product release and click Next
• Click Install
• After the server is installed, click Finish

Moving RTC Server to OS X

Transfer the contents of the JazzTeamServer directory to OS X.  Here is the method I used:

• cd ~/IBM
• zip -r jazz.zip JazzTeamServer
• Copy jazz.zip to your OS X box (I use a Parallels shared folder)
• unzip jazz.zip into the directory of your choice (I use /Library)
• cd JazzTeamServer/server
• rm -rf jre

Configuring RTC Server

You configure the RTC 3.0 Server as you would for any other platform.  If you are using OS X Server and want to set up LDAP authentication, skip that configuration during the setup.  The setup wizard will not configure it correctly for OS X.  I have instructions below on how to configure the Tomcat JNDI realm by hand below.

• ./server.startup
• Point your web browser to https://localhost:9443/jts/setup
• Login id: ADMIN password: ADMIN
• Click Next
• Set the Public URI Root to https://<hostname>:9443/jts (where <hostname> is the hostname of your system)
• Click Test Connection and then click Next
• Keep the default Derby database settings and click Next
• Set up Email Notification as desired and click Next
• Set up your account and click Next
• Click Register Applications and click Next
• Keep the default URI, click Test Connection and click Next
• Keep the default Derby configuration and click Next
• Click Finalize Application Setup and click Next
• Click Finish
• (Optional) Set up LDAP for use with OS X Server
  • ./server.shutdown
  • edit tomcat/conf/server.xml
  • Disable the database realm
  • Configure the JNDI realm as shown below
  • ./server.startup

<Realm className="org.apache.catalina.realm.JNDIRealm"
    connectionName=""
    connectionURL="ldap://<hostname>:389"
    roleBase="cn=groups,dc=<host>,dc=<domain>,dc=com"
    roleName="cn"
    roleSearch="(memberUid={1})"
    roleSubtree="true"
    userBase="cn=users,dc=<host>,dc=<domain>,dc=com"
    userSearch="(uid={0})"
    userSubtree="true"/>

• Install your license as you normally would

You should now have a functional server.  If you are using OS X Server, remember that the LDAP groups are case sensitive, so make sure you create a JazzUsers group and not a jazzusers group.

Starting RTC Server on Boot

If you would like the RTC Server automatically started when OS X boots, put the following in /Library/LaunchDaemons/com.ibm.rtc.plist

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.ibm.rtc</string>
  <key>OnDemand</key>
  <true/>
  <key>Program</key>
  <string>server.startup</string>
  <key>AbandonProcessGroup</key>
  <true/>
  <key>RunAtLoad</key>
  <true/>
  <key>WorkingDirectory</key>
  <string>/Library/JazzTeamServer/server</string>
</dict>
</plist>

At the command prompt: sudo launchctl load com.ibm.rtc.plist

Installing RTC Client on OS X

Installing the client on OS X is super simple using the P2 repository.

• From the All Downloads tab on jazz.net, scroll down to the section containing the zips and download the P2 Install Repository
• unzip the downlaod
• From the Eclipse IDE, choose Help -> Install New Software …
• Add the directory to the unzipped P2 repository
• Check Rational Team Concert and install using the wizard