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



ClearCase Support: How to Create a ClearCase VOB


Here are the procedures for creating a VOB in ClearCase on UNIX.
  1. Log in as root or your VOB administration account.
  2. Check the disk space on all of your VOB storage directory partitions on all of your VOB servers. I recommend using the VOB storage directory partition with the most available disk space.
  3. Go to the partition with the most available disk space. Your account must have write access to this partition.
  4. Create a VOB using this command.

    cleartool mkvob –tag VOB_NAME -public –password REGISTRY_PASSWORD
    -host VOB_SERVER_NAME -hpath VOB_PATH –gpath VOB_PATH VOB_PATH

    The VOB_NAME is a unique VOB name, such as "/vob/test". You may want to run "cleartool lsvob" to list all existing VOBs to make sure that a VOB with the same name does not already exist.

    The REGISTRY_PASSWORD is the ClearCase registry password that was set when the ClearCase environment was first configured. This ensures only administrators can create new VOBs.

    The VOB_SERVER_NAME is the name of the VOB server that the VOB storage directory partition resides on.

    Finally, the VOB_PATH is the new VOB storage directory that you want created, such as "/vob_partition/test" if you are creating a VOB called "/vob/test/".
  5. Next, inspect the new VOB’s permissions using this command:

    cleartool describe vob:VOB_NAME

    For example:

    cleartool describe vob:/vob/test

  6. Change the new VOB’s owner and group permissions. Note that most of these arguments below are optional.

    cleartool protectvob -force -chown VOB_OWNER -chgrp PRIMARY_GROUP
    -delete_group GROUP1,GROUP2,... -add_group SECONDARY_GROUP1, SECONDARY_GROUP2,... VOB_PATH

    The VOB_OWNER should be your ClearCase administration account.

    The PRIMARY_GROUP is the primary UNIX group that you want to own the VOB. This is typically the same primary group that the VOB’s users belong to.

    Next, GROUP# arguments are the secondary groups that you want to remove, such as any administration groups.

    The SECONDARY_GROUP# arguments are the secondary groups that you want to add to the VOB for access for secondary users’ groups.

    Finally, the VOB_PATH is the new VOB storage directory that you created previously.
  7. Change the permissions of the data in the VOB using the "cleartool protect …" command. See this webpage for more information on this command.
  8. If the VOB needs to be accessed in multiple regions, such as Windows, you will need to register the newly created UNIX VOB on Windows too. You can use the Region Synchronizer in the ClearCase Home Base to do this step for Windows.
  9. Finally, setup the VOB with whatever triggers or directory structure your users may require.
Don't forget to tell your users that the new VOB is available to start using.

by Phil B.

Related Articles
 » ClearCase Support: How to Make a VOB
 » ClearCase Support: How to Make a ClearCase Branch
 » ClearCase Support: How to Make a ClearCase Label