Content-type: text/html
Man page of NSRCAP
NSRCAP
Section: Maintenance Commands (8)
Updated: Dec 11, 01m
Index
Return to Main Contents
NAME
nsrcap
- update the capabilities of a NetWorker installation
SYNOPSIS
nsrcap
[
-vn
] {
-c
|
-d
|
-u
}
enabler-code
[
-a
authorization-code
]
DESCRIPTION
The
nsrcap
program is primarily used to enable new features on NetWorker.
You can also use
nsrcap
to upgrade or downgrade NetWorker software features that are currently being used.
(Upgrades and downgrades should be performed carefully. Read the options descriptions below).
Enablers are separate from the NetWorker software, and are specified
by an 18-digit enabler-code, usually displayed as 3 groups of 6 digits each.
The authorization code is an 8 digit hexadecimal number.
To enable a new feature, the
nsrd(1m)
program must be running on the system where the NetWorker server
software is installed. To enable a new feature you must be logged in to the NetWorker
server as administrator or root. The
nsrcap
program is run once for each feature you want to enable by specifying the
18-digit enabler-code. You may authorize a new enabler as you enable the feature or
authorize an already existing enabler.
If no errors occur, the following message gets displayed on the screen:
"License enabler loaded. Please register all enablers immediately."
You can inspect the enablers currently loaded by viewing the NSR license
resources using
nsradmin(1m).
OPTIONS
- -c
-
Causes
nsrcap
to enable a feature that is not currently installed, using the specified enabler code.
Enabler codes are listed on enabler certificates provided when
you purchase NetWorker. An authorization code is required to
make each license permanent. To obtain authorization codes for your NetWorker product via the World Wide Web, simply point your web browser to URL: http://customernet.emc.com. You will need to enter the enabler code for each authorization code that you
request. For more details on NetWorker licensing, including
other methods to obtain authorization codes, refer to the
NetWorker Installation and Administration Guide and the latest
NetWorker Release Supplement.
You can only load a feature once; an error is returned if you attempt to load the
enabler more than once.
You can only specify one of the
-c,
-d,
or
-u
options.
- -d
-
Causes
nsrcap
to downgrade an existing Base or Jukebox enabler.
After you downgrade the enabler, you cannot return to the previous level enabled
on the system.
Do not
use the
-u
option unless instructed to do so by EMC Technical Support.
You must specify one of the
-c,
-d,
or
-u
options.
- -u
-
Causes
nsrcap
to enter an enabler that upgrades an existing Base or Jukebox enabler.
After you upgrade the enabler, you cannot return to the previous level enabled on the
system. If you use the Base enabler, it will put the new license in the grace
mode. The nsrcap program utilizes the grace mode to ensure that the new enabler will not
immediately time out.
Do not
use the
-u
option unless instructed to do so by EMC Technical Support.
- -v
-
Causes
nsrcap
to display more verbose information, describing the enabler being
loaded. You must specify one of the
-c,
-d,
or
-u
options.
- -n
-
No load.
Causes
nsrcap
to inspect the enabler code for validity. When you specify the
-n
option, the enabler code you enter on the command line is inspected and verified,
but is not entered into the NetWorker server's
nsr_license
resource.
You must specify one of the
-c,
-d,
or
-u
options.
- -a,
-
Authorizes a license with the specified authorization code, making the
license permanent. Specify the license to be authorized by using the
-c
option followed by the enabler-code and the
-a
option followed by the authorization-code. To obtain authorization codes for this product via the World Wide
Web, simply point your web browser to customernet.emc.com to enter the
enabler code for each authorization code that you request.
For more details on product licensing, including other methods to obtain
authorization codes, refer to the product Installation and Administration
Guide and the latest Release Supplement.
SEE ALSO
jbconfig(1m),
nsradmin(1m),
nsrd(1m),
lgtolic(1m).
DIAGNOSTICS
- enabler-code is too long
-
Enabler codes must be 18 digits in length. The code entered is longer than 18 digits
and is invalid. Note that 24-digit enabler codes are intended for the NetWorker License
Manager.
- authorization-code is too long
-
Authorization codes must be 8 digits in length. The code entered is longer than 8 digits
and is invalid.
- authorization-code is too short
-
Authorization codes must be 8 digits in length. The code entered is shorter than 8 digits
and is invalid.
- invalid enabler code: xxxxxx-xxxxxx-xxxxxx
-
The 18-digit enabler code entered on the command line is invalid. Re-check
the enabler-code on your enabler sheet.
- License authorization fails
-
Either the 8-digit authorization code entered on the command line is invalid or
this license has already been authorized and hence cannot overwrite existing
authorization code. Re-check the enabler-code and the corresponding authorization-code.
- cannot find a jukebox resource to enable
-
The code word entered is a jukebox license enabler, but there are no
jukebox resources to enable. You need to run
jbconfig(1m)
to complete the jukebox installation before running
nsrcap.
- found a jukebox, but it had more than N slots.
-
Jukebox enablers can only enable jukeboxes with at most
N
physical slots, where
N
is the type of jukebox enabler. Either the jukebox was installed
incorrectly, or you need to obtain a larger jukebox enabler.
- this enabler-code is already assigned
-
The enabler-code entered is already loaded onto the system and cannot
be used again for an upgrade.
- no appropriate jukeboxes to upgrade
-
An upgrade was attempted, but no jukebox resources were found. Only use the
-u
option for jukeboxes when upgrading from one jukebox level to another,
not on the initial installation. You also need to run
jbconfig(1m)
before running
nsrcap.
- this enabler-code previously loaded
-
The enabler-code entered has been loaded onto the system
previously and cannot be used again. You need to purchase a new enabler-code for the upgrade.
- don't know how to upgrade this enabler
-
- don't know how to downgrade this enabler
-
The enabler-code entered is not for a base or jukebox enabler. These
are the only types of enablers that you can currently upgrade or
downgrade.
- base enabler must be loaded before upgrading
-
- base enabler must be loaded before downgrading
-
You cannot perform an upgrade or downgrade until a base product has
been installed. Install a base enabler, and then perform the upgrade
or downgrade.
- cannot find the enabler to upgrade
-
A jukebox upgrade was attempted, but the license enabler for the
jukebox is not currently loaded. You must use the
-c
option for the initial installation of a jukebox enabler, not the
-u
option.
- RPC error: Program not registered
-
The
nsrcap
program requires that the NetWorker daemons be running. Start your
NetWorker daemons (cd /; nsrd) and re-run the
nsrcap
program.
If
nsrd
is already running, you have probably reached a resource limit on
the server (for example, not enough memory, or no more processes).
RAP error: user login name needs to be of the type: NSR
-
administrator list.
Your login name is not listed in the administrator's list for the
server. You need to be a
valid administrator to run
nsrcap.
- RAP error: ...
-
Various other errors can be returned from
nsrd
if the enabler is invalid. For example, if you try to load a base
enabler onto a system that already has a base enabler loaded, or if
you attempt to load a jukebox enabler before the jukebox has been
completely installed. The specific problem will follow the
RAP error
prefix.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- SEE ALSO
-
- DIAGNOSTICS
-
This document was created by
man2html,
using the manual pages.
Time: 02:37:07 GMT, October 02, 2010