.\"
.\" $Id: nsr_license.5,v 1.1.64.3 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_LICENSE" 5 "Aug 23, 06" "StorEdge EBS 7.3.2"
.SH NAME
nsr_license \- Sun StorEdge EBS resource type ``NSR license''
.SH SYNOPSIS
.B "type: NSR license"
.SH DESCRIPTION
A resource of type
.B "NSR license"
is used to describe each feature enabled in your Sun StorEdge EBS installation.
See
.BR nsr_resource (5)
for more information on Sun StorEdge EBS resources.
To inspect the NSR license resources type:
.br 2
.RS
\fR\s10nsradmin \-c "type:NSR license"\fP\s0
.RE
.br 2
or use
.B Sun StorEdge EBS Management Console.
NSR license resources may be created, enabled and authorized from 
the GUI, but the
.BR nsrcap (8) 
command must be used to update an existing license resource.
See
.BR nsradmin (8)
for more information on using the Sun StorEdge EBS administration program.
.SH ATTRIBUTES
.LP
The following attributes are defined for resource type
.BR "NSR license" .
The information in parentheses describes how the attribute values are accessed.
.B Create-only
indicates that the value cannot be changed by an administrator, except
when the resource is created.
.B Read/write
means the value can be changed at any time by authorized administrators.
.B Read-only
means the value cannot be changed by authorized administrators.
.B Static
attributes change values rarely, if ever.
.B Dynamic
attributes may change often.
.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 (8).
For example, an attribute marked
.B "(create-only, static)"
has a value which is set when the attribute is created and never changes.
Several additional attributes (for example, administrator) are common
to all resources, and are described in
.BR nsr_resource (5).
.TP
.BR "name" "  (create-only, static)"
This attribute holds the name of the license resource.
.TP
.BR "comment" "		(read/write)"
This attribute is provided for the administrator to keep any explanatory
remarks or supplementary information about the license. 
.br
.TP
.BR "enabler code" "  (create-only, static)"
This code is identical to the code entered into the
.BR nsrcap (8)
command to enable the feature named in this resource.
The enabler code consists of 18 hexidecimal digits, printed in groups
of 6 digits.
.br
.I Example:
\fR\s10enabler code: 123456-123456-123456;\fP\s0
.TP
.BR "host id" "  (read-only, dynamic)"
The unique host id associated with the computer or licensed operating
system on which the enabler has been loaded.
This value will often be an 8 digit hexidecimal number; however, other
formats are possible, depending on specific platform requirements.
.br
.I Example:
\fR\s10host id: 7260d859;\fP\s0
.TP
.BR "expiration date" "  (read-only)"
The date on which this enabler will expire, if the enabler is an
evaluation enabler or an otherwise un-registered license enabler.
The enabler expires at 12:00:01 am on the date listed.
The special prefix
.I G
means that a grace period has been allowed for this enabler.
Enablers with the grace period allowed should be registered immediately.
If the enabler has been registered, and the
.B "auth code"
is filled in with a valid value, the value will be as shown in the
example, below.
.br
.I Example:
\fR\s10expiration date: Authorized - no expiration date;\fP\s0
.TP
.BR "auth code" "  (read/write)"
An 8 digit hexidecimal value used to permanently authorize an enabler.
The unique, valid authorization code for an enabler is obtained from EMC by
registering each purchased license enabler.
Evaluation enablers cannot be permanently authorized.
If the server's host id changes, all authorization codes will immediately be
invalidated, and the enablers must be re-registered with EMC to
obtain new authorization codes.
.br
.I Example:
\fR\s10auth code: abcdef00;\fP\s0
.TP
.BR "license type" "  (create-only, hidden)"
A special code, used internally to describe the specific feature or
features enabled by this license enabler.
.br
.I Example:
\fR\s10license type: J16;\fP\s0
.TP
.BR "checksum" "  (read/write, hidden)"
A coded checksum used to maintain consistency of a NSR license resource,
and between license resources.
.SH EXAMPLE
.LP
Below is a complete NSR license resource for an authorized base enabler:
.nf
.na
.ta \w'expiration date:'u+1nR +2n

	type:	NSR license;
	name:	Sun StorEdge EBS Advanced/10;
	enabler code:	123456-123456-123456;
	host id:	7260d859;
	expiration date:	Authorized - no expiration date;
	auth code:	abcdef00;
	license type:	B10;
	checksum:	xxxxxxxxxxxxxxxxxxxxxx;
.ta
.fi
.SH FILES
.I /nsr/res/nsrdb
\- files in this directory should never be edited directly. Use
.B Sun StorEdge EBS Management Console
instead.
.SH SEE ALSO
.na
.BR nsr_resource (5),
.BR nsr (8),
.BR nsradmin (8),
.BR nsrcap (8)
.ad