Installation road map for Rational Team Concert

Select options that best describe your installation environment

Choose an edition of IBM® Rational® Team Concert:

Choose the operating system for your application server:

Choose your application server:

Choose your database server:

Choose your preferred installation method:

Based on your environment, consider this road map as a guide for properly installing Rational Team Concert.

To Install Rational Team Concert:

Verify the hardware requirements

You can install Rational Team Concert on x86-based and Sun Solaris SPARC machines.

For a list of minimum hardware requirements, see Detailed System Requirements.

Get the Rational Team Concert installation media

Depending on the type of download, you need approximately two gigabytes (2 GB) of hard drive space to download and extract the Rational Team Concert installation media.

You can download the Jazz Team Server, Rational Team Concert client, Build System Toolkit, ClearCase Connector, ClearQuest Connector, and other incubator files from http://jazz.net. To purchase Rational Team Concert, go to http://www.ibm.com/software/awdtools/rtc/, where you can download an installable image or order a DVD.

Learn about Rational Team Concert editions and licenses

Rational Team Concert is available in several different editions. Each edition offers different licensing and feature configurations. In addition, the different editions include different numbers and kinds of Client Access Licenses (CALs). For detailed information, see Rational Team Concert editions and licenses.

For more information about Rational Team Concert editions and the Client Access Licenses included with each edition, visit the downloads section of jazz.net.

Install the Express-C edition server

The Express-C edition server is available in two different archive packages. Each package is platform dependent. The "Client for Eclipse IDE and Server" package contains the server and the client. The server package contains only the server. If you download the server package, you need to download the client separately.

To install the Express-C edition server:

  • Download the files to your computer.
  • Extract the contents of the package to your file system.

When you extract the files, choose a location that is close to the root of the file system. Long file path names can cause unnecessary errors or warnings. For example, extract the files to C:/IBM.

When you extract the files, choose a location that is close to the root of the file system. Long file path names can cause unnecessary errors or warnings. For example, extract the files to /opt/IBM.

Install the Express edition server

Before you begin installing the server, verify that the following tasks have been completed:

  • If Security-Enhanced Linux (SELinux) is enabled, you must disable it or change the security context of the Java Runtime Environment (JREs) to allow text relocation in order to install and run Rational Team Concert. For more information, see Installing Rational Team Concert with Security-Enhanced Linux.
  • The Jazz Team Server installation path names must not contain spaces. The startup script (JazzInstallDir/server/server.startup) and the repository tools script (JazzInstallDir/server/repotools.sh) detect and report this problem.
  • Increase the maximum number of files that the Apache Tomcat user can handle to 5000. On Red Hat Enterprise Linux, you can do this by adding the following lines to /etc/security/limits.conf:
    tomcat_user hard nofile 5000
    tomcat_user soft nofile 5000
  • The Reports component requires that 32-bit X11 libraries be installed on the server. On Red hat Enterprise Linux 5, the required packages are libXp, libXinerama, mesa-libGL, and compat-libstdc++-33.
  • When installing DB2 on Linux, set the shmmax to 1GB.
  • When running the Jazz Team Server, there are logs and other files (such as tomcat.users if used) that can be modified and written in the Jazz installation directory. For all users to be able to write to the installation directory, you must manually grant write permissions to the JazzInstallDir.

There are two methods to install Rational Team Concert Express edition by using IBM Installation Manager:

  • Installation Manager Web-based installation for client, server, and optional components: This archive file contains the Installation Manager launchpad program and the predefined installation repository locations. This is a self-extracting file that starts the IBM Installation Manager launchpad program after extracting the contents. The benefit of using the Web-based installation package is that the size of the download is reduced and the installation process downloads only the resources that you choose to install.

    Note: The Web-based installation requires an Internet connection during the installation process.

  • Local installation .zip file: This archive file contains the Installation Manager launchpad program and a local copy of all the installable resources. The benefit of using the local installation package is that you can perform the installation without being connected to the Internet. This is not a self-extracting .zip file.

For more information, see Installing the Express edition from the IBM Installation Manager.

When using the compressed archive files to complete the installation, record the directory in which you extract the files. The directory is referred to as JazzInstallDir.

