YoLinux.com: IBM/Rational Clearcase Client 5.0 on Red Hat 8.0 Installation on Linux

IBM/Rational have discontinued support of Clearcase 5.0 (2002.05.00) on 09/30/2005. Clearcase 2002.05 clients are compatible with 2003.06 servers. See the current IBM/Rational Clearcase Client Installation on Linux Tutorial - Clearcase 6.0 on Red Hat Enterprise Linux 3 and 4

This tutorial is for software developers using IBM/Rational Clearcase for change management (CM) on Linux. Unlike many of the text file based CM systems like RCS and CVS, Clearcase used its Multi Version File System (MVFS) to hold various revisions of a file and control locking of files checked out to a developer.

This tutorial covers the installation and configuration of Cleacase as a client (5.0) on Linux (Red Hat 8.0) connecting to a Clearcase server. This tutorial covers the client installation only. IBM states that the Clearcase client is only supported on the Red Hat Linux distribution but the only thing limiting you to this distribution is the kernel version, files, directory structure and the version of gcc. The directory structure can be duplicated and the version of the kernel, C libraries and compiler can be matched to that used on Red Hat 8.0. See details below.

Also see:

Related YoLinux Tutorials:

°Clearcase Client installation

°Clearcase Commands

°C++ Info, links

°Software development tools

°C++ String Class

°C++ STL vector, list

°Emacs and C/C++

°YoLinux Tutorials Index




Free Information Technology Magazines and Document Downloads
TradePub link image


Prerequisites:

  • Requires RPM ncompress-4.2.4-33: rpm -ivh ncompress-4.2.4-33.i386.rpm
    This RPM contains the command uncompress required during installation.
  • Requires RPM compat-db-3.3.11-2: rpm -ivh compat-db-3.3.11-2.i386.rpm
    Without this RPM you will get the error that /lib/libdb.so.3 is missing.
  • Linux Kernel source is required: Check to see if kernel source is installed:
        # rpm -q kernel-source
    kernel-source-2.4.18-14
    While we build a new kernel we will not be installing a new kernel. This step is required for building a new kernel loadable module (mvfs.o) to replace the broken and unpatched one shipped with the Clearcase client.
  • Clearcase server to connect to. Note that it needs to be a Unix/Linux hosted Clearcase server. A Unix/Linux server can have Microsoft Windows clients as well as Unix and Linux clients. A Microsoft Windows server can not be used to host Unix or Linux clients.
    DO NOT USE MICROSOFT WINDOWS AS A CLEARCASE SERVER!!!


Download Clearcase Client 5.0 for Linux Red Hat 8.0:

  • Download client software: The versions are very specific. You will also have to be a licensed customer in order to perform the download.
    • http://www.rational.com
    • List of supported systems - platforms, OS and versions
    • Select "Software support" + "Upgrades" + "IBM Rational downloads and licensing center" (requires a login and password)
    • Download current full product versions: Select "V2002.05.00" + "Continue"
      [Client download page]
    • Download client software: C502JNA.tar.Z
      Select "Accept".
      Note: The download manager may ask for proxy settings, etc
  • Download Latest Patch:
    • http://www.rational.com
    • Select "Software support" + "Upgrades" + "IBM Rational downloads and licensing center" (requires a login and password)
    • Select: "Available Patches and service releases"
    • Enter in search box: "clearcase redhat" + Limit by type of support: "Downloadable files"
    • Download patch: clearcase p2002.05.00-28 for (Red Hat 8.0 kernel 2.4.18-14): rhat_x86.tar.gz

IBM/Rational use the following release numbers:

Clearcase Version Release number
6.0 2003.06
5.0 2002.05


