EMC Legato NetWorker Commands Reference

save

SYNOPSIS

       command [ -BEiKLnquSVvx ] [ -s server ] [ -c client-name ] [ -N name  ]
       [  -e  expiration ] [ -f dirfile ] [ -o save_operations ] [ -b pool ] [
       -F file ] [ -I input_file ] [ -g group ] [ -l level ] [ -t date ] [  -m
       masquerade  ]  [  -w browse_time ] [ -y retention_time ] [ -W width ] [
       path ...  ]
       where command is either save or savepnpc.

DESCRIPTION

       save saves files, including directories or entire filesystems,  to  the
       NetWorker server (see nsr(1)).  The progress of a save can be monitored
       using the X Window System based nwadmin(1) program  or  the  curses(3X)
       based nsrwatch(1) program for other terminal types.

       The  user  of  this command may retain root privileges if the command's
       modes are properly set as described in nsr(1).

       If no path arguments are specified on the command line or  via  the  -I
       option,  the  current directory will be saved.  save will save a direc-
       tory by saving all the files and subdirectories  it  contains,  but  it
       will not cross mount points, or follow symbolic links.  If the paths to
       be saved are mounted from a network file  server,  save  instructs  the
       user to run the save on the remote machine or use the -L option.

       The directive files (see nsr(5)) encountered in each directory are read
       by default, and they contain special instructions directing how partic-
       ular  files  are  to  be saved (i.e. compressed, skipped, etc.).  These
       files are named '.nsr' on UNIX or 'nsr.dir' on Windows.

       Each file in the subdirectory structures specified by  the  path  argu-
       ments  is encapsulated in a NetWorker save stream.  This stream of data
       is sent to a receiving process (see nsrd(1)) on the  NetWorker  server,
       which  processes  the  data,  adding  entries to the on-line index (see
       nsrindexd(1)) for each file in the stream, with the data finally ending
       up on a long term storage media (see nsrmmd(1)).  By default, these on-
       line index entries are stored in the "backup" index namespace.

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

       savepnpc  consists of the same command options as save but requires the
       -g group to run.  Apart from running the actual save, it also  performs
       the pre and post processing commands, if any.  Prior to the actual save
       of the first saveset on a NetWorker client, savepnpc performs  pre-pro-
       cessing  commands if any exists in the /nsr/res/<grpname>.res file, and
       at the end of the save of the last save set on the  client,  the  post-
       processing  commands  (if any) will be invoked. It is possible to setup
       multiple  clients  in  a savegroup  such  that   each  client  can  run
       different pre and post commands.  The <grpname>.res file resides on the
       nsr_getdate(3)).  Also, abort precmd with group attribute exists in the
       /nsr/res/<grpname>.res  file.  This  can be set to Yes or No. If set to
       Yes, the precmd will terminate if the particular savegrp is aborted. If
       it  is  set  to  No,  the  precmd will run to completion even after the
       abnormal exit of the savegrp session.

       An example of /nsr/res/<grpname>.res can be described as:
            type: savepnpc;
            precmd: /bin/true;
            pstcmd: /bin/true, "/bin/sleep 5";
            timeout: "12:00pm";
            abort precmd with group: No;

       The precmd field can be manually modified to contain any number of com-
       mands that are needed to be run at the beginning of the save of the 1st
       save set.  The pstcmd is to hold any commands that are needed to be run
       at  the end of the save of the last save set.  The post-processing com-
       mands are run after the save of the last save set or the timeout condi-
       tion,  whichever  comes  first. Note that on Windows Networker Clients,
       the shell should be set to "cmd.exe"and the Shell flag should be set to
       "/c",  for  running  the  precmd and postcmd. This will force the OS to
       close all the opened File Descriptors and other resources in  a  timely
       manner,  after the execution of the commands. Also, for both the precmd
       and the pstcmd, on all Networker Clients, its best to redirect the out-
       put(stdout and stderr) to another file, to avoid unclosed File Descrip-
       tors, after the commands have completed executing.

       An example of precmd and pstcmd for Windows Clients is shown below:
       precmd: cmd.exe /c start_pre_cmd > pre_result.txt 2>&1
       pstcmd: cmd.exe /c start_post_cmd > post_result.txt 2>&1

