Installing IBM Rational Team Concert Express-C

An informal quickstart guide for beginners

The Jazz technology platform and IBM® Rational® Team Concert, the first product based on Jazz technology, enable software developers to truly deliver software as one ensemble.


Jeff Miller, Senior Software Engineer, SWG Competitive Technology, IBM Developer Relations

Jeff Miller photoJeff Miller is a software consultant with IBM ISV & Developer Relations Worldwide Developer Skills program. He has over 24 years of software development experience as an electrical engineer, software developer and architect. His focus at IBM is Java EE application architecture, design, development, Web services, SOA and security. Jeff consults, codes, teaches, writes technical articles and speaks to universities and groups. He is an IBM-certified On Demand Solution Designer and Solution Technologist, an IBM Certified Solution Designer -- Service Oriented Architecture, and is IBM-certified on Rational Application Developer and WebSphere Application Server. Jeff is a CompTIA Security+ Certified Professional. He received his Masters degree in Computer Science from Rensselaer Polytechnic Institute.

developerWorks Contributing author

01 June 2008 (First published 12 February 2008)

Also available in Chinese Russian Vietnamese Spanish

I played music professionally for many years, both solo and in bands. I liked each, but I always preferred playing in bands, because when a group of musicians are playing in sync, in harmony, listening, complementing, and playing off of each other, it's a wonderful thing.

As a software developer, I've always wished that teams I was on could be as tight as some of the bands that I've been in. Unfortunately, that hasn't always been the case. As developers, we often work on different parts of a project, have different responsibilities, may be geographically or organizationally dispersed, and yet, we need to pull it all together in the end to deliver high-quality software as if we were the tightest software development team.

Well, now there is a platform that can help us do just that, and the beauty of it is that its name is musical: Jazz. We can always tell when a musical group, whether a rock band, a jazz ensemble, a choir, or even an orchestra, is playing as one. The Jazz technology platform and IBM® Rational® Team Concert, the first product based on Jazz, enable software developers to truly deliver software as one ensemble.

This is intended as a quickstart guide to installing and configuring Rational Team Concert Express-C.

Summary of the products and process

Rational Team Concert Express is a client/server offering consisting of the Rational Team Concert client and the Jazz™ Team Server. I won't go into more detail here about what they are, because you can find a lot of information about them elsewhere (see Resources). Instead, I'll give you the "guide to the guide" for installing and setting up the server and client software. I'll point you to the pertinent, more detailed instructions as we go along. And I'll add a few tips to help you avoid problems.

The overall installation process involves four steps:

  1. Downloading the Rational Team Concert Express-C installation files from
  2. Installing and configuring the server
  3. Installing and configuring the client
  4. Optionally, setting up IBM Lotus® Sametime® (or open source Jabber) as your collaboration tool

Getting started

  1. Start by registering at It's open to the public, and it's free. Just click the Register now! link under "How do I join?"
  2. After you have registered and logged in, go to the Downloads page (see Figure 1), where you'll see three editions available:
  • Express-C
  • Express
  • Standard
Figure 1. Jazz Downloads page
image of web page
  1. Click Express-C to download the file (378 MB).
  2. Extract the contents of the zip file to a local installation directory (..\<installdir>).

Setting up the Jazz Team Server

In this section you will start the Tomact server and log in to the Jazz Team Server Setup wizard. Once this is done you can configure and administer your Jazz projects by accessing the Jazz Team Server Administration pages.

  1. Start the Tomcat server by running the file <installdir>\jazz\server\server.startup.bat
  2. Open a browser and enter the URL: https://localhost:9443/jazz/setup
  3. Log in to the Jazz Team Server Setup wizard with the user/password: ADMIN/ADMIN (case-sensitive), as shown in Figure 2.
Figure 2. The Jazz Team Server Setup login page
image of page
  1. On the Jazz Team Server Setup page, click the Fast Path Setup button for the default configuration (Figure 3).

Note: Optionally, you and click Custom Setup to configure a different database and enable e-mail notifications, but for now let's get Jazz up and running quickly.

