EMC Legato NetWorker Commands Reference

nsrndmp_clone

SYNOPSIS

       nsrndmp_clone [ -v ] [ -s server ] [ -b pool ] { -f file | volname...
                     }

       nsrndmp_clone [ -v ] [ -s server ] [ -b pool ] -S { -f file | ssid...
                     }

       nsrndmp_clone [ -v ] [ -s server ] [ -b pool ] -V { -f file | volid...
                     }

       DESCRIPTION
              The  nsrndmp_clone  program  makes  new  copies of existing save
              sets. These copies  are  indistinguishable  from  the  original,
              except  for  the  volume(s)  storing the copies.  The copies are
              placed on different media volumes, allowing for higher reliabil-
              ity  than  a  single copy provides.  The copies may be made onto
              any kind of media (for example, save sets on an 8mm tape may  be
              copied  to  a  set of optical disks). However, all media used as
              the destination of an nsrndmp_clone operation must be in a clone
              pool.   See  nsr_pool(1)  for  a description of the various pool
              types.

       Although the command line parameters allow you to specify volume  names
       or  volume identifiers, nsrndmp_clone always copies complete save sets.
       Save sets that begin on a specified volume will be  completely  copied,
       so volumes may be requested during the cloning operation in addition to
       those specified on the command line.  Conversely, save sets residing on
       the specified volumes that begin elsewhere are not cloned.

       Note that nsrndmp_clone does not perform simple volume duplication, but
       rather, copies full save sets to a set  of  destination  volumes  in  a
       given  pool.  If the first destination volume chosen cannot hold all of
       the save sets to be copied, another volume will be chosen.  This allows
       you  to  use different kinds of media for each copy, allowing for vari-
       able sized volumes, such as tapes.

       The nsrndmp_clone program, in conjunction  with  nsrmmd(1),  guarantees
       that each save set will have at most one clone on a given volume.  When
       you specify a volume name or identifier, the copy of the save  sets  on
       that  volume  are  used  as  the  source.  When save sets are specified
       explicitly, those with existing multiple copies are automatically  cho-
       sen  (copies of save sets that exist on volumes in a jukebox are chosen
       over those that require operator intervention).  You can  also  specify
       which  copy  (clone)  of  a  save set to use as the source, (see the -S
       option,in the options section).

       Cloning between storage nodes is accomplished by a NDMP Tape Server  on
       the  source node reading from a volume, and another NDMP Tape Server on
       the target node writing to a volume.  The source node is determined  by

OPTIONS

       -b pool
              Specifies the media pool to which the destination clones  should
              be  sent.   The  pool  may be any pool currently registered with
              nsrd(1) that has its status set to clone.  The  possible  values
              can be viewed by selecting the Pools menu item from the Adminis-
              tration menu of nwadmin(1).  If you omit this option, the cloned
              save sets are automatically sent to the Default Clone pool.

       -f file
              Instructs nsrndmp_clone to read the volume names, volume identi-
              fiers or save set identifiers from the file  specified,  instead
              of  listing them on the command line.  The values must be listed
              one per line in the input file.  The file may be "-",  in  which
              case the values are read from standard input.

       -s server
              Specifies  a  NetWorker server.  See nsr(1) for a description of
              server selection.  The default is the current system.

       -v     Enable verbose operation.  In this mode, additional messages are
              displayed  about  the  operation  of nsrndmp_clone, such as save
              sets that cross volumes, or save set series expansions.

       -S     Causes nsrndmp_clone to treat subsequent command line parameters
              as save set identifiers, not volume names.  Save set identifiers
              are unsigned numbers.  You can find out the save set  identifier
              of  a save set using the mminfo -v command (see mminfo(1)).  The
              -S option is useful when you want to copy individual  save  sets
              from a volume or all save sets matching an mminfo query (see the
              examples below).  The save  set  identifiers  may  also  specify
              exactly  which copy of a save set with multiple copies to use as
              the source.  To specify exact copies, use the ssid/cloneid  for-
              mat  for  each  save set identifier.  In this case, the ssid and
              the cloneid are unsigned numbers, separated by  a  single  slash
              (/).   You  can  find  out  the cloneid for a particular copy by
              using the mminfo -S report, or a custom report.

       -V     Causes nsrndmp_clone to treat subsequent command line parameters
              as volume identifiers, not volume names.  Volume identifiers can
              be found using the mminfo -mv report, for example.  This  option
              can not be used in conjunction with the -S option.

