NSR_POOL(5)

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

SYNOPSIS
type: NSR pool

DESCRIPTION
Each NSR pool is described by a single resource of type NSR pool (see nsr_resource(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 nsradmin(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, for example, Group or Level, of the save. Consult your NetWorker Administrator's Guide for more guidelines on using pools.

There are four types of pools. Backup pools accept data from savegrp and manual backups. Archive pools accept archive data. Data cloned from a backup pool can be directed to a backup clone pool. Likewise, archive data can be cloned to an archive clone pool.

There are four pools shipped pre-enabled with NetWorker. The Default 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 Archive pool. When cloning data, the user must select a destination pool for the operation. The Default clone pool is available for users to clone backup data to. The Archive clone pool is available for users to clone archive data to.

There are also a few pools shipped with NetWorker that are not enabled by default. The Full and NonFull pools can be used to segregate full level backups from other backups, for example, fulls versus incrementals. The Offsite 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 the ``Save Set Recover'' feature of nwadmin(8) or recover(8).

ATTRIBUTES

The following attributes are defined for resource type NSR pool. The information in parentheses describes how the attribute values are accessed. Create-only indicates that the value cannot be changed after the resource has been created. Read/write means the value can be updated by authorized administrators. Yes/no means only a yes or no choice is possible. Choice indicates that the value can only be selected from a given list. 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(8) or if the Details View option is selected in the Media Pools window in nwadmin(8).

archive only	(read/write, yes/no, hidden, create)
    If yes is selected, only archive saves are allowed to this pool. This hidden attribute can be modified by a user.
    Example: archive only: no;

auto media verify	(read/write, yes/no, choice)
    If set to yes, 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.
    Example: auto media verify: yes;

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

devices	(read/write, choice)
    This attribute lists the ONLY devices that 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.
    Example: devices: /dev/nrst8;

groups	(read/write, choice)
    What groups (nsr_group(5)) are allowed in this pool.
    Example: groups: Accounting;

label template	(read/write, choice)
    Determine what label template (nsr_label(5)) is referenced when generating volume names for this pool.
    Example: label template: Accounting;

levels	(read/write, choice)
    What levels (nsr_schedule(5)) are allowed in this pool.
    Example: levels: full;

name	(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 be chosen at the administrator's convenience, but it must be unique for this NetWorker server. The pool resources named Default, Default Clone, Archive, and Archive Clone cannot be modified or deleted. The pool resource named Full and NonFull cannot be deleted. Other pools can only be deleted if no volumes still reference them.
    Example: name: Accounting;

recycle from other pools 	(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.
    Example: recycle from other pools: yes;

recycle to other pools	(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.
    Example: recycle to other pools: yes;

save sets	(read/write, choice)
    What save sets (nsr_client(5)) are allowed in this pool. Save sets can be matched using the regular expression matching algorithm described in nsr_regexp(5)).
    Example: save sets: /, /usr, C:\windows\system, *.JPG ;

status	(read/write, hidden, choice)
    If set to enabled, this pool is considered for determining what pools a save set should be saved to when performing backup volume selection. If set to clone, this pool is considered only as the destination of cloning operations. If set to disabled, this pool is completely ignored. This hidden attribute can be modified by a user.
    Example: status: enabled;

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

volume type preference	(read/write, choice)
    This attribute is used as a selection factor when a request is made for a write-able volume. The preferred type will be considered first within a priority level such as jukebox or stand alone device .
    Example: volume type preference: 4mm;

EXAMPLE

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;

SEE ALSO
nsr(5), nsr_label(5), nsr_resource(5), nsradmin(8), nwrecover(8), recover(8), savegroup(8), savefs(8), uasm(8)