6.2 NFS Client Products

ClearCase supports these NFS client products on Windows computers:

• Microsoft Windows Services for UNIX (SFU 1.0) Client for NFS

• Intergraph DiskAccess

• Hummingbird NFS Maestro

Some versions of these products may not be supported for use with ClearCase. The Release Notes for Rational ClearCase and ClearCase MultiSite include the most recent information about supported NFS client products and versions.

If you are using an NFS client product, you must install it on each Windows client that will access VOBs or views located on UNIX servers. You must install the product correctly and completely; in particular, you must assign and configure the NFS daemon and authentication process.

NOTE: A Windows computer configured to use an NFS client product to access UNIX VOBs cannot be a view_server host for Windows 98 or Windows Me computers.

The Release Notes for Rational ClearCase and ClearCase MultiSite contain the most up-to-date information about NFS client products, including which versions of those products Rational supports for use with ClearCase.

The rest of this section describes configuration procedures specific to using an NFS client product with ClearCase. Read and perform all procedures recommended for your product.

Disabling Automatic Case Conversioncontents@cc_inter.hlp">

Some NFS client products change the case of file names by default, typically by converting to lowercase. Because ClearCase is case-sensitive, you need to disable case conversion, as described later in this section.

NOTE: Typically, you can use a command-line option to disable case conversion for a particular NFS mount. However, ClearCase automatically mount remote storage directories. See Automounting and NFS Client Software. For correct behavior on these mounts, configure NFS mount drive options to disable case conversion.

Microsoft SFU and Intergraph DiskAccesscontents@cc_inter.hlp">

To disable automatic case conversion:

1. Start the Client for NFS (for SFU) or DiskAccess (for DiskAccess) Control Panel program.

2. On the Filenames tab, click Preserve Case (no conversion).

Hummingbird NFS Maestrocontents@cc_inter.hlp">

To disable automatic case conversion:

1. Click Start > Settings > Control Panel. Start the Network program.

2. On the Services tab, select NFS Maestro for Windows NT Client.

3. Click Properties to open the client configuration dialog box.

4. Under Filename Capitalization, click Preserve Case.

Setting an NFS Client's Default Protectioncontents@cc_inter.hlp">

If you plan to work in a shared UNIX view, configure your NFS client with a default protection that grants group write access. Without this permission, other developers cannot modify view-private files that you have created.

Microsoft SFU or Intergraph DiskAccesscontents@cc_inter.hlp">

To set the default protection:

1. Start the Client for NFS (for SFU) or DiskAccess (for DiskAccess) Control Panel program.

2. On the File Access tab, ensure User is RWX, Group is RWX, and Other is RX.

Hummingbird NFS Maestrocontents@cc_inter.hlp">

To set the default protection:

1. Click Start > Settings > Control Panel. Start the Network program.

2. On the Services tab, select NFS Maestro for Windows NT -Client.

3. Click Properties to open the client configuration dialog box.

4. Under Default Protection, specify the protections as follows:

User Group Other
RWX RWX RWX
xxx xxx x x

Setting the Correct Logon Name contents@cc_inter.hlp">

To avoid VOB and view access permission problems, do not log on to an NFS server as user nobody or with any user or group ID that does not match your Windows user and primary group IDs.

To verify that your Windows user name/UID and group name/GID match their UNIX counterparts, pass the name of a UNIX NFS server to ccase-home-dir\etc\utils\credmap. For example:

ccase-home-dir\etc\utils\credmap saturn

After you confirm your user name/UID and group name/GID, supply the user name as an NFS logon parameter.

Microsoft SFU or Intergraph DiskAccesscontents@cc_inter.hlp">

To set your logon user name:

1. Start the Client for NFS (for SFU) or DiskAccess (for DiskAccess) Control Panel program.

2. On the Authentication tab, type the correct User Name, Password, and PCNFSD Server.

3. Click OK; your logon session is validated.

Hummingbird NFS Maestrocontents@cc_inter.hlp">

To set your logon user name; at the command prompt, run the nfs register command:

nfs register username

This command prompts for a password.

Hummingbird NFS Maestro: Disabling DOS Sharing

