config_ccase

ClearCase and ClearCase LT configuration

APPLICABILITY


Product

Command Type

ClearCase


data structure


ClearCase LT


data 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/atria

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/atria/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:
widget
widget-gtwy
Note that only the first hostname in each hosts entry need be included in the file. The file must list each alternative host name of 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 at all.
automount_prefix

By default, automount(1M) mounts directories under /tmp_mnt. If another location is used for a host's automatic mounts (for example, you use automount -M, or you use an alternative auto-mount program), you must specify it in file /var/adm/atria/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 into 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/atria/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/atria/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 may modify these values directly with a Windows Registry Editor.

Registry Key Description

snapshot

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

DomainMappingEnabled

Enables this host to use domain mapping (to support ClearCase access by users from multiple Windows NTdomains) as described in the Administrator's Guide.

Files in ccase-home-dir\var\config

Anyone can read or write to this directory.

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