


NSRCLONE(8)                                           NSRCLONE(8)


NNAAMMEE
       nsrclone - NetWorker save set cloning command

SSYYNNOOPPSSIISS
       nnssrrcclloonnee [ --vv ] [ --ss _s_e_r_v_e_r ] [ --bb _p_o_o_l ] { --ff _f_i_l_e |
                _v_o_l_n_a_m_e_._._.  }

       nnssrrcclloonnee [ --vv ] [ --ss _s_e_r_v_e_r ] [ --bb _p_o_o_l ] --SS { --ff _f_i_l_e |
                _s_s_i_d_._._.  }

       nnssrrcclloonnee [ --vv ] [ --ss _s_e_r_v_e_r ] [ --bb _p_o_o_l ] --VV { --ff _f_i_l_e |
                _v_o_l_i_d_._._.  }

       aanndd oonn HHSSMM eennaabblleedd sseerrvveerr::

       nnssrrcclloonnee [ --vv ] [ --ss _s_e_r_v_e_r ] [ --bb _p_o_o_l ] --cc _c_l_i_e_n_t --NN
                _s_a_v_e_s_e_t

DDEESSCCRRIIPPTTIIOONN
       The  nnssrrcclloonnee program is used to make new copies of exist-
       ing 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  reliability 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 that will be used as the desti-
       nation  of  an nnssrrcclloonnee operation must be in a _c_l_o_n_e _p_o_o_l.
       See nnssrr__ppooooll(8) for a  description  of  the  various  pool
       types.

       Although  the command line parameters allow you to specify
       volume names or volume identifiers, nnssrrcclloonnee always copies
       complete  save  sets.   Save  sets that are only partially
       contained 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.   Note
       that  nnssrrcclloonnee does not perform simple _v_o_l_u_m_e _d_u_p_l_i_c_a_t_i_o_n,
       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 one to use
       different kinds of media for each  copy,  and  allows  for
       variable sized volumes, such as tapes.

       If  you  use the --cc and --NN options together, nnssrrcclloonnee will
       create a _s_u_p_e_r_-_f_u_l_l clone for the given client  save  set.
       A  super-full  clone  is  a feature that is supported only
       with HSM (most useful on HSM enabled servers).   It  auto-
       matically creates a clone of the most recent complete full
       backup of the named client and save set,  along  with  any
       HSM  migration  save  sets  referenced  to  by the backup.
       Super-full clones should be cloned to a volume from a pool
       of  type  _M_i_g_r_a_t_i_o_n  _C_l_o_n_e.  If no migration save sets are



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        1





NSRCLONE(8)                                           NSRCLONE(8)


       referenced by the most recent backup, only the  full  save
       set is cloned.

       The nnssrrcclloonnee program, in conjunction with nnssrrmmmmdd(8), guar-
       antees that each save set will have at most one clone on a
       given  volume.   When you specify a volume name or identi-
       fier, 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 juke-
       box are chosen over those that require operator  interven-
       tion).   You can also specify which copy (clone) of a save
       set to use as the source; see the --SS option, below.

       Cloning between storage nodes is accomplished by  an  nnssrr--
       mmmmdd(8)  on  the  source  node  reading  from a volume, and
       another nnssrrmmmmdd(8) on the target node writing to a  volume.
       The  source node is determined by the location of a source
       volume, which is given by where the  volume  is  currently
       mounted or by its "location" field if unmounted (see mmmmlloo--
       ccaattee(8)).  The target node of a  clone  is  determined  by
       either  the "clone storage nodes" attribute of the storage
       node's client resource,  that  of  the  server's,  or  the
       "storage  nodes"  attribute  of the server.  See nnssrr__ssttoorr--
       aaggee__nnooddee(5) and nnssrr__cclliieenntt(5) for additional detail on how
       these attributes are used and on other storage node infor-
       mation.

