Setting the DevOps Code ClearCase 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).

DevOps Code ClearCase® users who are members of multiple domain groups must set the user environment variable CLEARCASE_PRIMARY_GROUP to the domain-qualified name of the DevOps Code ClearCase users group (for example, NT_WEST\clearusers). This guarantees an unambiguous definition of the group that DevOps Code ClearCase considers the user's primary group. DevOps Code ClearCase 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 DevOps Code ClearCase users group who are also members of the DevOps Code ClearCase administrators group must set CLEARCASE_PRIMARY_GROUP to the name of the DevOps Code ClearCase users group, not the name of the DevOps Code ClearCase 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 ClearCase Doctor.

Procedure

  1. Click Start > DevOps Code ClearCase > Administration > ClearCase 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.