


NSRSSC(8)                                               NSRSSC(8)


NNAAMMEE
       nsrssc - NetWorker save set consolidation program

SSYYNNOOPPSSIISS
       nnssrrsssscc --cc _c_l_i_e_n_t --NN _s_a_v_e_s_e_t [ --pp _p_o_o_l ] [ --rr ] [ --vvqq ]

DDEESSCCRRIIPPTTIIOONN
       nnssrrsssscc consolidates the most recent level 1 (partial) save
       set and its corresponding full level save set into  a  new
       full  level  save  set.  This consolidation process effec-
       tively achieves the same outcome as a full level backup at
       the time partial backup was done.

       Normally, nnssrrsssscc is invoked within ssaavveeggrrpp(8) as part of a
       _C_o_n_s_o_l_i_d_a_t_i_o_n level backup. During the _C_o_n_s_o_l_i_d_a_t_i_o_n level
       backup,  ssaavveeggrrpp(8)  automatically  generates  a  level  1
       backup, then calls nnssrrsssscc to create a consolidated backup,
       using the latest full level save set.

       Using  nnssrrsssscc allows for greater flexibility in scheduling
       backups and save set consolidation.  Unlike the ssaavveeggrrpp((88))
       command,  which  completes  a consolidation backup prompty
       after the level 1 backup is completed, nnssrrsssscc  allows  you
       to   schedule  the  consolidation  at  a  different  time.
       Scheduling a time between the full backup  and  consolida-
       tion  backup  frees  up  NetWorker  to complete other pro-
       cesses.

       If nnssrrsssscc is executed manually, the most  recently  backed
       up  save  set  must  be a level 1 save set; otherwise, the
       consolidation will not be successful.

       The nnssrrsssscc command requires at least two  active  devices.
       The  consolidation  process uses simultaneous device reads
       and writes to create  its  consolidated  save  set.   This
       mechanism  creates  a restriction upon the location of the
       newly created save set.  The new saveset _c_a_n_n_o_t be created
       on  the  same volume on which the partial or full save set
       from which it was derived reside.  Also, volumes  contain-
       ing  the previous full and level 1 must reside on the same
       storage node.


OOPPTTIIOONNSS
       --cc _c_l_i_e_n_t
              The name of the  client  whose  saveset  should  be
              included for the consolidation process.

       --NN _s_a_v_e_s_e_t
              The name for the generated consolidated save set.

       --pp _p_o_o_l
              Specifies  the  destination media pool to build the
              consolidated full save set.  The pool  may  be  any



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        1





NSRSSC(8)                                               NSRSSC(8)


              pool   currently   registered   with  nnssrrdd(8);  the
              selected pool _m_u_s_t be the same  pool  type  as  the
              previous full level save set.  Possible pool values
              can be viewed by selecting the Pools menu item from
              the Administration menu of nneettwwoorrkkeerr(8).  Pool val-
              ues are also listed in the  NNSSRRppooooll  resource  (see
              nnssrr__ppooooll(5))

              If  this  option  is omitted, then the consolidated
              save sets is automatically built on volume(s) whose
              media pool is the same as that of the previous full
              level save set.

       --rr     Removes the level 1 save set. If the level  1  save
              set  is on tape, then the save set will be expired.
              If the level 1 save set is on diskfile type volume,
              then  the  save  set  (both  its index entries, its
              media database entries, and  the  actual  save  set
              data  on disk) is removed.  Please note that nnssrrsssscc
              will _n_e_v_e_r attempt to remove the level 1 if consol-
              idation fails.

       --vv     Enable verbose operation.  In this mode, additional
              messages may be generated during the  consolidation
              process.

       --qq     Run quietly.  (This is the default mode.)

SSEEEE AALLSSOO
       nnssrr__sscchheedduullee(5), nnssrr__mmmmiinnffoo(8), ssaavveeggrrpp(8)

EEXXAAMMPPLLEESS
       The following examples demonstrate how save set consolida-
       tion can be  performed.  In  both  examples,  a  save  set
       defined in a group name _e_l_m_a_n_c_o is consolidated for client
       _d_e_l_e_p_a_n_t_o _.  The save set data for group _e_l_m_a_n_c_o  is  _/_e_t_c
       and _/_u_s_e_r_s _.

       Example #1

       To perform a save set consolidation, perform the following
       commands:
              ssaavveeggrrpp --GG eellmmaannccoo --ll 11 --II
              nnssrrsssscc --cc ddeelleeppaannttoo --NN //eettcc
              nnssrrsssscc --cc ddeelleeppaannttoo --NN //uusseerrss

       Note that this example is almost the same as doing a ssaavvee--
       ggrrpp --GG eellmmaannccoo --ll cc..  The only differences are:
        1)   no  index and bootstrap is backed after data is con-
       solidated.
        2)  if there is a failure during  the  consolidated  pro-
       cess, a full backup is not performed.

       Example #2:



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        2





NSRSSC(8)                                               NSRSSC(8)


       To  direct  level  1  data to a disk cache (i.e. file-type
       device) and have the level 1 save set removed after a full
       level  save  set  is  built on tape, perform the following
       operations:

       First, set-up a pool which only accepts level 1  data  and
       its devices are only file type devices.  Then run the fol-
       lowing commands:
              ssaavveeggrrpp --GG eellmmaannccoo --ll 11 --II
              nnssrrsssscc --cc ddeelleeppaannttoo --NN //eettcc --rr
              nnssrrsssscc --cc ddeelleeppaannttoo --NN //uusseerrss --rr

       This process removes the level 1 completely.  Also,  since
       fast media (i.e. disk-file type) is involved, this process
       may very well be a much faster way of  generating  a  full
       level  save  set  then compared to do a regular full level
       backup.

DDIIAAGGNNOOSSTTIICCSS
       On successful completion, nnssrrsssscc returns zero;  otherwise,
       a non-zero value is returned.

       Some error codes are:

       98    Failed because the level 1 and previous full are not
       in the same storage node.

       99   Failed, most likely due to a  renamed/deleted  direc-
       tory condition

       You may also see one of the following messages:

       YYoouu aarree nnoott aauutthhoorriizzeedd ttoo rruunn tthhiiss ccoommmmaanndd
              Only  root  or  NetWorker  administrators  may  run
              nnssrrsssscc

       CCaannnnoott ccoonnttaacctt mmeeddiiaa ddaattaabbaassee
              Most likely, nnssrrmmmmdd(8)  is  unavailable  to  answer
              queries,  or  an additional NetWorker daemon may be
              done.  In this case, the system administrator needs
              to  determine  if the NetWorker services need to be
              restarted.  Note, there may  be  a  small  interval
              during startup when the services may be unavailable
              to answer any queries.













NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        3


