Installing Rational Team Concert client using IBM Installation Manager

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 the client using the IBM Installation Manager

Installing Rational Team Concert with Security-Enhanced Linux

Installing the client using the IBM Installation Manager

The client is distributed as a downloadable file via the IBM^(R) Installation Manager.

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

Note:

If Security-Enhanced Linux^(R) (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.

Download one of the following installation packages.
There are three methods to install theRational^(R) Team Concert client.
- Client CD Contents .zip file - Installation Manager local install for client: This archive file contains the Installation Manager launchpad program and a local copy of the Rational Team Concert client. The benefit of using the local install package is that it allows the installation to proceed without an Internet connection. This is a .zip file that is not self extracting.
- 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 will start the IBM Installation Manager launchpad program after extracting the contents. The benefit of using the Web install package is that it reduces the initial download and the installation process only downloads the resources you choose to install.
  Note:
  
  The Web install requires an Internet connection during the installation process.
- Full DVD Contents .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 a .zip file that is not self extracting.
Start the launchpad program.
If the Installation Manager is not already running, complete the following steps to start it.

Note:

You must have administrator privileges to run the launchpad program.
To start the launchpad program file on:
- If you are using the Client CD Contents .zip file, extract the contents of the archive into a temporary directory and run the launchpad program. To start the launchpad program file on:
  - To run the file on Windows, run this command:
```
launchpad.exe
```
  - To run the file on Linux, run this command:
```
sh launchpad.sh
```
- If you are using the Installation Manager Web install, run the executable file. The files are extracted to a directory and a launchpad program appears. To start the executable file on:
  - To run the file on Windows, run this command:
```
RTC-edition-Full-version-Win-Web.exe
```
  - To run the file on Linux, run this command:
```
sh RTC-edition-Full-version-Linux-Web.sh
```
- If you are using the Full DVD Contents .zip file, extract the contents of the archive into a temporary directory and run the launchpad program. To start the launchpad program file on:
  - To run the file on Windows, run this command:
```
launchpad.exe
```
  - To run the file on Linux, run this command:
```
sh launchpad.sh
```
Click the Rational Team Concert client link to start the client installation.
Start the client. Start the client by clicking the Rational Team Concert shortcut created by the installation.
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^(TM) 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 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^(TM) 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^(R) 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^(R) 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

Installing Rational Team Concert client using IBM Installation Manager

Contents

Installing the client using the IBM Installation Manager

Installing Rational Team Concert with Security-Enhanced Linux