nsrla(5)
nsrla(5)
NAME
NSRLA - resource for the NetWorker client execution service
SYNOPSIS
type: NSRLA
DESCRIPTION
The NSRLA resource is used by NetWorker client execution service nsrex-
ecd (see nsrexecd(8)). To edit the NSRLA resources run:
nsradmin -s host_name -p nsrexec -c type:NSRLA
or
nsradmin -s host_name -p 390113 -v 1 -c type:NSRLA
See nsradmin(1m) for information on using the NetWorker administration
program.
ATTRIBUTES
The following attributes are defined for resource type NSRLA The infor-
mation 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 Net-
Worker 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 cer-
tificate 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 pri-
vate 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 pri-
vate 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):
IP(/mask)?,auth1(/authN)*
where IP = the peer's IP address or a network IP address, mask =
the network mask (in the 255.255.0.0 format or a number indicat-
ing 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 authenti-
cation (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:
"0.0.0.0/0,nsrauth/oldauth".
For example:
The following entries (combined) mean that the host: 10.101.1.1
can use AUTH_NONE, AUTH_UNIX, and AUTH_LGTO to authenticate,
anything on the network: 137.69.0.0/16 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.
"10.101.1.1,oldauth", "137.69.0.0/16,nsrauth/oldauth",
"0.0.0.0/0,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 ker-
nels 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 sup-
ported are TCP (the Transport Control Protocol) or UDP (the User
Datagram Protocol).
SEE ALSO
nsradmin(1m), nsrexecd(8), nsrtund(8)
NetWorker 8.0.1 Dec 02, 12 nsrla(5)