config_ccase

ClearCase® configuration

Applicability

Product

Command type

ClearCase

data structure

Platform

UNIX

Linux

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 and Linux) or a Windows registry key as described here.

Description: UNIX and Linux system files

Files in /var/adm/devops/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 DevOps Code ClearCase Administrator's Guide.

Files in /var/adm/devops/clearcase/config

Anyone can read and write information in this directory to configure the local host, with the exception of rgy_hosts.conf and rgy_region.conf. Only the root user can modify these two files 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 river-005 wid
159.0.16.103 widget-gtwy river-105 

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

widget
widget-gtwy

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 or Linux automount program mounts remote directories under /tmp_mnt. If automount uses a different location, you must specify it in file /var/adm/devops/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 the DevOps Code ClearCase Guide to 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. For more information, see the vob_snapshot reference page.
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/devops/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.

lockmrg.conf
Changes the default startup options for the lockmgr. For more information, see the DevOps Code ClearCase Administrator's Guide.
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

The registry key is HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Atria\ClearCase\CurrentVersion.

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

Registry key

Description

snapshot

Configuration information for semi-live VOB backup. For more information, see the vob_snapshot reference page.

LockMgrCommandLine

Changes the default startup options for the lockmgr. For more information, see the DevOps Code ClearCase Administrator's Guide.

DomainMappingEnabled

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

Files in \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

DevOps Code ClearCase Administrator's Guide, DevOps Code ClearCase Guide to Building Software