Cisco PVM Installation Guide, 1.0.2
Installing the Cisco PVM License

Table Of Contents

Installing the Cisco PVM License

License Install Process

Evaluation and Production Modes of Operation

License Administration

Installing the License File

Testing the License Manager

Verifying the License Manager Status


Installing the Cisco PVM License


Cisco PVM requires a license file to be installed to operate in the non-evaluation mode. The license file is not included in the Cisco PVM distribution; instead, Cisco PVM must first be installed on a host computer and then a license file must be acquired and installed for that particular host. This chapter describes how to install and test the Cisco PVM license file.

This chapter contains the following topics:

License Install Process

Evaluation and Production Modes of Operation

License Administration

Installing the License File

Testing the License Manager

Verifying the License Manager Status

License Install Process

You must install a license file to run Cisco PVM in Production mode. Without a valid license, Cisco PVM will run for 90 days in Evaluation mode and then cease to operate.

The basic sequence of steps for installing a Cisco PVM license is as follows:

1. Cisco PVM is installed on a host computer.

2. Cisco PVM users request a license file from Cisco. The following information is required during registration:

Hostname: obtained by executing the command hostname on the host computer where Cisco PVM is installed.

Host ID: obtained by executing the command lmhostid on the host computer where Cisco PVM is installed.

Product: Cisco Performance Visibility Manager.

3. Cisco provides the license file and customers install it on the host where Cisco PVM is installed. This involves:

copying the license file to the host computer where Cisco PVM is installed and

saving the file as /opt/CSCOpvm/server/etc/sp_license.dat and restarting the license server by issuing the command lmreread.

Evaluation and Production Modes of Operation

Without a valid license file installed, Cisco PVM will operate in Evaluation mode and will cease operating after 90 days. When a valid license file is installed, Cisco PVM will operate in Production mode. The Production license has no expiration date.


Note Changes to the license file (such as adding NAMs over the number of current supported licenses) do not require reinstallation of Cisco PVM. In this case, replace the current license file on the Cisco PVM host computer with the new license file and issue the command lmreread.


License Administration

Cisco PVM includes the following command-line programs, located in /opt/CSCOpvm/flexlm/bin, for handling the licenses.

lmstat - indicates the status of the license server and whether it is up or down.

lmreread - re-reads the license file. This is necessary when the license file is replaced as in the case of obtaining new licensed features.

lmhostid - provides the host ID information that is necessary for generating the license file. All license files are node locked to the host computer for which Cisco PVM is installed.

Cisco PVM provides a log file, /opt/CSCOpvm/flexlm/log/flexlm.log, which provides detailed information with respect to when licensed features were checked in and checked out.

Installing the License File

After the installation is complete, the product license must be installed before the application can be run in Production mode.

To install the license file, complete the following steps:


Step 1 Log in as the Cisco PVM Administrator by entering su - pvmadm.

Step 2 Obtain the host name by entering hostname at the command prompt

Step 3 Obtain the host ID by entering the following at the command prompt:

cd /opt/CSCOpvm/flexlm/bin

./lmhostid

Step 4 Contact Cisco Systems to request a new license file for the specific host where Cisco PVM is installed.

Step 5 Copy the license file to the host computer installation directory where Cisco PVM is installed and save it as /opt/CSCOpvm/server/etc/sp_license.dat.

Step 6 Restart the license server by entering the following at the command prompt:

cd /opt/CSCOpvm/flexlm/bin; lmreread


Testing the License Manager

After installing the license file, verify the license manager status. Ensure that the following Cisco PVM components are up and running:

License Manager license server daemon (lmgrd) is UP.

Vendor daemon (SP_LM) is UP.

License server is the current host.

Verifying the License Manager Status

Perform the following steps to check the status of the License Manager.


Step 1 Log in as the Cisco PVM Administrator.

Step 2 Invoke the status daemon (lmstat):

/opt/CSCOpvm/flexlm/bin/lmstat -c /opt/CSCOpvm/server/etc/sp_license.dat

Step 3 Ensure that the lmgrd process is running by entering ps -ef|grep lmgrd at the command prompt.