Post Install:

As user "root"

• Assign a registry password: /opt/rational/clearcase/bin/rgy_passwd

You will be asked to supply a password.
• Create VOB storage area:
o mkdir /vob
chown vobadm:devel /vob
o mkdir /path-goes-here/vobstore
chown vobadm:devel /path-goes-here/vobstore
o mkdir /path-goes-here/viewstore
chown vobadm:devel /path-goes-here/viewstore
• Export VOB storage areas using NFS:

NFS config file (example): /etc/exports

/path-goes-here/vobstore 192.168.1.0/255.255.255.0(rw)
/path-goes-here/viewstore 192.168.1.0/255.255.255.0(rw)
Note: The directory /vob is an internal mount generated by Clearcase and not an
NFS mount.

Pick up NFS exports configuration: exportfs -a

See the YoLinux Systems administration tutorial covering NFS.

As user "vobadm"

• Expand path to include Clearcase commands: (add to .bashrc file)

export PATH=/opt/rational/clearcase/bin:$PATH
• Install license and test:
o cp license.db /var/adm/rational/clearcase/
(Note: This is soft linked to /var/adm/atria/)
o Test with command: clearlicense

IBM/Rational will issue a license based on the hostid or MAC address. These are
found by issuing the following commands:

o Host ID: /opt/rational/clearcase/bin/clearlicense -hostid

o Linux Host ID: hostid (not necesarily unique for Linux and thus not
usually used.)
o MAC address: ifconfig
• Make a storage location for VOB:
o cleartool mkstgloc -vob -region region-name -host ccserver
-hpath /path-goes-here/vobstore -gpath /path-goes-
here/vobstore vobstore /path-goes-here/vobstore
o cleartool mkstgloc -view -region region-name -host ccserver
-hpath /path-goes-here/viewstore -gpath /path-goes-
here/viewstore viewstore /path-goes-here/viewstore
 When asked "Advertise existing directory [no]" answer "yes".

• Test Clearcase storage locations: cleartool lsstgloc

This will list the full paths of the "vobstore" and "viewstore" locations.
• Create the VOB:
o cleartool mkvob -region region-name -tag /vob/PROJECT
-stgloc vobstore -public
You will be asked to enter the registry password assigned with the
rgy_passwd command.
o cleartool mkview -region region-name -tag vobadm_proj
-stgloc viewstore
• Mount the VOB: cleartool mount -a
• View VOB info: cleartool -ver
Shows VOB db schema version. The current Clearcase schema version for
2003.06.00 is 54.
• cleartool setview vobadm_proj
• Create main directory:
o Optional - make sub-directories: cleartool mkdir subdir-name
Or import (clearfsimport) as shown below.
o cd /vob/PROJECT
• Show VOBs: cleartool pwv
• Show Views: cleartool lsview
• Show Regions: cleartool lsregion
• Show VOBs: cleartool lsvob
• Show Configspec: cleartool catcs
• Import files and directories:

1.cleartool setview your_view