OPTIONS

       -b pool
              Specifies a particular destination pool for the save.

       -c client-name
              Specifies the client name for starting the save  session.   This
              is  useful on clients with multiple network interfaces, and mul-
              tiple host names.  It can  be  used  to  create  multiple  index
              databases  for  the same physical client.  This does not specify
              the network interface to use.  This is specified in  the  server
              network   interface   attribute  of  the  client  resource  (see
              nsr_client(5)).  This option can also be used on a cluster  when
              performing  manual  saves, or in specifying a non-default backup
              command for scheduled saves.  This option directs  NetWorker  to
              override the cluster path-ownership rules, saving the path argu-
              ment(s) as belonging to client-name and making index entries  in
              the index for client-name instead of using the name of the phys-
              ical host or virtual host which owns the path, according to  the
              cluster  management  software.   Refer to pathownerignore(5) for
              more information about path-ownership rules.

       -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 both  browsable  and  non-recyclable  until  it
              expires  Thus,  the explicitly provided expiration overrides the
              existing browse and retention times specified in the client pol-
              nsr(5)).  A dirfile of - causes the  default  directives  to  be
              read from standard input.

       -o save_operations
              Save  Operations of the form KEYWORD:TOKEN=STATE.  It is used to
              configure VSS saves on Windows 2003.  Examples:

              "vss:*=off"                          Turn off VSS.

              "vss:Microsoft Exchange Writer=off"  Disable a writer.

              "vss:C:=off"                         Disable VSS for a drive.

              Please see the Admin Guide for more details.

       -g group
              This option is used by savegrp(1) and savefs(1)  to  denote  the
              group  of  the  save (see nsr_client(5) and nsr_group(5)) and is
              used by the NetWorker server to select the specific media  pool.

       -i     Ignores  any .nsr (UNIX) or nsr.dir (Windows) directive files as
              they are encountered in the subdirectory structures being saved.

       -l level
              The  level  of  the save.  This option is used by savegrp(1) and
              savefs(1) to specify a particular level for  a  scheduled  save.
              This option is ignored by manual save command.

       -m masquerade
              Specifies  the  tag to precede the summary line.  This option is
              used by savegrp(1) and savefs(1) to aid in savegrp summary noti-
              fications.   savepnpc(1)  also  uses this tag to identify client
              operations on the  savegrp's  work  list  that  should  complete
              before pstclntsave(1) will trigger its post-processing.

       -n     No save.  Estimate the amount of data which will be generated by
              the save, but do not perform the actual save.

       -q     Quiet.  Displays only summary information and error messages.

       -s server
              Specifies which machine to use as the NetWorker server.

       -t date
              The date (in nsr_getdate(3) format) by  which  files  must  have
              been  modified  for  them  to  be saved.  This option is used by
              savegrp(1) and savefs(1) to perform scheduled saves by  consult-
              ing  with  the  media database to determine the appropriate time
              value based on the previous saves for the save set and the level
              of the scheduled save.

       -u     Stop  the  save  if an error occurs.   The save program normally
              treats errors as warnings and continues to save the rest of  the
              files in the backup.  When this option is set, errors will cause
              save to exit and abort the save.  This option is not recommended
              for general use, although it can be useful when a group of files
              needs to be backed up as a set.

              mines 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 browse_time
              Sets  the  date (in nsr_getdate(3) format) after which this save
              set will no longer be browsable.  By default, the server  deter-
              mines the browse date for the save set based on the browse poli-
              cies in effect.  This  option  allows  overriding  the  existing
              policies on a save by save basis.

       -x     Cross  mount  points.   This option is only applicable to manual
              save command.  When -x option is specified  with  a  (save  set)
              path,  the  mount  point under this path is crossed and files in
              the mounted file system are backed up.  When -x  option  is  not
              specified,  only the local files and directories of the path are
              backed up.

              This option has no effect and is ignored when a mount point  (or
              file/subdirectory  path  under  it)  is specified as the (local)
              path to be backed up for the manual save command,  which  gener-
              ally requires the -L option.

              For  example,  if  /tmp_mnt/pumbaa  is  a  mount  point for pum-
              baa:/space, the following three commands behave differently with
              the specification of -x option:

              save -x /tmp_mnt                 follows mount points,
                                               backs up the local files
                                               and directories of /tmp_mnt
                                               along with files and directories
                                               of /tmp_mnt/pumbaa

              save /tmp_mnt                    does not cross mount
                                               points, only local files
                                               and directories of /tmp_mnt
                                               are backed up

              save [-x] /tmp_mnt/pumbaa[/...]  when mount point is specified
                                               as the (save set) path, "-x"
                                               option is ignored and an error
                                               message is displayed to indicate
                                               "-L" option is required on most
                                               platforms

       -B     Force  save  of  all  connecting directory information from root
              ('/') down to the point of invocation.

       -E     Estimate the amount of data which will be generated by the save,
              then  perform the actual save.  Note that the estimate is gener-
              ated from the inode information; thus, the  data  is  only  read
              once.

       -F file
              Only save files whose change time is newer than the file modifi-
              cation date of file.

       -I input_file
              even  when  files  are  from  a network file server.  To recover
              these files, run recover(1) with the -c client arguments,  where
              client is the name of the NetWorker client that did the save.

       -LL    In  addition to treating the backup as a local backup, causes an
              extra line to be printed at the end of the completion output  of
              the form 'complete savetime=number', where number is the save-
              time of the save set created by this  backup.   This  option  is
              meant  to  be used by the savegrp(1) command in performing auto-
              matic cloning.

       -N name
              The symbolic name of this save set.  By default, the most common
              prefix  of  the  path arguments is used as the save set name. If
              the -N option is used when saving any of the  SYSTEM  save  sets
              (SYSTEM  STATE, SYSTEM FILES, and SYSTEM DB), the path must also
              be specified and must match the name value assigned with the  -N
              option.

       -S     Allows  only  save set recovery.  This performs the save without
              creating any index entries.  This means that the save  set  will
              not  be  browsable,  although  save  set recovery may be used to
              recover the data.

       -V     Prevent the OFC mechanism from creating a point-in-time copy  of
              the  source  volume.   (Included  for compatibility with NT Net-
              Worker servers.)

       -W width
              The width used when formatting the summary  information  output.
              Valid  values  for  width are integer values from 1 to 10000. If
              the supplied width is too small for the summary to fit  in,  the
              width  will  be  silently  adjusted upwards as necessary. If the
              supplied width is larger than the minimum  needed,  then  spaces
              will be used to pad the summary to the correct width.  Note that
              if no -W argument is supplied then there is no fixed width used,
              and the summary simply expands to whatever minimum width is nec-
              essary.

SEE ALSO

       curses(3X), nsr_getdate(3), nwadmin(1), nsr(5), nsr(1),  nsr_client(5),
       nsr_device(5),   nsr_group(5),   nsr_service(5),   nsrd(1),   nsrim(1),
       nsrindexd(1), nsrmm(1), nsrmmd(1), nsrwatch(1), recover(1),  savefs(1),
       savegrp(1), pathownerignore(5).

DIAGNOSTICS

   Exit Codes
       0      Normal  exit.   This means that a save set was correctly created
              on the server.  Messages about individual file  backup  failures
              are warnings, and do not cause abnormal exit.
       <>0    Abnormal  exit.   A  save  set  was not correctly created on the
              server.

   Messages
       host: saveset   level=level,  size   time  count files.
              This message (with the appropriate  client  host  name,  saveset
              name,  level, total save set size, elapsed time, and file count)
              is printed whenever save is run by  savegrp(1)  and  exits  nor-

ADVERTISEMENT