Installation of IBM/Rational Cleacase Client on Linux Red Hat 8.0:

  • Prepare directory structure:
    • mkdir /lib/modules/fs
    • mkdir /opt/Clearcase
    • Files C502JNA.tar.Z and clearcase_p2002.05.00-28.rhat_x86.tar.gz are loaded to the install directory /opt/Clearcase and the installation is performed from here (or the directory of your choice).
  • Unpack basic client software:
    • uncompress C502JNA.tar.Z
    • tar -xf C502JNA.tar
      This creates directory ./v5.0
  • Unpack the patch:
    • gzip -d clearcase_p2002.05.00-28.rhat_x86.tar.gz
    • mkdir ./v5.0/rhat_x86/patches
    • mv clearcase_p2002.05.00-28.rhat_x86.tar ./v5.0/rhat_x86/patches
    • cd ./v5.0/rhat_x86/patches
    • tar xf clearcase_p2002.05.00-28.rhat_x86.tar
  • Install: as "root"
    • [root prompt]# cd clearcase_p2002.05.00-28/install
    • [root prompt]# ./apply_patch
    • [root prompt]# cd ../../../install
    • [root prompt]# ./site_prep
      Note readme offers variations of installation. i.e.: ./site_prep -chmod ; ./site_prep -setuid for installing with alternate admin uid. Still run ./site_prep as root.


Installation Log:

Site Preparation log:

[root prompt]# ./site_prep

Updating release area '/opt/Clearcase/v5.0/rhat_x86'

For any of the queries that follow, help is available
by entering 'help', 'h' or '?' at the prompt.


The host name of the ClearCase license host must match the host
name returned by the '/bin/uname -n' command on the license host and
it must be resolvable by the 'gethostbyname(3N)' function.

Site default ClearCase license host: [Unknown] node-name-of-license-server Site default ClearCase registry host: [Unknown] node-name-of-clearcase-server Site default ClearCase registry data backup host: [Unknown] Site default ClearCase registry region: [Unknown] unix - or whatever name you are using at your site.
Would you like to configure (enable for some host(s)) setuid operation [no]
Would you like ClearCase Remote Administration to be enabled on clients [no]

Information for the previous entries can be obtained from an existing installation with the following Clearcase command: ct hostinfo -l

The bold text indicates an entry. The rest were defaults chosen by the "Enter" key.

The "host", "license" and "region" are stored in the following configurations files:

  • Host: /var/adm/atria/rgy/rgy_hosts.conf
  • Region: /var/adm/atria/rgy/rgy_region.conf
  • License server: /var/adm/atria/config/license_host
The host and region are a single entry in their respective file. This file and the appropriate NFS mount points will be changed when connecting to a different VOB server.


Clearcase Client Installation log:

[root prompt]# ./install_release
This release area contains the following Atria product(s):

ClearCase
MultiSite
ClearCase ClearDDTS Integration
ClearCase ClearQuest Integration
ClearCase Web Interface Server
ClearCase Attache

A transcript of this installation will be initially written
to /tmp/Atria_install.031120.18:59.
After a successful installation, the transcript will be located
at /var/adm/atria/log/Atria_install.031120.18:59.


The following installation methods are available:

1. Local Install: Install occurs on the local host.
2. Remote Install: Install occurs on a single remote host.
3. Multiple Remote Installs: Install occurs on a set of remote hosts.
4. Local Deinstall: Deinstall occurs on the local host.

Type "Help" or "h" for expanded descriptions

Type "Quit" or "q" to exit the installation

Please select the installation method by number.


