unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



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

  -check
      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).

  -clrtrans
      Sets the versw_transition	attribute in the generic kernel	subsystem of
      the member-specific /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	ver-
      sion switch state	is 0.

  -forcesw
      Unconditionally sets the active version ID to the	new version ID in
      the generic kernel subsystem of the member-specific /etc/sysconfigtab
      file and in the member's running kernel.

  -mount path
      Specifies	a directory path to an alternative /etc/sysconfigtab file. By
      default, the member-specific /etc/sysconfigtab file is used.

  -setnew
      Sets the new version ID in the generic kernel subsystem of the member-
      specific /etc/sysconfigtab file and in the running kernel. The instal-
      lation of	the Tru64 UNIX operating system	and the	cluster	software
      automatically sets these values.

  -settrans
      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.

  -switch
      Attempts to set the active version ID to the new version ID on a stan-
      dalone system or on all currently	active cluster members.	 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	complete a cluster rolling upgrade, by issu-
      ing a clu_upgrade	-switch, clu_upgrade automatically issues the versw
      -switch command to set the active	and new	versions consistently on all
      cluster members.

  -versw_test
      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 utility.

  The active and new operating system versions are recorded in the act_vers
  and new_vers attributes, respectively, 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 ver-
  sions	will be	identical. When	you install Tru64 UNIX on a standalone sys-
  tem, 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 completes.
  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:

   1.  Compares	the active and new version IDs in each member's	running	ker-
       nel. If new versions of the operating system and	cluster	software have
       been installed, the new version ID will be higher than the active ver-
       sion ID.	 If the	IDs are	identical or the new version ID	is less	than
       that of the active version, the utility issues a	warning	and exits.

   2.  Checks that each	member's /etc/sysconfigtab file	is accessible. If
       not, the	utility	issues a warning and exits.

   3.  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.

   4.  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 provide instructions
       for manually restoring compatibility between installed and new ver-
       sions: 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	upgrade. Moving	these files to another directory
       removes the blocking condition.

   5.  Determines whether all running members are capable of the switch	this
       member is proposing. If not, it displays	an error and exits.

   6.  Sets the	versw_transition attribute in the generic kernel subsystem in
       each member's /etc/sysconfigtab file (and in each member's running
       kernel) to 1.

   7.  Requests	that the connection manager stop new members from joining the
       cluster until the completion of the version switch.

   8.  Sets the	active version to the new version in the generic kernel	sub-
       system 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 members clear	their versw_transition attri-
       butes and restore their /etc/sysconfigtab copies.

   9.  Sets the	versw_transition attribute in the generic kernel subsubsystem
       of each member's	/etc/sysconfigtab file to 0.

   10. 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

  /usr/sbin/versw
      Specifies	the command 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, /etc/sysconfigtab is a context-dependent
      symbolic link (CDSL) that	references the sysconfigtab file for a
      member.

  /var/adm/versw
      Rolling upgrade blocking conditions directory.





SEE ALSO

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