Installation raod map for Rational Team Concert

Describe your environment

Which edition of IBM® Rational® Team Concert are you installing?

Which operating system do you want to use to run your application server?

Which application server will you be using?

Which database server will you be using?

Will you be using Installation Manager?

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

To Install Rational Team Concert:

Know what you need as a minimum hardware requirements

Rational Team Concert can be installed on x86-based and Sun Solaris SPARC machines.

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

Retrieve and extract the Rational Team Concert installation media

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

The Jazz Team Server, Rational Team Concert client, Build System Toolkit, ClearCase Connector, ClearQuest Connector and other incubator files can be downloaded 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.

Rational Team Concert editions and licenses

Rational Team Concert is available in several different editions with different licensing and feature configurations. Depending on the edition that is licensed for use on your Jazz Team Server, different features will be available to you. 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

You will need the following:

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

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.

When you extract the files, choose a location 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 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

You need one of the following resources:

  • Web install for clients, server, and optional features
  • Local install for clients, server and optional features (separate downloads)

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

  • Installation Manager Web install 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 install package is that it reduces the size of initial download and the installation process downloads only the resources you choose to install.

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

  • Local install .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 install package is that it allows the installation to proceed without an Internet connection. This is not a self-extracting .zip file.

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

You need the following information:

  • 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

You need one of the following resources:

  • Web install for clients, server, and optional features
  • Local install for clients, server and optional features (separate downloads)

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

  • Installation Manager Web install 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 install package is that it reduces the size of initial download and the installation process downloads only the resources you choose to install.

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

  • Local install .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 install package is that it allows the installation to proceed without an Internet connection. This is not a self-extracting .zip file.

For more information, see Installing the Standard edtion from the IBM Installation Manager.

You need the following information:

  • 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 Standard edition from the .zip file.

Install the Enterprise edition server

You need one of the following resources:

  • Web install for clients, server, and optional features
  • Local install for clients, server and optional features (separate downloads)

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

  • Installation Manager Web install 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 install package is that it reduces the size of initial download and the installation process downloads only the resources you choose to install.

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

  • Local install .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 install package is that it allows the installation to proceed without an Internet connection. This is not a self-extracting .zip file.

For more information, see Installing the Enterprise edtion from the IBM Installation Manager.

You need the following information:

  • 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 Enterprise edition from the .zip file.

Setup the database

If you are using the included Derby database, no additional setup is necessary.

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.

You will need the following permissions and information:

  • Proceed to Starting the server.
  • 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:
    • A 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 seup a DB2 database, see Setting up a DB2 database.

To seup 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.

You will need the following information:

  • 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 this 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 this 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 this command:
./server.startup

If your user ID has administrator access, run this 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 this command:
./server.shutdown

If your user ID has administrator access, run this 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 a WebSphere Application Server

Before you begin, you will need to have the following completed:

  • WebSphere application server is already 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 WAS security setting "Use available authentication data when an unprotected URI is accessed" is checked.
  • The Jazz Team Server includes the files required to run a complete Apache Tomcat-based server. For a WebSphere installation you only need a subset of the Jazz Team Server files and you should place them in a directory on your WebSphere server machine.

For more information, see Setting up a WebSphere Application Server.

For more information, see Setting up a WebSphere Application Server.

Tip: When using the IBM Installation Manager the Jazz Team Server files can be installed into a Web Application directory. During the installation process, you should not install the included Apache Tomcat application server; this makes the Installation Manager ask for a Web Application directory and install only the files needed for WebSphere.

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

The default directory is /opt/IBM/JazzTeamServer.

The installation directory is referred to as JazzInstallDir in this procedure. If you use the IBM Installation Manager to install the files into the WebSphere Application Server Web applications directory, then you do not need to manually move the files as described above.

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, after testing the connection you will be prompted to create the database tables. 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 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 the IBM Installation Manager. The IBM Installation Manager install prompts you for the workbench you want to extend and takes care of managing 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.