Raises the feature level of a VOB
Product | Command Type |
---|---|
ClearCase | cleartool subcommand |
ClearCase LT | cleartool subcommand |
Platform |
---|
UNIX |
Windows |
Analyze and possibly raise the feature level of a VOB on the local host:
Raise the feature level of a MultiSite replica:
Raise the feature level of a MultiSite VOB family:
The chflevel command raises the feature level of a VOB. A feature level is an integer that is incremented at each ClearCase and ClearCase LT release that introduces features that affect VOBs created in an earlier ClearCase or ClearCase LT release. The purpose of raising feature levels is to make all features in a release available to users of the VOB that was created in the earlier release.
Every ClearCase and ClearCase LT release is associated with a feature level. Read the Release Notes for your product for information on which releases correspond to which feature levels.
To raise the feature level of a VOB, use the chflevel command with the -auto option at the host running the VOB server.
In some circumstances-for example, when you describe a VOB-you will notice MultiSite terms such as VOB family. This kind of information is of interest only to MultiSite users.
Raising the feature level of a MultiSite VOB prevents features from being used at one replica that are not meaningful to other replicas that are at a lower feature level.Thus, feature level control makes it unnecessary to upgrade all replicas in a VOB family to a new ClearCase release simultaneously.
Every VOB replica has a feature level, and every VOB family has a feature level:
The replica feature level is the feature level that is equal to or less than the feature level of the ClearCase release installed on the host where the replica's server runs.
The family feature level is the feature level that is equal to or less than the lowest replica feature level found among members of the VOB family.
You must raise the replica feature levels before raising the VOB family feature level. After raising the feature level of replicas in the VOB family, raise the VOB family feature level to the lowest feature level of any replica in the family.
For more information, see the Administrator's Guide for Rational ClearCase MultiSite.
Identities: You must have one of the following identities:
VOB owner
root (UNIX)
Member of the ClearCase group (ClearCase on Windows)
Local administrator of the ClearCase LT server host (ClearCase LT on Windows)
Locks: An error occurs if one or more of these objects are locked: VOB, VOB replica.
Mastership: (Replicated VOBs only) A replica whose feature level is to be raised must master its own replica object. The family feature level can be raised only through the replica that masters the VOB object.
Other: (Replicated VOBs only) If the current family feature level is less than or equal to 1, the first replica whose feature level is raised must be the replica that masters the VOB object.
Raise the feature levels of any unreplicated VOBS running on the local host without prompting for confirmation and list the feature levels of any replicated VOBs on this host.
cmd-context chflevel -force -auto
Raise the feature level of the replica rome to 2.
cmd-context chflevel -replica 2 replica:rome
Raise the feature level of the VOB family \tmp\testvob to 2.
cmd-context chflevel -family 2 vob:\tmp\testvob
Raise the family feature level of the current VOB to 2. Override the check to ensure that family feature level 2 is no higher than the lowest replica feature level found among replicas in this VOB family.
cmd-context chflevel -force -override -family 2 vob:.
chmaster, describe, Release Notes for your product
Feedback on the documentation in this site? We welcome any comments!
Copyright © 2001 by Rational Software Corporation. All rights reserved. |