OOPPTTIIOONNSS
       --bb _p_o_o_l
              Specifies the media pool to which  the  destination
              clones  should  be  sent.  The pool may be any pool
              currently registered with nnssrrdd(8) that has its sta-
              tus  set  to  _c_l_o_n_e.   The  possible  values can be
              viewed by selecting the Pools menu  item  from  the
              Administration  menu  of  nnwwaaddmmiinn(8).   If you omit
              this option, the cloned save sets are automatically
              sent to the _D_e_f_a_u_l_t _C_l_o_n_e pool.

       --cc _c_l_i_e_n_t
              Specifies  a  client whose save sets should be con-
              sidered in the  creation  of  a  super-full  clone.
              This option must always be specified in conjunction
              with the --NN option.

       --ff _f_i_l_e
              Instructs nnssrrcclloonnee to read the volume names, volume
              identifiers  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 _f_i_l_e may be "-", in which case
              the values are read from standard input.





NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        2





NSRCLONE(8)                                           NSRCLONE(8)


       --NN _s_a_v_e_s_e_t
              Specifies  which  save set name is used to create a
              super-full clone.  This option must always be spec-
              ified in conjunction with the --cc option.

       --ss _s_e_r_v_e_r
              Specifes  a  NetWorker  server to migrate save sets
              from.  See  nnssrr(8)  for  a  description  of  server
              selection.  The default is the current system.

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

       --SS     Causes nnssrrcclloonnee 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 mmmmiinnffoo --vv  command  (see  mmmmiinnffoo(8)).
              The --SS option is useful when you want to copy indi-
              vidual save sets from a volume  or  all  save  sets
              matching  an mmmmiinnffoo 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  _s_s_i_d_/_c_l_o_n_e_i_d  format for each save set identi-
              fier.  In this case, the _s_s_i_d and the  _c_l_o_n_e_i_d  are
              unsigned  numbers, separated by a single slash (/).
              You can find out the _c_l_o_n_e_i_d for a particular  copy
              by  using the mmmmiinnffoo --SS report, or a custom report.

       --VV     Causes nnssrrcclloonnee to treat  subsequent  command  line
              parameters as volume identifiers, not volume names.
              Volume identifiers can be found  using  the  mmmmiinnffoo
              --mmvv  report,  for  example.  This option can not be
              used in conjunction with the --SS option.

EEXXAAMMPPLLEESS
       Copy all save sets on the volume mmaarrss..000011 to a  volume  in
       the OOffffssiittee CClloonnee pool:
              nnssrrcclloonnee --bb ''OOffffssiittee CClloonnee'' mmaarrss..000011

       Copy  all  complete  save sets created during the previous
       weekend (recall that nnssrr__ggeettddaattee(3) dates without time-of-
       day  match  midnight  at the beginning of that day).  Only
       complete save sets can be copied by nnssrrcclloonnee(8):
              nnssrrcclloonnee --SS ``mmmmiinnffoo --rr ssssiidd \\
                   --qq ''!!iinnccoommpplleettee,,ssaavveettiimmee>>llaasstt ssaattuurrddaayy,,ssaavveettiimmee<<llaasstt mmoonnddaayy''``

       Copy a specific clone of a specific save set:
              nnssrrcclloonnee --SS 11553388880000551177//777700770000778866





NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        3





NSRCLONE(8)                                           NSRCLONE(8)


SSEEEE AALLSSOO
       nnssrr__ggeettddaattee(3), nnssrr__ppooooll(5), nnssrr__ssttoorraaggee__nnooddee(5),
       mmmmiinnffoo(8), nnssrr(8), nnssrrdd(8), nnssrrmmmmdd(8), nnwwaaddmmiinn(8).

DDIIAAGGNNOOSSTTIICCSS
       The exit status is zero if all of the requested save sets
       were cloned successfully, non-zero otherwise.

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

       aaddddiinngg ssaavvee sseett sseerriieess wwhhiicchh iinncclluuddeess _s_s_i_d
              If running in verbose mode, this message is printed
              when nnssrrcclloonnee 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).

       CCaannnnoott ccoonnttaacctt mmeeddiiaa ddaattaabbaassee
              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.

       ccaannnnoott cclloonnee ssaavvee sseett _n_u_m_b_e_r,, sseerriieess iiss ccoorrrruupptt
              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.

       ccaannnnoott cclloonnee bbaacckkuupp aanndd aarrcchhiivvee ddaattaa ttooggeetthheerr
              Archive and backup data is fundamentally different
              and cannot be cloned to the same pool.  You need to
              run nsrclone twice, once to clone the backup save
              sets and once more for the archive save sets.

       ccaannnnoott ooppeenn nnssrrcclloonnee sseessssiioonn wwiitthh _s_e_r_v_e_r
              This message is printed when the server does not
              accept clone sessions.

       cclloonniinngg nnoott ssuuppppoorrtteedd;; uuppggrraaddee rreeqquuiirreedd
              Another enabler is required to use this feature.

       cclloonniinngg rreeqquuiirreess aatt lleeaasstt 22 ddeevviicceess
              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.

       _s_e_r_v_e_r ddooeess nnoott ssuuppppoorrtt cclloonniinngg
              The named server is not capable of cloning.



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        4





