Troubleshooting
Problem
This technote explains how to resolve the error, rgy_check: Error: This VOB object is stranded (it has no tags in any region), when running the IBM® Rational® ClearCase® utility rgy_check.
Symptom
Running the rgy_check utility returns the following output.
rgy_check: Error: This VOB object is stranded (it has no tags in any region):
-hostname = "host1"
-local_path = "d:\ClearCase_Storage\usr_name_tut\input.vob"
-vob_replica = "d8b54141.3b1011d4.9719.00:60:08:cc:c1:65"
-vob_family = "d8b54140.3b1011d4.9719.00:60:08:cc:c1:65"
Note: The rgy_check utility is located in <CLEARCASE HOME>/bin or /opt/rational/clearcase/etc/.
Similar errors like the following may be reported if the issue is related to a View:
The rgy_check utility reports the following error:
# /opt/rational/clearcase/etc/rgy_check -views
rgy_check: Error: This view object is stranded (it has no tags in any region):
-hostname = "host1"
-local_path = "/views/dev_debug.vws"
-owner = "vobadm"
-view_uuid = "b86d5c88.d1cf11db.8fa7.00:01:83:44:97:72"
-attributes = "sumview"
rgy_check: Error: This view object is stranded (it has no tags in any region):
-hostname = "host1"
-local_path = "/views/dev.vws"
-owner = "vobadm"
-view_uuid = "56ad2448.d1c811db.8fa3.00:01:83:44:97:72"
-attributes = "sumview"
rgy_check: Error: 2 total registry errors/inconsistencies detected.
Email notification from the nightly scheduled job, Daily View Space, reports the following error:
Job 5 "Daily View Space" (16091) Completed: OK but with messages:
"cleartool: Error: Storage directory
"/views/dev.vws" does not exist.
cleartool: Error: Storage directory
"/views/dev_debug.vws" does not exist.
Note: Daily View Space is a default job in the ClearCase Schedule.
Cause
The VOB has been removed, but the vob_object (uuid) entry still exists in the ClearCase registry.
In the case of a view, it may have been removed improperly , which left a stranded reference to it in the ClearCase registry.
Resolving The Problem
Use the cleartool unregister command to manually remove the VOB or View references from the ClearCase Registry.
For a VOB:
Example:
cleartool unregister -vob -uuid d8b54141.3b1011d4.9719.00:60:08:cc:c1:65
For a View:
Example:
cleartool unregister -view -uuid b86d5c88.d1cf11db.8fa7.00:01:83:44:97:72
* There is a possibility that the same name is used for a newer vob.
Here is an example to make sure you are unregistering the older one
from the rgy_check output.
bash-3.00$ /apps/IBM/RationalSDLC/clearcase/sol_x86/etc/rgy_check -vobs
rgy_check: Error: This VOB object is stranded (it has no tags
in any region):
-hostname = "per-clearcase.cts.cubic.cub"
-local_path = "/apps/ccase_storage/vobs/MREF_Package.vbs"
-vob_replica = "e1dbd9ef.f04a11de.81a6.00:01:3b:04:1a:07"
-vob_family = "e1dbd9eb.f04a11de.81a6.00:01:3b:04:1a:07"
bash-3.00$ cleartool dump -l vob:/vobs/MREF_Package | more
/vobs/MREF_Package
oid=760c4649.792111d6.a0d6.00:01:80:e9:04:8b dbid=23486 (0x5bbe)
mtype=versioned object base
master replica dbid=1
flags: predefined, replicated, pc_line_count, unrestricted
this replica dbid=1
hostname="per-clearcase"
storage dir="/apps/ccase_storage/vobs/MREF_Package.vbs"
Just compare the vob_replica oid from the rgy_check output to the oid in the output of the dump
and if they are different you can safely unregister the one from the rgy_check output.
Review the IBM Rational ClearCase Command Reference Guide on the topic of rgy_check (cleartool man rgy_check) as well as the topic of unregister (cleartool man unregister) for more information.
Also refer to technote 1134700 for more information about Manually removing a VOB or View from the ClearCase registry whose storage has been deleted.
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21146427