Content-type: text/html Man page of NSR_LA


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


NSRLA - Resource for the NetWorker client execution service  


type: NSRLA  


The NSRLA resource is used by NetWorker client execution service nsrexecd (see nsrexecd(8)). To edit the NSRLA resources run:

nsradmin -s host_name -p nsrexec -c type:NSRLA


nsradmin -s host_name -p 390113 -v 1 -c type:NSRLA

See nsradmin(1m) for information on using the NetWorker administration program.  


The following attributes are defined for resource type NSRLA The information in parentheses describes how the attribute values are accessed. 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. For example, an attribute marked (read-only, static) has a value which is set when the attribute is created and may never change. Not all attributes are available on all Operating Systems.

name (read-only, single string)
The name attribute specifies the NW instance name of the local install. This value is is a shorthand for the NW instance name. The value in this attribute should be entered where ever a NetWorker instance needs to be referred to. The default value is hostname. The value should be unique throughout the data zone.
NW instance ID (read-only, hidden, single string)
The NW instance ID. This value will be used to identify the local NetWorker install whenever a NetWorker program needs to communicate with another NetWorker program. This value has a one to one correspondence with the NetWorker instance name. The value is created by NetWorker by default. It should be unique throughout the data zone.
certificate (read-only, hidden, single string)
The certificate for the local NetWorker installation. The certificate is used by remote NetWorker installations to validate the identity of the local NetWorker install.
private key (read-only, hidden, single string)
The private key for the local NetWorker installation. The private key is used to validate the identity of the local NetWorker install to remote NetWorker installations. No users can view this attribute.
NW instance info operations (read-write, dynamic, choice)
One can use this attribute to import or export the NW instance information, or request that NetWorker generate a new private key and certificate. The NW instance information includes: the name, NW instance ID, certificate, and private key attributes. Setting this field to: Export will cause NetWorker to export the NW instance information to a file specified in the NW instance info file attribute. Setting this field to: Import will cause NetWorker to import the NW instance information from the file specified by the NW instance info file attribute and set the corresponding values in the nsr_la(5) resource. Setting this field to: New Keys will cause NetWorker to generate a new private key and certificate and store the values in the private key and certificate fields. The previous values in these fields will be overwritten. This field will be reset to blank after NetWorker uses the value.
NW instance info file (read-write, dynamic, single string)
This field is used to specify a file name where NetWorker should load/store information when the NW instance info operations attribute is set to Export or Import. This field will be reset to blank after NetWorker uses the value.
version (constant, single string)
The software release version string. The string is made up of four parts: the company name, the product name, the release identifier, and the release timestamp.
servers (constant, list of string)
The list of NetWorker servers allowed to back up this client.
disable directed recover (read-write, hidden, choice yes/no)
Determines whether remote hosts are allowed to direct recoveries to this host. The default setting is no which means that remote hosts are allowed to direct recoveries to this host. To disable the ability of remote hosts to direct recoveries to this host, set this attribute to yes.
auth methods (read-write, list of strings)
This field will be used to specify the list of authentication methods that are allowed for communicating with the listed peer. The allowed authentication methods can be specified on a per peer basis.

The auth methods field is a multivalued attribute whose values are of the following format (in regular expression format):


where IP = the peer's IP address or a network IP address, mask = the network mask (in the format or a number indicating the number of 1's on the left side of the mask), and auth1, ..., authN are of the values: nsrauth or oldauth.

The value: oldauth indicates that AUTH_NONE, AUTH_UNIX, and AUTH_LGTO will be accepted by a TCP server and tried by a TCP client for the indicated set of peers. The value of nsrauth indicates that GSS EMC v1 authentication or nsr logon authentication (used by the GUI) will be tried/accepted.

The "auth methods" field is order dependent. That is, the client/server will look for a match for the peer in the list starting with the first entry. It will continue looking through the list until it finds a match. If it does not find a match, then it will use the default value of: ",nsrauth/oldauth".

For example:

The following entries (combined) mean that the host: can use AUTH_NONE, AUTH_UNIX, and AUTH_LGTO to authenticate, anything on the network: network can use AUTH_NONE, AUTH_UNIX, AUTH_LGTO, and GSS EMC v1 to authenticate, and all other machines must use GSS EMC v1 to authenticate.

",oldauth", ",nsrauth/oldauth", ",nsrauth"

types created (constant, hidden, list of strings)
The type of resources that can be created by the NSRLA server. (see hagentd(8)).
administrator (read-write, list of strings)
The administrator list contains users and user netgroups that are allowed to add, delete, and update the NSRLA resources. Netgroups are indicated by preceeding the name by an ampersand ('&') character. The NSRLA administrator list is used by default for all other NSRLA resources. Updating this list will also update the other resources on this server that have not been explicitly changed.
arch (constant, single string)
The instruction set architecture determines which user programs are binary compatible.
kernel arch (constant, single string)
The kernel architecture determines which operating system kernels are binary compatible.
CPU type (constant, single string)
The CPU type of this machine.
machine type (constant, single string)
The high-level type of this machine, e.g. server or workstation.
OS (constant, single string)
The operating system and version number.
NetWorker version (constant, single string)
The version of NetWorker client.
client OS type (constant, single string)
The operating system running on this machine.
CPUs (constant, number)
The number of CPUs on the system.
disks (const, number)
The number of secondary storage devices on the system that can be backed up.
MB used (dynamic, number)
The current total amount of disk storage used in MB.
IP address (constant, list of string)
Dotted-decimal Internet Protocol address list.
hostname (constant, hidden, single string)
The hostname of the machine on which the service that controls this resource is running. It is used internally and cannot be changed by the administrator.
ONC program number (constant, hidden, number)
The Open Network Computing (sunrpc) identification number for the client to server protocol provided by this service.
ONC version number (constant, hidden, number)
The Open Network Computing (sunrpc) identification number for the client to server protocol provided by this service.
ONC transport (constant, hidden, list of choice)
The Open Network Computing (sunrpc) transport protocols supported are TCP (the Transport Control Protocol) or UDP (the User Datagram Protocol).


nsradmin(1m), nsrexecd(8), hagentd(8).




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