^{Highley Recommended, Inc.}

CM Home
CM Resources
Getting Started
Config. Spec.
CM Procedures
ClearCase
Scripts
Triggers
CM Plan
ClearCase Best Practices
Merging
ClearCase FAQ

Site_prep.pl should have be run as the first step. Site_prep.pl creates a directory structure that these utilities operate within.

New Project VOBs and Applying Process Software

You should be logged in as vobadm, except as noted. Note: we are assuming that all VOBs will be accessed by UNIX and Windows systems so they must be set up and served by a UNIX VOB server system. The scenario we use to setup a new project, or VOB, is:

Steps For Setting Up a New VOB

1. cd "process area"/vobsetup
2. newgrp "developer" - switch to primary group that the developers are in.
3. MkVob.pl [-private] "VobTag" - this makes a new project VOB. NOTE: if you are making a private VOB, first do a mkdir for the vobtag mount point or you will need to login as root to change the owner and group for the mount point before you will be able to mount the new vob.
4. newgrp vob - change back to primary group.
5. MkEltypes.pl "VobTag" - creates element types for the new vob so that so that the proper triggers and type managers are associated with the data we will be putting into the new vob.
6. cd "process area"/triggers - install two triggers.
   pre_ci_trig -install "VobTag" - does strip of control M at EOL.
   post_mkelem_trig -install "VobTag" - changes owner and permissions.
   
7. cd to directory source tree location of existing files we want to put into ClearCase control.
8. clearexport_ffile -r or clearexport_rcs -r - to build script to populate new VOB, can use -o flag to put script in another location.
9. ct setview "project" - view created in step 3 above.
10. cd - root of new vob.
11. clearimport - import the file structure using the script created in the previous step.

Steps For Applying Process Software to New Project

1. cd "process area"/triggers
   Install "VobTag" - this will install all triggers in new vob.
   or
   To install individual triggers, example:
   pre_ci_trig -install "VobTag"
2. cd "process area"/vobsetup
   InstallAuthLists "VobTag" - will install the ClearCase process authorization lists attaching them to the new projects vob object.

Install ClearCase Product

To create a new product installation release area follow the steps below.

UNIX:

1. Insert product CD into drive
2. Login in as root
3. cd to CD mount point
4. Run copy.sh
5. Select products and platforms
6. Enter release area storage location
7. Under each platform directory, Example: ccase_rls/v3.2.1/sun5, create a patches directory
8. Down load patches for each platform from Rational site at
   Technical Support Patches/Upgrades
   to the appropriate platform patches directory
9. Unpack archive files
10. Follow installation instructions for each patch

Windows:

1. Insert product CD into drive
2. Login in as CM Administrator
3. Follow instructions for setting up a release installation area. If you want the installation area to be on a UNIX server, pre-create an NT directory under the ccase_rls/v3.2.1 directory with the CM Administrator owning the directory. Change the directory permissions to have global write permissions for so install shield can write into this directory, chmod +w. Also create a patches directory under the NT directory.
4. Down load patches from the Rational site to the patches directory.
5. Apply patches to the netinst directory
6. If release area is on a UNIX server remove global write from the files by changing directory to ccase_rls/v3.2.1. Then do chmod -R o-w NT, which remove global write permission from the NT directory and all files and directories below it.

Setting Up a New ClearCase System

To setup a new ClearCase system we need to do the following steps. Do ClearCase install from release area, currently "release area"/ccase_rls, picking the correct platform and ClearCase version.

UNIX:

1. su - root
2. cd "release area"/ccase_rls/v3.2.1/"platform"/install
3. ./install_release...
   1. Local Install: Install occurs on the local host.
   4. Link-only: , unless this is a remote system, 2. Full-copy:
   [/usr/atria]: - default file system location to install into
   ["release area"/ccase_rls/v3.2.1/"platform"]: - path to release area
   7 : ClearCase Full Function Installation
   f : Finish selection
   Atria License Server Host[oak]:
   Atria Registry Server Host[oak]:
   Atria Registry Region[oak]:
   Continue installation?(yes, no, quit)[yes]:
4. If system is a registry server set registry password by executing:
   /usr/atria/etc/rgy_passwd
5. If needed, modify and copy the magic file extensions from the process software VOB to the /usr/atria/config/magic directory.
6. exit root
7. For NT access if this is a registry server create "whostname" region by doing:
   ct mkregion -tag "whostname"

Windows:

1. login in as a user with administration capabilities
2. select Start menu
3. select find
4. select Computer
5. type "oak" into dialog box
6. double click on "oak"
7. browse to "release area"\ccase_rls\v3.2.1\NT40
8. browse to Client_Only
   or
   browse to Server
9. double click setup.exe
10. C:\Program Files\Rational\ClearCase - default installation location
    ClearCase client - normally you should select this choice
    or
    ClearCase server - if system is to be the NT snap shot server
11. Use the standard configuration
12. If needed, modify and copy the magic file extensions from the process software VOB to the C:\Program Files\Rational\ClearCase\config\magic if that is where you installed ClearCase.
13. After rebooting we suggest you elect not to run ClearCase Doctor on each reboot, but do run it the first time to see if there are any problems with the installation.
14. double click ClearCase Home Base
15. select Administration tab
16. select Region Synchronizer tab
17. select View Tags radial button
18. select views and import
19. make server path change:
    "process area"\viewstore\name.vws
    
20. select close button
21. select Control Panel
22. select MVFS tab
23. select Case Preserving check box
24. select OK button
25. select close button

Network Appliance:

1. Export file system volumes - giving UNIX ClearCase VOB server systems root write access to volume. Make sure filer volume is in UNIX mode.
2. Example snap shot schedule:
   Snap shot backups are being done at; 00:00, 08:00, 12:00, 16:00, and 20:00. Snap shots are stored at /home/cc-raid/.snapshot. Hourly.0 is the newest snap shot. Nightly.0 is the midnight snap shot.

Uninstalling ClearCase From a System

If you no longer need ClearCase on a system you can uninstall it by following these steps below.

UNIX:

1. su - root
2. cd /etc/init.d
3. ./atria stop
4. cd "release area"/ccase_rls/v3.2.1/"platform"/install
5. ./install_release...
   4. Local Deinstall: Deinstall occurs on the local host.
   Some times the step above does not work.
   • cd /usr
   • ls -ld atria
   • If it is a symbolic link do a rm atria; else do a rm -rf atria.
   • If the symbolic link pointed to a local disk storage location, cd to directory above and do a rm -rf atria.
   • cd /var/adm/atria/log and check Atria_install.... log for other locations that files were installed to and remove those files.
   • cd /var/adm and do rm -rf atria

Windows:

1. login in as a user with administration capabilities
2. select Start menu
3. select find
4. select Computer
5. type "server name" into dialog box
6. double click on "server name"
7. browse to "release area"\ccase_rls\v3.2.1\NT40
8. browse to Client_Only
   or
   browse to Server
9. double click on uninstal.exe
10. Read and follow prompts.