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.
If you use the korn shell (ksh), you must install it separately from the Red Hat CD before you install Rational ClearCase LT.
Instructions for confirming whether the required software packages are installed on your system depend on what version of Linux you are running.
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.
Check that the required packages exist by doing the following:
#rpm -q -f /lib/modules/`uname -r`/build/Makefile
The required package has a name of the form kernel-devel-*, or a similar name.
#rpm -q -f /lib/modules/`uname -r`/build/Module.symvers
The required package has a name of the form kernel-devel-*, or a similar name.
If the required packages are not installed, you will need to install them from your Linux release media before installing Rational ClearCase. Contact your System Administrator for assistance.
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.
Check that the required packages exist by doing the following:
#rpm -q -f /lib/modules/`uname -r`/build/Makefile
The required package has a name of the form kernel-source-*.
#rpm -q -f /lib/modules/`uname -r`/build/Module.symvers
The required package has a name of the form kernel-syms-*.
If the required packages are not installed, you will need to install them from your Linux release media before installing Rational ClearCase. Contact your System Administrator for assistance.
After you have verified that the required packages are installed, you can proceed with the Rational ClearCase installation. Refer to Installing Rational ClearCase.
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
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]
If the precompiled modules do not load, follow one of the following two sets of steps:
cd /var/adm/rational/clearcase/mvfs/mvfs_src
make clean
make
You will be prompted for the path to the Linux kernel source directory. The default prompt is /lib/modules/`uname -r`/build.
make install
/opt/rational/clearcase/etc/clearcase stop /opt/rational/clearcase/etc/clearcase start
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/.