NSR_STAGE(5)

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) or if the Details View option is selected in the Stage window in nwadmin(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.

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

max storage period           (read/write)
    Specifies the maximum number of days for a save set in a given volume before it is staged to a different volume.

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)
    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 devices associated with this policy.

Recover space interval          (read/write, hidden)
    The number of hours between recover space operations for save sets with no entries in the media database form file devices.

Fs check interval          (read/write, hidden)
    The number of hours between file system check operations.

Start now	(read/write)
    Updating this aribute 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 fs - check file system and stage data if neccessary.
    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;
                   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 operation will be triggered if necessary. A recover-space operation (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;

SEE ALSO
nsrstage(1m), nsrclone(1m), nsradmin(1m), nwadmin(1m).