


NSR_STAGE(5)                                         NSR_STAGE(5)


NNAAMMEE
       nsr_stage - NetWorker resource type ``NSR stage''

SSYYNNOOPPSSIISS
       ttyyppee:: NNSSRR ssttaaggee

DDEESSCCRRIIPPTTIIOONN
       Each   staging  policy  used  by  a  NetWorker  server  is
       described by a single resource of  type  NNSSRR  ssttaaggee.   See
       nnssrr__rreessoouurrccee(5)  for  information  on NetWorker resources.
       To edit the NNSSRR ssttaaggee resources run:
              nsradmin -c "type:NSR stage"
       Be careful  to  include  the  space  between  ``NSR''  and
       ``stage''  and  the  surrounding quotes.  See nnssrraaddmmiinn(1m)
       for information on using the NetWorker administration pro-
       gram.

AATTTTRRIIBBUUTTEESS
       The following attributes are defined for resource type NNSSRR
       ssttaaggee.  The information in parentheses describes  how  the
       attribute  values  are accessed.  RReeaadd--oonnllyy indicates that
       the  value  cannot  be  changed   by   an   administrator.
       RReeaadd//wwrriittee  means  the  value  can be set as well as read.
       HHiiddddeenn means it is an attribute of interest only  to  pro-
       grams  or  experts,  and these attributes can only be seen
       when the hidden option is turned on in nnssrraaddmmiinn(1m) or  if
       the _D_e_t_a_i_l_s _V_i_e_w option is selected in the _S_t_a_g_e window in
       nnwwaaddmmiinn(1m).  SSttaattiicc attributes change values  rarely,  if
       ever.    DDyynnaammiicc   attributes  have  values  which  change
       rapidly.  For example,  an  attribute  marked  ((rreeaadd--oonnllyy,,
       ssttaattiicc))  has  a  value  which is set when the attribute is
       created and  may  never  changes.   Additional  attributes
       (e.g.  administrator) are common to all resources, and are
       described in nnssrr__rreessoouurrccee(5).

       nnaammee          (read-only, single string)
              The name attribute  specifies  the  staging  policy
              name.

       eennaabblleedd          (read/write, choice)
              The  enabled  attribute  determines  whether or not
              save sets are  automatically  staged  from  devices
              associated  with  this policy.  It also enables and
              disables the periodic   recover  space  operations.
              It may be one of two values: _Y_e_s_, _N_o

       mmaaxx ssttoorraaggee ppeerriioodd           ((rreeaadd//wwrriittee))
              Specifies the maximum number of _d_a_y_s for a save set
              in a given volume before it is _s_t_a_g_e_d to a  differ-
              ent volume.

       hhiigghh wwaatteerr mmaarrkk %%            ((rreeaadd//wwrriittee))
              The point at which save sets should be _s_t_a_g_e_d_, mea-
              sured as the percentage of available space used  on



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        1





NSR_STAGE(5)                                         NSR_STAGE(5)


              the  file  system.  Staging will continue until the
              lower mark is reached.
              _E_x_a_m_p_l_e_: high water mark (%): 90;

       llooww wwaatteerr mmaarrkk %%          (read/write)
              The point at which the staging process should _s_t_o_p_,
              measured  as the percentage of available space used
              on the file system.
              _E_x_a_m_p_l_e_: low water mark (%): 80;

       SSaavvee sseett sseelleeccttiioonn          (read/write)
              Save set selection criteria for staging.  It may be
              one of four values:
              _l_a_r_g_e_s_t _s_a_v_e _s_e_t
              _s_m_a_l_l_e_s_t _s_a_v_e _s_e_t
              _o_l_d_e_s_t _s_a_v_e _s_e_t
               or
              _y_o_u_n_g_e_s_t _s_a_v_e _s_e_t_.

       DDeessttiinnaattiioonn ppooooll          (read/write)
              The  pool  to  which  save sets should be sent (see
              nnssrr__ppooooll(5)).

       DDeevviicceess          (read/write, multiple choice)
              This attribute lists the _f_i_l_e _t_y_p_e devices  associ-
              ated with this policy.

       RReeccoovveerr ssppaaccee iinntteerrvvaall          (read/write, hidden)
              The  number  of  _h_o_u_r_s between recover space opera-
              tions for save sets with no entries  in  the  media
              database form file devices.

       FFss cchheecckk iinntteerrvvaall          (read/write, hidden)
              The number of _h_o_u_r_s between file system check oper-
              ations.

       SSttaarrtt nnooww (read/write)
              Updating this aribute will cause the selected oper-
              ation  to  be  triggered immediately on all devices
              associated with this policy.  The  attribute  value
              will  not actually change.  Operation can be one of
              the following:
              _C_h_e_c_k _f_s check file system and stage data  if  nec-
              cessary.
              _R_e_c_o_v_e_r  _s_p_a_c_e  recover space for save sets with no
              entries in the  media  database  (garabage  collec-
              tion).
              _S_t_a_g_e _a_l_l _s_a_v_e _s_e_t_s stage all save sets to the des-
              tination pool.

       _E_X_A_M_P_L_E_S

       Note:  the hidden options are not shown in the first exam-
       ple.



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        2





NSR_STAGE(5)                                         NSR_STAGE(5)


       The  following  example  shows  a  resource that defines a
       stage policy called `test  stage1'.   Save  sets  will  be
       staged  from  device  `/disk/fd0'  to pool `Default Clone'
       when the file system is 90% full or 7 days after the  date
       of  the  backup,  whichever comes first.  The largest save
       set will be the first to stage to the destination pool:
                               type: NSR stage;
                               name: test stage1;
                          autostart: Enabled;
                 max storage period: 7;
                high water mark (%): 90;
                 low water mark (%): 85;
                 save set selection: largest save set;
                   destination pool: Default Clone;
                            devices: /disk/fd0;
                          start now: ;

       The following example shows  a  resource  that  defines  a
       stage  policy  called  `test  stage2'.   Save sets will be
       staged from device `/disk/fd2' to pool `Default' when  the
       file  system  is 95% full or 14 days after the date of the
       backup, whichever comes first.  The smallest save set will
       be  the  first to stage to the destination pool.  The file
       system will be checked every 1 hour and a  staging  opera-
       tion will be triggered if necessary. A recover-space oper-
       ation  (for  save  sets  with  no  entries  in  the  media
       database)  will  be triggered every 3 hours on all devices
       associated with the policy:
                               type: NSR stage;
                               name: test stage2;
                          autostart: Enabled;
                 max storage period: 14;
                high water mark (%): 95;
                 low water mark (%): 80;
                 save set selection: smallest save set;
                   destination pool: Default;
                            devices: /disk/fd2;
             recover space interval: 3;
                  fs check interval: 1;
                          start now: ;
                      administrator: root@omni;
                           hostname: omni;


SSEEEE AALLSSOO
       nnssrrssttaaggee((11mm)),, nnssrrcclloonnee((11mm)),, nnssrraaddmmiinn(1m), nnwwaaddmmiinn(1m).











NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        3


