IBM Support

The given credentials are not recognized by the remote host

Troubleshooting


Problem

This technote explains why attempts to create an IBM® Rational® ClearCase® snapshot view from a UNIX® or Linux™ client and placing the view storage on Microsoft® Windows® fails with the error message []The given credentials are not recognized by the remote host.[]

Cause

Attempts to create a snapshot view from a UNIX client using a Windows storage location fails with the following error message:

Note: The Storage Location (stgloc) is configured to store views on a Windows host called Windows1. Review the ClearCase Reference Guide on the topic of mkstgloc (cleartool man mkstgloc) for more information.

% cleartool mkview -snapshot -stgloc win_views /snapshot/snap_1
cleartool: Error: The given credentials are not recognized by the remote host.
cleartool: Error: More information might be available in albd or credmap logs on host: "Windows1".
cleartool: Error: Cannot create a view storage directory in "Windows1:c:\views": error detected by ClearCase subsystem.
cleartool: Error: Unable to create view storage directory in Server Storage Location "Windows1_win_views" for snapshot view "/snapshot/snap_1".



The cause of this error relates to the users credential information. It is not mapping properly from UNIX (or Linux) to Windows.

This can be verified by running the credmap utility from the UNIX client using the view server host name:

Example:


    % /usr/atria/etc/utils/credmap Windows1
    Identity on local system:
    User: nis/jdoe (UNIX:UID-20980)
    Primary group: nis/cc_users (UNIX:GID-5089)
    Groups: (0)

    Identity on host "Windows1":
    User SID: NOBODY
    Primary group SID: NOBODY
    Group SID list: (0)

Note: Running credmap from the Windows host to the UNIX client does report the correct information:

    C:\Program Files\Rational\ClearCase\etc\utils>credmap UNIX1
    Identity on local system:
    User: DOM1\jdoe (NT:S-1-5-21-1453292567-1645505489-561332275-19107)
    Primary group: DOM1\Domain Users (NT:S-1-5-21-1453292567-1645505489-561332275-513)
    Groups: (9)
    Everyone (NT:S-1-1-0)
    Windows1\ORA_DBA (NT:S-1-5-21-839522115-706699826-854245398-1013)
    BUILTIN\Administrators (NT:S-1-5-32-544)
    BUILTIN\Users (NT:S-1-5-32-545)
    DOM1\Cup-User (NT:S-1-5-21-1453292567-1645505489-561332275-2124)
    DOM1\cc_users (NT:S-1-5-21-1453292567-1645505489-561332275-5265)
    LOCAL (NT:S-1-2-0)
    NT AUTHORITY\INTERACTIVE (NT:S-1-5-4)
    NT AUTHORITY\Authenticated Users (NT:S-1-5-11)

    Identity on host "UNIX1":
    User SID: UNIX:UID-20980
    Primary group SID: UNIX:GID-65537
    Group SID list: (9)
    NOBODY
    NOBODY
    NOBODY
    NOBODY
    NOBODY
    UNIX:GID-5089
    NOBODY
    NOBODY
    NOBODY

Resolving The Problem

In the ClearCase Control Panel Applet on Windows (Start > Run type: cc.cpl) on the Options tab there is a section named:

Use this domain to map UNIX user and group names

This specifies the domain(s) in which user and group names will be verified when UNIX® clients request access to ClearCase services hosted on that Windows host.


Add or change the Windows domain name and restart the server.

Once this change is made, the credmap output from the UNIX client should return correct information:


    % /usr/atria/etc/utils/credmap Windows1
    Identity on local system:
    User: nis/jdoe (UNIX:UID-20980)
    Primary group: nis/cc_users (UNIX:GID-5089)
    Groups: (0)

    Identity on host "Windows1":
    User SID: SID:3.010500000000000500000015569f7c1762146bd12175403300004aa3
    Primary group SID: SID:3.010500000000000500000015569f7c1762146bd12175403300001491
    Group SID list: (0)

Once the credmap is confirmed, creating a view should work:

    %cleartool mkview -snapshot -stgloc win_views /snapshot/snap_1
    Created view.
    Host-local path: Windows1:c:\views\DOM1\jdoe\jdoe_snap_1.vws
    Created snapshot view directory "/snapshot/snap_1".



[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Credmap Server","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":"2002.05.00;2003.06.00","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"View: Snapshot","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"View: Snapshot","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21135399