e

NNAAMMEE
       nsr_pool - NetWorker resource type ``NSR pool''

SSYYNNOOPPSSIISS
       ttyyppee:: NNSSRR ppooooll

DDEESSCCRRIIPPTTIIOONN
       Each  NSR  pool  is described by a single resource of type
       NNSSRR ppooooll (see nnssrr__rreessoouurrccee(5)).   To  edit  the  NSR  pool
       resources for a NetWorker server type:
              nsradmin -c "type:NSR pool"
       Be  careful  to  include  the quotes and the space between
       ``NSR'' and ``pool''.  See the nnssrraaddmmiinn(8) manual page for
       more  information  on  using  the NetWorker administration
       program.

       These resources are used by NetWorker  to  determine  what
       volumes  save  sets  should  reside  on depending upon the
       characteristics, e.g. Group or Level, of the  save.   Con-
       sult  your  _N_e_t_W_o_r_k_e_r _A_d_m_i_n_i_s_t_r_a_t_i_o_n _G_u_i_d_e for more guide-
       lines on using pools.

       There are four types of pools.  _B_a_c_k_u_p pools  accept  data
       from  ssaavveeggrroouupp  and manual backups.  _A_r_c_h_i_v_e pools accept
       archive data.  Data cloned  from  a  backup  pool  can  be
       directed  to  a _b_a_c_k_u_p _c_l_o_n_e pool.  Likewise, archive data
       can be cloned to a _a_r_c_h_i_v_e _c_l_o_n_e pool.

       There are four pools shipped pre-enabled  with  NetWorker.
       The  _D_e_f_a_u_l_t  pool is meant to collect any backup data not
       directed to a pool a user creates with selection criteria.
       Any  archive  data  not  directed to a pool with selection
       criteria is collected in the _A_r_c_h_i_v_e pool.   When  cloning
       data,  the  user  must  select  a destination pool for the
       operation.  The _D_e_f_a_u_l_t _c_l_o_n_e pool is available for  users
       to clone backup data to.  The _A_r_c_h_i_v_e _c_l_o_n_e pool is avail-
       able for users to clone archive data to.

       There are also a few pools shipped with NetWorker that are
       not enabled by default.  The _F_u_l_l and _N_o_n_F_u_l_l pools can be
       used to segregate full level backups from  other  backups,
       e.g.   fulls versus incrementals.  The _O_f_f_s_i_t_e pool can be
       used to generate offsite backups, because no index entries
       are  stored  for the media pool and will not be referenced
       during normal recovers.  Note  that  one  can  also  clone
       media to produce copies of data to be taken offsite.  Save
       sets that are generated without index entries can still be
       recovered using ``Save Set Recover'' feature of nnwwaaddmmiinn(8)
       or rreeccoovveerr(8).

AATTTTRRIIBBUUTTEESS
       The following attributes are defined for resource type NNSSRR
       ppooooll.   The  information  in parentheses describes how the
       attribute values are accessed.  CCrreeaattee--oonnllyy indicates that
       the  value  cannot  be changed after the resource has been
       created.  RReeaadd//wwrriittee means the value  can  be  updated  by
       authorized  administrators.  YYeess//nnoo means only a yes or no
       choice is possible.  CChhooiiccee indicates that the  value  can



                                                                1





NSR_POOL(5)                                           NSR_POOL(5)


       only be selected from a given list.  HHiiddddeenn means it is an
       attribute of interest only to  programs  or  experts,  and
       these  attributes  can only be seen when the hidden option
       is turned on in nnssrraaddmmiinn(8) or if the _D_e_t_a_i_l_s _V_i_e_w  option
       is selected in the _M_e_d_i_a _P_o_o_l_s window in nnwwaaddmmiinn(8).

       nnaammee                   (create-only)
              The  names of pool resources are used when labeling
              volumes and when determining what  volumes  a  save
              set  should  reside  on.  The name can generally be
              chosen at the administrator's convenience,  but  it
              must be unique for this NetWorker server.  The pool
              resources named DDeeffaauulltt,  DDeeffaauulltt  CClloonnee,  AArrcchhiivvee,
              and  AArrcchhiivvee  CClloonnee may not be modified or deleted.
              The pool resource named FFuullll and NNoonnFFuullll may not be
              deleted.   Other  pools  can  only be deleted if no
              volumes still reference them.
              _E_x_a_m_p_l_e_: name: Accounting;

       ggrroouuppss                 (read/write, choice)
              What _g_r_o_u_p_s  (nnssrr__ggrroouupp(5))  are  allowed  in  this
              pool.
              _E_x_a_m_p_l_e_: groups: Accounting;

       cclliieennttss                (read/write, choice)
              What  _c_l_i_e_n_t_s  (nnssrr__cclliieenntt(5))  are allowed in this
              pool.  If a _g_r_o_u_p is specified, only  clients  that
              are members of that group are allowed to be listed.
              _E_x_a_m_p_l_e_: clients: mars;

       ssaavvee sseettss              (read/write, choice)
              What save sets (nnssrr__cclliieenntt(5)) are allowed in  this
              pool.   Save  sets can be matched using the regular
              expression matching algorithm described in nnssrr__rreegg--
              eexxpp(5)).
              _E_x_a_m_p_l_e_: save sets: /, /usr;

       lleevveellss                 (read/write, choice)
              What  _l_e_v_e_l_s  (nnssrr__sscchheedduullee(5)) are allowed in this
              pool.
              _E_x_a_m_p_l_e_: levels: full;

       aarrcchhiivvee oonnllyy           (read/write, yes/no, hidden, cre-
       ate)
              If  yyeess is selected, only archive saves are allowed
              to this pool.  _T_h_i_s _h_i_d_d_e_n _a_t_t_r_i_b_u_t_e _c_a_n  _b_e  _m_o_d_i_-
              _f_i_e_d _b_y _a _u_s_e_r_.
              _E_x_a_m_p_l_e_: archive only: no;

       ssttaattuuss                 (read/write, hidden, choice)
              If  set  to  eennaabblleedd,  this  pool is considered for
              determining what pools a save set should  be  saved
              to when performing backup volume selection.  If set
              to cclloonnee, this  pool  is  considered  only  as  the



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        2





