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&gt;: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"
  • 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">

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

19 thoughts on “Rational Team Concert 3.0 on OS X

  1. Sorry to ask this question that is vaguely related to your topic. Did you have any issues installing RTC3 Server on Ubuntu. When I try I get the error: /bin/bash: /opt/RTC-Web-Installer-Linux-3.0/im/linux.gtk/x86/install: No such file or directory

    And yes, the file exists and is wide open.

    • I installed RTC 3.0 on Ubuntu running under Parallels without problems. One difference is that I installed as a normal user instead of root which I assume is what you are doing based on your path.

  2. Thanks for the instructions! I’ve gotten stuck after copying it over to Mac OS X. When I try running ./server.startup (with or without sudo), I get only

    Using CATALINA_BASE: /Users/shiraeliaser/Norm/JazzTeamServer/server/tomcat
    Using CATALINA_HOME: /Users/shiraeliaser/Norm/JazzTeamServer/server/tomcat
    Using CATALINA_TMPDIR: /Users/shiraeliaser/Norm/JazzTeamServer/server/tomcat/temp
    Using JRE_HOME: /System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Home
    Using CLASSPATH: /Users/shiraeliaser/Norm/JazzTeamServer/server/tomcat/bin/bootstrap.jar

    The tomcat/logs/catalina.out shows:

    Error occurred during initialization of VM
    The size of the object heap + VM data exceeds the maximum representable size

    I tried looking for the analogs to what’s shown for older versions of JTS in http://jazz.net/library/article/80, but the MaxPermSize is already 384m, and JRE_HOME is already properly set. There’s no reference to IbmX509 in the server.xml file.

    I’d greatly appreciate any pointers. Thanks!

    • I vaguely recall having a similar issue and working around it by experimenting with the wizard until I found some combination of data and “Test Connection” that it was happy with. Sorry I can’t give you a better answer – this is a pretty major hack to get the server working. If all else fails, you can try configuring it on Linux, then copy over all / some of the configuration files in server/conf.

      • If you follow Jason’s example from the jazz forum link I cited, and “skip that step,” by putting a 3 into the URL to skip step 2, you can get through the other steps. I’d been afraid that there was a form post that was required for step 3, but it seems there isn’t.

        Setup brings you back to step 2 at the end, but it seems you can get enough configured to move along and use the server. I’ll see if there are other issues down the line, but for playing in the sandbox, this seems to work!


  3. You’ll be happy to see that the server zips are back in 3.01 milestones. Look under All Downloads->Plain zips. The server zip there now includes the Jazz Team Server and RTC, RQM, and RRC capability. I run these natively on my Mac, no need to install and move.

    Scott Rich (IBM)

    • You might try either of the zips under the Enterprise Platform Installers section. If that doesn’t work, then the zips got pulled from the 3.0.1 release, and you will have to give my instructions above a try.

  4. Thanks a bunch as this worked great with me getting Rational Team Concerted installed on MAC OS X 64 bit with existing eclipse that i just installed separately. Here are my detailed notes – James Stroud from IBM

    1) install eclipse on MAC via http://www.eclipse.org/downloads/?osType=macosx I used the Eclipse IDE for Java EE Developers. My version of eclipse is
    Eclipse Java EE IDE for Web Developers.

    Version: Indigo Service Release 2
    Build id: 20120216-1857
    2) tthe followed installing RTC Client on OS X from link below

    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 this was RTC-Client-p2Repo- when done on June 5, 2012
    unzip the download this created a directory called RTC-Client-p2Repo-
    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

    during install of Rational Team Concert select the “Rational Team Concert Client (extend and Eclipse installation)” and not the “Rational Team Concert Client (standalone installation”.
    Accept all defaults
    and after the install you will be asked to restart eclipse, go ahead and I did a File …. Accept Team Invitation
    then I copied and pasted my the text of the team invitation given to me in advance by a team member to configure my Rational Team Concert with
    my organization’s server

  5. Have tested the procedure with RTC 4.0 on Mac OS-X 10.7.4,
    via an initial installation on Ubuntu 12.04,
    and it works exactly as described.

    There was one catch:
    The RTC installation failed on Ubuntu 64-bit, as some 32-bit libs were missing in the basic configuration,
    and my workaround was to install it on Ubuntu 32-bit
    (the installation gave a warning that this 32-bit OS is not supported,
    but it did not fail the process).



Leave a Reply

Please log in using one of these methods to post your comment:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s