Installing Rational ClearCase on Linux

The Multi-version File System (MVFS) in Rational ClearCase on Linux(TM) has been implemented with a loadable kernel module. In order to accommodate the specific kernel running on your host, it may be necessary to rebuild the MVFS during Rational ClearCase installation. Rebuilding the MVFS requires access to kernel include files matching your running kernel.

If you are using a standard kernel from your Linux distribution, you may need to install software packages that provide the required kernel include files. These packages include a symbolic link of the form /lib/modules/`uname -r`/build that points to the proper kernel files. Proceed to Confirm that the required software packages are installed.

If you have built your kernel from a custom configuration file, then you can install the kernel using standard tools. These standard tools will create the required symbolic link. Proceed to Installing Rational ClearCase.

Note:
All procedures in this chapter require you to log in to your Linux system with superuser privileges.

Before you install

korn shell requirements

If you use the korn shell (ksh), you must install it separately from the Red Hat CD before you install Rational ClearCase LT.

Confirm that the required software packages are installed

Instructions for confirming whether the required software packages are installed on your system depend on what version of Linux you are running.

Confirming package installation on Red Hat Enterprise Linux 3

Check that the required package exists by running the command:

#rpm -q -f /lib/modules/`uname -r`/build/Makefile

The required package has a name of the form kernel-source-*. If the required package is not installed, you will need to install it from your Linux release media before installing Rational ClearCase. Contact your System Administrator for assistance.

Confirming package installation on Red Hat Enterprise Linux 4

Check that the required packages exist by doing the following:

Confirming package installation on SuSE Linux Enterprise Server 8 for IBM zSeries hosts

Check that the required package exists by running the command:

#rpm -q -f /lib/modules/`uname -r`/build/Makefile

The required package has a name of the form kernel-source-*. If the required package is not installed, you will need to install it from your Linux release media before installing Rational ClearCase. Contact your System Administrator for assistance.

Confirming package installation on SuSE Linux Enterprise Server 9

Check that the required packages exist by doing the following:

Note:
On all versions of Linux, there may be slight variations in the name of the required packages, depending on your particular kernel variant. You may see these substrings in the package names:

After you have verified that the required packages are installed, you can proceed with the Rational ClearCase installation. Refer to Installing Rational ClearCase.

Linux x86 - SUSE (SLES) 9 with bigsmp kernel

When installing Rational ClearCase on Linux x86 SUSE (SLES) 9 with bigsmp kernel, you must set the LD_ASSUME_KERNEL environment variable to 2.4.19 on the same command line you run ./install_release. For example:

env LD_ASSUME_KERNEL=2.4.19 ./install_release

All supported Linux platforms

If you have installed the Rational ClearCase Server or the Rational ClearCase Web Application component, you must set the LD_ASSUME_KERNEL environment variable to 2.4.19 before running any of the processes available from these components. For instance, the rwp_restart or cqserver_restart processes.

To set the LD_ASSUME_KERNEL:

In the Bourne-shell (sh)

export LD_ASSUME_KERNEL=2.4.19

In the C-shell (csh)

setenv LD_ASSUME_KERNEL 2.4.19

To run the Rational ClearCase Server and the Rational ClearCase Web Application components, you must set the following additional environment variables:

In the Bourne-shell (sh)

export LD_LIBRARY_PATH=/opt/rational/clearquest/linux_x86/shlib
export TZ=[local_time_zone]

In the C-shell (csh)

setenv LD_LIBRARY_PATH=/opt/rational/clearquest/linux_x86/shlib
setenv TZ=[local_time_zone]
Note:
You cannot install Rational ClearCase in the same environment shell after you have set the LD_ASSUME_KERNEL environment variable.

Installing Rational ClearCase

After the installation process has completed, test that Rational ClearCase has been properly installed by running the cleartool -version command. You should see output indicating the version of MVFS that has been installed, as in the following example.

# /opt/rational/clearcase/bin/cleartool -version 
ClearCase version 7.0.0 (Thu Sep 15 12:57:19 EDT 2005)
@(#) MVFS version 7.0.0.0 (Thu Sep 15 08:17:03 2005) 
built at $Date: 2005-09-15.12:56:01 (UTC) $
cleartool         7.0.0.0 (Thu Sep 15 08:42:46 EDT 2005)
db_server         7.0.0.0 (Thu Sep 15 08:39:34 EDT 2005)
VOB database schema version: 54

If Rational ClearCase has not been successfully installed, refer to the README.txt file for help. The README.txt file is located on your Rational ClearCase host, in the directory /var/adm/rational/clearcase/mvfs/mvfs_src/.