Content-type: text/html Man page of NSR_MOUNT_REQUEST

NSR_MOUNT_REQUEST

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

NAME

nsr_mount_request - NetWorker resource type "NSR mount request"  

SYNOPSIS

type: NSR mount request  

DESCRIPTION

When a nsrmmd processes requires media for a session, e.g. save or recover, it sends a request to nsrd. If there is no media currently mounted which meets the requirements of the nsrmmd process, nsrd starts a nsrjb command to mount media. Before nsrd starts the nsrjb command a resource of the type NSR mount request is created. The resource exists until the corresponding nsrjb command exits. This resource and all its attributes are read only. A resource of this type may not be created or deleted using any administrative interface. See nsr_resource(5) for information on NetWorker resources. To view the NSR mount request resources run:
nsradmin -c "type:NSR mount request"

Be sure to include quotation marks and to insert a space between "NSR", "mount", and "request".  

ATTRIBUTES

The following attributes are defined for the resource type NSR mount request. The information in parentheses describes how the attribute values are accessed. Read-only indicates that the value cannot be changed by an administrator. Hidden indicates a hidden attribute of interest only to programs or experts. These attributes can only be seen when the hidden option is turned on in nsradmin(8). Static attributes change values rarely, if ever. Dynamic attributes have values that change rapidly. For example, an attribute marked (read-only, static) has a value that is set when the attribute is created and never changes.

name                    (read-only, static) The name attribute corresponds to the instance of the nsrjb
command that was created to load the media described by this resource. The instance of the nsrjb command is specified using the -O command line option.
Example: name: 15;
nsrmmd id                (read-only/ static)
This attribute records the number that identifies the nsrmmd process
which requested the media.
Example: nsrmmd id: 2;
nsrmmd host              (read-only/static)
This attribute indicates the name of the host on which the nsrmmd
process which requested the media is running.
Example: nsrmmd host: host1;
nsrmmd mount id          (read-only/static/null ok)
Some operations, e.g. cloning, require two nsrmmd processes and two volumes
be mounted at the same time. The value of this attribute will be the same for all mount requests submitted by such nsrmmd processes. When the nsrmmd which requested media is not participating in an operation which requires another nsrmmd process to complete, the value of this attribute is null.
It is possible that only one cooperating nsrmmd process may be requesting media be mounted. For example, this may occur while cloning data. If the nsrmmd writing data reaches end of media while the nsrmmd process reading data is still has data to be cloned, then the nsrmmd process writing data will request a new volume be mounted.
Example: nsrmmd mount id: 5;
operation                (read-only/static)
This attribute indicates the operation being performed by the nsrmmd
requesting media be mounted. The value for this attribute attribute can be either reading, writing, or media. If the value is set to reading, the nsrmmd process is reading data from media. It could either be recovering data or the process that is reading data from media as part of a cloning operation. If the value is set to writing, the nsrmmd process is writing data to media. It could either be saving data or the process that is writing data to media as part of a cloning operation. If the value is set to media, the nsrmmd is performing an operation that involves only the media, e.g. labeling media.
Example: operation: writing;
data operation           (read-only, static, null OK)
This attribute has a value when the
operation attribute is set to either reading or writing. If the operation attribute is set to media this attribute has no value. Values for this attribute can be either save, recover, archive, retrieve, migrate, clone, or consolidate.
Example: data operation: save;
media operation          (read-only, static)
This attribute indicates operations which are expected to be performed
on the media after it is loaded into a drive. Values for this attribute can be either mount, label, relabel, or verify. This attribute may have multiple values. For example media may be labeled and then mounted.
Example: media operation: label, mount;
pool                     (read-only, static)
The pool to which the requested media belongs or the pool to which the
media is to be added if the media operation attribute includes label or relabel values. Valid values for this attribute are any currently defined pool.
Example: pool: Default;
volume                   (read-only, static, null OK)
This attribute records the name of the volume being mounted.
The value of the attribute is NULL if the volume name is not known at the time the operation is started. This can occur when labeling scratch media.
Example: volume: vol1;
client                   (read-write, static, null ok)
This attribute is used to record the name of the NetWorker client
from which data is being read while saving (archiving) data or to which data is being written while recovering (retrieving) data.
Example: client: host1;
save set                 (read-only, static, null ok)
This attribute specifies the data being read from client and written to
media (save) or the data read from media and written to client (recover).
Example: save set: /usr;
group                    (read-only, static, null ok)
If the operation being performed by the nsrmmd which requested the mount
is the result of a command initiated by savegrp (8), this attribute records the name of the group. Otherwise there is no value. Valid values for this attribute are any currently defined group.
Example: group: Default;
 

EXAMPLE

A complete example follows:



                 type:NSR mount request;
                 name:10;
                 nsrmmd id:2;
                 nsrmmd host:host1;
                 nsrmmd mount id:tape;
                 operation:writing;
                 data operation:save;
                 media operation:label, mount;
                 volume:vol1;
                 pool:Default;
                 client:host1;
                 save set:/usr;
                 group:Default;


 

FILES

/nsr/res/nsrdb - files in this directory should never be edited directly. Use nsradmin(8), or NetWorker Management Console instead.  

SEE ALSO

nsr_resource(5), nsr_pool(5), nsr_group(5), nsr_service(5), nsr(8), nsrmmd(8), nsradmin(8),


 

Index

NAME
SYNOPSIS
DESCRIPTION
ATTRIBUTES
EXAMPLE
FILES
SEE ALSO

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