EXAMPLES

       Copy all save sets that begin on the volume mars.001 to a volume in the
       Offsite Clone pool:
              nsrndmp_clone -b 'Offsite Clone' mars.001

       Copy all complete save sets created during the previous weekend (recall
       that  nsr_getdate(3)  dates  without  time-of-day match midnight at the
       beginning of that day).  Only complete  save  sets  can  be  copied  by
       nsrndmp_clone(1):
              nsrndmp_clone -S 'mminfo -r ssid \
                   -q '!incomplete,savetime>last saturday,savetime<last monday''

       Copy a specific clone of a specific save set:
              nsrndmp_clone -S 1538800517/770700786

       Several messages are printed signaling that nsrd(1) is unavailable for
       cloning data; these are self-explanatory.  You may also see a message
       from the following list.

       adding save set series which includes parent ssid
              If running in verbose mode, this message is printed when
              nsrndmp_clone notices that a requested save set is continued,
              requiring the entire series to be cloned (even if only part of
              the series was specified in the command line parameters).

       adding save set series which includes descendent ssid
              If running in verbose mode, this message is printed when
              nsrndmp_clone notices that a requested save set is a continua-
              tion, requiring the entire series to be cloned.

       Cannot contact media database
              The media database (and most likely other NetWorker services as
              well) on the named server is not answering queries.  The server
              may need to be started, or if it was just started, it needs to
              finish its startup checks before answering queries.

       cannot clone save set number, series is corrupt
              The given save set is part of a save set series (used for saving
              very large files or filesystems), but not all of the save sets
              in the series were found in the media database.  This can happen
              if, for example, you relabel a tape that contains part of a save
              set series.

       cannot open nsrndmp_clone session with server
              This message is printed when the server does not accept clone
              sessions.

       cloning not supported; upgrade required
              Another enabler is required to use this feature.

       cloning requires at least 2 devices
              Cloning requires at least one read/write device and one read-
              only or read/write device, since data is copied from one volume
              directly to another.

       server does not support cloning
              The named server is not capable of cloning.

       each clone host needs at least two enabled devices
              When cloning between two storage nodes that share the same phys-
              ical drive, each node must have at least two enabled devices.

       error, no valid clones of ssid number
              The listed save set exists, but cannot be cloned because there
              are no complete copies of the save set. The save set was either
              aborted or is in progress.  Only complete save sets can be
              copied.

       error, user username needs to be on administrator list
       error, user username needs to be on archive users list
              Only NetWorker administrators are allowed to make clones of
              backup save sets.  NetWorker administrators are listed in the
              understood: simple save set identifiers and those with a cloneid
              specified.  Simple save sets are unsigned numbers.  The save set
              with the cloneid form is specified as two unsigned numbers sepa-
              rated by a single slash (/).

       pool is not a cloning pool
              The pool specified with the -b pool option is not a clone pool.
              You must always use a pool with a type of "Backup Clone" for the
              -b option.

       Volume name has clone; requesting
              additional volumes
              This message is printed in verbose mode when a specified save
              set has already been cloned to the volume specified in the error
              message.  Since a save set can have at most one clone per vol-
              ume, nsrndmp_clone automatically requests additional volumes.

       save set number does not exist
              The given save set (from a -S save set list) does not exist.
              Verify your save set identifiers using mminfo(1).

       save set number crosses volumes; requesting
              additional volumes
              This message is printed in verbose mode when volume names or IDs
              were specified, but the given save set is only partially resi-
              dent on the listed volumes.  Since only complete save sets can
              be cloned, nsrndmp_clone automatically requests additional vol-
              umes.

       save set clone number/cloneid does not exist
              A specific clone of a save set was specified, but that save set
              has no clones with that clone identifier.  Verify your save set
              identifiers using mminfo(1).

       volume name-or-number does not exist
              The given volume (either a volume name or a volume id specified
              in the -V option) does not exist in the media database.

       waiting 30 seconds then retrying
              A temporary error occurred and nsrndmp_clone will automatically
              retry the request until the condition is cleared.  For example,
              an error will occur if all devices are busy saving or recovering
              and nsrndmp_clone must wait for these devices become available.

ADVERTISEMENT