Based on your environment, consider this road map as a guide for properly installing Rational Team Concert.
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.
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.
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.
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:
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.
Before you begin installing the server, verify that the following tasks have been completed:
tomcat_user hard nofile 5000tomcat_user soft nofile 5000libXp, libXinerama, mesa-libGL, and compat-libstdc++-33.There are two methods to install Rational Team Concert Express edition by using IBM Installation Manager:
Note: The Web-based installation requires an Internet connection during the installation process.
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.
Before you begin installing the server, verify that the following tasks have been completed:
tomcat_user hard nofile 5000tomcat_user soft nofile 5000libXp, libXinerama, mesa-libGL, and compat-libstdc++-33.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:
Note: The Web-based installation requires an Internet connection during the installation process.
For more information, see Installing the Standard edition from the IBM Installation Manager.
For more information, see Installing the Enterprise 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 Standard edition from the .zip file.
For more information, see Installing the Enterprise edition from the .zip file.
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:
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.
You are now ready to start the Apache Tomcat server.
Before you start the server, verify that the following tasks have been completed:
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.
Before you begin, verify that the following tasks have been completed:
teamserver.properties file is updated with your database settings.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.
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.
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.
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.