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.

Note

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.

Tip

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 java.net.BindException: 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.