Setting the HCL VersionVault primary group

About this task

Although you can designate a user's primary group by using various Windows® domain account maintenance tools, that group name is not always returned when an application requests the name of a user's primary group (unless the user is a member of only one domain group).

HCL VersionVault users who are members of multiple domain groups must set the user environment variable CLEARCASE_PRIMARY_GROUP to the domain-qualified name of the HCL VersionVault users group (for example, NT_WEST\clearusers). This guarantees an unambiguous definition of the group that HCL VersionVault considers the user's primary group. HCL VersionVault users who are members of a single domain group do not have to take this step.
Note: CLEARCASE_PRIMARY_GROUP must be a user environment variable. It cannot be a system environment variable.
The value of CLEARCASE_PRIMARY_GROUP is used only when evaluating a user's rights to access a VOB. It has no other security or access-control implications. Users who are members of multiple groups but have not set CLEARCASE_PRIMARY_GROUP correctly are likely to have problems creating elements or otherwise accessing VOBs, especially in complex domain configurations.
Note: Members of the HCL VersionVault users group who are also members of the HCL VersionVault administrators group must set CLEARCASE_PRIMARY_GROUP to the name of the HCL VersionVault users group, not the name of the HCL VersionVault administrators group.

Procedure

  1. Right-click My Computer, and then click Properties.
  2. Click the Advanced tab.
  3. Click Environment variables.
  4. In the User variables section, click New.
  5. In the New User Variable window, specify CLEARCASE_PRIMARY_GROUP in the Variable name field.
  6. In the Variable value field, specify a domain-qualified group name of the form DOMAIN\groupname.
  7. Click OK to save your work.

Editing the value of CLEARCASE_PRIMARY_GROUP

About this task

Procedure

  1. Right-click My Computer, and then click Properties.
  2. Click the Advanced tab.
  3. Click Environment variables.
  4. In the User variables section, select CLEARCASE_PRIMARY_GROUP and click Edit.
  5. In the Variable value field, specify a domain-qualified group name of the form DOMAIN\groupname.
  6. Click OK to save your work.

Verifying the value of CLEARCASE_PRIMARY_GROUP

About this task

You can verify the value of CLEARCASE_PRIMARY_GROUP using VersionVault Doctor.

Procedure

  1. Click Start > Programs > HCL > HCL VersionVault > Administration > VersionVault Doctor.
  2. Click Start Analysis.
  3. When the analysis is finished, click the Topics page and open the User Login Account folder.
  4. Double-click Primary Group, read the user's primary group, and verify that it is correct.