Book Image

IBM Rational Team Concert 2 Essentials

Book Image

IBM Rational Team Concert 2 Essentials

Overview of this book

Software development is a collaborative effort needing active and timely input and response from all its members. Every day, project managers face ever-increasing pressures to produce high-quality software with increasing constraints. With IBM's Rational Team Concert collaborative software delivery environment, you can tremendously improve the productivity of your entire team through a web-based user-interface, continuous builds, a customizable process with work support, team support, integration and many more features. Written by Suresh Krishna and TC Fenstermaker, experts on Rational Team Concert, this book will help you leverage the full potential of the IBM Rational Team Concert platform to improve your individual and team performance. It follows a realistic case-study example enabling you to learn about Rational Team Concert fundamentals and best practices along the way to efficiently manage your software projects and tackle various software development challenges.Beginning with an in-depth analysis of software development challenges, the book goes on to introduce the Jazz Platform followed by a complete overview of the architecture of Rational Team Concert. After you install Rational Team Concert on WebSphere and learn to configure the server and clients, you will see all the features in relation to Web and Eclipse clients.From Chapter 3 onwards a realistic sample application is constructed to give you a strong grasp of your concepts. As you proceed, you learn source control, the mechanism to create, control, and manage documents, artifacts in a software development lifecycle, followed by different tools that Rational Team Concert offers for effective team and work management. You tackle the various challenges of Team Collaboration by integrated e-mail, instant messaging, events, feeds, and work items, the basic units of the task. You also learn the various aspects of the software development process and release planning along with process templates, which provide the initial process and iteration of your project. Finally, you extend the Rational Team Concert and make use of the Jazz Platform APIs to customize your process to fit your organizational needs.
Table of Contents (20 chapters)
IBM Rational Team Concert 2 Essentials
About the Authors
About the Reviewers

Installing Rational Team Concert Express-C

In this chapter, we will run Express-C on the following configuration:

  • Derby database

  • Tomcat as application server

  • Eclipse as IDE

  • Subversion—import existing demo application into Jazz Repository

Our examples and screenshots are from a Windows 32-bit installation. The ideal hardware configuration suggested by IBM RTC experts is as follows:

  • Intel Pentium Xeon (32 bit or 64 bit)

  • 1024 x 786 screen resolution

  • 2 GB RAM

  • 1 GB disk space

As with the Enterprise edition, you can get the Rational Team Concert Express–C distribution from either the IBM or Jazz websites. Once you've downloaded the Express-C ZIP file, installation, and configuration are only few clicks away. If you download the full client for Eclipse IDE and server distribution, after installation you will have Express-C the server, client, build system, report tools, and SCM tools. Alternatively, you can download each piece separately. Our steps here assume you've downloaded the complete bundle.

A quick installation has several easy steps to follow. The idea is to install, set up, and configure project on the server.

Installing Express-C

Extract the contents of the Express-C ZIP to a directory of your choice. It is that simple.


The installation directory for the Rational Team Concert is now referred to as <root>.

As with the Enterprise version, the extracted contents will contain the build system, client, repository tools, SCM tools, and server.

Express-C basic setup

Go to the <root>\server folder and run the server.startup.bat command to start the server. This will start the Tomcat server, and deploy the Jazz Team Server application, jazz.war, in <root>\server\tomcat\webapps. As the server starts, you will see information messages as shown in the following screenshot. Notice that the server starts on a http port 9080 and on https port 9443. You can connect to it on either of these:

Once the server is started, you are ready to set up and configure the Rational Team Concert. You can now create projects, workspaces, and users from the web interface.


Connection error

By default, the server starts on http port 9080. When you start the Rational Team Concert, you may get an exception that may read Address already in use.

This error points you to check the already used and running ports on the machine. Change the server port by editing the server.xml file in the <root>\server\tomcat\conf folder.

Using a web browser, navigate to http://localhost:9080/jazz or https://localhost:9443/jazz. Like in Enterprise installation, you will see a screen similar to the following one, where you sign-on to administer the installation. For the initial login, use the default of ADMIN/ADMIN. As always, be sure to change it from this default immediately.

Once logged in, you are presented with the setup screens, as shown next. Walk through these to configure e-mail, database, and public repository URI settings or choose the Fast Path Setup:

With Express–C, you have a choice of administering users through a non-LDAP registry, or through Tomcat. During the Setup User Registry screen (seen next), choose which you intend to use. This step is also where you should change the default administrative login and password.

Admin setup

The remainder of the administrative setup, including establishing project areas, assigning user roles, and the like, are identical to the steps we followed in the Enterprise setup. Refer to Chapter 2 for the details.

Client setup

As with the Enterprise setup, the Rational Team Concert client is provided with its own JDK, and is available at <rtcRoot>\jazz\client\eclipse\eclipse.exe. Follow the steps in Chapter 2 to do the following client tasks:

  • Accept a team invitation

  • Connect to a project area

  • Create a project area

  • Create project plans

  • Create work items

  • Define process templates

  • Import the source code from SVN, ClearCase

  • Create team builds

Rational Team Concert client asks for the location of the workspace. This is the workspace location for any new projects that are created and/or imported to, as shown in the next screenshot:

Once the workspace is selected, the Rational Team Concert's client is started and the welcome screen appears.