Method of installation>> 1 The following installation operations or models are available: 1. Standard: Regular installation, allowing links to this release area. 2. Full-copy: Regular installation, with no links to this release area. 3. Mounted: Host install via mounted or pre-populated /usr/atria or ATRIAHOME. 4. Link-only: Host install via a symbolic link to this release-area. 5. Deinstall: Deinstall software from the local installed host. Type "Help" or "h" for expanded descriptions Type "Quit" or "q" to exit Please select the installation type by number. Model of installation>> 2 Specify directory to be installed with ClearCase, MultiSite, ClearCase ClearDDTS Integration, ClearCase ClearQuest Integration, ClearCase Web Interface Server, ClearCase Attache [/usr/atria]: Pathname to the network-wide release directory (used as target of symbolic links) [/opt/Clearcase/v5.0/rhat_x86]: 1 : ClearQuest Integration with ClearCase 2 : ClearCase MultiSite Full Function Installation 3 : ClearCase Attache Helper 4 : ClearCase Server-only Installation 5 : ClearCase MultiSite Shipping Server-only Installation 6 : ClearCase Web Interface Server 7 : ClearCase Minimal Developer Installation 8 : ClearCase Full Function Installation 9 : ClearDDTS Integration with ClearCase a : Select all f : Finish selection x : Toggle expanded descriptions r : Reset selections q : Quit Selection number(s)>> 8 Next selection, '*' denotes a selected component 1 : ClearQuest Integration with ClearCase 2 : ClearCase MultiSite Full Function Installation 3 : ClearCase Attache Helper 4 : ClearCase Server-only Installation 5 : ClearCase MultiSite Shipping Server-only Installation 6 : ClearCase Web Interface Server 7 : ClearCase Minimal Developer Installation * 8 : ClearCase Full Function Installation 9 : ClearDDTS Integration with ClearCase a : Select all f : Finish selection x : Toggle expanded descriptions r : Reset selections q : Quit Selection number(s)>> f Atria License Server Host[node-name-of-license-server]:
ClearCase Registry Server Host[node-name-of-clearcase-server]:
ClearCase Registry Backup Host(s)[Unknown]:
ClearCase Registry Region[unix]:

Do you want to relink the MVFS when install is
complete (yes, no, quit, help)[no]:

Continue installation?(yes, no, quit)[yes]:

/lib/modules/fs/mvfs.o:
Hint: You are trying to load a module without a GPL compatible license
and it has unresolved symbols. Contact the module supplier for
assistance, only they can help you.

Using /lib/modules/fs/mvfs.o
/usr/atria/etc/atria_start: Loading MVFS failed
---- Please review /var/log/messages for information on the problem.
---- You may need to rebuild your kernel, rebuild your mvfs module,
---- and reboot your system. Information on how to do this can be found in
---- your Release Notes and file /var/adm/atria/mvfs/README.txt.

----
End of command output.
You will get the previous error. This problem is resolved in the next step.


Generate a new MVFS loadable module mvfs.o:

The newly compiled module will resolve the "unresolved symbols" error. Compile kernel source but do not install. This builds necessary files for the rebuild of the loadable module mvfs.o.

Error fix:

[root prompt]# cd /usr/src/linux-2.4.18-14
[root prompt]# make mrproper
[root prompt]# make oldconfig
[root prompt]# make dep
[root prompt]# cd ../ - Current directory: /usr/src [root prompt]# ln -s linux-2.4.18-14 linux - Fixes /var/adm/atria/mvfs/linux_ia32_2418_14smp/Makefile reference [root prompt]# cd /var/adm/atria/mvfs/linux_ia32_2418_14smp
[root prompt]# make
This will update /lib/modules/fs/mvfs.o

The above soft link is to fix the error generated by the following makefile assignment:

LINUX_KERNEL_DIR=/usr/src/linux
Instead of creating the link, one may also edit the makefile in /var/adm/atria/mvfs/linux_ia32_2418_14smp/


NFS mount Clearcase server:

For directories/mount points exported by the Clearcase server look at the NFS exports file /etc/exports (Solaris: /etc/dfs/dfstab).

Clearcase Client Configuration:

Typical Linux NFS client config file /etc/fstab:
(Solaris /etc/vfstab)
name-of-clearcase-server:/r1vob /net/name-of-clearcase-server/r1vob nfs rw,soft,bg 0 0
name-of-clearcase-server:/views /net/name-of-clearcase-server/views nfs rw,soft,bg 0 0
For use with separate mount points for views and VOBs.
or
name-of-clearcase-server:/home/cleardata /home/cleardata nfs soft,vers=2
In this example we use a single mount point for views and VOBs where the cleardata directory contains the sub-directories ccase_rls/ views/ and vobs/.
Another format, if one is using multiple VOB servers: /hosts/hostname/cleardata.

Clearcase Server Configuration:

Typical Clearcase NFS server (Linux, IRIX) /etc/exports:
...
/opt/ccase_rls -nohide
/r1vob -nohide
/views -nohide
...

Typical Solaris server /etc/dfs/dfstab:
...
share -F nfs /opt/ccase_rls
share -F nfs /r1vob -nohide
share -F nfs /views -nohide
...

