System Management Services 1.4 man pages


sun.com \| docs.sun.com		How To Buy \| My Sun \| Worldwide Sites

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.

Note – SMS 1.1 and SMS 1.3 are not consecutive releases and you cannot switch from one to the other using smsversion. You must do a fresh installation. Refer to the System Management Services (SMS) 1.4 Installation Guide for more information.

smsversion permits two-way SMS version-switching between sequential co-resident installations on the same operating environment but with the following conditions:

Condition Explanation

New features The features supported in the newer version of SMS may not be supported in the older version. Switching to an older version of SMS can result in the lose of those features. Also, the settings for the new features might be erased.

Flash PROM differences Switching versions of SMS requires reflashing the CPU flash PROMs with the correct files. These files can be found in the /opt/SUNWSMS/<SMS_version>/firmware directory. Use flashupdate(1M) to reflash the PROMs after you have switched versions. Refer to the flashupdate man page, Chapter 11 of the System Management Services (SMS) 1.4 Administrator Guide and the System Management Services (SMS) 1.4 Installation Guide for more information on updating flash PROMs.

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 necessary for activating 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 do one of the following:

Turn off failover and stop SMS. Then 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.
Start SMS and turn on failover. For information about manually starting and stopping SMS refer to the System Management Services (SMS) 1.4 Installation Guide .

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, "SMS Security Options and Administrative Privileges" in the System Management Services (SMS) 1.4 Administrator Guide for more information.

EXAMPLES

Example 1. Displaying the Version with 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.

You must stop SMS prior to switching versions.

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

Is this correct? [y,n] y

smsversion: Upgrading SMS from 1.2> to 1.3>.
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.3>.
smsversion: New Version 1.3> Active
smsversion: Active SMS version  1.3 >
To use the previous SMS configuration settings type: 
smsrestore /var/tmp/sms_backup.1.2.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

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

Is this correct? [y,n] y
smsversion: Downgrading SMS from 1.3> to 1.2>.
smsversion: SMS version 1.2 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.3.cpio
smsversion: Switching to target version 1.2>.
smsversion: New Version 1.2> Active
smsversion: Active SMS version  1.2 >
To restore previous the SMS configuration setting type: 
smsrestore /var/tmp/sms_backup.1.3.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