NSRCLONE(8)                                           NSRCLONE(8)


       eerrrroorr,, nnoo vvaalliidd cclloonneess ooff ssssiidd _n_u_m_b_e_r
              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.

       eerrrroorr,, uusseerr _u_s_e_r_n_a_m_e nneeeeddss ttoo bbee oonn aaddmmiinniissttrraattoorr lliisstt
       eerrrroorr,, uusseerr _u_s_e_r_n_a_m_e nneeeeddss ttoo bbee oonn aarrcchhiivvee uusseerrss lliisstt
              Only NetWorker administrators are allowed to make
              clones of backup save sets.  NetWorker administra-
              tors are listed in the NSR server resource, see
              nnssrr__sseerrvviiccee(5) for more information.  For servers
              with archive capability, users listed in the NSR
              archive client's user list are allowed to clone
              archive save sets.

       nnoo ccoommpplleettee,, ffuullll bbaacckkuupp ooff _c_l_i_e_n_t::_s_a_v_e_s_e_t
              During an attempt to create a super-full clone,
              nnssrrcclloonnee could not find a complete, full backup of
              the requested save set.

       nnoo ccoommpplleettee ssaavvee sseettss ttoo cclloonnee
              Only complete save sets can be copied, and no com-
              plete save sets were found matching the requested
              command line parameters.

       _n_u_m_b_e_r iiss nnoott aa vvaalliidd ssaavvee sseett
              The given save set identifier is not valid.  Two
              forms are 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
              separated by a single slash (/).

       ppooooll iiss nnoott aa cclloonniinngg ppooooll
              The pool specified with the --bb _p_o_o_l option is not a
              clone pool.  You must always use a pool with a type
              of "Backup Clone" or "Archive Clone" for the --bb
              option.

       ssaavvee sseett _n_u_m_b_e_r ddooeess nnoott eexxiisstt
              The given save set (from a --SS save set list) does
              not exist.  Verify your save set identifiers using
              mmmmiinnffoo(8).

       ssaavvee sseett _n_u_m_b_e_r ccrroosssseess vvoolluummeess;; rreeqquueessttiinngg aaddddiittiioonnaall
       vvoolluummeess
              This message is printed in verbose mode when volume
              names or IDs were specified, but the given save set
              is only partially resident on the listed volumes.
              Since only complete save sets can be cloned, nnssrr--
              cclloonnee automatically requests additional volumes.





NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        5





NSRCLONE(8)                                           NSRCLONE(8)


       ssaavvee sseett cclloonnee _n_u_m_b_e_r_/_c_l_o_n_e_i_d ddooeess nnoott eexxiisstt
              A specific clone of a save set was specified, but
              that save set has no clones with that clone identi-
              fier.  Verify your save set identifiers using
              mmmmiinnffoo(8).

       vvoolluummee _n_a_m_e_-_o_r_-_n_u_m_b_e_r ddooeess nnoott eexxiisstt
              The given volume (either a volume name or a volume
              id specified in the --VV option) does not exist in
              the media database.

       wwaaiittiinngg 3300 sseeccoonnddss tthheenn rreettrryyiinngg
              A temporary error occurred and nnssrrcclloonnee will auto-
              matically retry the request until the condition is
              cleared.  For example, an error will occur if all
              devices are busy saving or recovering and nnssrrcclloonnee
              must wait for these devices become available.

       WWaarrnniinngg:: NNoo ccaannddiiddaattee mmiiggrraattiioonn ssaavvee sseettss ooff
       _c_l_i_e_n_t::_s_a_v_e_s_e_t
              If you are using nnssrrcclloonnee to create a super-full
              clone, and the most recent full backup of the named
              client and save set does not refer to any migration
              save sets, this warning is printed as nsrclone
              begins cloning the full backup.
































NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        6


