NSRCAP(8)

NAME

nsrcap − update the capabilities of a NetWorker installation

SYNOPSIS

nsrcap [ −vn ] { −c | −u | −d } enabler-code

DESCRIPTION

nsrcap is primarily used to enable new features in a NetWorker installation. nsrcap can also be used to upgrade or downgrade your level of service (upgrade and downgrade must be used with care; read their descriptions below, carefully). Enablers are separate from the NetWorker software, and are specified by an 18-digit code (usually displayed as 3 groups of 6 digits each). To enable a new feature, the nsrd(8) program must be running on the machine on which the NetWorker server software is installed. Then, while logged in as a NetWorker administrator on the NetWorker server, run nsrcap once for each feature you wish to enable, each time specifying the 18-digit code. If no errors occur, no output is printed. You can inspect the currently-loaded enablers by viewing the NSR license resources using nwadmin(8) or nsradmin(8).

OPTIONS

−c Cause nsrcap to load (create) a new enabled feature, using the specified code. You can only load a feature once; if you try to load the same enabler more than once, an error will be returned. Exactly one of −c, −d, or −u must be specified.

−d Cause nsrcap to downgrade an existing enabler. Downgrades currently support only Base and Jukebox enablers. Once you have downgraded to a new enabler level, you will not be able to go back to your previous level, so do not use the −d option unless instructed to do so by Legato. Exactly one of −c, −d, or −u must be specified.

−u Cause nsrcap to load an upgrade enabler on top of an existing enabler. Upgrades currently support only Base and Jukebox enablers. Once you have upgraded to a new enabler level, you will not be able to go back to your previous level, so do not use the −u option unless instructed to do so by Legato.

−v Cause nsrcap to display more verbose information, describing the enabler being loaded. Exactly one of −c, −d, or −u must be specified.

−n No load. Cause nsrcap to inspect the enabler code on the command line and verify that it is valid, but not actually load the enabler into nsrd.

DIAGNOSTICS

enabler-code is too long
Code words are 18 digits long, and the one entered was longer than that, so it cannot be valid.

invalid code: xxxxxx-xxxxxx-xxxxxx
The 18-digit code entered on the command line is invalid. Re-check the code word on your enabler sheet.

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 jbm_enabler(8) 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. You 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 jbm_enabler(8) before running nsrcap.

this enabler-code previously loaded
The enabler-code entered had previously been loaded onto the system and cannot be used again. You need to purchase a new enabler-code and use that 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 kinds 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
You attempted to upgrade a jukebox, but the license enabler for the jukebox is not currently loaded. You must use −c for the initial installation of a jukebox enabler, not −u.

RPC error, Program not registered
The nsrcap program requires that the NetWorker daemons be running. Start your NetWorker daemons (cd /; nsrd) and re-run nsrcap. If nsrd is already running, you have probably reached some resource limit on the server (e.g. not enough memory, or no more processes).

RAP error, user you needs to be on type:NSR’s administrator list
Your login name is not listed in the administrator’s list for the server. You need to su(1) to a valid administrator and re-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.

NetWorker 4.1.2 — Last change: May 1995

Museum