For more information, see Installing the Express edition from the .zip file.

Install the Standard edition server

Install the Enterprise edition server

Before you begin installing the server, verify that the following tasks have been completed:

  • If Security-Enhanced Linux (SELinux) is enabled, you must disable it or change the security context of the Java Runtime Environment (JREs) to allow text relocation in order to install and run Rational Team Concert. For more information, see Installing Rational Team Concert with Security-Enhanced Linux.
  • The Jazz Team Server installation path names must not contain spaces. The startup script (JazzInstallDir/server/server.startup) and the repository tools script (JazzInstallDir/server/repotools.sh) detect and report this problem.
  • Increase the maximum number of files that the Apache Tomcat user can handle to 5000. On Red hat Enterprise Linux, you can do this by adding the following lines to /etc/security/limits.conf:
    tomcat_user hard nofile 5000
    tomcat_user soft nofile 5000
  • The Reports component requires that 32-bit X11 libraries be installed on the server. On Red hat Enterprise Linux 5, the required packages are libXp, libXinerama, mesa-libGL, and compat-libstdc++-33.
  • When installing DB2 on Linux, set the shmmax to 1GB.
  • When running the Jazz Team Server, there are logs and other files (such as tomcat.users if used) that can be modified and written in the Jazz installation directory. For all users to be able to write to the installation directory, you must manually grant write permissions to the JazzInstallDir.

There are two methods to install Rational Team Concert Standard edition by using IBM Installation Manager:

There are two methods to install Rational Team Concert Enterprise edition by using IBM Installation Manager:

  • Installation Manager Web-based installation for client, server, and optional components: This archive file contains the Installation Manager launchpad program and the predefined installation repository locations. This is a self-extracting file that starts the IBM Installation Manager launchpad program after extracting the contents. The benefit of using the Web-based installation package is that the size of the download is reduced and the installation process downloads only the resources that you choose to install.

    Note: The Web-based installation requires an Internet connection during the installation process.

  • Local installation .zip file: This archive file contains the Installation Manager launchpad program and a local copy of all the installable resources. The benefit of using the local installation package is that you can perform the installation without being connected to the Internet. This is not a self-extracting .zip file.

When using the compressed archive files to complete the installation, record the directory in which you extract the files. The directory is referred to as JazzInstallDir.

Set up the database

If you are using the included Derby database, no additional setup is necessary. Proceed to Starting the server.

Set up a supported DB2 or the bundled DB2 Workgroup Server database to work with the Jazz™ Team Server.

Set up a supported Oracle database to work with the Jazz™ Team Server.

Set up a supported SQL Server database to work with the Jazz™ Team Server.

Before you begin, verify that the following tasks have been completed:

  • Access to a database server that is installed and running.
  • DB2 is installed and running on a machine to be used as the database server. This machine can be a different one from that on which the Jazz Team Server runs.
  • The user performing DB2 setup has system admin authority on the DB2 database.
  • On Linux®, to get system admin authority on the DB2 database, sudo to the DB2 user db2inst1 and run bash. Note that db2inst1 is the default instance user.
  • You have SQL Server installed.
  • SQL Server service is started.
  • You have the SQL Server JDBC drivers installed. For more information, see Microsoft SQL Server JDBC Driver.
  • The TCP protocol is enabled for SQL Server.
  • The user who creates the DB table must have one of the following permissions:
    • Membership in the sysadmin fixed server role
    • Ownership of the database (dbo)
  • Oracle is installed on a machine to be used as the database server. This machine can be a different one from that on which the Jazz Team Server runs.
  • A default database exists on the Oracle server.
  • The user performing Oracle setup has system administration authority on the Oracle database.

To setup a DB2 database, see Setting up a DB2 database.

To setup an Oracle database, see Setting up an Oracle database.

To setup a SQL Server database, see Setting up a SQL Server database.

Start the Apache Tomcat server

You are now ready to start the Apache Tomcat server.

Before you start the server, verify that the following tasks have been completed:

  • Apache Tomcat has been installed in the directory JazzInstallDir/server/tomcat.
  • The Web application (jazz.war) has been installed in the Apache Tomcat directory webapps.
  • For more information about configuration, see Starting the Apache Tomcat server.