2.clearfsimport -recurse -identical -preview
/source/directory/path/* /vob/PROJECT/path
(Preview option shows what will happen when command executes)
3.clearfsimport -recurse -identical /source/directory/path/*
/vob/PROJECT/path
(Perform actual import)

Add option "-follow" to follow symbolic links.

[Potential Pitfall]: The command line option "-identical" should only be used for
the initial import and NOT for later revisions as file date differences will force
new entries even though the files may be identical.

Cleanup: (Removing VOBs from system)

• cleartool rmvob /path-goes-here/vobstore/PROJECT.vbs

• cleartool rmview -force -tag vobadm_proj

Slocate configuration:
The "slocate" command is run each day to create a database of all files on the system. It
ignores NFS mounted file systems (thus Clearcase clients need not worry) but will search
your Clearcase server storage areas which have Clearcase file storage names and not the
ones you see when in a view. Configure this cron job to ignore Clearcase repositories.

Slocate cron file: /etc/cron.daily/slocate.cron

#!/bin/sh
. /etc/updatedb.conf
renice +19 -p $$ >/dev/null 2>&1
/usr/bin/updatedb
This uses the configuration file /etc/updatedb.conf.

Edit the configuration file: /etc/updatedb.conf

PRUNEFS="sysfs selinuxfs usbdevfs devpts NFS nfs afs sfs proc smbfs cifs
autofs auto iso9660 udf mvfs"
PRUNEPATHS="/tmp /usr/tmp /var/tmp /afs /net /sfs /selinux /udev
/mnt/floppy /path-goes-here/viewstore /vob /view"
export PRUNEFS
export PRUNEPATHS
Note the addition of mvfs to the file system types to be ignored and /path-goes-
here/viewstore, the viewstore directory to be ignored.

ClearCase Web Access: ccweb

Clearcase Web Access uses Linux system authentication which uses md5 encrypted
passwords. This requires Clearcase patches 19, 37 and 38 in adition to 28 and 29 as
shown in the installation above.

Access via the URL:

• http://clearcase-server-name/ccweb
• https://clearcase-server-name/ccweb

Pam authentication configuration: Clearcase web uses the system PAM login
authentication. The configuration is identical to "login". Thus:

cp /etc/pam.d/login /etc/pam.d/clearcase

[Potential Pitfall]: The init service "rwp_startup" (Rational Web Process) may hang on
system boot. The last visible message on the screen is "Enabling Swap Space". The
system then hangs indefinitely. The only fix is to enter "Interactive Mode" during the
boot process by entering the letter "I". Read the boot messages and enter the mode when
the oportunity is displayed in the boot messages by entering "I". Accept all init services
by pressing the "Enter" key to take the yes [y] default. When presented with the option to
launch "rwp_startup", enter the letter "N" for no, and skip this process.
To fix CCWeb and enable it to work, remove a broken link: rm
/opt/rational/common/rwp/conf/include/msweb.conf
(Yes, IBM left a dead link in it's Linux installation which points to a configuration file
used on Microsoft Windows servers.)

Note, your system requires Java installation and browser plug-in configuration for Java.
See YoLinux Mozilla / Firefox web browser Java configuration.

Note: I have been running both the native Apache server which was issued with RHEL4
on port 80 and the Clearcase web server on port 81 with no apparent problems.

Connecting MS/Windows clients:

Steps to support MS/Windows clients:

On Clearcase server:

• Create a region for use by MS/Windows clients: cleartool mkregion -tag

devel_win
• Show Regions: cleartool lsregion

There are two methods of exporting the filesystems from the Clearcase server:

1. Export the Clearcase filesystem system using NFS and use an NFS client on the
MS/Windows client to mount the exported filesystem. This is fast and free of
many MS/Windows authentication hagups.
2. Export the Clearcase filesystem using SAMBA.

2) Use SAMBA to export two shares:

• vobstore
• viewstore

Using MS/Active Directory with "Unix services for Windows" NIS server for
authentication, configure the Linux Clearcase server's SAMBA authentication as follows:

File: /etc/krb5.conf

[logging]
default = FILE:/var/log/krb5libs.log
kdc = FILE:/var/log/krb5kdc.log
admin_server = FILE:/var/log/kadmind.log

[libdefaults]
default_realm = win-domain.domain.com
dns_lookup_realm = true
dns_lookup_kdc = true
[realms]
win-domain.domain.com = {
kdc = authserver.win-domain.domain.com:88
admin_server = authserver.win-domain.domain.com:88
}

[kdc]
profile = /var/kerberos/krb5kdc/kdc.conf

[appdefaults]
pam = {
debug = false
ticket_lifetime = 36000
renew_lifetime = 36000
forwardable = true
krb4_convert = false
}

File: /etc/samba/smb.conf

[global]
workgroup = win-domain
server string = clearcase-server Samba Server

printcap name = /etc/printcap

load printers = yes
cups options = raw
log file = /var/log/samba/%m.log
max log size = 50
password server = authserver

socket options = TCP_NODELAY SO_RCVBUF=8192 SO_SNDBUF=8192

dns proxy = yes

# SHare definitions

idmap uid = 16777216-33554431

idmap gid = 16777216-33554431
template shell = /bin/false
realm = win-domain.domain.com
security = ADS
windbind use default domain = no

[printers]
comment = All Printers
path = /var/spool/samba
browsable = no
printable = yes

[vobstore]
path = /path-goes-here/vobstore
 writeable = yes
create mask = 0777
force directory mode = 0777
force group = devel

[viewstore]
path = /path-goes-here/viewstore
writeable = yes
create mask = 0777
force directory mode = 0777
force group = devel

[home]
path = /home
writeable = yes
guest ok = no
create mask = 0766
force directory mode = 0766
force group = devel

Intallation:

• siteprep.exe
Choose client install
Create region: devel_win
• setup.exe
• Verify installation from control panel and check settings.
• From "Start" menu: "Rational Software" + "Administration" + "Syncronize
region"

Links:

• File corruption by editing with Visual Studio using a view server - Download
Microsoft patch.
• IBM/Rational Clearcase-SAMBA interoperational tips

Backup:

To perform a tape backup, unmount the VOBs, stop the Clearcase daemon and backup
the "viewstore" and "vobstore" directories.

• cleartool umount -a
• service clearcase stop
(or use the start and stop scripts in /opt/rational/clearacase/etc/)

There is no need to backup the MVFS /vob and /view as this is just a Clearcase view of
data in the "viewstore" and "vobstore" directories.