IBM Support

How to remove a VOB or View from the ClearCase registry whose storage was deleted

Question & Answer


Question

How do you clean the IBM Rational ClearCase registry entries related to VOBs or Views whose storage was deleted on Windows, UNIX or Linux?

Cause

You see one of the following two errors. Which one depends on whether you try to unregister a view or a VOB.


VOB




%>cleartool unregister -vob \\host1\ccstg_e\VOBs\test.vbs

cleartool: Error: Unable to access "\\host1\ccstg_e\VOBs\test.vbs": No such file or directory.

cleartool: Error: Versioned object base not found: "\\host1\ccstg_e\VOBs\test.vbs".

cleartool: Error: Attempt to get location information about "\\host1\ccstg_e\VOBs\test.vbs" failed: No such file or directory.


View




%>cleartool unregister -view \\host1\ccstg_e\views\test.vws

cleartool: Error: Unable to open file "\\host1\ccstg_e\views\test.vws": No such file or directory.

cleartool: Error: \\host1\ccstg_e\views\test.vws is not a view: No such file or directory

cleartool: Error: Attempt to get location information about "\\host1\ccstg_e\views\test.vws" failed: ClearCase object not found.



In both cases, the storage directory tree, .vbs or .vws, was removed from the file system through operating system commands. Rational ClearCase cleartool sub-commands, rmvob or rmview, did not remove the storage directory tree

Answer

When the VOB or View storage area was deleted, the UUID must be
used to remove the registry entry.

The steps below will provide examples of the commands to use for either a VOB or view. Use the example for whichever object (VOB or view) you were experiencing the problem with.

  1. Determine a UUID of the VOB or View:

    VOB example:
    cleartool lsvob -long <vob-tag>

    Example:

    %>cleartool lsvob -long \test
    Tag: \test
    Global path: \\host1\ccstg_e\VOBs\test.vbs
    Server host: host1
    Access: private
    Mount options:
    Region: dev
    Active: NO
    Vob tag replica uuid: d6ca911d.229a41bb.942b.fd:ed:f2:bb:5c:f8
    Vob on host: host1
    Vob server access path: e:\ClearCase_Storage\VOBs\test.vbs
    Vob family uuid: a5a43471.f3e24c0e.96be.42:91:86:0e:6d:c9
    Vob replica uuid: d6ca911d.229a41bb.942b.fd:ed:f2:bb:5c:f8



    VIEW example: cleartool lsview -long <view-tag>

    Example:

    %>cleartool lsview -long test
    Tag: test
    Global path: \\host1\ccstg_e\views\test.vws
    Server host: host1
    Region: dev
    Active: NO
    View tag uuid:c8b329ed.60814357.9806.26:55:85:75:e2:bf
    View on host: host1
    View server access path: e:\ClearCase_Storage\views\test.vws
    View uuid: c8b329ed.60814357.9806.26:55:85:75:e2:bf
    View owner: DOM1\jdoe


  2. Remove the registry entry using the -uuid option with unregister:

    VOB example:
    cleartool unregister -vob -uuid <uuid>

    Example:

    %>cleartool unregister -vob -uuid 6ca911d.229a41bb.942b.fd:ed:f2:bb:5c:f8


    If there are no errors, the command does not return text.


    VIEW example: cleartool unregister -view -uuid <uuid>
    Example:

    %>cleartool unregister -view -uuid c8b329ed.60814357.9806.26:55:85:75:e2:bf


    If there are no errors, the command does not return text.


  3. Remove the tag entry using the cleartool rmtag command.

    VOB example: cleartool rmtag -vob <vob-tag>

    Example:

    %>cleartool rmtag -vob \test


    If there are no errors, the command does not return text.

    VIEW example: cleartool rmtag -view <view-tag>

    Example:

    %>cleartool rmtag -view test

    If there are no errors, the command does not return text.

  4. Run cleartool rmview -force -all -uuid <view uuid>

    Example:

    %>cleartool rmview -force -all -uuid dc308c46.353c11e0.8e44.00:11:25:27:b8:94
    Removed references to view "dc308c46.353c11e0.8e44.00:11:25:27:b8:94" from VOB "hostname:vob.vbs".

Internal Use Only




Added step 4 per the following update:
It may be worth adding a step to issue the command cleartool rmview -force -all - uuid <view uuid> after unregistering and removing the tag.

Issues have been seen in ucm/cq integration where a clearquest record that is still referencing the view will not allow the user to move to a closed state without this last step.
-Leigh Haith
Nov 10, 2009

Placing the following Web feedback here pending validation. -denise Aug 6, 2009
"The problem can also occur when removing a view with the cleartool rmview subcommand. After this it may happen that you have to manually remove the the storage directory tree (.vws) from the file system using operating system commands."

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU004","label":"Hybrid Cloud"},"Component":"ClearCase Registry","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;7.1.1;7.1.2;8.0;8.0.1","Edition":""}]

Document Information

Modified date:
19 February 2019

UID

swg21134700