IBM Support

Mounting a VOB returns ClearCase Object Not Found

Technote (troubleshooting)


Problem(Abstract)

This technote outlines the possible causes for the error ClearCase Object Not Found when attempting to mount an IBM® Rational® ClearCase® VOB on Microsoft® Windows®, Linux® or UNIX®.

Cause

Attempts to mount a VOB results in the following error:


    ClearCase Object Not Found


This error may get reported in the VOBRPC error log:
    01/06/2006 09:24:34 vobrpc_server(5016): Error: vobrpc_server.exe(5016): Error: Unable to get VOB tag registry information for replica uuid "db7983f9.052d498a.915f.bb:f9:0e:b0:b4:ea": ClearCase object not found

This error may get reported in the vob_scrubber log:
    vob_scrubber: Error: Unable to get VOB tag registry information for replica uuid "db7983f9.052d498a.915f.bb:f9:0e:b0:b4:ea": ClearCase object not found

Note: All of the above errors may not occur when the ClearCase Object Not Found error occurs. These are just possible indicators of the below detailed causes to help with identifying the problem.


This error will occur when trying to mount the VOB before the VOB tag creation is complete. This would be due to a timing issue where the cleartool mkvob and cleartool mount operations are done via a script, and maybe a longer pause is required before the VOB is mounted on a remote host. This would also be true in an environment where the VOB creation takes several moments to complete, and there is an extended period before the VOB tag is available for users to mount.

Note: This does not occur as a result of the cleartool mount that is executed automatically during the cleartool mkvob operation.



Cause 2

The VOB tag may still exist even though the VOB storage (or VOB server host) are no longer available in the ClearCase network. This will happen as a result of improper removal of the VOB storage.



Cause 3


The server storage location (network share or export) is not available. When mounting a VOB, the location that the VOB is stored must be accessible from the host that you are trying to mount the VOB.


Cause 4

If the VOB is not yet tagged in the primary region of the VOB server. This is applicable to environments that have multiple registry regions.


Resolving the problem


The cleartool mkvob command must process several operations during execution, and the time to completion will vary in different ClearCase networks:

    • Creates a VOB storage directory at a specified path or in a VOB server storage location created with cleartool mkstgloc.
    • Creates a VOB tag (cleartool mktag) with which the VOB is accessed by users.
    • Places entries in the network's VOB registries (cleartool register); use the cleartool lsvob command to list registered VOBs.
    • Starts a VOB server process (cleartool mount) on the named host.

Note: The below solutions are paired with the above causes, for example, solution 1 is for cause 1 above, and so forth.

To verify if the error is benign and was generated as a result of an incomplete cleartool mkvob operation, run the following:

    • cleartool lsvob \<VOB-tag>
    • cleartool mount \<VOB-tag>
Note: Replace \<VOB-tag> with the actual \VOB-tag, for example, \MyVOB.

The error message should not get reported during the cleartool mount execution.



Solution 2

You will need to verify that there are no invalid entries in the ClearCase registry using rgy_check -vobs.

Note: It is advised that you run the rgy_check utility periodically to diagnose problems and clean up obsolete or stranded registry entries. For more information on this command, run cleartool man rgy_check from command line.

If you get the following message when you run rgy_check -vobs:

The VOB storage at <VOB Storage> has a malformed or missing replica_uuid file.


    You need to run:
    • cleartool unregister -vob -uuid <UUID from the error>
    • cleartool rmtag -vob <VOB-tag in the error>

    Refer to technote 1134700 for more information on this issue.



Solution 3

The ClearCase server storage location, the network share on Windows or an export on UNIX or Linux must be accessible from the host you are trying to mount the VOB.

A network share is a location on a computer network, typically allowing multiple users on the same network to have a centralized space for storing and accessing data. You can review this Microsoft article 301198 for more information.

An export on UNIX or Linux is a way to make a local resource available for mounting by remote systems. For more information, you should refer to the man page for export or share. Otherwise, consult your systems administrator.

To verify that you can access the share from the host that you are trying to mount the VOB:
    1. Run cleartool lsvob \<VOB-tag>
    2. The global path reported in the output is the path you need access to from the host you are trying to mount the VOB, for example:
      • Windows: Global path: \\hostname\vobstore\MyVOB.vbs
      • UNIX or Linux: Global path: /net/hostname/vobstore/my_vob.vbs
    3. Try to list the VOB storage directories contents:
      • Windows: dir \\hostname\vobstore\MyVOB.vbs
      • UNIX or Linux: ls /net/hostname/vobstore/my_vob.vbs
    4. If you get an Access Denied (or permissions error), refer to the Access to VOB Data and Metadata in the IBM Rational ClearCase Administrator's Guide, under the section VOB Administration. Also see, Troubleshooting VOB Access Problems. If you need a soft copy, the cc_admin.pdf is available on any host with ClearCase installed located by default in:
      • UNIX or Linux: /opt/rational/clearcase/doc/books
      • Windows: C:\Program Files\Rational\ClearCase\doc\Books


Solution 4

Verify if the \VOB-tag is registered in the primary region of the ClearCase VOB server:

cleartool lsvob \<VOB-tag>

Note: If you are not at (or physically logged into) the VOB server host, you will need to issue the -host switch, cleartool lsvob \<VOB-tag> -host <VOB-server>.

Refer to the IBM Rational ClearCase Administrator's Guide, under the section Registry Regions for information on managing multiple registry regions. If you need a soft copy, the cc_admin.pdf is available on any host with ClearCase installed located by default in:
    • UNIX or Linux: /opt/rational/clearcase/doc/books
    • Windows: C:\Program Files\Rational\ClearCase\doc\Books


Document information

More support for: Rational ClearCase
VOB

Software version: 2003.06.00

Operating system(s): AIX, HP-UX, IRIX, Linux, Solaris, Windows

Reference #: 1228175

Modified date: 27 October 2010