Based on your environment, consider this road map as a guide for properly installing Rational Team Concert.
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.
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 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.
You will need the following:
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.
You need one of the following resources:
There are two methods to install Rational Team Concert Express edition by using IBM Installation Manager:
Note: The Web install requires an Internet connection during the installation process.
For more information, see Installing the Express edtion from the IBM Installation Manager.
You need the following information:
For more information, see Installing the Express edition from the .zip file.
You need one of the following resources:
There are two methods to install Rational Team Concert Standard edition by using IBM Installation Manager:
Note: The Web install requires an Internet connection during the installation process.
For more information, see Installing the Standard edtion from the IBM Installation Manager.
You need the following information:
For more information, see Installing the Standard edition from the .zip file.
You need one of the following resources:
There are two methods to install Rational Team Concert Enterprise edition by using IBM Installation Manager:
Note: The Web install requires an Internet connection during the installation process.
For more information, see Installing the Enterprise edtion from the IBM Installation Manager.
You need the following information:
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.
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:
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.
You are now ready to start the Apache Tomcat server.
You will need the following information:
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.
Before you begin, you will need to have the following completed:
teamserver.properties
file is updated with your database settings.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.
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.
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 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.