


NSR_MIGRATION(5)                                 NSR_MIGRATION(5)


NNAAMMEE
       nsr_migration - NetWorker resource type ``NSR migration''

SSYYNNOOPPSSIISS
       ttyyppee:: NNSSRR mmiiggrraattiioonn

DDEESSCCRRIIPPTTIIOONN
       Each  NSR  migration  client  is  described  by  a  single
       resource of type NNSSRR mmiiggrraattiioonn (see nnssrr__rreessoouurrccee(5)).   To
       edit  the  NSR  migration resources for a NetWorker server
       type:

              nsradmin -c "type:NSR migration"

       See the nnssrraaddmmiinn(8) manual page for  more  information  on
       using  the  NetWorker  administration program.  The client
       resource may also be edited using the command  nnwwaaddmmiinn(8).

       For   each   NetWorker  migration  client,  this  resource
       describes which files should be saved, the  schedule  used
       to  save  these  files,  which directive should be used to
       omit files from the save, the group  that  files  will  be
       pre-migrated  with, the high-water mark for migration, the
       low-water mark for migration, the minimum last access time
       for file migration, the minimum file size for migration, a
       list of file owners and groups to include or  exclude  for
       migration, and a list of file name patterns to skip migra-
       tion of.   A  client  may  have  more  than  one  resource
       describing it.

AATTTTRRIIBBUUTTEESS
       The following attributes are defined for resource type NNSSRR
       mmiiggrraattiioonn.  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(8)  or  by
       selecting  the  details  Menu  Item in the View Menu for a
       particular window in nnwwaaddmmiinn(8).  DDyynnaammiicc attributes  have
       values which change rapidly.  EEnnccrryypptteedd attributes contain
       data that is not displayed  in  its  original  form.   The
       assumption  is  that  the  data is sensitive in nature and
       needs to be protected from accidental disclosure.  Several
       additional  attributes  (e.g. administrator) are common to
       all resources, and are described in nnssrr__rreessoouurrccee(5).

       nnaammee           (read-only, single string)
              This attribute identifies the NetWorker client  and
              save  set  whose migration attributes are stored in
              this resource.
              _E_x_a_m_p_l_e_: name: venus All;




NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        1