Mount NFS file systems:

After your /etc/fstab is configured properly you are ready to mount the Clearcase NFS server file system:
[client root prompt]# mount /net/name-of-clearcase-server/r1vob
[client root prompt]# mount /net/name-of-clearcase-server/views


Start Clearcase client:

Create internal Atria/Clearcase mount points:

[root prompt]# service atria start
This start script (/etc/rc.d/init.d/atria) will create the directory /vob/... and generate internal mount points. This configuration is generated for you and will reside in the config file /etc/mtab. It will also perform a cleartool mount. The start script will also be executed during system boot. Once the service is started or the systems re-booted there is no need to re-execute this command manually.

The start script will also load the kernel module mvfs.o by performing an insmod mvfs.


User configuration:

Clearcase uses .bashrc for it's clearcase "view" shell.

Append the following to your $HOME/.bashrc

if [ $CLEARCASE_ROOT ]
then
export PS1='[`basename $CLEARCASE_ROOT`]$PWD>'
fi

alias ct=cleartool
This will change your prompt whenever you are in a Clearcase "view" (shell). The "view" will be listed in the prompt adding sanity to your experience.


Append the following to your $HOME/.bash_profile

PATH=/usr/atria/bin:$PATH
LD_LIBRARY_PATH=/usr/atria/lib:$LD_LIBRARY_PATH
alias ct=cleartool
Either re-login or initialize your shell session with the new changes: . $HOME/.bash_profile


Test installation with the following commands:

  • ct lsvob
  • ct hostinfo -l


The user's uid (user id) as defined in /etc/passwd and the user's gid (group id) as defined in /etc/passwd and /etc/group MUST match that used on the Clearcase server otherwise file permissions may not be compatable on the Clearcase MVFS file system. Other users defined on the Clearcase server may have to be defined locally on the client system to resolve uid/gid references. (i.e. When the command ls -l is issued, it will list the user/group as defined by the gid/uid) This can be supported by added entries to the local /etc/passwd and /etc/group files, NIS or LDAP.


Clearcase GUI xclearcase:

Gui tools loaded:

/usr/atria/bin/xclearcase
xcleardiff
xlsvtree

Use the following shell script to launch xclearcase:
File: /opt/bin/startXclearcase
#!/bin/bash
export LANG=C
PATH=/usr/atria/bin:$PATH
LD_LIBRARY_PATH=/usr/atria/lib:$LD_LIBRARY_PATH
cd /vob
/usr/atria/bin/cleartool setview -exec /usr/atria/bin/xclearcase name_of_view &
Desktop launcher icon:

The environment variable LANG MUST be set to "C" or "en_US.iso885915". The default in Red Hat 8.0 and 9.0 is en_US.UTF-8 which will crash xclearcase.

To use a different editor other than the default "vi" set the editor environment variable.
Example: export EDITOR=emacs

Tip: To view the additional collumns of information select "File" + "Preferences..." + select the collumns to display.

This script is for a single user system as it specifies a given view. For a multiuser system use the command /usr/atria/bin/xclearcase & which is not tied to a view but will allow the user to interactively select the view upon startup.


Licenses:

One can keep track of the number of client licenses used with the following Gnome desktop launcher.

File: ~/.gnome-desktop/ClearcaseLicenses.desktop

[Desktop Entry]
Encoding=UTF-8
Version=1.0
Type=Application
Exec=/usr/X11R6/bin/xterm -bg black -fg green -s -hold -geometry x50 \
-title "Clearcase licenses currently used:" \
-e /usr/atria/bin/clearlicense
TryExec= Icon=/usr/share/pixmaps/gnome-gnomoku.png X-GNOME-DocPath= Terminal=false Name[en_US]=Clearcase Licenses GenericName[en_US]= Comment[en_US]=

One may release a license with the command: clearcaselicense -release user-id


De-Install/Removal:

To remove Clearcase, remove the following:

/usr/atria
/var/adm/atria
/etc/rc.d/...atria
/opt/Clearcase - or whatever directory you used to download and unpack Clearcase cient software.
/lib/modules/fs/mvfs.o
entries in: /etc/fstab
/etc/mtab

