 |
Index for
Section 8 |
|
 |
Alphabetical
listing for V |
|
 |
Bottom of
page |
|
versw(8)
NAME
versw - Manages the transition of the active version of the operating
system to a new version
SYNOPSIS
/usr/sbin/versw [option...]
OPTIONS
-check
Checks if version switch is pending. The versw utility returns a 1 if a
version switch is pending (the active and new versions differ), a 0 if
one is not (the active and new versions are the same).
-clrtrans
Sets the versw_transition kernel attribute in the /etc/sysconfigtab
file to 0 (zero).
-dump
Prints the old (previously active), active, and new version IDs, the
version transition state, and the version switch state. If a version
switch is in progress, the version switch state is the member ID of the
cluster member running the versw utility plus 100. Otherwise, the
version switch state is 0.
-forcesw
Unconditionally sets the active version ID to the new version ID in the
/etc/sysconfigtab file and in the running kernel.
-mount path
Specifies a directory path to an alternative /etc/sysconfigtab file:
<path>/etc/sysconfigtab. By default, the /etc/sysconfigtab file is
used.
-setnew
Sets the new version ID in the /etc/sysconfigtab file and in the
running kernel. The installation of the Tru64 UNIX operating system and
the cluster software automatically sets this value. The new version ID
must always be higher than the active version ID.
-settrans
Sets the versw_transition kernel attribute in the /etc/sysconfigtab
file to 1. When run with the -switch option, the versw utility
automatically sets this attribute.
-switch
Attempts to set the active version ID to the new version ID on a
standalone system or on all currently active cluster members.
-versw_test
Check the return value from the versw() function. See the versw
reference page for a description of this function.
DESCRIPTION
The versw utility manages the transition of the active version of the
operating system to a new version. On a standalone system, in which the
active and new versions should always be the same, the versw utility runs
automatically as part of the installation procedure. In a cluster, the
active and new versions may differ, primarily while the cluster is in the
midst of a rolling upgrade. To complete a cluster rolling upgrade, you must
manually run the versw utility with the -switch option. The utility sets
the active version to the new version. After all cluster members have been
rebooted with the new active version, all features of the new operating
system can be enabled across all cluster members.
You must be root to use this utility.
The active and new operating system versions are recorded in the act_vers
and new_vers kernel attributes, respectively, in the /etc/sysconfigtab
file.
When you install a new version of the Tru64 UNIX operating system or
cluster software, the installation procedure automatically issues the versw
-setnew command to establish the new version ID in the /etc/sysconfigtab
file and in the running kernel. When you install Tru64 UNIX on a
standalone system, the installation procedure concludes by using a versw
-switch command to set the active version to the new version. When you
install Tru64 UNIX on a system on which cluster software is also installed
(for instance, as the first step of a cluster rolling upgrade), the
installation procedure informs you that you must manually issue the versw
-switch command in the cluster at the completion of the rolling upgrade.
When run with the -switch option in a cluster, the versw utility performs
the following operations:
1. Compares the active and new version IDs on each running kernel. If
they are identical or the new version ID is less than that of the
active version, the utility issues a message and exits.
2. Sets the versw_transition kernel attribute in the /etc/sysconfigtab
file to 1.
3. Determines whether all cluster members are up. If they are not, the
utility prints a warning message. You can choose to continue or exit
at this point.
4. Determines whether all running members are capable of the switch this
member is proposing. If not, it displays an error and exits.
5. Checks for any blocking conditions. If any exist, the utility prints
an error message and exits. If an operating system component has
introduces some change or enhancement in the new version that is
incompatible with the active version, it sets up a condition that
blocks the rolling upgrade. Such incompatibilities usually involve
changes to configuration files, on-disk structures, or local or remote
interface protocols. Operating system components establish a blocking
condition by placing files in the /var/adm/versw directory. These
text files provide instructions for manually restoring compatibility
between installed and new versions: for instance, by editing a
configuration file or running a data conversion script. You must
follow the directions in these files to proceed with the rolling
upgrade. Moving these files to another directory removes the blocking
condition.
6. Requests the connection manager to disallow new members from joining
the cluster until the completion of the version switch.
7. Sets the active version to the new version in each cluster member's
/etc/sysconfigtab file. Note that, if a member goes down during this
stage, the versw utility exits with an error message. All running
members clear their transition options and restore their
/etc/sysconfigtab copies.
8. Sets the versw_transition kernel attribute in the /etc/sysconfigtab
file to 0.
FILES
/usr/sbin/versw
Specifies the command path.
<path>/etc/sysconfigtab
Configurable subsystem definition database file, as specified to the
-mount option of the versw utility. By default, the /etc/sysconfigtab
file is used. In a cluster, there is an /etc/sysconfigtab file for each
member.
/var/adm/versw
Rolling upgrade blocking conditions directory.
SEE ALSO
Functions: versw(3), clu_is_member(3), clu_get_info(3)
|
Index for
Section 8 |
|
|
Alphabetical
listing for V |
|
 |
Top of
page |
|