RegisterLog In to Jazz.net dW
Download 4.0.6 Release
February 28, 2014
Try it in the Sandbox
Buy it | Questions?

Rational Team Concert

Task tracking Source control Agile planning

Rational Team Concert 1.0

Product Release Trial | June 25, 2008 | Documentation
This is not the most recent version. We recommend Rational Team Concert 4.0.6 . This is made available for archival purposes and may contain bugs and/or security vulnerabilities. If you do download this version, it is being provided AS IS, without warranties of any kind, including the implied warranties of merchantability and fitness for a particular purpose. We strongly advise you review the support pages for this version and update the product or take actions recommended therein. Security bulletins contain instructions for the security vulnerability addressed therein, and may require upgrading to a newer version. Link to security vulnerability blog: IBM PSIRT blog.

Installing IBM Rational Team Concert Standard Edition using a .zip file

This version was built 18 Jun 2008.

The latest version of this installation procedure, along with helpful planning information, can be found online at http://publib.boulder.ibm.com/infocenter/rtc/v1r0m0/index.jsp.

Installing Rational Team Concert Standard edition

Standard edition installation overview

The installation package includes everything you need to get started.

The default configuration includes:

  • The supported versions of a Java(TM) Development Kit (JDK) for Windows(R) and Linux(R).
  • A working image of Apache Tomcat Web application server containing the Jazz(TM) Web application.
  • A Derby database and all necessary database libraries.
    Important:
    Using Jazz Team Server with a Derby database supports up to 10 users. To support more than 10 users, use a DB2(R) Express, DB2 or Oracle database. DB2 Express is included with the Standard and Express edition installation packages when you use the IBM Installation Manager. If you use the .zip file installation method, the DB2 Express download is available on the same site as the Rational(R) Team Concert download. After DB2 Express is installed, you must install and configure it as described in the installation setup guide.
Note:
An optional planning worksheet is available within the online help to help you choose your configuration and record your decisions.

Preparing to install the Standard edition

Before installing the server verify the special considerations are met.

Special instructions for Linux

Review the following special instructions when the Jazz Team Server is installed on Linux.

  • 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 Redhat 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
  • If you are installing software on a 64-bit system, some JVMs require the 32-bit X11 libraries. The 32-bit libraries can coexist with the 64-bit libraries.
  • The Reports component requires that 32-bit X11 libraries be installed on the server. On Redhat Enterprise Linux, the required packages are xorg-x11-deprecated-libs, xorg-x11-libs, and xorg-x11-Mesa-libGL.

Installing the Standard edition from the .zip file

After obtaining the installation files, extract the contents.

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

Note:
When using the compressed archive files to complete installation, record the directory in which you extract the files. The directory is referred to as JazzInstallDir.
  1. Download the .zip file for Rational Team Concert Standard edition server to your computer.
  2. Extract the contents of the package to your file system.
  3. Optional: Install DB2 Express.
    Note:
    While a Derby database is included in the default configuration and requires no installation, this database has a 10 user limit. You should install DB2 Express if you have a need to support more than 10 users and do not have access to an existing DB2 or Oracle database.

    If you install DB2 Express, record the user ID, password and port number. This information is needed later. Accepting the defaults during the installation simplifies the Jazz Team Server configuration.

Setting up the database

After your database is installed, configuration work is required.

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

The overview steps for setting up a database are:

  1. Create a database.
  2. Configure the properties files.
  3. Create the database tables.

If you are using DB2 or DB2 Express, proceed to Setting up a DB2 database.

If you are using Oracle, proceed to Setting up an Oracle database.

Setting up a DB2 database

Set up a DB2 or DB2 Express database to work with the Jazz Team Server.

This procedure assumes the following prerequisites have been met. Consult your DB2 documentation or a DB2 database administrator (DBA) for help.

  • 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 these instructions has system admin authority on the DB2 database.