/vob
/view
Also the mount point to the VOB server would be deleted after unmounting the NFS file system.


Clearcase Client installation on other Linux Distributions:

The Red Hat 8.0 Clearcase dependencies as shipped in its original form:

  • Linux kernel: 2.4.18-14
  • GNU gcc: gcc-3.2-7
  • GNU glibc: glibc-2.2.93-5
    I upgraded to glibc-2.3.2-4.80
  • File: /etc/issue
    Red Hat Linux release 8.0 (Psyche)
    Kernel \r on an \m
  • Start script path: /etc/rc.d/init.d/
  • Lock file path: /var/lock/subsys/
    (File: /var/lock/subsys/atria)
  • Red Hat command paths: (used by site_prep)
    • PATH: /usr/bin:/bin:/usr/etc:/etc:/sbin:/usr/sbin
    • /bin/uname
    • /bin/nawk


Switching Clearcase Servers:

Script to switch to a new Clearcase server:

service atria stop
rm /var/adm/atria/rgy/rgy_hosts.conf
echo "server_X" > /var/adm/atria/rgy/rgy_hosts.conf
rm /var/adm/atria/rgy/rgy_region.conf
echo "region_A" > /var/adm/atria/rgy/rgy_region.conf
rm /var/adm/atria/config/license_host
echo "license-server" > /var/adm/atria/config/license_host
service atria start
Note the file system NFS mount should be in effect. It is not a problem to mount all the NFS servers at once. Only one can be an active Clearcase server at any given time. this script activates a single server. I have a script for each Clearcase server.


Clearcase Notes:

  • Info:
  • Clearcase Client 4.2 can be installed on Red Hat 7 but can NOT be installed on Red Hat Linux 8.0. This is because all of the source for the kernel loadable module mvfs.o is not included. The module mvfs.o is linked with premvfs.o, which is available only as a pre-compiled object module compiled with the gcc 2 compiler. This can NOT be used by the Red Hat 8.0 kernel compiled with the gcc 3 compiler. It will not load.
  • A lower version of the Clearcase client will work with a higher version of the Clearcase view and VOB server or a matching version. The client can not have a higher version than the server.
  • Clearcase uses port 371
  • System tuning: One can set parameters in the startup script /usr/atria/etc/atria_start
    • For environments with a large number of users (client or server), increase the limit of files that lockmgr can handle. Default:
              .../etc/lockmgr .... -f 256 ...
      It is not unusual to increase this to 512.
  • System tuning: MVFS scaling factors:
    • mvfs_largeinit=(available RAM in GBytes)/2 + 1
      Where mvfs_largeinit < 8.
      You must reboot ccase after defining the mvfs_largeinit parameter.
    • mvfs_vobfreemax=1800 Default =900
    • mvfs_mnmax<=4096 Sets max number of objects. Grows dynamically if more required.
    • mvfs_dncregmax: Number of files to cache.
    • mvfs_dncdirmax: Number of directory names to cache.
  • IBM/Rational:
    • North America: 1-800-728-1212, 1-800-433-5444
      Cupertino CA (408)863-4000
      20 Maguire Road, Lexington MA 02421 (781)676-2460
    • Europe/Middle East: 31-(0)20-4546-200 Netherlands
    • Asia Pacific: 61-2-9419-0111 Australia


Books:

Software Configuration Management Strategies and IBM(R) Rational(R) ClearCas e(R) : A Practical Introduction
by David E. Bellagio, Tom J. Milligan
ISBN #0321200195, IBM Press May 23 2005

Amazon.com
The Art of ClearCase(R) Deployment : The Secrets to Successful Implementatio n
by Christian D. Buckley, Darren W. Pulsipher
ISBN #0321262204, Addison-Wesley Professional (July 13, 2004)

Amazon.com
Software Configuration Management Strategies and Rational ClearCase: A Practical Introduction
by Brian White
ISBN #0201604787, Addison-Wesley Professional; 1st edition (August 25, 2000)

Amazon.com
   

    Bookmark and Share


Advertisements




Copyright © 2003, 2004, 2005 by Greg Ippolito