nnmlicense.sh

Administer Network Node Manager licensing

SYNOPSIS

DESCRIPTION

nnmlicense.sh provides license management for Network Node Manager (NNMi). License management includes the ability to retrieve license passwords from Hewlett-Packard, installing license passwords from a file, the removal of license passwords, and reporting valid licenses.

There are two steps to adding a license: updating the license database and notifying the running NNMi processes that new license information is available. The -nosync option performs the former but does not notify NNMi. If the -nosync option is not specified, the running NNMi system is automatically notified; it is not necessary to stop and restart NNMi.

The -nosync option allows you to perform multiple licensing tasks (e.g. removing a license and installing a replacement license). You then notify NNMi with the following:

nnmlicense.sh NNM

The -g|-gui option opens the license management GUI, which provides access to most license management capabilities:

Retrieve/Install License Key

Enables a license password to be retrieved from Hewlett-Packard.

Install/Restore License Key

Installs license passwords from a text file.

Request License Key through Email/Fax

Provides the ability to to request a license for systems that cannot transfer data to Hewlett-Packard.

Report License Key

Reports license information for the particular product.

Backup License File

Enables the backing up of a license file before installing or removing licenses.

Remove License Key

Removes license keys (usually temporary or emergency licenses provided by Hewlett-Packard).

Recover License Key

Adds back licenses that were previously removed.

The license management GUI enables multiple operations before updating the running NNMi system. For example, you can replace a license by removing the old license, and then adding a new one in its place.

Parameters

PRODUCT

The short name for the product being licensed.

-nosync

Prevents synchronization with the running NNMi system.

-g|-gui

Starts the license management GUI.

-f|-install <lic_file>

Install the license contained in the specified license file

EXAMPLES

To install a license password contained in a file named "license.txt", perform the following:

$NnmInstallDir/bin/nnmlicense.sh NNM -f license.txt

This will update the license database and notify NNMi of the licensing change. To avoid notifying NNMi, the -nosync option can be provided:

$NnmInstallDir/bin/nnmlicense.sh NNM -nosync -f license.txt

The following example demonstrates replacing a license with a new one. Suppose the customer is given a temporary license for the NNM product, with a capacity of 500 nodes. Sometime later this customer receives their official license. The temporary license must first be removed the permanent license is accepted. This can be done using the license management GUI. First remove the temporary license (Remove License Key), and then add the permanent license (Install/Restore License Key). The running NNMi system is updated when they exit the GUI.

AUTHOR

nnmlicense.sh was developed by Hewlett Packard Enterprise.

FILES

$NnmInstallDir/misc/nms/lic/NNM.pdf

Product definition file used by licensing.

$NnmDataDir/shared/nnm/conf/licensing/NNM.bin

Data file representing the license information that is consumed by ovjboss.

/opt/OV/HPOvLIC

Program files for licensing on UNIX-based systems.

/var/opt/OV/HPOvLIC

Data files for licensing on UNIX-based systems.

SEE ALSO

Installation Guide for future details on licensing.