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

• 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 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

• 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.

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

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.

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

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

LINUX_KERNEL_DIR=/usr/src/linux

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

Clearcase Client Configuration:

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.

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:

... /opt/ccase_rls -nohide /r1vob -nohide /views -nohide ...

... share -F nfs /opt/ccase_rls share -F nfs /r1vob -nohide share -F nfs /views -nohide ...

Mount NFS file systems:

[client root prompt]# mount /net/name-of-clearcase-server/r1vob
[client root prompt]# mount /net/name-of-clearcase-server/views

Create internal Atria/Clearcase mount points:

[root prompt]# service atria start

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

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

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

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.

Gui tools loaded:

/usr/atria/bin/xclearcase
               xcleardiff
               xlsvtree

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.

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

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

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

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.

• Info:
  • Clearcase Online Manuals and Documentation
  • When Good VOBs Go Bad - IBM Web based training
  • /usr/atria/doc/hlp/*.pdf - Installed
  • /opt/Clearcase/v5.0/rhat_x86/doc/hlp/*.pdf - if client download is un-tarred to /opt/Clearcase.
  • /opt/Clearcase/v5.0/rhat_x86/install/cdf/*.pdf
  • /usr/atria/doc/man/...
• 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
	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)
	Software Configuration Management Strategies and Rational ClearCase: A Practical Introduction by Brian White ISBN #0201604787, Addison-Wesley Professional; 1st edition (August 25, 2000)

Copyright © 2003, 2004, 2005 by Greg Ippolito