NSR_POOL(5)                                           NSR_POOL(5)


              destination  of cloning operations.  If set to ddiiss--
              aabblleedd, this pool is completely ignored.  _T_h_i_s  _h_i_d_-
              _d_e_n _a_t_t_r_i_b_u_t_e _c_a_n _b_e _m_o_d_i_f_i_e_d _b_y _a _u_s_e_r_.
              _E_x_a_m_p_l_e_: status: enabled;

       llaabbeell tteemmppllaattee         (read/write, choice)
              Determine  what  _l_a_b_e_l  _t_e_m_p_l_a_t_e  (nnssrr__llaabbeell(5)) is
              referenced when generating volume  names  for  this
              pool.
              _E_x_a_m_p_l_e_: label template: Accounting;

       ddeevviicceess                (read/write, choice)
              This  attribute lists the OONNLLYY devices volumes from
              this pool are allowed to be mounted  onto.   If  no
              devices  are  listed, volumes from this pool may be
              mounted on any device.
              _E_x_a_m_p_l_e_: devices: /dev/nrst8;

       ssttoorree iinnddeexx eennttrriieess    (read/write, yes/no, choice)
              If set to yyeess,  entries  are  made  into  the  file
              indexes  for  the  backups.   Otherwise, only media
              database entries for the save sets are created.
              _E_x_a_m_p_l_e_: store index entries: yes;

       aauuttoo mmeeddiiaa vveerriiffyy      (read/write, yes/no, choice)
              If set to yyeess, NetWorker verifies data  written  to
              volumes  from  this  pool.  Data is verified by re-
              positioning the volume to read  a  portion  of  the
              data  previously written to the media and comparing
              the data read to the original data written.  If the
              data  read  matches  the data written, verification
              succeeds otherwise it  fails.   Media  is  verified
              whenever  a volume becomes full while saving and it
              is necessary to continue onto  another  volume,  or
              when a volume goes idle because all save sets being
              written to the volume are complete.  When a  volume
              fails  verification  it is marked full so NetWorker
              will not select the volume for future  saves.   The
              volume  remains full until it is recycled or a user
              marks it not full.  If a volume fails  verification
              while  attempting  to  switch volumes all save sets
              writing to the volume are terminated.
              _E_x_a_m_p_l_e_: auto media verify: yes;

       rreeccyyccllee ttoo ootthheerr ppoooollss (read/write, yes/no, choice)
              This attribute determines whether or  not  a  given
              pool  allows other pools to  recycle its recyclable
              volume for their use.
              _E_x_a_m_p_l_e_: recycle to other pools: yes;

       rreeccyyccllee ffrroomm ootthheerr ppoooollss (read/write, yes/no, choice)
              This attribute determines whether or  not  a  given
              pool  can  recycle volumes from other pools when it
              exhausts all its write-able and recyclable volumes.



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        3





NSR_POOL(5)                                           NSR_POOL(5)


              _E_x_a_m_p_l_e_: recycle from other pools: yes;

       vvoolluummee ttyyppee pprreeffeerreennccee (read/write, choice)
              The  volume  selection preference attribute is used
              as a selection factor when a request is made for  a
              write-able volume.  The preferred type will be con-
              sidered first within a priority level such as _j_u_k_e_-
              _b_o_x or _s_t_a_n_d _a_l_o_n_e _d_e_v_i_c_e _.
              _E_x_a_m_p_l_e_: volume type preference: 4mm;


       EEXXAAMMPPLLEE

       A complete NSR pool resource, named `Default', follows:

                        type:  NSR pool;
                archive only:  No;
                     clients:  ;
                     devices:  ;
                      groups:  ;
              label template:  Default;
                      levels:  ;
                        name:  Default;
                   save sets:  ;
                      status:  Enabled;
         store index entries:  Yes;
           auto media verify:  Yes;
    recycle from other pools:  Yes;
    recycle from other pools:  Yes;
      volume type preference:  4mm;


SSEEEE AALLSSOO
       nnssrr(5),  nnssrr__llaabbeell(5), nnssrr__rreessoouurrccee(5), nnssrraaddmmiinn(8), nnwwrree--
       ccoovveerr(8), rreeccoovveerr(8), ssaavveeggrroouupp(8), ssaavveeffss(8), uuaassmm(8).






















NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        4