To set up a DB2 database:

  1. Create the database in the DB2 Command Window. The example commands create a new database called JAZZ. These commands run in the DB2 Command Window. The Command Window can be opened from the application Start menu under the DB2 Command Line Tools menu.
    • On Windows:
      db2 create database JAZZ on c: using codeset UTF-8 territory en
    • On Linux:
      db2 create database JAZZ using codeset UTF-8 territory en
    Note:
    To ensure proper handling of Unicode content, the database character set must be UTF-8 encoding.
    Tip:
    If the database is not running, the command db2start starts DB2.
  2. Locate the file teamserver.properties in the directory JazzInstallDir/server and rename it to teamserver.derby.properties.
  3. Locate the file teamserver.db2.properties in the directory JazzInstallDir/server and rename it to teamserver.properties.
  4. Specify the database and connection details in the file teamserver.properties.

    The default connection specification connects to a DB2 database that runs on localhost on port 50000. The database is called JAZZ, and both the user name and password are db2admin. If the default values were used when setting up your database, the teamserver.properties file might already be configured correctly. If not, change this information to match your configuration.

    1. Open the file teamserver.properties in a text editor.
    2. Locate the following lines:
      com.ibm.team.repository.db.vendor = DB2
      com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:fullyMaterializeLobData=false;user=db2admin;password={password};
      com.ibm.team.repository.db.jdbc.password=db2admin
    3. Edit the value of com.ibm.team.repository.db.jdbc.location for your DB2 server and database.
      Tip:
      In the DB2 Command Window, run the command db2 get dbm cfg and find the line with SVCENAME, which indicates the DB2 port name or number. If you need help, ask your database administrator or consult the database documentation.
    4. Edit the value of com.ibm.team.repository.db.jdbc.location for your DB2 user name.

      It is important that the user has authority to create tables, tablespaces, and modify the database configuration.

    5. Specify the user password in the property com.ibm.team.repository.db.jdbc.password.
      Note:
      Do not change the password={password} text in the com.ibm.team.repository.db.jdbc.location property.
    6. If necessary, change the property com.ibm.team.repository.db.db2.content.tablespace.location to a path on your Jazz Team Server where the main tablespace can be created.
      Note:
      If this value is not changed from the default of content_tablespace, the tablespace is created under the database storage location. On Windows, if a new path is specified, it must be specified by using double backslashes, for example: com.ibm.team.repository.db.db2.content.tablespace.location=c:\\db2\\jazz\\content_tablespace.

You are finished setting up your database. Continue with Creating the Jazz Team Server database tables.

Setting up an Oracle database

Set up an Oracle database to work with the Jazz Team Server.

This assumes the following prerequisites have been met. Consult your Oracle documentation or an Oracle database administrator (DBA) for help.

  • 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.
    Note:
    When you install Oracle, you have the option to create a database automatically.
    Note:
    To ensure proper handling of Unicode content, the database character set must be UTF-8 encoding.
  • The user who performs these instructions has system administration authority on the Oracle database.

When running Jazz Team Server on Oracle, create an Oracle tablespace to improve performance. You must create a user linked to that tablespace.

Note:
Neither of these steps are performed by the database builder with the repository tools.

