System Management Services 1.2 man pages


	www.sun.com	docs.sun.com \| \| \|

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

System Administration

smsversion(1m)

DESCRIPTION
OPTIONS
OPERANDS
EXTENDED DESCRIPTION
EXAMPLES
EXIT STATUS
FILES
ATTRIBUTES
SEE ALSO

NAME

smsversion - change the active version of SMS to another co-resident version of the SMS software

SYNOPSIS

smsversion new_version

smsversion -t

smsversion -h

DESCRIPTION

smsversion(1M) can be used to switch between two co-installed (and consecutively released) versions of SMS.

smsversion, when invoked with no command-line argument, displays the list of all properly installed versions of SMS on the current system controller. You can pick from that list and smsversion stores a copy of the current configuration environment and then switches all necessary software links needed to activate the new version of the software. smsversion can run with an optional command-line argument specifying the target version for switching.

Once smsversion completes the switch, the target version becomes the active version. To restore the configuration automatically saved by smsversion you must use smsrestore(1M). Your previous configuration is not automatically restored as part of the version switch.

To restore your previous configuration:

Turn off failover and stop SMS before running smsrestore.
Run smsrestore. Note – If you changed your network configuration using smsconfig -m after you created the backup you just restored, you must run smsconfig -m and reboot now.
Otherwise, you can start SMS and turn on failover. For information on manually starting and stopping SMS refer to the System Management Services (SMS) 1.2 Installation Guide and Release Notes for the Sun Fire 15K/12 Systems.

If any errors occur, smsversion writes error messages to /var/sadm/system/logs/smsversion.

OPTIONS

The following options are supported.

-h: Help. Displays usage descriptions.Note – Use alone. Any option specified in addition to -h is ignored.
-t: Displays the current active version of sms and exits.

OPERANDS

The following operands are supported:

version_number: Release number of the target SMS version.

EXTENDED DESCRIPTION

Group Privileges Required

You must have superuser privileges to run this command.

Refer to Chapter 2 in the System Management Services (SMS) 1.2 Administrator Guide for the Sun Fire 15K/12K Systems for more information.

EXAMPLES

Example 1. One Version of SMS Installed

Displays the active version and exits when only one version of SMS is installed.

sc# smsversion -t
1.2

Example 2. Changing the Active Version of SMS

Displays versions of SMS installed on this system controller. Choose the inactive version and perform a version switch.

SMS must be stopped prior to switching versions.

sc# smsversion
smsversion: Active SMS version  1.1 
smsversion: SMS version 1.1 installed
smsversion: SMS version 1.2 installed
Please select from one of the following installed SMS versions.
1) 1.1
2) 1.2
3) Exit
Select version: 2
You have selected SMS Version 1.2

Is this correct? [y,n] y

smsversion: Upgrading SMS from 1.1> to 1.2>.
To move to a different version of SMS an archive of
critical files will be created. What is the name of
the directory or tape device where the archive will be
stored? [/var/tmp][return]

smsversion: Backup configuration file created: /var/tmp/
sms_backup.1.1.cpio
smsversion: Switching to target version 1.2>.
smsversion: New Version 1.2> Active
smsversion: Active SMS version  1.2 >
To use the previous SMS configuration settings type: 
smsrestore /var/tmp/sms_backup.1.1.cpio

NOTE: When switching to another SMS version,
the user must choose (via use of smsrestore) to restore the
configuration settings from the previously active version.

Example 3. Downgrading SMS Versions

Use of the command-line argument to downgrade SMS versions.

sc# smsversion 1.1
smsversion: Active SMS version  1.2 >
You have requested SMS Version 1.1

Is this correct? [y,n] y
smsversion: Downgrading SMS from 1.2> to 1.1>.
smsversion: SMS version 1.1 installed
To move to a different version of SMS an archive of
critical files will be created. What is the name of
the directory or tape device where the archive will be
stored? [/var/tmp][return]

smsversion: Backup configuration file created: /var/tmp/
sms_backup.1.2.cpio
smsversion: Switching to target version 1.1>.
smsversion: New Version 1.1> Active
smsversion: Active SMS version  1.1 >
To restore previous the SMS configuration setting type: 
smsrestore /var/tmp/sms_backup.1.2.cpio

EXIT STATUS

The following exit values are returned:

0: Successful completion
>0: An error occurred.

FILES

The following file is used by this command:

/var/sadm/system/logs/smsversion: smsversion log file

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

Attribute Types	Attribute Values
Availability	SUNWSMSop