versw man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

versw(8)							      versw(8)

NAME
       versw - Manages the transition from the active version of the operating
       system to a new version

SYNOPSIS
       /usr/sbin/versw [option...]

OPTIONS
       Checks whether a 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 a version switch is not pending (the active and new versions are
       the  same).   Sets the versw_transition attribute in the generic kernel
       subsystem of the member-specific /etc/sysconfigtab file	to  0  (zero).
       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  ver‐
       sion  switch state is 0.	 Unconditionally sets the active version ID to
       the new version ID in  the generic kernel subsystem of the  member-spe‐
       cific /etc/sysconfigtab file and in the member's running kernel.	 Spec‐
       ifies a directory path to an  alternative  /etc/sysconfigtab  file.  By
       default,	 the member-specific /etc/sysconfigtab file is used.  Sets the
       new version ID in the generic kernel subsystem of  the  member-specific
       /etc/sysconfigtab  file	and in the running kernel. The installation of
       the Tru64 UNIX operating system and the cluster software	 automatically
       sets  these values.  Sets the versw_transition attribute in the generic
       kernel subsystem of the member-specific /etc/sysconfigtab  file	to  1.
       When  run with the -switch option, the versw utility automatically sets
       this attribute.	Attempts to set the active version ID to the new  ver‐
       sion  ID on a standalone system or on all currently active cluster mem‐
       bers.  When you install Tru64 UNIX on a standalone system, the  instal‐
       lation  procedure concludes by using a versw -switch command to set the
       active version to the new version. When you complete a cluster  rolling
       upgrade,	 by  issuing  a clu_upgrade -switch, clu_upgrade automatically
       issues the versw -switch command to set the  active  and	 new  versions
       consistently  on all cluster members.  Checks the return value from the
       versw() function. See versw(3) for a description of this function.

DESCRIPTION
       The versw utility manages the transition from the active version of the
       operating  system  to a new version. You must be root to use this util‐
       ity.

       The active and new  operating  system  versions	are  recorded  in  the
       act_vers_low, act_vers_high, new_vers_low, and new_vers_high attributes
       in the generic kernel subsystem of the /etc/sysconfigtab file (or  each
       member's	 /etc/sysconfigtab  file in a cluster). 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.   At  installation	 time, the new version ID must
       always be higher than the active version ID.

       When installation completes on a standalone system, the active and  new
       versions will be identical. 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.

       During a rolling upgrade of a cluster, the active and new versions will
       not be the same on each cluster member until the rolling	 upgrade  com‐
       pletes.	 When  you  conclude  the  rolling  upgrade,  by  issuing  the
       clu_upgrade -switch command, clu_upgrade automatically issues the versw
       -switch command to set the active and new versions equal on all cluster
       members. After all cluster members have	been  rebooted	with  the  new
       active  version,	 all  features of the new operating system and cluster
       software are enabled across all cluster members.

       When called by the clu_upgrade -switch command in a cluster, the	 versw
       utility	performs the following operations: Compares the active and new
       version IDs in each member's running kernel. If	new  versions  of  the
       operating system and cluster software have been installed, the new ver‐
       sion ID will be higher than the active version  ID.   If	 the  IDs  are
       identical  or  the  new version ID is less than that of the active ver‐
       sion, the utility issues a warning and exits.  Checks  that  each  mem‐
       ber's  /etc/sysconfigtab file is accessible. If not, the utility issues
       a warning and exits.  Checks that all members have booted with the  new
       version.	 If  not,  the	utility	 issues	 a warning and you must either
       reboot  the  members  or	 run  versw  -forcesw  to  continue.  Use  the
       clu_get_info command to determine which systems are running at or below
       their installed version.	 Checks for blocking conditions. If any exist,
       the  the	 versw	utility	 prints an error message and exits. If the new
       software has introduced a change or enhancement	that  is  incompatible
       with  the active version, the component 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 pro‐
       vide  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	direc‐
       tions in these files to proceed with the upgrade. Moving these files to
       another directory removes the blocking condition.   Determines  whether
       all running members are capable of the switch this member is proposing.
       If not, it displays an error  and  exits.   Sets	 the  versw_transition
       attribute in the generic kernel subsystem in each member's /etc/syscon‐
       figtab file (and in each member's running kernel) to 1.	Requests  that
       the  connection manager stop new members from joining the cluster until
       the completion of the version switch.  Sets the active version  to  the
       new  version  in	 the generic kernel subsystem of 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 mem‐
       bers  clear  their  versw_transition  attributes	 and   restore	 their
       /etc/sysconfigtab  copies.   Sets the versw_transition attribute in the
       generic kernel subsubsystem of each member's /etc/sysconfigtab file  to
       0.  Sends a clusterwide clu.versw EVM event to signify that the version
       switch was successful.

EXAMPLE
       The following example shows how a script might  use  the	 versw	-check
       command to enable new features on a cluster member that has completed a
       version switch: #!/usr/bin/ksh -p #	 Script example usage of versw
       command switch # if versw -check ; then
	       echo  "Enable  new  version features" else    echo "Disable new
       version features" fi

       The following command shows the output of the versw -dump command on  a
       cluster that has completed a roll: # versw -dump Old version    = ( 0 ,
       0 ) Active version = ( 14000800009a1700 , 3b88 )	 New  version	  =  (
       14000800009a1700	 ,  3b88 ) Version transition state = 0 Version switch
       state = 0

FILES
       Specifies the command path.  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, /etc/syscon‐
       figtab  is a context-dependent symbolic link (CDSL) that references the
       sysconfigtab file for a member.	Rolling	 upgrade  blocking  conditions
       directory.

SEE ALSO
       Functions: versw(3), clu_is_member(3), clu_get_info(3)

								      versw(8)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net