To set up an Oracle database:

  1. Create a tablespace. The tablespace location must be appropriate to the machine and disk drive.
    Note:
    The tablespace can have any of these properties:
    • A name other than oracle_tbs
    • A location in another directory
    • A size larger than 1GB. For large installations, you need to allocate more space.
    The example below shows a create statement executed on a Windows machine:
    CREATE BIGFILE TABLESPACE oracle_tbs DATAFILE 'D:\oracle_tbs\oracle_tbs.dbf' SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE
    Note:
    The directory path (in this example D:\oracle_tbs) must exist. It is not necessary to create a separate special tablespace. You can use the Oracle default USERS tablespace, but Oracle performs better with a pre-allocated space on the disk that it manages.
  2. Create an Oracle user.

    After the tablespace is created, a special Oracle user must be created for Jazz to use the Oracle database.

    In this example, the user has the name jazzDBuser and password (IDENTIFIED BY in Oracle terms) jazzDBpswd and exists in the tablespace created in 1.
    CREATE USER jazzDBuser IDENTIFIED BY jazzDBpswd DEFAULT TABLESPACE oracle_tbs
    After the user is created, grant the database system permissions necessary to perform these actions:
    • Create a session.
    • Create, alter, and drop tables and indexes.
    • Insert, update, and delete from the tables created.
  3. Locate the file teamserver.properties in the directory JazzInstallDir/server and rename it to teamserver.derby.properties.
  4. Locate the file teamserver.oracle.properties in the directory JazzInstallDir/server and rename it to teamserver.properties.
  5. Configure the server
    1. Open the file teamserver.properties in a text editor. Locate the following lines; and change the location and password properties for your configuration:
      com.ibm.team.repository.db.vendor = ORACLE
      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/ORCL
      com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      Note:
      If you are using Oracle Express, change ORCL to XE.
      com.ibm.team.repository.db.vendor = ORACLE
      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/XE
      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/XE
      com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      Specify the user password in the property com.ibm.team.repository.db.jdbc.password.
      Note:
      Do not change the password={password} text in the property com.ibm.team.repository.db.jdbc.location.
    2. In the same directory as the server scripts (JazzInstallDir/server), create a directory named oracle.
    3. Locate the Oracle JDBC driver JAR file, named ojdbc14.jar. The location can vary depending on the Oracle product and operating system. Copy this file to the directory named oracle.
      Note:
      If you are using WebSphere(R) Application Server, configure a property named "ORACLE_JDBC"; then set it to the absolute file path (not URL) to the Oracle JDBC drivers. This task is described in the WebSphere Application Server setup instructions. Make a note of the file path for later use in these instructions.

You are finished setting up your database and can continue with Creating the Jazz Team Server database tables.

Creating the Jazz Team Server database tables

Create the database tables using the repository tools.

To create the database tables:

  1. Run the command repotools -createTables to create the database tables for a Jazz repository.

    The repotools file is located in JazzInstallDir/server.

    The command uses the configuration properties in teamserver.properties for the connection and size settings. By default, the command looks in the current directory. The parameter teamserver.properties can be used to reference a different properties file.

    • On Windows:
      repotools -createTables
    • On Linux:
      ./repotools.sh -createTables
    This command creates the tablespace and all the required tables and indexes for a Jazz Team Server repository.
  2. After the database tables are created, you must stop and restart the database to make sure all changes are in effect.
    Tip:
    Example commands that stop and start DB2 are db2stop and db2start. These commands are run at the DB2 Command Window. The Command Window can be opened from the application start menu under the DB2 Command Line Tools cascade menu.

You are finished setting up your database and can continue with Starting the server.

Starting the server

This topic describes the different options for running the server startup scripts.

If you plan to use the included Apache Tomcat application server, you are ready to start the Jazz Team Server.

If you plan to use the WebSphere Application Server, set up your server environment as described in Setting up a WebSphere Application Server.

Starting the Apache Tomcat server

You are now ready to start the Apache Tomcat server.

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. In a command window, set your current directory to JazzInstallDir/server. The server startup and shutdown scripts are located in this directory.

  • If you want to run the start and stop scripts from any other directory, you must change the profiles.ini file in JazzInstallDir/server/provision_profiles to use an absolute path.
  • Apache Tomcat is configured to use the ports 9080 and 9443 in file JazzInstallDir/server/tomcat/conf/server.xml. If necessary, change them as appropriate for your system. If necessary, also update the configuration settings of Jazz server Repository HTTP ports in the Advanced Properties configuration page of in the Jazz Admin Web UI.
  • The directory JazzInstallDir/server/tomcat/logs contains the server log files. If you have trouble starting the server, check the log files.

Starting the server on Windows

Run the startup file to start your server on Windows.

  1. To start the server, 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.
  2. To stop the server, run this command:
    server.shutdown.bat

Note:
The example above runs the start and stop scripts directly from the directory JazzInstallDir/server. If you installed Jazz Team Server using IBM(R) Installation Manager, you can also run the commands from the Jazz Team Server Windows start menu.

After the server is started, proceed to Running the setup wizard.

Starting the server on Linux

