Enabler Entry and Registration

When you enter an enabler code, you unlock features of Backup that you can use for 45 days. To continue to use Backup after the 45 days expire, you must follow the instructions provided on your Enabler Certificate and register your enabled software. When you register your software, a unique authorization code is generated that is keyed to your specific system information and enabler code. After you receive and enter the authorization code, you can use the Backup software indefinitely.

nsr_ize

The interactive nsr_ize program installs or removes Backup software and files to or from a machine. Informational prompts guide you through a series of questions, many of which already provide default answers to use for a standard environment.

The nsr_ize program modifies several system administration files, including /etc/rpc. If you use YP, modify the YP master's /etc/rpc file with the same modifications that nsr_ize makes to the local copy of /etc/rpc.

The following example describes the format and options available for the nsr_ize program:

nsr_ize [-i | -r -u] [-c | -s] [-kmnqxv>

• Use the -c option to tell nsr_ize to install or remove only the client software.

• Use the -i option to install the Backup software and associated files.

• Use the -k option to kill the Backup daemons without confirmation.

• Use the -m option to tell nsr_ize not to install or remove the Backup man pages.

• Use the -n option to tell nsr_ize not to perform actions that change the filesystem. When you use the -n option, nsr_ize prints the installation script without performing the commands.

• Use the -q option to run nsr_ize in quiet mode.

• Use the -r option to remove the Backup software and associated files.

• Use the -s option to tell nsr_ize to install or remove only the server software.

• Use the -u option to prepare your system for a Backup software upgrade. The existing Backup software is removed, but the nsr.res file, client file indexes, server bootstrap, and media database are preserved.

• Use the -v option to run nsr_ize in verbose mode.

• Use the -x option to set the debug flag.

nsrlic

The nsrlic program generates reports about all the license information currently active on the Backup server. This command queries the Backup resource database, and formats and displays the results to standard output. You do not need to be root to invoke nsrlic.

If you enter nsrlic at the shell prompt without optional flags, you receive a report, similar to the following example, for the server that you invoked the command from:

SERVER (UNIVERSAL) CLIENT LICENSES
                     Available: 10
                          Used: 0
          Borrowed from Server: 0
                     Remaining: 10
             Connected Clients: ;
               Defined Clients: ;
WORKSTATION CLIENT LICENSES
                     Available: 0
                          Used: 0
                     Remaining: 0
             Connected Clients: ;
               Defined Clients: ;
SERVER CLIENT TYPES
                           AIX: 0
                            HP: 0
                       Solaris: 0
                         SunOS: 0
             Windows NT Server: 0
                       NetWare: 0
WORKSTATION CLIENT TYPES
                           DOS: 0
                     Macintosh: 0
                          OS/2: 0
                  Windows 3.1x: 0
                    Windows 95: 0
        Windows NT Workstation: 0
                        Others: 4

The following example describes the format and options available for the nsrlic program:

nsrlic -vi -s server

Use the -i option to use nsrlic in the interactive mode. In this mode, you can request different reports, refresh the information, or switch to a different server. The interactive mode provides a prompt and displays the choices available:

connecting to jupiter...
Available commands are:
   summary - display a summary report of licenses
   detail - display a detailed report of licenses
   connect [server name] - connect to server
   help - list command helps.
   quit - quit out of nsrlic command.
nsrlic> 

The information is requested once and cached until you issue another connect command at the nsrlic prompt.

• Use the -s server option to select a specific Backup server to query. If you omit this option, the server from which you invoked the nsrlic program is queried.

• Use the -v option to generate a more detailed, verbose report. In addition to the number of licenses or the number of clients, a list of connected and defined clients is gathered and displayed.

NSR license

The NSR license resource describes each Backup software feature that you entered an enabler code for, as well as the permanent authorization code, once entered. To inspect the NSR license resource on your Backup server, become root and use the GUI to view the Registration window or enter the following command at the shell prompt:

# nsradmin -c "type:NSR license"

You can create, enable, or authorize a NSR license resource from within the GUI; however, you must use the nsrcap command to update an existing NSR license resource.

nsrcap

The nsrcap program enters a unique enabler code into the Backup server's nsr_license resource that enables you to use features in the Backup software that you installed. You can use the nsrcap program to enter the enabler code for a new feature, or you can use the nsrcap program to enter an enabler code that upgrades or downgrades Backup software features that you are already using.

The following example describes the format and options available for the nsrcap program:

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

To use the nsrcap program, you must become root on the Backup server and specify only one of the following command options:

• Use the -c option to enter an enabler code that enables you to use a feature that is not already installed. You can only load a feature once; an error is returned if you try to load the enabler more than once.

• Use the -d option to enter an enabler that downgrades an existing Base or Jukebox enabler. After you downgrade the enabler, you cannot return to the previous level enabled on your system. Do not use the -d option unless instructed to do so by SunSoft.

• Use the -u option to enter an enabler that upgrades an existing Base enabler. (The -u option only works for the server enabler code). After you upgrade the enabler, you cannot return to the previous level enabled on your system.

  The nsrcap program has two additional options that you can elect to use when you enter the one of the following command options:

• Use the -v option if you want the nsrcap program to display verbose information that describes the enabler entered.

• Use the -n option if you want to inspect the enabler code for validity. When you specify the -n option, the enabler code you enter on the command line is inspected, but is not entered into the Backup server's nsr_license resource.

nsr_shutdown

The nsr_shutdown command identifies and kills the Backup processes on a Backup server. Use the command whenever you need to install or remove Backup software. You must become root on the system to use the nsr_shutdown command.

The following example describes the format and command options available for nsr_shutdown:

• Use the -a option to kill all of the Backup daemons. The option has the same effect as the -A, -d, and -s options combined.

• Use the -A option to kill any nsralist processes.

• Use the -d option to kill the Backup server daemons. If you do not specify any options, the -d option is assumed by default.

• Use the -n option to echo the kill command without a real shutdown.

• Use the -q option to perform a quiet shutdown, without prompts for confirmation.

• Use the -s option to kill any savegrp and nsrexecd processes.

• Use the -v option to echo commands and their arguments as nsr_shutdown executes them.