Phil for Humanity Phil for Humanity
A Guide for the Survival of Humankind and Helping the World, Society, and Yourself.



ClearCase Support: How to Delete a VOB Replica


These are the procedures for turning off a VOB replica. This is also known as VOB decommission or obsolete VOB replica.
  1. The first step is to stop all synchronization exports to the VOB replica that you are decommissioning. I recommend finding all of these replicas by looking up which replicas this obsolete VOB is exporting to, then contacting the ClearCase administrators of those replicas. Skip this step if the VOB is not MultiSited.
  2. Find all checked out elements in the local VOB replica.

    cleartool lsco –all VOB_TAG
  3. You will have to checkin or uncheckout each checkedout element found in the previous step, and that may require root access to log in as the users that have the checkedout elements.

  4. Change mastership of each local object to the master site (or the new master site). You will need to be logged in as VOB owner or root to do this step. Skip this step if the VOB is not MultiSited. First, find the master replica name, then change mastership.

    cleartool describe vob:VOB_TAG

    cleartool setview VIEW_NAME
    cd VOB_TAG
    multitool chmaster –vob . –all –long MASTER_REPLICA_NAME

  5. Push the final synchronization export of the obsolete VOB replica. You should wait until the remote master site imports and confirms these changes. Skip this step if the VOB is not MultiSited.

    multitool syncreplica -export -fship replica:MASTER_REPLICA_NAME@vob:VOB_TAG
  6. Next, turn off all local synchronization exports and imports for this obsolete VOB replica. Skip this step if the VOB is not MultiSited.
  7. Remove the local obsolete VOB replica. Skip this step if the VOB is not MultiSited.

    multitool rmreplica replica:OBSOLETE_REPLICA_NAME@vob:VOB_TAG
  8. The master site should rename the deleted replica. Skip this step if the VOB is not MultiSited.

    multitool rename replica:OBSOLETE_REPLICA_NAME@vob:VOB_TAG replica:OBSOLETE_REPLICA_NAME.deleted@vob:VOB_TAG
  9. It is strongly recommended that the VOB is backed up in permanent storage, such as tape or DVDs.
  10. It is strongly recommended that the VOB is backed up in permanent storage, such as tape or DVDs.
  11. Remove the VOB TAG.

    cleartool rmtag –vob –password REGISTRY_PASSWORD VOB_TAG
  12. Next, un-register the VOB TAG.

    cleartool unreg –vob VOB_STORAGE_DIRECTORY
  13. Finally, delete the obsolete VOB storage directory.
You are done deleting a VOB replica.

by Phil for Humanity
on 20081022

Related Articles
 » ClearCase Support: How to Synchronize 2 VOBs
 » ClearCase Support: How to Replicate a VOB
 » ClearCase Support: How to Backup a VOB