To start the server, from the JazzInstallDir/server directory, run the following command:
server.startup.bat

Note: A separate Apache Tomcat console window opens. Do not close this window or the server will stop working.

To stop the server, from the JazzInstallDir/server directory, run the following command:
server.shutdown.bat

If you installed Jazz Team Server using IBM Installation Manager, you can also run the commands from the Jazz Team Server Windows start menu.

To start the server, from the JazzInstallDir/server directory, as user root, run the following command:
./server.startup

If your user ID has administrator access, run the following command:
sudo ./server.startup

Note: A separate Apache Tomcat window will not be displayed. You can check the server startup progress by viewing the log file at JazzInstallDir/server/logs/jazz.log.

To stop the server, from the JazzInstallDir/server directory, as user root, run the following command:
./server.shutdown

If your user ID has administrator access, run the following command:
sudo ./server.shutdown

If you installed Jazz Team Server by using IBM Installation Manager, you can also run the commands from the Jazz Team Server application start menu.

Set up the WebSphere Application Server

Before you begin, verify that the following tasks have been completed:

  • WebSphere Application Server is installed.
  • The database is created and the teamserver.properties file is updated with your database settings.
  • (Optional) Enabling the case insensitive login.
  • Java 2 Security option should be turned off. If this option is turned on in the WebSphere Application Server, it will cause the Jazz Team Server .war to fail to start.
  • Ensure that the WenSphere Application Server security setting "Use available authentication data when an unprotected URI is accessed" is selected.
  • The Jazz Team Server includes the files that are required to run the Apache Tomcat server. For a WebSphere Application Server installation, you only need a subset of the Jazz Team Server files. If you are not using IBM Installation Manager, manually copy the following files form JazzInstallDir to a directory on the application server machine:
    • The file JazzInstallDir/server/tomcat/webapps/jazz.war
    • The directory JazzInstallDir/server/update-site
    • The directory JazzInstallDir/server/conf
    • The default repository database in JazzInstallDir/repositoryDB
    • The repository tools in JazzInstallDir/repotools
    • The directory JazzInstallDir/server/license-update-site
    • The directory JazzInstallDir/server/nl1-update-site
    • The directory JazzInstallDir/server/nl2-update-site

After the jazz.war application is deployed, start the Application Server. For more information, see Setting up a WebSphere Application Server.

After the jazz.war application is deployed, start the Application Server. For more information, see Setting up a WebSphere Application Server.

Tip: When using IBM Installation Manager, you can install the Jazz Team Server files into a Web application directory. During the installation process, do not install the included Apache Tomcat application server. Doing so forces Installation Manager ask for a Web application directory and then installs only the files needed for WebSphere Application Server.

The default directory is C:\Program Files\IBM\JazzTeamServer.

The default directory is /opt/IBM/JazzTeamServer.

Run the setup wizard

Running the setup wizard verifies that the server is operating properly and guides you through the steps to configure the server.

By default, the server is configured to use Derby as the database. To use another database, such as DB2, select the custom setup path and complete Step 2: Configure Database. If you have not created your database tables, you will be prompted to create the database tables after you test the connection. If you choose the Fast Path Setup and your database tables are not created, you will be prompted to go to Step 2 and create database tables. For more information, see Running the setup wizard.

You have installed Rational Team Concert Server!

After the server is installed, you must consider some configuration options before continuing. For more information, see Completing the Express-C edition installation.

After the server is installed, you must consider some configuration options before continuing. For more information, see Completing the installation.

After the server is installed, you must consider some configuration options before continuing. For more information, see Completing the installation.

Install the Rational Team Concert Eclipse client

If you want to use the Rational Team Concert Eclipse client, you can install it by using the downloadable .zip file. For more information, see Installing the client using a .zip file.

If you want to install the client into an existing Eclipse workbench, use IBM Installation Manager, which prompts you for the workbench that you want to extend. Installation Manager also administrates future workbench updates, rollbacks, and modifications.

You can also use Installation Manager to install the Rational Team Concert Eclipse client. For more information, see Installing the client using the IBM Installation Manager.