Installing Rational Team Concert client using IBM Installation Manager
Installing the client using the IBM Installation
Manager
The client is distributed as a downloadable file via the IBM® Installation
Manager.
About this task
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® (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® Team
Concert client.
- 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.
Note:
The Linux commands to start the launchpad program
are only for the Rational Team
Concert for
Eclipse IDE.
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:
- 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
- You can install the following clients:
- To install Rational Team
Concert client
for Eclipse, click Rational Team
Concert Client
for Eclipse IDE link.
- To install Rational Team
Concert client
for Microsoft Visual Studio, click Rational Team Concert Client for Microsoft® Visual Studio IDE link.
The Installation Manager wizard is displayed.
The wizard guides you through to install 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.
- Click File -> Accept
team invitation. The wizard guides you through
the process.
Note:
If you do not have an invitation you
need the URI or URL 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.
- Follow the instructions in the wizard to set up your
connection.
Example
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".
What to do next
After
you have successfully installed the client, you should refer to the
following topics to help you get started with Rational Team
Concert.
Upgrading to Rational Team
Concert 1.0.1
or 1.0.1.1
You can upgrade Rational Team
Concert clients
and servers by either performing a zip or Installation Manager install.
Note:
If you use the Installation Manager to install Rational Team
Concert 1.0.1.1 on a computer
where Rational Team
Concert is
not currently installed, the Installation Manager prompts you to select
the languages to install. However if you update from an earlier version
to 1.0.1.1, the Installation Manager assumes that you want to use
the current languages and does not prompt you to select languages.
Pre-1.0.1.1 versions are available in English only. To select the
additional languages, after you update to 1.0.1.1, select Modify from
the main screen in the Installation Manager, then select the offering.
The next screen shows the list of supported languages. Select the
ones you need.
Upgrading 1.0 Rational Team
Concert Eclipse
Clients
If you have 1.0 clients, we recommend that you obtain
the 1.0.1 or 1.0.1.1 client to connect to your new 1.0.1 or 1.0.1.1
server. You can install these using a zip file, or you can update
your prior Installation Manager installs.
Upgrading a Server from a Trial or Early Access release
to a Permanent release
If you are running an Early Access
release of Rational Team
Concert,
first upgrade to the 1.0 Trial release, or directly to the purchased
1.0.1 Server product. The 1.0 server keys do not make an Early Access
server Permanent.
From the 1.0 Trial release, you can make
your server Permanent by purchasing and installing the Server Activation
Kit for your edition which is available here: http://www-306.ibm.com/software/awdtools/rtc/.
The activation kit consists of a JAR file containing the Permanent
server key. It is installed using the License Key Management page
of your server's administrative Web interface.
Upgrading a Server from 1.0
You can upgrade
directly to the 1.0.1 or 1.0.1.1 release of Rational Team
Concert from
the 1.0 release. You can re-use your 1.0 database; there is no database
migration required.
Note:
Before you begin upgrading a Websphere
Application Server, reset the server by navigating to https://servername:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset and
clicking Request Server Reset.
If
you are running an earlier milestone or Beta, follow the upgrade instructions
for 1.0 https://jazz.net/downloads/rational-team-concert/releases/. First, perform any necessary database migration.
If
you installed the 1.0 release from a zip file, then there is no intersection
with the previous install. You can install the 1.0.1 or 1.0.1.1 release
from a zip in a new location, or you can use the Installation Manager
to install an instance of 1.0.1 or 1.0.1.1.
If you used Installation
Manager to install the 1.0 release, you can either install 1.0.1 or
1.0.1.1 as a separate instance or update the 1.0 instance to 1.0.1
or 1.0.1.1. If you install a separate instance of the server for the
1.0.1 or 1.0.1.1 release, select Create a new package group on
the Install Packages page of the installation
wizard.
Note:
To upgrade a Websphere Application Server, remove
the 1.0 jazz.war file and deploy the 1.0.1 jazz.war file.
To
complete the upgrade, see Copying the required configuration
files from a previous server installation and Installing 1.0.1 Activation
Keys.
Upgrading a Server from One Rational Team
Concert Edition
to Another
You can upgrade between Rational Team
Concert editions.
Typical upgrades include moving from Express-C to Express™,
or Express to Standard. You can also downgrade in the opposite direction
by following the same process.
Because all Rational Team
Concert 1.0.1
and 1.0.1.1 editions support Derby databases, you do not need to migrate
from Derby to DB2® or Oracle if you are moving from Express-C
to Express or Standard. We recommend that you migrate your server
edition first, make sure things work smoothly with the existing database,
and then perform a database migration if required. For information
on performing a database migration, see Migrating the Jazz™ Team
Server.
If you have installed a Rational Team
Concert 1.0.1
or 1.0.1.1 edition and want to upgrade to another, download and install
the new edition, alongside the existing edition, and then copy the
required configuration files to run the new edition. The section below
describes the configuration files that you require.
If you
installed your previous edition from a zip file, then there is no
intersection with the previous install. You can install the new edition
from a zip in a new location, or you can use the Installation Manager
install for the new edition. We recommend that the Installation Manager
be used for production servers to enable future updates to be applied.
If
you used Installation Manager to perform your previous server install,
and want to use Installation Manager to install your new edition,
during the new Installation Manager install, do not to overlay the
previous edition. On the Install Packages page
of the installation wizard, select Create a new package
group.
This will install the new edition in a different
location and create program shortcuts using the new package group
name.
If you do not perform this task, the installation will
fail with a file collision. This occurs if you see an error dialog
titled Installation Failed, and the details
show the following text:
Installation failed.
Error during "install" phase:
Failed to extract zip standard 1.0.1.I20081018-1820. File
D:\JazzTeamServer\server\license-update-site\site.xml already exists.
If this occurs, it is not fatal; you can restart
the installation and correctly create a new package group.
Copying the required configuration
files from a previous server installation
Copy the following
files from the source server to the target server. First, rename the
original files in the upgraded server install to create backups. If
you used the Installation Manager to update from 1.0 to 1.0.1, a backup
directory containing your 1.0 configuration files was created with
a name, such as backup-config-timestamp in
the server subdirectory of the installation location.
- workitemindex (directory)
- If you are using Derby, copy the repositoryDB directory
tree.
- If you are using Tomcat and have changed the configuration, copy
over the tomcat/conf directory.
- If you are using the Tomcat user database, copy over tomcat-users.xml.
- If you are using Tomcat and you have customized the application
deployment descriptor, copy the modified web.xml file
for jazz.war, located in \JazzTeamServer\server\tomcat\webapps\jazz\WEB-INF.
If you are upgrading to Standard edition, and you have purchased
the Developer Client Activation Kit for Express, purchase and install
the Developer Client Activation Kit for Standard Edition, so that
you can use those client licenses. Your Developer license assignments
will still be in effect, but the Developer licenses will be deactivated
until the correct activation kit is installed.
Installing 1.0.1 Activation
Keys
If you had installed the permanent Server Activation
Key and Client Activation License Keys onto the 1.0 server installation,
obtain and install the 1.0.1 versions of these keys. The server reverts
to a trial license after the upgrade to 1.0.1. Obtain the 1.0.1 activation
keys from Passport Advantage®. Below are
the names of the applicable keys for each server edition:
Express
edition keys:
- IBM Rational Team
Concert Express
Edition - Server License Activation Kit V1.0.1 Multiplatform
- IBM Rational Team
Concert Express
Edition - Developer Client License Activation Kit V1.0.1 Multiplatform
- IBM Rational Team
Concert -
Contributor Client License Activation Kit V1.0.1 Multiplatform
Standard edition keys:
- IBM Rational Team
Concert Standard
Edition - Server License Activation Kit V1.0.1 Multiplatform
- IBM Rational Team
Concert Standard
Edition - Developer Client License Activation Kit V1.0.1 Multiplatform
- IBM Rational Team
Concert -
Contributor Client License Activation Kit V1.0.1 Multiplatform
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.
About this task
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:
- From the windowing system:
- Select System -> Administration -> Security Level and Firewall.
- Switch to the SELinux tab.
- Change the SELinux setting to Disabled.
- Click OK to save the new setting.
- From the command line:
- Run the "setup" command (this is /usr/bin/setup)
- Select Firewall Configuration and press Enter
- Use the Tab and arrow keys to change the SELinux to
Disabled
- Select OK and press Enter
-
To change the security context of the JREs:
-
If you are installing directly from DVD media;
skip to step 2.
Otherwise, change the security context of the installation JRE.
- 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.
- 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
-
Install the Rational Team
Concert server, client and connectors, but do not start them.
- 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