Setting up ACLs on VOBs after upgrading to 8.0.1

Complete administrative tasks required to enable ACLs on VOBs and ClearCase® clients upgraded to version 8.0.1. Start by reformatting VOBs into the new schema, if required. Then, define ACLs, test them out in a limited deployment, and finally enable them for users.

Before you begin

Back up ClearCase
Before upgrading, back up the ClearCase environment. For instructions, see Back up environment resources. During back up, make sure you save the vob_scrubber_params.template file if you have customized it. In ClearCase version 8.0.1, the template was updated to add support for new events. After upgrading to ClearCase 8.0.1, merge the customized content from the back up file into the new template.
Check available disk space
VOBs at schema 54 must be reformatted to schema 80 before you can enable ACLs on VOB objects. Reformatting requires that the VOB storage database has enough free disk space to hold two copies of the VOB database. Before upgrading, verify that the VOB has enough space for reformatting. To check disk space, use the cleartool command cleartool space -vob <vobtag> and check the VOB database line. You can also generate a space report with this cleartool command: cleartool space -vob -generate. Before reformatting, review VOB administration in the ClearCase Administration documentation and the reformatvob reference page.
Check VOB health
For details, see Check VOB health before enabling ACLs.

About this task

A VOB that has been upgraded to version 8.0.1 from a previous ClearCase version, must meet these requirements to support ACL authorization of VOB objects.
  • VOB format must be schema 80
  • VOB feature level must be feature level 8.
  • ACLs must be explicitly enabled on the VOB.

If a schema upgrade is required, the VOB must be offline during reformatting. After the reformat completes, you can return the VOB to service until you are ready to complete the process to enable and enforce ACLs.

You can upgrade ClearCase clients to version 8.0.1 and use them with ClearCase version 8.0 servers while you are working on the server upgrade. After a ClearCase server is upgraded to version 8.0.1 and actively enforcing ACLs, that server is only compatible with ClearCase client version 8.0.1 or later.

Procedure

  1. Back up environment resources.
  2. Upgrade the ClearCase VOB server and client software to version 8.0.1.
  3. If the VOB is at schema 54, take the VOB offline and reformat it to schema 80.
  4. Raise the VOB feature level to feature level 8.
  5. Use the protectvob cleartool command to enable support for ACL authorization of VOB objects.
  6. Define ACLs for the VOB and test them in a limited deployment. See ACL authorization.
  7. Enable ACLs for all users.