Content-type: text/html Man page of NSRSCSI_SAVE

NSRSCSI_SAVE

Section: Maintenance Commands (8)
Updated: Dec 11, 01m
Index Return to Main Contents
 

NAME

nsrscsi_save - Performs binary image backup of a host accessible raw device to long term storage with NetWorker  

SYNOPSIS

nsrscsi_save [ -c client-name ] [ -g group ] [ -N save-set-name ] [ -I input filename ] [ -s server ] [ -b pool ] [ -e expiration ] [ -y retention time ] Path
 

DESCRIPTION

The nsrscsi_save program performs raw device backup using SCSI commands directly accessing the device. It retrieves the data blocks directly from the device and sends the data stream to a NetWorker storage device (See nsrmmd(1m)). Only the super-user may run this command. The user must specify a Path.

If a backup of a raw device needs to be performed, then the Path must be the raw device path that is accessible to nsrscsi_save.

If a backup of a SYMMETRIX device needs to be performed, then the Path must contain SYMMETRIX id and SYMMETRIX device id (See options section below for syntax of the Path). The nsrscsi_save program directly interacts with the SYMMETRIX device via the SYMAPI library and discovers the host accessible raw device path for the corresponding SYMMETRIX device id. It then performs a SCSI backup of the raw device path. (Refer to SYMMETRIX documentation for more details on SYMMETRIX and SYMAPI.)

The status of a backup can be monitored using the Java based NetWorker Management Console or the curses(3X) based nsrwatch(1m) program for other terminal types.

The user can also specify a device set to be backed up where the device set is a set of device entries. If the Path specified is a device-set-name (See Options section below), then for each device entry in the device set a backup thread is forked to dedicate the backup operation for each device for optimized performance and better utilization of system and NetWorker resources. The total number of threads run are directly proportional to number of device entries in the device set. However, server, client and device parallelism attributes are enforced on the NetWorker server.

Details about handling media are discussed in nsrmm(1m) and nsr_device(5).

In order to save data for another system, make sure the user performing the nsrscsi_save operation is on the remote access attribute list of the client resource. See nsr_client(5).

Since it is a raw device backup, the save sets are not browsable. These save sets are recoverable via nsrscsi_recover command only (See nsrscsi_recover (1m)). Also, if the number of devices to be backed up is more than one, then nsrscsi_save will start and end a save session to create a container set(deduced from cover set). This container set would encompass all the save sets backed up by threads. The mminfo tool would display the container sets as any other regular save sets (See mminfo (1m)).  

OPTIONS

-c client-name
Specifies the client name for starting the save session. However, the client name is optional. If client name is unspecified, then the local host will be assumed to be the client. If client-name is specified, the save session is started against this client and the resulting save set is registered against client-name.

Note:- This client name is not necessarily the host where device is accessible. For instance, a SYMMETRIX BCV device is accessible on a different host for backup but the user wants to register the backup against the client where standard device is attached.

-N save-set-name
Symbolic name to the save set. By default, save-set-name is the Path name itself. However, if the Path is a device-set-name , then -N will be ignored as device-set-name will be tagged against each device entry to form a save set name for that backup session.
-I input-filename
Input file name (eg. /tmp/testdisks.res) is the absolute file path name that must have the list of devices to be backed up. If the input-filename is not specified, then default input-filename is constructed from device-set-name. For example, if the device-set-name is oracledisks, the input-filename would be /nsr/res/oracledisks.res.

Inputfile can be an absolute path to the file that needs to be read, or inputfile can be "-" which means read device entries from stdin.

If device-set-name is specified in the Path and -I is not specified, the default location for input file is /nsr/res/device-set-name.res


Notes:

The input-filename should contain only the device entries that need to be backed up, and multiple device entries should be separated by newline. When -I is specified, device-set-name should also be specified.

Path
The Path can be anyone of the following formats:-

"Raw device path"            E.g. "/dev/rdsk/c1t2d0s2"

"{device-set-name}"          E.g. "{OracleDevices}"
                             Note that the braces are mandatory
                             to distinguish device-set-name from
                             single device path. 
                             In this case, device entries are read
                             from /nsr/res/device-set-name.res file
                             i.e., the resource file name should be
                             same as the device-set-name.
                             Also note that the device entries in
                             this file must be raw device paths.

"<<vendor>>{device-set-name}"
                             Same syntax as above. However, the
                             difference is that the device entries
                             must be in vendor specific format.

                             E.g. "<<emc_symm>>{OracleDevices}"
                             Currently, emc_symm is the only suppored
                             vendor.


                             SYMMETRIX format of a device entry or
                             a device path is SymID/DevId where
                             SymId is 00343456567 and DevId is 0366.

"<<vendor>>vendordevice"     E.g.  "<<emc_symm>>00343456567/0366"
                             In this case, only one vendor device is
                             backed up.  Here, vendor is "emc_symm"
                             and device to be backed up is
                             "SymID/DevId".

Note:- Path must be given in double quotes.

-g group
Is used by savegrp(1m) and savefs(1m) to denote the group of the save. See nsr_client(5) and nsr_group(5). It is also used by the NetWorker server to select the specific media pool.
-b pool
Specifies a particular destination pool for the save. Note that all the save sessions go the same pool.
-L
When two -L options are specified, this option causes an extra line to be printed at the end of the form ``complete savetime=number'', where number is the savetime of the save set created by this backup. Used by savegrp(1m).
-m masquerade
Specifies the tag to precede the summary line. This option is used by savegrp(1m) and savefs(1m) to aid in savegrp summary notifications.
-n
Indicates no save. Not supported, but provided for compatibility.
-q
Indicates quiet.
-s server
Specifies which machine to use as the NetWorker server.
-e expiration
Set the date (in nsr_getdate(3) format) when the saved data will expire. When a save set has an explicit expiration date, the save set remains non-recyclable until it expires. If it has expired and it has passed its retention time, the save set will become recyclable. The special value forever is used to indicate that a volume that never expires (i.e. an archive or a migration volume) must be used. By default, no explicit expiration date is used.
-w browse
Indicates the browse date. Not supported, but provided for compatibility.
-y retention
Sets the date (in nsr_getdate(3) format) when the saved data will become recyclable. The special value forever is used to indicate that a volume that never expires (an archive or a migration volume) must be used. By default, the server determines this date for the save set based on the retention policies in effect. This option allows overriding the existing policies on a save-by-save basis.
-W width
The width used when formatting summary information output.
 

SEE ALSO

curses(3X), mminfo(1m), nsr_getdate(3), nsr_client(5), nsr_device(5), nsr_group(5), nsr_service(5), nsrd(1m), nsrim(1m), nsrindexd(1m), nsrmm(1m), nsrmmd(1m), save(1m), nsrwatch(1m), recover(1m), savefs(1m), savegrp(1m)


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:37:07 GMT, October 02, 2010