Run the startup file to start server on Linux.

  1. To start the server, as user root, run this command:
    ./server.startup
    If your user ID has administrator access, run this command:
    sudo ./server.startup

    A separate Apache Tomcat console window is not visible. You can check the server startup progress by viewing the log file at JazzInstallDir/server/tomcat/logs/catalina.out.

  2. To stop the server, as user root, run this command:
    ./server.shutdown
    If your user ID has administrator access, run this command:
    sudo ./server.shutdown

Note:
This example runs the start and stop scripts directly from the directory JazzInstallDir/server. 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.

After the server is started, proceed to Running the setup wizard.

Setting up a WebSphere Application Server

This topic describes how to setup the Jazz Team Server to work with WebSphere Application Server.

Before beginning these steps, you should 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.
  • Refer to your WebSphere documentation for security setup and turn off the case-insensitive property.
    Note:
    Although Websphere and many LDAP directories allow you to log in case-insensive, Jazz Team Server stores user records with user IDs in exact case as they are imported. When you log in to the Jazz Team Server, the user record is retrieved from the list of users and the case must match exactly.
  • Java 2 Security option should be turned off. If this option is turned on in WebSphere Application Server it will cause the Jazz Team Server .war to fail to start.
  • 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. Further instructions refer to this as the Jazz Team Server installation directory, or JazzInstallDir for short. From this directory, use:
    • The file JazzInstallDir/server/teamserver.properties.
    • The file JazzInstallDir/server/log4j.properties.
    • The file JazzInstallDir/server/tomcat/webapps/jazz.war.
    • The directory JazzInstallDir/server/provision_profiles.
    • The directory JazzInstallDir/server/update-site.
    • The default repository database in JazzInstallDir/repositoryDB.
    • The repository tools in JazzInstallDir/repotools.
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 on Windows or /opt/IBM/JazzTeamServer on Linux. 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.

