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.

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.

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