Soft - is your software and documentation
A. 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. The Release Notes for your product provide information about which releases correspond to which feature levels.
You must have one of the following identities:
1. VOB owner
2. Root (UNIX)
3. Member of the ClearCase administrators group (ClearCase on Windows)
4. Local administrator of the ClearCase LT server host (ClearCase LT on Windows)
An error occurs if one or more of these objects are locked: VOB, VOB replica.
(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.
(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.
C. Raising the feature levels of VOBs. 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 levels of MultiSite VOBs. 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.
D. When specified with the –auto option, this option raises the feature levels of unreplicated VOBs without prompting for confirmation.
E. When specified with the –family option, this option forces MultiSite replicas on the local host to the feature level specified by –family without prompting. This option may fail to force the family feature level unless you also specify –override.
F. Lists each VOB on the local host, annotated with its replication state, family feature level, and replica feature level. For unreplicated VOBs only, this option offers to raise the feature levels. To raise the feature levels of replicated VOBs, use the command synopses shown for MultiSite.
G. A numerical value for the feature level to be raised to: 5 = ClearCase v7, 4 = ClearCase 2003-05-00, v6, 3 = ClearCase 2002-05-00 (v5), 2 = ClearCase v4.1, 1 = ClearCase v3.2
H. Overrides the check that ensures that the feature level specified by –family is less than or equal to the lowest feature level found among replicas in the family. When specified with the –force option, forcibly raises the VOB family feature level without prompting. When specified without –force, –override lists replicas that are below the specified family feature level.
I. Raises the feature level of the specified MultiSite VOB family
J. VOB tag of the VOB.
With the –auto option it will automatically raise the feature level for the VOB based on the ClearCase version running on the local host. Feature level 5 = ClearCase v7, 4= ClearCase v2003.06.00 (v6), 3 = ClearCase v2002-05-00 and 2 = ClearCase v4
cleartool chflevel -auto
If you use the force option the changes will be made automatically
cleartool chflevel -force –auto
To raise the feature level of VOB replica Sydney to use the features available in ClearCase v7 use:
cleartool chflevel –replica 5 replica:Sydney
To raise the feature level of the VOB family of the samecs VOB to use the features available in ClearCase v7 use: Note: Unless you use the –overide option all the replicas of the samecs VOB must be at feature level 5 before you can change the family level.
cleartool chflevel –family 5 vob:/vobs/samecs
Raise the family feature level of the samecs VOB to level 5 overriding any checks to ensure all the replicas in the family are already at level 5.
cleartool chflevel –force
–override –family 5 vob:/vobs/samecs