swts Command

Purpose

Switches a thin server to a different COSI.

Syntax

swts -c Image [-n |-t Time] [-v] ThinServer

Description

The swts command switches a thin server to a different Common Operating System Image (COSI). If specified with the -t flag, the thin server switches to a new common image at the time specified by the Time parameter. The value for Time must be a valid cron tab entry. Refer to the crontab command for creating valid cron time entries.

The swts command can be run on either a NIM master or a thin server. When a thin server is switched to a new common image, files in the /inst_root directory for the thin server will be synced with the new common image.

Flags

Item Description
-c Image Specifies the common image that the thin server switches to.
-n Specifies option to allow a thin server to switch to a new common OS image that was setup by the NIM administrator with the -c flag. The user running from the thin server will only need to execute the swts command without any argument to switch the common OS images.
-t Time Specifies a cron entry that allows thin servers to be switched over at a more convenient time.
-v Enables verbose debug output when the swts command runs.

Exit Status

Item Description
0 The command completed successfully.
>0 An error occurred.

Security

Access Control: You must have root authority to run the swts command.

Examples

  1. To switch the cosi1 common image of a thin server named lobo to a common image named cosi2, enter: 
    swts -c cosi2 lobo
    The lobo thin server is re-initialized and cosi2 is its new operating system.
  2. To switch the cosi1 common image of a thin server named lobo to a common image named cosi2 at midnight on Sunday, December 25, enter: 
    swts -c cosi2 -t "0 0 25 12 0" lobo
    The lobo thin server will continue to use the cosi1 common image until midnight on Sunday, December 25, when it switches to cosi2.

Location

/usr/sbin/swts

Files

Item Description
/etc/niminfo Contains variables used by NIM.