chflevel

Raises the feature level of a VOB

APPLICABILITY

ClearCase (cleartool subcommand)

UNIX and Windows

SYNOPSIS

• Analyze and possibly raise the feature level of a VOB on the local host:

  chflevel [-f·orce] -auto

• Raise the feature level of a MultiSite replica:

  chflevel -rep·lica feature-level replica-selector

• Raise the feature level of a MultiSite VOB family:

  chflevel [-f·orce] [-ove·rride] -fam·ily feature-level vob-selector

DESCRIPTION

The chflevel command raises the feature level of a VOB. A feature level is an integer that is incremented at each ClearCase release that introduces features that affect VOBs created in an earlier ClearCase release. The purpose of raising feature levels is to make all features in a ClearCase release available to users of the VOB that was created in the earlier release.

Every ClearCase release is associated with a feature level. Read ClearCase and MultiSite Release Notes for information on which releases correspond to which feature levels.

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. ClearCase architecture supports the easy migration of VOBs to MultiSite replicated VOBs, which is why you occasionally encounter that terminology.

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.

For more information, see ClearCase Feature Levels in ClearCase MultiSite Manual.

PERMISSIONS AND LOCKS

Permissions Checking: You must be the VOB owner or a member of the ClearCase group. See the permissions reference page.

Locks: chflevel fails if the VOB or VOB replica is locked.

Mastership: 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 restrictions: (MultiSite) 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.

OPTIONS AND ARGUMENTS

-aut·o
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. You must raise the feature levels of replicated VOBs using the command synopses for MultiSite.

-f·orce
When specified with the -auto option, this option raises the feature levels of unreplicated VOBs without prompting for confirmation.

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.

-rep·lica feature-level replica-selector

Raises the feature level of the specified MultiSite replica.

-ove·rride

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.

NOTE: Do not use the -force and -override options together unless you are certain that all replicas are at the feature level specified by -family.

-fam·ily feature-level vob-selector

Raises the feature level of the specified MultiSite VOB family.

EXAMPLES

• Raise the feature levels of 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:.

SEE ALSO

chmaster, describe