Content-type: text/html Man page of NSR_STAGE

NSR_STAGE

Section: File Formats (5)
Updated: Dec 11, 08
Index Return to Main Contents
 

NAME

nsr_stage - NetWorker resource type ``NSR stage''  

SYNOPSIS

type: NSR stage  

DESCRIPTION

Each staging policy used by a NetWorker server is described by a single resource of type NSR stage. See nsr_resource(5) for information on NetWorker resources. To edit the NSR stage resources run:

nsradmin -c "type:NSR stage"

Be careful to include the space between ``NSR'' and ``stage'' and the surrounding quotes. See nsradmin(1m) for information on using the NetWorker administration program.  

ATTRIBUTES

The following attributes are defined for resource type NSR stage. The information in parentheses describes how the attribute values are accessed. Read-only indicates that the value cannot be changed by an administrator. Read/write means the value can be set as well as read. Hidden 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 nsradmin(1m). Static attributes change values rarely, if ever. Dynamic attributes have values which change rapidly. For example, an attribute marked (read-only, static) has a value which is set when the attribute is created and may never change. Additional attributes (for example, administrator) are common to all resources, and are described in nsr_resource(5).

name (read-only, single string)
The name attribute specifies the staging policy name.
comment               (read/write)
This attribute is provided for the administrator to keep any explanatory
remarks or supplementary information about the staging policy.
enabled (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: Yes, No
high water mark (%) (read/write)
The point at which save sets should be staged, measured as the percentage of available space used on the file system. Staging will continue until the lower mark is reached.

Example: high water mark (%): 90;

low water mark (%) (read/write)
The point at which the staging process should stop, measured as the percentage of available space used on the file system.

Example: low water mark (%): 80;

save set selection (read/write, choice)
Save set selection criteria for staging. It may be one of four values:

largest save set,
smallest save set,
oldest save set,

 or
youngest save set.

destination pool (read/write)
The pool to which save sets should be sent (see nsr_pool(5)).
devices (read/write, multiple choice)
This attribute lists the file type and adv_file type devices (see nsr_device(5)) associated with this policy to be used as the source of staging.
max storage period (read/write)
Specifies the maximum duration for a save set in a given volume before it is staged to a different volume.
max storage period unit (read/write, choice, hidden)
Specifies the unit for max storage period. It may be one of two values: days, hours.
recover space interval (read/write, hidden)
The interval between recover space operations for recyclable, aborted save sets and save sets with no entries in the media database from file or adv_file devices.
recover space unit (read/write, choice, hidden)
Specifies the unit for recover space interval. It may be one of two values: hours, minutes.
file system check interval (read/write, hidden)
The interval between file system check operations. Stage operation is invoked by NetWorker server every file system check interval to determine whether the high water mark or max storage period has been reached to stage the data from the devices associated with the policy.
file system check unit (read/write, choice, hidden)
Specifies the unit for file system check interval. It may be one of two values: hours, minutes.
start now (read/write, choice)
Updating this attribute will cause the selected operation 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:

Check file system - check file system and stage data if necessary.
Recover space - recover space for save sets with no entries in the media database.
Stage all save sets - stage all save sets to the destination pool.

 

EXAMPLES

Note: the hidden options are not shown in the first example.

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;
                     comment: ;
                     enabled: No   [Yes];
         high water mark (%): 90;
          low water mark (%): 85;
          save set selection: largest save set;
            destination pool: Default Clone;
                     devices: /disk/fd0;
          max storage period: 7;
                   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 3 hours and a staging operation will be triggered if necessary. A recover-space operation will be triggered every 8 hours on all devices associated with the policy:

                        type: NSR stage;
                        name: test stage2;
                     comment: ;
                     enabled: No   [Yes];
         high water mark (%): 95;
          low water mark (%): 80;
          save set selection: smallest save set;
            destination pool: Default;
                     devices: /disk/fd2;
          max storage period: 14;
     max storage period unit: Hours   [Days];
      recover space interval: 8;
          recover space unit: Minutes   [Hours];
  file system check interval: 3;
      file system check unit: Minutes   [Hours];
                   start now: ;
               administrator: [email protected];
                    hostname: omni;

 

SEE ALSO

nsr(5), nsr_device(5), nsrstage(1m), nsrclone(1m), nsradmin(1m),


 

Index

NAME
SYNOPSIS
DESCRIPTION
ATTRIBUTES
EXAMPLES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:39:48 GMT, October 02, 2010