Figure 3. The Jazz Team Server Setup page
image of page
  1. On the Setup User Registry page, select your user registry, setup a user account for yourself, and assign a client access license to the user account you're creating. Click Next.

Note: In the Express-C version, the following account licenses are available: 1 for the build system user account, and and 3 for Developer clients. You can purchase additional client licenses for up to a total of 10 Contributor and Developer users. If you anticipate a larger team, then download and install either the Rational Team Concert Express or Standard.

  1. On the Summary page of the Jazz Team Server Setup wizard, you can create more user accounts or create a new Jazz project, or simply click Finish to complete the server setup (Figure 4).
Figure 4. The Jazz Team Server Setup Summary page
image of page

On the Jazz Team Server Administration pages you'll see summaries, statistics, and status of your projects, you can also manage users, project areas, e-mail and database settings, and other project properties. You can log in to the Jazz Administration pages by entering the URL: https://localhost:9443/jazz/admin in your browser and change these settings at any time now that server setup is complete.

Note:For a more complete description of the installation process, as well as some troubleshooting tips, see the Product Overview at the Rational software Information Center.

Server installation tips

I extracted the ZIP file below the root directory and a single Jazz directory was created that installed both the server and client directories under it, but the installation location is up to you. The server comes with its own Java™ runtime environment (JRE) tool, as the client does, too. You can use the default Derby database that is part of the default installation, or you can configure the server to use IBM DB2® or another database as your repository, depending on your edition. I took the quickest path and opted to use the Derby database. I used Tomcat (included) as the application server.

After the installation, I created shortcuts to start and stop the application server and added them to the Windows Start menu. That makes it easy. Figure 5 shows the menu after I also installed the client.

Figure 5. Menu after installation
image of new menu commands

If you have trouble accessing the default Tomcat page or the Jazz Team Server administration page from your browser, check to see whether your firewall is preventing access. You can find other troubleshooting help in the online server setup guide.

Client installation tips

Next, you'll start the client installation and log in to the Rational Team Concert workspace.

  1. Navigate to the installation dierctory, <installdir>\jazz\client\eclipse
  2. Double-click the file TeamConcert.exe.

Note: You may want to create a shortcut to this file on your Desktop or Start menu.

  1. When the Workplace Launcher dialog appears, select a location for your workspace, and click OK.

The Rational Team Concert workspace is displayed, as shown in Figure 6.

Figure 6. The Rational Team Concert workspace
image of workspace

Note: If you get a warning dialog that you cannot connect to the localhost repository, as shown in Figure 7, check the following:

Figure 7. Login Failed warning dialog
image of dialog box
  • Make sure that Tomcat is started and properly configured.

If you still cannot connect, do the following:

  1. In the Rational Team Concert workspace, expand the Repository Connections node.
  2. Right-click ADMIN@localhost, and click Properties.
  3. In the Properties for ADMIN@localhost dialog box, click Jazz Repository Connection, and make sure that under Location, that the value for URI is: https://localhost:9443/jazz/.
  4. If not, enter the URI above.
  5. Under Authentication, enter the Jazz server administrator password, and click Apply and then click OK (Figure 8).
Figure 8. Properties for ADMIN@localhost dialog
image of dialog box

You should now be able to connect to your localhost.

Note: If you are already a team member in another Rational Team Concert project, you should also see those connections in your workspace under the Repository Connections node.


The Jazz technology platform and Rational Team Concert Express enable your team to work even more in harmony. Not only do they change the way that your team members can work together, but they are fun to use.



Get products and technologies



developerWorks: Sign in

Required fields are indicated with an asterisk (*).

Need an IBM ID?
Forgot your IBM ID?

Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.


The first time you sign into developerWorks, a profile is created for you. Information in your profile (your name, country/region, and company name) is displayed to the public and will accompany any content you post, unless you opt to hide your company name. You may update your IBM account at any time.

All information submitted is secure.

Choose your display name

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

Required fields are indicated with an asterisk (*).

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.


All information submitted is secure.

Dig deeper into Rational software on developerWorks

Zone=Rational, DevOps
ArticleTitle=Installing IBM Rational Team Concert Express-C