Note:
This document does not teach the configuration of WebSphere authentication or SSL, which is a complex topic. Detailed information about the various authentication and encryption options for WebSphere is covered in the WebSphere Information Center. For more information, go to the WebSphere Information Center and search for Securing applications and their environment. The Jazz Web UI requires that authentication be configured in order to perform authorization and personalize the application.
  1. Modify the profile.ini and license-profile.ini files:

    Edit each of profiles in JazzInstallDir/server/provision_profiles/ and set an absolute path for the URL property.

    For example,

    • Change this line:
      url=file:./update-site
    • To something like this:
      url=file:/opt/IBM/JazzTeamServer/server/update-site
    Note:
    The directory JazzInstallDir/server/provision_profiles/ must only contain the .ini files included and must not contain any backup files. Some editors automatically save a backup file which must be removed.
  2. Review and update the database location in the teamserver.properties file
    com.ibm.team.repository.db.vendor = DB2
    com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:fullyMaterializeLobData=false;user=db2admin;password={password};
    com.ibm.team.repository.db.jdbc.password=db2admin
  3. Verify or update the WebSphere Application Server level.

    Jazz Team Server requires WebSphere Application Server Version 6.1 with the IBM Java SDK 1.5 SR5 or later Cumulative Fix applied. The IBM Java SDK 1.5 SR6 SDK update is available from http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492. With WebSphere 6.1 and the GA IBM Java SDK, Jazz starts to report "proxy errors" after some number of operations.

  4. Update the JVM arguments.

    The Jazz Team Server needs some specific settings on the Java Virtual Machine in which it is run.

    First, it needs to know where to find the configuration files for the server and for log4j, the logging framework used by the server. This is done by setting the system properties com.ibm.team.server.configURL and log4j.configuration. These properties use a URL rather than a simple path, so the value should be specified as a file://-style URL.

    The second property which is required for the Jazz JVM is to provide it with more than the default maximum memory allocation, using the -Xmx setting. This should be set based on the size of the team supported by the server and the memory capacity of the server where Jazz Team Server is running. A typical medium-size team can use a value of -Xmx1000M, providing 1000 MB of heap memory for the Jazz Team Server process.

    If you are connecting to an Oracle database then you need to add a property named "ORACLE_JDBC". Set the property to the absolute file path (not a URL) to the Oracle jdbc drivers.

    There are a couple other system properties which need to be set to control some behavior of the server, they are included below. Here are the specifics of setting these JVM properties in the WebSphere Administrative Console, substitute JazzInstallDir with your Jazz Team Server installation directory:

    1. Click on Servers -> Application Servers.
    2. Click on server1.
    3. Click on Java and Process Management -> Process Definition.
    4. Click on Java Virtual Machine.
    5. Add the value 1000 to the Maximum Heap Size.
    6. Click Apply.
    7. Click Custom Properties
    8. Add the following properties: Click New; enter the Name and Value; then click OK.
      • Name: com.ibm.team.repository.provision.profile Value: file:///JazzInstallDir/server/provision_profiles (as file URL)
        Note:
        The property com.ibm.team.repository.provision.profile needs to point to the directory containing the provision_profiles.
      • Name: com.ibm.team.server.configURL Value: file:///JazzInstallDir/server/teamserver.properties (as file URL)
      • Name: log4j.configuration Value: file:///JazzInstallDir/server/log4j.properties (as file URL)
      • Name: java.awt.headless Value: true
      • Name: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Value: true
    9. Click Save directly to the master configuration.
  5. Restart Websphere to install the Jazz Application

    In the following command line examples, WASInstallDir represents the location where WebSphere Application Server is installed on your server.

    • On Windows, the default value for WebSphere installation directory is:
      C:\Program Files\IBM\WebSphere\AppServer

      You can restart the server with the following commands on Windows:

      cd WASInstallDir\bin 
      stopServer.bat server1 [for a secure server, include: -username {LDAP_User} -password {LDAP_Password}] 
      startServer.bat server1
    • On Linux, the default value for WebShpere installation directory is:
      /opt/IBM/WebSphere/AppServer

      You can restart the server with the following commands on Linux:

      cd WASInstallDir/bin 
      ./stopServer.sh server1 [for a secure server, include: -username {LDAP_User} -password {LDAP_Password}] 
      ./startServer.sh server1
    1. Open the Admin console for your WebSphere Application Server.
    2. Click on Applications -> Install New Application.
    3. Under Path to new Application, click Local file system.
    4. Under Full path enter:
      JazzInstallDir/server/jazz.war
    5. Set Context Root to /jazz.
    6. Click Next and continue through the remaining Install New Application steps.
    7. Click Finish.
    8. Click Save directly to the master configuration.
    9. Click on Applications -> Enterprise Applications.
    10. Select the box next to jazz_war; click Start.

      A green arrow should appear indicating the application started successfully.

After the server is started, proceed to Running the setup wizard.

Running the setup wizard

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

To verify that the Jazz Team Server is connecting to the database, look at the server log or console output. The connection and database information is echoed on its first access. The directory JazzInstallDir/server/tomcat/logs is used for the server log files.

This procedure assumes your server is available using the hostname localhost and the default ports 9443. If necessary, replace localhost with your server hostname and replace the port 9443.

Start the setup wizard to configure your server. Use the URL https://localhost:9443/jazz/setup.

The default user name and password are case-sensitive:

  • The user name is ADMIN.
  • The password is ADMIN.

If you configured the LDAP directory Web container, log in with a JazzAdmin user that is defined in your LDAP directory.

Choose a setup path. The setup wizard has two main paths.

  • The Fast Path Setup uses the default configuration. If you want to get the server running quickly, the fast path setup is a good option. During the Fast Path Setup, setup
    • the user registry.
  • The Custom Setup configures guides you through the detailed server configuration including the ability to enable e-mail notifications. During the Custom Setup, setup
    • the database,
    • e-mail notification, and
    • the user registry.

When the initial setup is complete, additional options can be configured from the Jazz Team Server Admin Web user interface by using the URL https://localhost:9443/jazz/admin.

If the server setup wizard does not load, check the following items:

  • Verify that the application server has started. Use the URL http://localhost:9080.
  • Verify the Jazz Team Server has started by logging in to the Jazz Team Server Admin Web UI using the URL https://localhost:9443/jazz/admin. If the page does not load or the server has errors, the server did not start correctly. See the troubleshooting information at Troubleshooting server issues.
  • The URI root for the Jazz Team Server path must be /jazz. For example https://example.com:9443/jazz must be used rather than https://example.com:9443.

