IBM Support

Usernames and primary groups in a ClearCase Interop environment

Preventive Service Planning


Abstract

This technote specifies the supported requirements for usernames and primary groups when working in an IBM Rational ClearCase Interoperation (Interop) environments with Microsoft Windows, UNIX and or Linux.

Content

All Windows users' usernames and their primary groups must have matching usernames and primary groups on UNIX (and or Linux) in a Rational ClearCase Interop environment.

On UNIX (and Linux), Rational ClearCase relies on group IDs to implement workgroup sharing and to maintain strict access control. To access UNIX VOBs and views correctly, each Windows user's username and primary group name must match that user's username and primary group name on UNIX.

Note: The case and spelling must be identical between the operating systems for both the usernames and primary groups. Avoid names that have spaces or special characters that are not supported on the different operating systems. For further information refer to the IBM Rational ClearCase Administrator's Guide under the topic of Rational ClearCase Network Administration in Mixed Environments



As seen in the below table, on Windows, the username, dev1, with the primary group, ccusers, has a matching counterpart on UNIX as dev1 with primary group, ccusers.

Windows
UNIX (or Linux)
Username: dev1
username: dev1
Primary Group: ccusers
Primary Group: ccusers

Note: Using the clearcase server process group from Windows as the primary group for the VOB is not supported. Refer to technote 1264867 Problems that occur if the ClearCase Administrator group owns the VOB or VOB objects for further details.

To verify that the username and primary group are the same on Windows and UNIX, use the credmap utility from Windows, and compare that output to the id (or id -a) output from UNIX. For details on using credmap, run cleartool man credmap.


Example:
  • credmap output:
G:\Documents and Settings\hakank>credmap unix_server
Identity on local system:
User: domain\dev1 (NT:S-1-5-21-2052111302-1417001333-682003330-1004)
Primary group: domain\ccusers   (NT:S-1-5-21-2052111302-1417001333-682003330-1009)
Groups: (32)
domain\Domain users (NT:S-1-5-21-2052111302-1417001333-682003330-1038)
Everyone (NT:S-1-1-0)
HKTEST\1 (NT:S-1-5-21-2052111302-1417001333-682003330-1010)
HKTEST\10 (NT:S-1-5-21-2052111302-1417001333-682003330-1019)

 BUILTIN\Users (NT:S-1-5-32-545)
------------------------snip-----------------------------

 Identity on host "unix_server":
 User SID: UNIX:UID-500
 Primary group SID: GID-244

 Group SID list: (32)
  NOBODY
  NOBODY
  UNIX:GID-20

  G:\Documents and Settings\developer>
  • id -a output:
id -a
unix_server% uid=500(dev1) gid=244(ccusers) groups=20(users)


Documentation

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Interop","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF015","label":"IRIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.0;7.0.1;7.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Permissions","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21146784