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

smsbackup(1m)

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

SYNOPSIS

smsbackup directory_name

smsbackup -h

smsbackup(1M) creates a cpio(1) archive of files that maintain the operational environment of SMS. To create a complete and accurate backup, turn off SMS before running smsbackup. For information about manually starting and stopping SMS refer to the System Management Services (SMS) 1.4 Installation Guide .

Whenever changes are made to the SMS environment--for example, by shutting down a domain-- you must run smsbackup again to maintain a current backup file for the system controller.

The name of the backup file is sms_backup.X.X.cpio, where X.X represents the active version from which the backup was taken.

Restore SMS backup files using the smsrestore(1M) command.

If any errors occur, smsbackup writes error messages to /var/sadm/system/logs/smsbackup if /var/sadm/system/logs exists and /var/tmp if it does not exist.

OPTIONS

The following option is supported

-h: Help. Displays usage descriptions.Note – Use alone. Any option specified in addition to -h is ignored.

OPERANDS

The following operands are supported:

directory_name

Name of the directory in which the backup file is created. This file can reside in any directory on the system, connected network or tape device to which you have read/write privileges. If no directory_name is specified, a backup file is created in /var/tmp. The directory_name does not require the absolute path name for the file.

The directory_name specified must be mounted as a UFS file system. Specifying a TMPFS file system, such as /tmp, causes smsbackup to fail. If you are not certain that your directory_name is mounted as a UFS file system, type:

/usr/bin/df -F ufs directory_name

A UFS file system returns directory information. Any other type of file system returns a warning.

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. Backing Up SMS to /var/opt/SUNWSMS/bkup

sc0:sms-user:> smsbackup  /var/opt/SUNWSMS/bkup

Example 2. Backing Up SMS to Tape Device 0

sc0:sms-user:> smsbackup /dev/rmt/0

Example 3. Backing Up SMS to TMPFS System

sc0:sms-user:> smsbackup /tmp 
ERROR: smsbackup fails to backup to /tmp, a TMPFS
file system.  Please specify a directory that is
mounted on a UFS file system.
ABORT:

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/smsbackup: smsbackup log file

ATTRIBUTES

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

Attribute Types	Attribute Values
Availability	SUNWSMSop