EMC Legato NetWorker Commands Reference

nsrpmig

SYNOPSIS

       nsrpmig [ -BEiLnpqvx ] [ -LL ] [ -s server ] [ -N name ] [ -f dirfile ]
       [ -b pool ] [ -g group ] [ -m masquerade ] [ -W width ] [ -I input file
       ] path

DESCRIPTION

       nsrpmig  premigrates files to the NetWorker server.  Premigration means
       making a copy of a file on NetWorker storage in preparation for  migra-
       tion.   When  a file is later migrated, the on-disk copy of the file is
       replaced with a reference to the premigrated copy in NetWorker.

       Currently, only regular files are premigrated.  Criteria  specified  in
       the  NetWorker  migration  client resource are used to select files for
       premigration.  The progress of a nsrpmig session 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 nsrpmig command will not cross mount points,  nor  will  it  follow
       symbolic links.  If the path to be saved is mounted from a network file
       server, nsrpmig will instruct 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 will be
       read by default.  They contain special instructions directing how  par-
       ticular  files  are  to be saved, such as compressed or skipped.  These
       files are named .nsrhsm.  Note that the directive files  used  by  Net-
       Worker for save and recover named .nsr are ignored by nsrpmig.

       Each  file  in  the subdirectory structures specified by the path argu-
       ments will be encapsulated in a NetWorker save stream.  This stream  of
       data  is  sent  to  a  receiving  process  on the NetWorker server. See
       nsrd(1).  The server processes the data, adding entries to  the  online
       index  for each file in the stream. See nsrindexd(1).  The data finally
       resides on some long term storage media. See nsrmmd(1).

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

OPTIONS

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

       -i     Ignores any .nsrhsm directive files as they are  encountered  in
              the subdirectory structures being saved.

       -L     Indicates  local.   Saves  will be performed from the local Net-
              Worker client, even when files are from a network  file  server.
              To  recover these files, run recover(1) with the -c client argu-
              ments, where client is the name of the NetWorker client that did
              the save.
              Specifies the tag to precede the summary line with.  This option
              is  used  by  savegrp(1) and savefs(1) to aid in savegrp summary
              notifications.

       -n     Indicates no save.  Estimates the amount of data which  will  be
              generated by the save, but does not perform the actual save.

       -v     Indicates  verbose.   Causes  the  save  program  to  report its
              progress. If you specify multiple -v options, then the verbosity
              level increases.

       -p     Exits  with  status 0.  Is used by server to determine if client
              installed properly.

       -q     Indicates quiet.  Displays only summary  information  and  error
              messages.

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

       -N name
              Indicates  the  symbolic name of this save set.  By default, the
              path argument is used as the save set name.

       -f dirfile
              Indicates the file from which to read prototype  default  direc-
              tives. See nsr(5).  A dirfile of - causes the default directives
              to be read from standard input.

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

       -g group
              Is used by savegrp(1) and savefs(1) 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.

       -I input_file
              In addition to taking the paths to save from the  command  line,
              this  option reads paths to save from the named file.  The paths
              must be listed one per line.  If no paths are specified  on  the
              command  line,  then only those paths specified in the file will
              be saved.

       -W width
              Indicates the width used  when  formatting  summary  information
              output.

       -x     Indicates that if a subdirectory is a mount point, scan it also.
              This option currently has no effect.

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

DIAGNOSTICS

   Exit Codes
        0     Normal exit.
       -1     Abnormal exit.

ADVERTISEMENT