NSR_MIGRATION(5)                                 NSR_MIGRATION(5)


       cclliieenntt              (read-only, single string)
              The _c_l_i_e_n_t _n_a_m_e identifies  the  HSM  client  whose
              save sets are to be placed under migration control.
              This name must be a valid name for an existing  NSR
              client resource.
              _E_x_a_m_p_l_e_: client: elantra;

       ssaavvee sseett                        (read/write, list)
              The  _s_a_v_e  _s_e_t  attribute  lists  the path names of
              filesystems or sub-trees within filesystems to  put
              under migration control for this client.  The names
              should be separated  by  comma  space  (,  ).   The
              default  value  is  `All'.   On Unix clients, `All'
              refers to all mounted file systems, except for  the
              filesystems  /,  /usr,  /var (and /opt on solaris),
              where migration of files is not allowed.

              _E_x_a_m_p_l_e_: save set: /usr/src, /spare;

       eennaabblleedd                  (read/write, choice)
              The _e_n_a_b_l_e_d attribute determines whether  the  save
              set  named in this resource should be automatically
              migrated.  A resource can be disabled to  temporar-
              ily  keep  migration  from occuring. On update, any
              ongoing migration operations  will  complete.  This
              attribute has no affect on recall operations.
              _E_x_a_m_p_l_e_: enabled:  No;

       ddiirreeccttiivvee               (read/write, choice)
              Directives  tell  the client how to migrate certain
              files.  The choices  are  defined  by  the  set  of
              existing  directives.   The  default value is NULL.
              The valid choices for the  directive  resource  are
              names  of  the  currently  defined  `NSR directive'
              resources, see nnssrr__ddiirreeccttiivvee(5).
              _E_x_a_m_p_l_e_: directive: Unix  with  compression  direc-
              tives;

       ggrroouupp               (read/write, list)
              The  groups this client/saveset is part of for pre-
              staging migrated files.  The choices are defined by
              the set of existing groups.
              _E_x_a_m_p_l_e_: group: Default;

       hhiigghhwwaatteerr mmaarrkk %%    (read/write, single string)
              The   point  at  which  files  should  start  being
              replaced by stubs, measured as  the  percentage  of
              available space used on the file system.  Migration
              (stub replacement) will continue  until  the  lower
              water mark is reached.
              _E_x_a_m_p_l_e_: high water mark (%): 90;

       llooww wwaatteerr mmaarrkk %%    (read/write, single string)
              The  point  at  which  files  should  be stop being



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        2





NSR_MIGRATION(5)                                 NSR_MIGRATION(5)


              replaced by stubs, measured as  the  percentage  of
              available space used on the file system.
              _E_x_a_m_p_l_e_: low water mark (%): 80;

       llaasstt aacccceessss ttiimmee    (read/write, single string)
              Migrate   only  those  files  that  have  not  been
              accessed in the past specified relative  time.   If
              this value is empty, the last access time to not be
              considered.
              Example values: 5 days ago, 1 month ago,  1  second
              ago.
              _E_x_a_m_p_l_e_: last access time: 7 days ago

       mmiinniimmuumm ffiillee ssiizzee ((KKBB))   (read/write, single string)
              Migrate  only those files that are larger than then
              specified size (in KiloBytes).  Setting this  value
              to zero causes file size to not be considered.
              _E_x_a_m_p_l_e_: minimum file size (KB): 5;

       ffiillee oowwnneerr          (read/write, list)
              A list of the users whose files should be migrated.
              A leading dash (`-') in a user name indicates nega-
              tion,  in  which  case  all  users except the named
              user's files will be migrated.
              _E_x_a_m_p_l_e_: file owner: karl, cohrs;

       ffiillee ggrroouupp          (read/write, list)
              A  list  of  the  groups  whose  files  should   be
              migrated.   A  leading  dash  (`-') in a group name
              indicates negation, in which case all groups except
              the named group's files will be migrated.
              _E_x_a_m_p_l_e_: file group: staff, developers;

       pprreesseerrvvee       (read/write, list)
              A  list of regular expressions, in the client shell
              syntax (e.g. /bin/sh syntax on Unix).  A file  name
              which  matches any pattern in the list will be pre-
              served and will never be migrated.
              _E_x_a_m_p_l_e_: preserve: *.exe *.dll;

       ssttaattiissttiiccss          (read/write, hidden, list)
              A list of statistics about recent migration  activ-
              ity   for   the  save  set(s)  managed  using  this
              resource.  The first value is the last update time.
              Subsequent  groups  of  values  contain  a save set
              name, and statistics. The statistics are  currently
              a  date,  K-bytes pre-migrated, files pre-migrated,
              K-bytes stubbed, files stubbed, K-bytes de-migrated
              and files de-migrated.

       uuppddaattee ssttaattiissttiiccss   (read/write, hidden, choice)
              This   controls  whether  the  statistics  in  this
              resource should be updated  to  match  the  current
              values  on  the client.  Selecting "Yes" causes the



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        3





NSR_MIGRATION(5)                                 NSR_MIGRATION(5)


              statistics to be updated, but the  attribute  value
              will not actually change.
              _E_x_a_m_p_l_e_: update statistics:  No;

EEXXAAMMPPLLEESS
       Note:  the hidden options are not shown in these examples.

       A resource  to  define  an  HSM  client,  called  elantra,
       migrating and recalling files in the /test filesystem from
       a NetWorker server:
                               type: NSR migration;
                               name: "elantra:/test";
                             client: elantra;
                           save set: /test;
                            enabled:  Yes;
                          directive:  Unix with compression directives ;
                              group:  Default;
                high water mark (%): 90;
                 low water mark (%): 80;
                   last access time: ;
             minimum file size (KB): 5;
                         file owner: joe, dave;
                         file group: staff, developers;
                           preserve: *.exe *.dll;


       A resource  to  define  an  HSM  client,  called  elantra,
       migrating  and recalling files owned by the user "karl" in
       all filesystems except for /, /usr, and /var (and /opt  on
       solaris), to the NetWorker server jupiter:
                               type: NSR migration;
                               name: "elantra:All";
                             client: elantra;
                           save set: All;
                            enabled:  Yes;
                          directive:  Unix with compression directives ;
                              group: Default ;
                high water mark (%): 90;
                 low water mark (%): 60;
                   last access time: ;
             minimum file size (KB): 10;
                         file owner: ;
                         file group: ;
                           preserve: ;


SSEEEE AALLSSOO
       nnssrr(5), nnssrr__ddiirreeccttiivvee(5), nnssrr__ggrroouupp(5), ssaavveeggrrpp(8),
       ssaavveeffss(8), nnssrrppmmiigg(8), nnssrrmmiigg(8), nnssrrhhssmmcckk(8), nnssrraadd--
       mmiinn(8), nnssrreexxeeccdd(8), nnwwaaddmmiinn(8).







NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        4