Completing the installation

After the server is installed, you must consider some configuration options before continuing.

After the installation, there are a few additional actions to take.

  • Some files contain passwords. Those files should be protected so that they are readable only by users authorized to know the password for the accounts.
    • teamserver.properties - The Jazz Team Server requires that the database password is stored in JazzInstallDir/server/teamserver.properties.

      When properties files are saved, the application always makes a backup copy of the previous version in the same directory. If you want to remove all files that contain the clear-text password, remove the backup properties files after configuring the server for the first time.

    • The ClearCase Connector sync engine requires that user passwords be stored in an properties file.
    • cqconnector.properties - The ClearQuest Connectorrequires that both ClearQuest user IDs and passwords be stored in a properties file.
  • When connecting to the server with the Rational Team Concert client or a Web browser, you might see security certificate warnings. To disable the warning, see Configuring security certificate settings.
  • If you configured the application server to use ports other than the defaults, these ports should also be configured in the Jazz configuration. These port numbers are used for composing URLs for things like feed links and item links in email notifications. To update the defaults, use the advanced properties configuration page of the Admin Web UI to modify the following properties:
    • com.ibm.team.repository.servlet.internal.ServletConfigurationService
      • Repository HTTP port
      • Repository HTTPS port
    • com.ibm.team.repository.service.internal.webuiInitializer.ConfigPropertyInitializer
      • URL HTTP Port
      • URL HTTPS Port
  • You are now ready to connect to the server with the Rational Team Concert client or a Web browser.

Installing the client using a .zip file

The client is distributed as a downloadable .zip file.

