Sun Microsystems, Inc.
   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 Administrationsmsbackup(1m)


NAME

 smsbackup - back up the SMS environment

SYNOPSIS

 smsbackup directory_name
 smsbackup -h

DESCRIPTION

 

smsbackup(1M) creates a cpio(1) archive of files that maintain the operational environment of SMS. In order to create a complete and accurate backup, turn off SMS before running smsbackup. 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.

Whenever changes are made to the SMS environment, for example by shutting down a domain, you must run smsbackup again in order 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.

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 on as a UFS file system. Specifying a TMPFS file system, such as /tmp, will cause 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 will return directory information. Any other type of file system will return a warning.

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. Backing Up SMS to /var/opt/SUNWSMS/bkup
 
 
sc0:sms-user:> smsbackup  /var/opt/SUNWSMS/bkup
Example 2. Backing Up SMS to a Tape Device 0
 
 
sc0:sms-user:> smsbackup /dev/rmt/0 
Example 3. Backing Up SMS to a 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:

0abcd
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 TypesAttribute Values
AvailabilitySUNWSMSop

SEE ALSO

 

smsrestore(1m)

NOTES

 

Include any notes here.


SMS 1.2Go To TopLast Changed 22 April 2002

 
      
      
Copyright 2002 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, CA 95054 USA. All rights reserved.