The Maestro DOS Sharing option is incompatible with ClearCase use. When using Hummingbird NFS Maestro with ClearCase, you must disable this mode. If you do not, you may encounter MVFS log errors when attempting to open MVFS files. For example:

ZwOpenFile returned status 0xc0000043

This error indicates a sharing violation.

To disable DOS Sharing:

1. Start the Network program in Control Panel.

2. On the Services tab, select NFS Maestro for Windows NT -Client.

3. Click Properties to open the client configuration dialog box.

4. Under Default Links, clear the DOS-Style Sharing check box.

Automounting and NFS Client Softwarecontents@cc_inter.hlp">

When you mount a UNIX VOB or start a UNIX dynamic view, ClearCase needs to access the VOB storage directory or view storage directory on the UNIX file-system partition. In the ClearCase program in Control Panel, the setting of the Enable automatic mounting of NFS storage directories check box determines how ClearCase accesses those directories when you use NFS client products.

All supported NFS client products can process UNC names. If you are using one of these products, clear the Enable automatic mounting of NFS storage directories check box. ClearCase then uses UNC names to access UNIX VOB and view storage directories. We recommend that you configure ClearCase hosts in this way.

If you have been using ClearCase with the Enable automatic mounting of NFS storage directories check box selected, you can continue to do so. ClearCase then maps Windows drive letters to UNIX VOB and view storage directories and accesses the directories through those drive letters.

NOTE: These drive letters are for internal ClearCase use. They are different from the drive letters you can assign and use for your own work within views. In particular, do not confuse them with the drive letters you can assign to dynamic views when you start those views.

We recommend that you disable automounting when using any supported NFS client product. If you install Microsoft SFU or Intergraph DiskAccess before you install ClearCase, the ClearCase installation procedure disables automounting for you.

If you are using Hummingbird NFS Maestro or if you install a supported NFS product after you have installed ClearCase, you can disable automounting using the ClearCase program in Control Panel.

1. Click Start > Settings > Control Panel. Start the ClearCase program.

2. On the Options tab, clear the Enable automatic mounting of NFS storage directories check box.

3. Click OK.

Microsoft SFU 1.0 or Intergraph DiskAccess: Configuring Authentication for the ClearCase Server Process User

SFU and DiskAccess must be configured to allow logins by an individual user (typically the owner of the of the workstation) as well as by the ClearCase server process user. After you install SFU or DiskAccess on a computer, use the following procedure to configure an additional SFU or DiskAccess log-in for the UNIX clearcase_albd user.

NOTE: This procedure requires a UNIX account for the ClearCase server process user. See Creating a ClearCase Server Process User Account on UNIX for more information about how to create this account.

1. Log in as the ClearCase server process user (clearcase_albd).

2. Start the Client for NFS (for SFU) or DiskAccess (for DiskAccess) Control Panel program.

3. On the Authentication tab, specify the UNIX user name and password for the ClearCase server process user (the name and password that you used in Step #1 of this procedure).

4. Click OK.

5. When you exit the program, read the confirmation dialog box. It should show that you have been authenticated on UNIX as the ClearCase server process user. If there is an error, or if the confirmation dialog box shows a UID of -1 and GID of -2, you did not supply a valid name and password in Step #1 of this procedure.

6. Optionally, take the following additional steps to generate a Windows registry key file that other users can run to add support for this clearcase_albd login without having to log in as the clearcase_albd.

1. Run the creds utility to display the user SID of the clearcase_albd user. You will need this SID in a later step.

ccase-home-dir\etc\utils\creds clearcase_albd
Windows NT user info (on local system):
.
.
SID S-1-5-21-103034363-981818062-1465874335-1064
.

2. In a Windows Registry Editor, navigate to the key:

HKEY_LOCAL_MACHINE\SOFTWARE\Intergraph\DiskAccess\CurrentVersion\Users

3. Select the subkey that matches the SID of the clearcase_albd user as returned by creds.

4. Save the key to a registry file by clicking Registry > Export Registry File in the Registry Editor. When this saved file is executed on any Windows computer that has SFU or DiskAccess installed, it creates the Windows registry key that enables SFU and DiskAccess logins for the ClearCase server process user on UNIX.