Note:
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.
  1. Download the client package file.

    You should download the Rational Team Concert client .zip file.

    Note:
    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
  2. Install the client distribution. Extract the .zip file to an installation directory of your choice (for example, /opt/IBM/ on Linux or c:\IBM on Windows,). Relative to the installation directory you choose, the client path is JazzInstallDir/client.
  3. Start the client. Double click on the TeamConcert.exe application in the directory JazzInstallDir/client/eclipse .
  4. Connect to the server The easiest way to connect to a server is using the Team Invitation. If you do not have an invitation you can connect manually.
    1. From the Welcome Screen click on Accept an invitation to join a Jazz team area. The wizard guides you through the process.
      Note:
      If you do not have an invitation you need the URI from your server admin. (an example format is: https://example.com:9443/jazz). Click on the connecting to an existing project area hyperlink that appears in the bottom right corner of the Accept Team Invitation window.
    2. Follow the instructions in the wizard to set up your connection.

Trouble Shooting: Here are some suggested problem management techniques.

  • Start with an empty workspace.
  • The client and the server builds must match. Make sure the build ID's match for both the client and server distributions.
  • Make sure the server is up. Confirm using the status URL: https://example.com:9443/jazz.
  • On Linux, if you want to start the client from outside of the directory JazzInstallDir/client/eclipse you must change each file in JazzInstallDir/client/eclipse/links/ and include the absolute path to the named directory. By default, relative paths are used. For example, JazzInstallDir/client/eclipse/links/build.link contains the text "path=jazz/build". If your client is installed in the directory /home/username/teamconcert, edit the file to look like "path=/home/username/teamconcert/jazz/client/eclipse/build".

After you have successfully installed the client, you should refer to the following topics to help you get started with Rational Team Concert.

Installing the Build System Toolkit from a .zip file

The Build System Toolkit can be installed on the build machines using a .zip file download.

  1. Download the Build System Toolkit .zip file.
  2. Extract the .zip file into the JazzInstallDir directory.
  3. After the installation is complete a build should be configured. More information about the Build System Toolkit can be found in About Jazz team build.

Installing Rational Team Concert ClearCase Connector from a .zip file

The ClearCase Connector can be installed on the build machines using a .zip file download.

  1. Download the ClearCase Connector .zip file.
  2. Extract the .zip file into the JazzInstallDir directory.
  3. After the installation is complete configure the ClearCase Connector. See Deploying ClearCase Connector.

Installing Rational Team Concert ClearQuest Connector from a .zip file

The ClearQuest Connector can be installed on the build machines using a .zip file download.

  1. Download the ClearQuest Connector .zip file.
  2. Extract the .zip file into the JazzInstallDir directory.
  3. After the installation is complete configure the ClearQuest Connector. See Deploying ClearQuest Connector.

Installing Rational Team Concert with Security-Enhanced Linux

If Security-Enhanced Linux (SELinux) is enabled, you must either disable it or change the security context of the Java Runtime Environments (JREs) used for installing and running Rational Team Concert to allow text relocation.

If you have setup a machine for the sole purpose of evaluating Rational Team Concert and the SELinux features are not important to you, then the easiest way to proceed is to disable SELinux.

Note:
  • SELinux is installed and enabled by default on Red Hat Enterprise Linux 5.
  • SELinux is not installed on Suse Linux Enterprise Server 10 or Suse Linux Enterprise Desktop 10.
  • To disable SELinux do one of the following:
    1. From the windowing system:
      1. Select System -> Administration -> Security Level and Firewall.
      2. Switch to the SELinux tab.
      3. Change the SELinux setting to Disabled.
      4. Click OK to save the new setting.
    2. From the command line:
      1. Run the "setup" command (this is /usr/bin/setup)
      2. Select Firewall Configuration and press Enter
      3. Use the Tab and arrow keys to change the SELinux to Disabled
      4. Select OK and press Enter
  • To change the security context of the JREs:
    1. If you are installing directly from DVD media; skip to step 2. Otherwise, change the security context of the installation JRE.
      1. In the installation files directory, locate the directory jre. linux/jre_5.0.2.sr5_20070511/jre. If you extracted the installation files to /tmp/rtc then the directory jre is located at /tmp/rtc/linux/jre_5.0.2.sr5_20070511/jre.
      2. Run the command chcon -R -t textrel_shlib_t against the jre directory. This command recursively processes the files and allows text relocation. For example, if you extracted the installation files to /tmp/rtc run the following command:
      chcon -R -t textrel_shlib_t /tmp/rtc/linux/jre_5.0.2.sr5_20070511/jre 
    2. Install the Rational Team Concert server, client and connectors, but do not start them.
    3. Before you start Rational Team Concert, you must change the security context of the product JREs. For each product you install, run the same command (chcon -R -t textrel_shlib_t) with the appropriate product-specific JRE directory. The default directories are listed below.
      Note:
      The paths are the default if you installed the product as user root. If you installed as a non-root user, look for these directories inside an opt/IBM structure in the installation user's home directory.
      • IBM Installation Manager:
        • /opt/IBM/InstallationManager/eclipse/jre_5.0.2.sr5_20070511/jre
      • Jazz Team Server:
        • /opt/IBM/JazzTeamServer/server/linux/ibm-java2-i386-50/jre
      • Rational Team Concert - Client: (run chcon on all 4 directories)
        • /opt/IBM/TeamConcert/jdk/bin
        • /opt/IBM/TeamConcert/jdk/lib
        • /opt/IBM/TeamConcert/jdk/jre/bin
        • /opt/IBM/TeamConcert/jdk/jre/lib
      • Rational Team Concert - Build System Toolkit:
        • not applicable (no JRE included)
      • Rational Team Concert - ClearCase Connector: (run chcon on all 4 directories)
        • /opt/IBM/ClearCaseConnector/jdk/bin
        • /opt/IBM/ClearCaseConnector/jdk/lib
        • /opt/IBM/ClearCaseConnector/jdk/jre/bin
        • /opt/IBM/ClearCaseConnector/jdk/jre/lib
      • Rational Team Concert - ClearQuest Connector:
        • /opt/IBM/ClearQuestConnector/gateway/linux/ibm-java2-i386-50/jre

Feedback

Did this help? You can provide feedback at Jazz.net (registration required): Comment in the forums or submit a bug