.\" .\" $Id: nsr_la.5,v 6.4.54.2 2006/04/26 18:52:18 castrv Exp $ Copyright (c) 2005 EMC Corporation. .\" .\" .\" Copyright (c) 2005 EMC Corporation. .\" .\" All rights reserved. This is an UNPUBLISHED work, and .\" comprises proprietary and confidential information of EMC. .\" Unauthorized use, disclosure, and distribution are strictly .\" prohibited. Use, duplication, or disclosure of the software .\" and documentation by the U.S. Government is subject to .\" restrictions set forth in a license agreement between the .\" Government and EMC or other written agreement specifying .\" the Government's rights to use the software and any applicable .\" FAR provisions, such as FAR 52.227-19. .\" .TH NSR_LA 5 "Aug 23, 06" "StorEdge EBS 7.3.2" .SH NAME NSRLA \- Resource for the Sun StorEdge EBS client execution service .SH SYNOPSIS .B "type: NSRLA" .SH DESCRIPTION The NSRLA resource is used by Sun StorEdge EBS client execution service .B nsrexecd (see .BR nsrexecd (8)). To edit the .BR NSRLA resources run: .br .sp .RS \fR\s10nsradmin -s host_name -p nsrexec -c type:NSRLA\fP\s0 .RE .br .sp or .RS \fR\s10nsradmin -s host_name -p 390113 -v 1 -c type:NSRLA\fP\s0 .RE .br .sp See .BR nsradmin (1m) for information on using the Sun StorEdge EBS administration program. .SH ATTRIBUTES .PP The following attributes are defined for resource type .BR NSRLA The information in parentheses describes how the attribute values are accessed. .B 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 .BR nsradmin (1m). .B Static attributes change values rarely, if ever. For example, an attribute marked .B "(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. .TP .BR "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 Sun StorEdge EBS instance needs to be referred to. The default value is hostname. The value should be unique throughout the data zone. .TP .BR "NW instance ID" " (read-only, hidden, single string)" The NW instance ID. This value will be used to identify the local Sun StorEdge EBS install whenever a Sun StorEdge EBS program needs to communicate with another Sun StorEdge EBS program. This value has a one to one correspondence with the Sun StorEdge EBS instance name. The value is created by Sun StorEdge EBS by default. It should be unique throughout the data zone. .TP .BR "certificate" " (read-only, hidden, single string)" The certificate for the local Sun StorEdge EBS installation. The certificate is used by remote Sun StorEdge EBS installations to validate the identity of the local Sun StorEdge EBS install. .TP .BR "private key" " (read-only, hidden, single string)" The private key for the local Sun StorEdge EBS installation. The private key is used to validate the identity of the local Sun StorEdge EBS install to remote Sun StorEdge EBS installations. No users can view this attribute. .TP .BR "NW instance info operations" " (read-write, dynamic, choice)" One can use this attribute to import or export the NW instance information, or request that Sun StorEdge EBS generate a new private key and certificate. The NW instance information includes: the \fBname\fR, \fBNW instance ID\fR, \fBcertificate\fR, and \fBprivate key\fR attributes. Setting this field to: \fBExport\fR will cause Sun StorEdge EBS to export the NW instance information to a file specified in the \fBNW instance info file\fR attribute. Setting this field to: \fBImport\fR will cause Sun StorEdge EBS to import the NW instance information from the file specified by the \fBNW instance info file\fR attribute and set the corresponding values in the \fBnsr_la(5)\fR resource. Setting this field to: \fBNew Keys\fR will cause Sun StorEdge EBS to generate a new private key and certificate and store the values in the \fBprivate key\fR and \fBcertificate\fR fields. The previous values in these fields will be overwritten. This field will be reset to blank after Sun StorEdge EBS uses the value. .TP .BR "NW instance info file" " (read-write, dynamic, single string)" This field is used to specify a file name where Sun StorEdge EBS should load/store information when the \fBNW instance info operations\fR attribute is set to \fBExport\fR or \fBImport\fR. This field will be reset to blank after Sun StorEdge EBS uses the value. .TP .BR "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. .TP .BR "servers" " (constant, list of string)" The list of Sun StorEdge EBS servers allowed to back up this client. .TP .BR "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 .B 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 .B yes. .TP .BR "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 \fIIP\fR = the peer's IP address or a network IP address, mask = the network mask (in the 255.255.0.0 format or a number indicating the number of 1's on the left side of the mask), and auth1, ..., authN are of the values: \fInsrauth\fR or \fIoldauth\fR. The value: \fIoldauth\fR 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 \fInsrauth\fR 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: "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" .TP .BR "types created" " (constant, hidden, list of strings)" The type of resources that can be created by the .B NSRLA server. (see .BR hagentd (8)). .TP .BR "administrator" " (read-write, list of strings)" The .B administrator list contains users and user netgroups that are allowed to add, delete, and update the .B NSRLA resources. .B Netgroups are indicated by preceeding the name by an ampersand .B "('&')" character. The .B NSRLA administrator list is used by default for all other .B NSRLA resources. Updating this list will also update the other resources on this server that have not been explicitly changed. .TP .BR "arch" " (constant, single string)" The instruction set architecture determines which user programs are binary compatible. .TP .BR "kernel arch" " (constant, single string)" The kernel architecture determines which operating system kernels are binary compatible. .TP .BR "CPU type" " (constant, single string)" The CPU type of this machine. .TP .BR "machine type" " (constant, single string)" The high-level type of this machine, e.g. server or workstation. .TP .BR "OS" " (constant, single string)" The operating system and version number. .TP .BR "Sun StorEdge EBS version" " (constant, single string)" The version of .B Sun StorEdge EBS client. .TP .BR "client OS type" " (constant, single string)" The operating system running on this machine. .TP .BR "CPUs" " (constant, number)" The number of CPUs on the system. .TP .BR "disks" " (const, number)" The number of secondary storage devices on the system that can be backed up. .TP .BR "MB used" " (dynamic, number)" The current total amount of disk storage used in MB. .TP .BR "IP address" " (constant, list of string)" Dotted-decimal Internet Protocol address list. .TP .BR "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. .TP .BR "ONC program number" " (constant, hidden, number)" The Open Network Computing (sunrpc) identification number for the client to server protocol provided by this service. .TP .BR "ONC version number" " (constant, hidden, number)" The Open Network Computing (sunrpc) identification number for the client to server protocol provided by this service. .TP .BR "ONC transport" " (constant, hidden, list of choice)" The Open Network Computing (sunrpc) transport protocols supported are .B TCP (the Transport Control Protocol) or .B UDP (the User Datagram Protocol). .SH SEE ALSO .na .BR nsradmin (1m), .BR nsrexecd (8), .BR hagentd (8). .ad