config_ccase

ClearCase and ClearCase LT configuration

APPLICABILITY

ProductCommand type
ClearCasedata structure
ClearCase LTdata structure

Platform
UNIX
Windows

SYNOPSIS

Most ClearCase configuration options can be set using a cleartool command or a ClearCase GUI. Only a few require you to edit a text file (on UNIX) or a Windows registry key as described here.

DESCRIPTION—UNIX SYSTEM FILES

Files in /var/adm/rational/clearcase

Anyone can read the information in this directory, but only the root user can modify it.

license.db
(License server host only) The license database file, which defines a set of ClearCase licenses. See the Administrator's Guide.

Files in /var/adm/rational/clearcase/config

Anyone can read and write information in this directory to configure the local host.

alternate_hostnames
If a host has two or more network interfaces (two or more separate lines in the /etc/hosts file or the hosts NIS map), you must create a file with this name on that host to record its multiple entries. For example, suppose that the /etc/hosts file includes these entries:
159.0.10.16 widget sun-005 wid
159.0.16.103 widget-gtwy sun-105 

In this case, the alternate_hostnames file should contain these names:

widget
widget-gtwy

Note that only the first host name in each hosts entry must be included in the file. The file must list each alternative host name on a separate line. There is no commenting facility; all lines are significant. If a host does not have multiple network interfaces, this file should not exist.

automount_prefix
By default, the UNIX automount program mounts remote directories under /tmp_mnt. If automount uses a different location, you must specify it in file /var/adm/rational/clearcase/automount_prefix. For example, if your automatic mounts take place within directory /autom, create an automount_prefix file containing this line:

/autom

bldserver.control
Controls the way in which a host is used during parallel builds. See Building Software.

license_host
(Required for each ClearCase host) Contains the name of the host that acts as the ClearCase license server host for the local host.

snapshot.conf
Configuration information for semi-live VOB backup. See the vob_snapshot reference page for more information.

admin.conf
Controls whether this host's Clearcase properties can be changed by a user logged on to a remote host.

db.conf
Configuration information for the file, vista.tjf, which is a journal of VOB updates. This file can grow large, especially as a result of such operations as rmver, rmview, rmtype, and scrubber. To limit the size of vista.tjf, create the file db.conf (in /var/adm/rational/clearcase/config) and add the line

–journal_file_limit bytes

where bytes may not be less than 5000000. Setting this value too low may degrade performance.

Files in /var/adm/rational/clearcase/rgy

Anyone can read these files but only the root user can modify them to configure the local host.

rgy_hosts.conf
Specifies this host's registry server and backup registry server hosts.

rgy_region.conf
Specifies this host's registry region.

DESCRIPTION—WINDOWS REGISTRY KEYS AND FILES

Values in Registry Key HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion

If necessary, you can modify these values directly with a Windows Registry Editor.

Registry KeyDescription
snapshotConfiguration information for semi-live VOB backup. See the vob_snapshot reference page for more information.
LockMgrCommandLine Startup options for the lockmgr. See the Administrator's Guide for more information.
DomainMappingEnabledEnables this host to use domain mapping (to support ClearCase access by users from multiple Windows NT domains), as described in the Administrator's Guide.

Files in ccase-home-dir\var\config

Anyone can read or write to this directory.

db.confConfiguration information for the file, vista.tjf, which is a journal of VOB updates. This file can grow large, especially as a result of such operations as rmver, rmview, rmtype, and scrubber. To limit the size of vista.tjf, create the file db.conf (in ccase-home-dir\var\config) and add the line –journal_file_limit bytes where bytes may not be less than 5000000. Setting this value too low may degrade performance.

SEE ALSO

Administrator's Guide, Building Software



Copyright© 2003 Rational Software. All Rights Reserved.