vselicense(1M)

DESCRIPTION

The vselicense command is installed on the Central Management Server (CMS) with the VSE Management Software. This command installs and removes Licenses to Use (LTUs) for the HP Virtual Server Environment (VSE) Management Software products. It can also be used to correct the number of per-core licenses that are applied for licenses migrated from an earlier version of the VSE Management Software.

This command applies only to HP Integrity systems running HP-UX, Linux, or Microsoft Windows operating systems, and HP 9000 systems running HP-UX. It is only used for LTUs that were purchased prior to VSE Management Software version 4.0. Specifically, the following LTUs are the only products that can be managed by vselicense:

	NOTE: HP Integrity virtual machines are licensed through the VM Host. You cannot specify a virtual machine as the target of a vselicense command. Instead, apply the command to the VM Host system.

Starting with VSE Management Software version 4.0 (A.04.00.07.xx), licenses are now managed in the HP Systems Insight Manager (SIM) License Manager database on the CMS. New licenses are encoded in a key consisting of 5 blocks of 5 numbers or characters (a “5x5” license key). These licenses are added to the CMS and applied to managed systems through HP SIM. To obtain new licenses for the current version of the VSE Management Software, contact your HP sales representative, your HP services representative, or your authorized HP reseller.

In previous releases, licenses were installed directly on HP-UX managed systems. A license scan procedure was then used to obtain the license information from the managed systems for use on the CMS. LTUs for managed systems running Linux for HP Integrity and Microsoft Windows for HP Integrity were installed as keys on the CMS. When you upgrade an HP-UX CMS that has a previous version of the VSE Management Software installed, any product LTU that was previously installed or scanned is automatically migrated to the License Manager database. The VSE Management Software products are licensed per core on managed HP Integrity and HP 9000 systems. When licenses prior to version 4.0 are migrated to the current version, the number of cores on the managed system is determined via a WBEM query. The value returned is used as the number of licenses assigned to that system. If the WBEM query is unsuccessful at determining the number of cores, the value “1” is assumed.

You are responsible for verifying that the correct number of licenses are applied to your managed systems, based on the number of cores in use. To remain in compliance with your End User Licensing Agreement, you may need to correct the number of cores assigned during the license migration process. To correct the number of cores assigned during migration, enter the following command on the CMS:

  vselicense -m -c cores -n sys

where cores is the correct number of per-core licenses to assign for system sys.

If permitted by your licensing agreement with HP, unused licenses that were purchased for an earlier release but have not yet been installed or scanned can also be applied to a managed system and added to the License Manager database using the vselicense command.

To add and apply unused HP-UX LTUs, follow these steps:

To add and apply unused HP Integrity Linux or HP Integrity Windows LTUs, follow these steps:

	NOTE: Changes made by vselicense may not show up in the product's user interface until you refresh the data (click the Refresh Data link in Capacity Advisor, or the Refresh Data icon in the Visualization tab).

After migration to the License Manager database, your previously purchased LTUs will appear in the HP SIM License Manager under the following new license names:

Use the HP SIM License Manager to view the status of these licenses (select Deploy -> License Manager... from the HP SIM menu, then select one of the new license names, as shown in the preceding list).

RETURN VALUES

EXAMPLES

Apply licenses for the HP Integrity Linux Virtualization Manager (product T2783AC) on the managed system that is identified in HP SIM as linsys1. The key value was obtained from HP when the LTU was purchased.

vselicense -l key -n linsys1 -p T2783AC

Apply licenses for LTUs installed on an HP-UX managed system named uxsys2. The command uses SSH to scan for the LTU(s) installed on the system.

vselicense -m -n uxsys2

Use gWLM to scan and apply T2762AA licenses on an HP-UX managed system.

vselicense -m -g -n uxsys3

Correct the number of per-core licenses to 4 for a system with previously migrated licenses.

vselicense -m -c 4 -n uxsys2

Remove all the licenses that were previously migrated and assigned to the managed system winsys4.

vselicense -m -c 0 -n winsys4

AUTHORS

vselicense was developed by Hewlett-Packard Company.

SEE ALSO

Additional information is available in the VSE Licenses topic of the VSE Management Software online help, and in the following documents:

vseinitconfig(1M), VSE Management Software Version 4.0 Getting Started Guide, VSE Management Software Version 4.0 Installation and Update Guide for HP-UX.