Enterprise License Manager User Guide

First Published: July 18, 2012 Last Modified: June 19, 2013

Americas Headquarters
Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 527-0883

Text Part Number: OL-27040-01

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS. THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY. The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version of the UNIX operating system. All rights reserved. Copyright 1981, Regents of the University of California. NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED AS IS" WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE. IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental. Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: http://

www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership
relationship between Cisco and any other company. (1110R)
2013

Cisco Systems, Inc. All rights reserved.

CONTENTS

Preface

Preface v

CHAPTER 1

Enterprise License Manager 1

CHAPTER 2

Enterprise License Manager installation and upgrade 3 Enterprise License Manager installation 3 Install standalone Enterprise License Manager 4 Start installation 5 Enter configuration information 6 Perform basic installation 6 Upgrade information 8 Upgrade software through platform GUI 8 Upgrade from local source 9 Upgrade from remote source 9 Upgrade standalone Enterprise License Manager using CLI 11 Upgrade from local source 11 Upgrade from remote source 12 License management CLI commands 13 Post-upgrade tasks 13 Install COP files 13

CHAPTER 3

Enterprise License Manager operation 15 Enterprise License Manager considerations 15 Log in to Enterprise License Manager 16 Add product instance 16 Edit product instance 17 Delete product instance 17

Enterprise License Manager User Guide OL-27040-01 iii

Contents

System status information 18 Dashboard view 18 License usage view 19 License fulfillment 20 Migrate licenses using Upgrade Licenses wizard 21 Use the Add Licenses wizard to determine new licensing requirements 22 Generate license request 22 Install license 23

CHAPTER 4

Enterprise License Manager setup 25 About window 25 Monitoring view settings 26 Dashboard settings 26 License Usage page settings 27 License Management view settings 29 Licenses page settings 29 License Planning page settings 31 Inventory view settings 33 Administration view settings 35

CHAPTER 5

Troubleshooting 39 Unknown username and password for Enterprise License Manager login 39 Configuration changes are not appearing in Enterprise License Manager 40 The following error message appears: The cause of the error is unknown 40 Product instance was modified, but changes are not reflected in license usage data 40 Product instance was deleted, but is still showing up in license usage data 41 Product instance is not showing up in license usage data 41 Product instance data in administration GUI does not match data Product Instances view in Enterprise License Manager 41 Overage alerts are not appearing when Enterprise License Manager goes into overage 42 Enterprise License Manager does not indicate a product overage 42 Licenses are missing following restoration of Enterprise License Manager on a different server 42 Cannot bring system into compliance using the Upgrade Licenses wizard 43

Enterprise License Manager User Guide iv OL-27040-01

Preface
This preface describes the purpose and audience of this guide, and provides information on how to obtain related documentation. Purpose The Enterprise License Manager User Guide provides instructions on how to install, set up, and use Enterprise License Manager. Audience This document provides information for network administrators and engineers who are responsible for installing and managing Enterprise License Manager. Related documentation Refer to the following documents for further information about related licensing applications and products: Using Cisco Unified Communications Manager License Count Utility Cisco Unified Communications Manager Features & Services Guide, "Licensing" chapter Cisco Unified Communications Manager Administration Guide, "Other System Menu Options" chapter Obtaining technical assistance Cisco provides Cisco.com as a starting point for all technical assistance. Customers and partners can obtain documentation, troubleshooting tips, and sample configurations from online tools. For Cisco.com registered users, additional troubleshooting tools are available from the Cisco Technical Assistance Center website.

Enterprise License Manager User Guide OL-27040-01 v

Preface

Enterprise License Manager User Guide vi OL-27040-01

CHAPTER

Enterprise License Manager

Enterprise License Manager provides simplified, enterprise-wide management of user-based licensing, including license fulfillment. Enterprise License Manager handles licensing fulfillment, supports allocation and reconciliation of licenses across supported products, and provides enterprise-level reporting of usage and entitlement.

Note

You have the ability to define how to manage licensing of your enterprise. You can have one Enterprise License Manager for the entire enterprise, or you can have several Enterprise License Managers and divide the enterprise in a manner that best suits your needs. Enterprise License Manager can run on a separate server or virtual machine or can coreside on a product's server or virtual machine. For more information on designing Cisco Unified Communications Systems, see www.cisco.com/go/ucsrnd. Supported products Enterprise License Manager supports the following products: Cisco Unified Communications Manager Cisco Unity Connection

Enterprise License Manager User Guide OL-27040-01 1

Enterprise License Manager

Enterprise License Manager User Guide 2 OL-27040-01

CHAPTER

Enterprise License Manager installation and upgrade

Enterprise License Manager installation, page 3 Install standalone Enterprise License Manager, page 4 Start installation, page 5 Enter configuration information, page 6 Perform basic installation, page 6 Upgrade information, page 8 Upgrade software through platform GUI, page 8 Upgrade from local source, page 9 Upgrade from remote source, page 9 Upgrade standalone Enterprise License Manager using CLI, page 11 Post-upgrade tasks, page 13 Install COP files, page 13

Enterprise License Manager installation

Enterprise License Manager is installed automatically as part of the installation of Unified CM, Unity Connection, or both, as well as Unified Communications Manager Business Edition 5000 and Unified Communications Manager Business Edition 6000. You may choose to run Enterprise License Manager on one of these servers in a co-resident configuration, or you may opt to run Enterprise License Manager in a standalone configuration. For a standalone configuration, Enterprise License Manager must be installed separately. This installation follows the same installation framework as Unified CM and Unity Connection, as described below.

Enterprise License Manager User Guide OL-27040-01 3

Enterprise License Manager installation and upgrade Install standalone Enterprise License Manager

Important

A standalone Enterprise License Manager supports the same OVA or MCS server types that are supported for Unified CM 9.X or Unity Connection.

Important

In a virtual environment, Enterprise License Manager requires a static MAC address to function properly.

Install standalone Enterprise License Manager

This section describes how to install Enterprise License Manager on a standalone server or virtual machine. You install the operating system and application by running one installation program. This document divides the procedure for using this installation program into the following major topics: Start installation Enter configuration information Perform basic installation Configure the first node Navigate installation wizard For instructions on how to navigate within the installation wizard, refer to the following table.
Table 1: Installation Wizard Navigation

To Do This Move to the next field Move to the previous field Select an option Scroll up or down in a list Go to the previous window Get help information on a window

Press This Tab Alt-Tab Space bar or Enter Up or down arrow Space bar or Enter to select Back (when available) Space bar or Enter to select Help (when available)

Enterprise License Manager User Guide 4 OL-27040-01

Enterprise License Manager installation and upgrade Start installation

Start installation
Procedure
Step 1 Step 2 Insert the installation DVD into the tray and restart the server, so it boots from the DVD. After the server completes the boot sequence, the DVD Found window displays. To perform the media check, select Yes or, to skip the media check, select No. The media check checks the integrity of the DVD. If your DVD passed the media check previously, you might choose to skip the media check. If you select Yes to perform the media check, the Media Check Result window displays. Perform these tasks: If the Media Check Result displays Pass, select OK to continue the installation. If the media fails the Media Check, either download another copy from Cisco.com or obtain another DVD directly from Cisco. Step 4 The system installer performs the following hardware checks to ensure that your system is correctly configured. If the installer makes any changes to your hardware configuration settings, you will get prompted to restart your system. Leave the DVD in the drive during the reboot: First, the installation process checks for the correct drivers, and you may see the following warning:
No hard drives have been found. You probably need to manually choose device drivers for install to succeed. Would you like to select drivers now?

Step 3

Step 5

To continue the installation, select Yes. The installation next checks to see whether you have a supported hardware platform. If your server does not meet the exact hardware requirements, the installation process fails with a critical error. If you think this is not correct, capture the error and report it Cisco support. The installation process next verifies RAID configuration and BIOS settings. If this step repeats, select Yes again. If the installation program must install a BIOS update, a notification appears telling you that the system must reboot. Press any key to continue with the installation.
Note

After the hardware checks complete, the Product Deployment selection window displays. Step 6 Step 7 In the Product Deployment selection window, select Cisco Enterprise License Manager. If software is currently installed on the server, the Overwrite Hard Drive window opens and displays the current software version on your hard drive and the version on the DVD. Select Yes to continue with the installation or No to cancel. Caution: If you select Yes on the Overwrite Hard Drive window, all existing data on your hard drive gets overwritten and destroyed. The Platform Installation wizard displays. You may begin the install configuration. Step 8 Select one of the following options: To enter your configuration information manually and have the installation program install the configured software on the server, select Proceed and continue with this procedure.

Enterprise License Manager User Guide OL-27040-01 5

Enterprise License Manager installation and upgrade Enter configuration information

To install the software before manually configuring it, select Skip and continue with the "Enter Configuration Information" procedure. In this case the installation program installs the software, then prompts you to configure it manually. You can select Skip if you want to pre-install the application on all your servers first and then enter the configuration information at a later time. This method might cause you to spend more time performing the installation than the other methods. To cancel the installation, select Cancel. Step 9 In the Basic Install window, select Continue to install the software version on the DVD or configure the pre-installed software. Continue with the "Perform the Basic Installation" section.

Enter configuration information

Start here if you chose Skip in the Platform Installation Wizard window.

Procedure
Step 1 Step 2 Step 3 After the system restarts, the Preexisting Installation Configuration window displays. To continue with the Platform Installation Wizard, select Proceed. In the Basic Install window, select Continue. Continue with the "Perform the Basic Installation" section.

Perform basic installation

Procedure
Step 1 When the Timezone Configuration displays, select the appropriate time zone for the server and then select OK. The Auto Negotiation Configuration window displays. The installation process allows you to automatically set the speed and duplex settings of the Ethernet network interface card (NIC) by using automatic negotiation. You can change this setting after installation. To enable automatic negotiation, select Yes and continue with Step 5. The MTU Configuration window displays. To use this option, your hub or Ethernet switch must support automatic negotiation. To disable automatic negotiation, select No and continue with Step 3. The NIC Speed and Duplex Configuration window displays.

Step 2

Enterprise License Manager User Guide 6 OL-27040-01

Enterprise License Manager installation and upgrade Perform basic installation

Step 3

If you chose to disable automatic negotiation, manually select the appropriate NIC speed and duplex settings now and select OK to continue. The MTU Configuration window displays. In the MTU Configuration window, you can change the MTU size from the operating system default. The maximum transmission unit (MTU) represents the largest packet, in bytes, that this host will transmit on the network. If you are unsure of the MTU setting for your network, use the default value, which is 1500 bytes. Caution: If you configure the MTU size incorrectly, your network performance can be affected. To accept the default value (1500 bytes), select No. To change the MTU size from the operating system default, select Yes, enter the new MTU size, and select OK. The DHCP Configuration window displays.

Step 4

Step 5

For network configuration, you can select to either set up a static network IP address for the node or to use Dynamic Host Configuration Protocol (DHCP). Static IP addresses are recommended. If you select the DHCP option, an IP address is dynamically assigned by the DHCP server. If you have a DHCP server that is configured in your network and want to use DHCP, select Yes. The network restarts, and the Administrator Login Configuration window displays. Skip to Step 8. If you want to configure a static IP address for the node, select No. The Static Network Configuration window displays.

Step 6

If you chose not to use DHCP, enter your static network configuration values and select OK. See Installing Cisco Unified Communications Manager for Node Configuration Data. The DNS Client Configuration window displays. To enable DNS, select Yes, enter your DNS client information, and select OK. See Installing Cisco Unified Communications Manager for information on the field descriptions of node configuration data. The network restarts by using the new configuration information, and the Administrator Login Configuration window displays. Enter your Platform Administrator login and password. See Installing Cisco Unified Communications Manager for information on the field descriptions of node configuration data. The Platform Administrator login must start with an alphabetic character, be at least six characters long, and can contain alphanumeric characters, hyphens, and underscores. You will need the Platform Administrator login to log in to Cisco Unified Communications Operating System Administration, the command line interface, and the Disaster Recovery System. The Certificate Information window displays.

Step 7

Step 8

Step 9

Enter your certificate signing request information and select OK.

Step 10 The Network Time Protocol Client Configuration window displays. Cisco recommends that you use an external NTP server to ensure accurate system time on the first node. Ensure the external NTP server is stratum 9 or higher (meaning stratums 1-9). Subsequent nodes in the cluster will get their time from the first node.When you install Cisco Unity Connection on a virtual machine, you must specify an external NTP server. Step 11 Choose whether you want to configure an external NTP server or manually configure the system time.

Enterprise License Manager User Guide OL-27040-01 7

Enterprise License Manager installation and upgrade Upgrade information

To set up an external NTP server, select Yes and enter the IP address, NTP server name, or NTP server pool name for at least one NTP server. You can configure up to five NTP servers, and Cisco recommends that you use at least three. Select Proceed to continue with the installation. The system contacts an NTP server and automatically sets the time on the hardware clock. Note: If the Test button displays, you can select Test to check whether the NTP servers are accessible. To manually configure the system time, select No and enter the appropriate date and time to set the hardware clock. Select OK to continue with the installation. The Security Configuration window displays. Step 12 Enter the Security password. See Installing Cisco Unified Communications Manager for information on the field descriptions of node configuration data. Note: The Security password must start with an alphanumeric character, be at least six characters long, and can contain alphanumeric characters, hyphens, and underscores. The system uses this password to authorize communications between nodes, and you must ensure this password is identical on all nodes in the cluster. Step 13 Select OK. The Application User Configuration window displays. Step 14 Enter the Application User name and password (see Installing Cisco Unified Communications Manager). Enter the password again to confirm. Step 15 Select OK. The Platform Configuration Confirmation window displays. Step 16 To continue with the installation, select OK; or to modify the platform configuration, select Back. The system installs and configures the software. The DVD drive ejects, and the server reboots. Do not reinsert the DVD. Step 17 When the installation process completes, you are prompted to log in by using the Administrator account and password. Step 18 Complete the post-installation tasks that are listed in the "Post-Installation Tasks" section. Step 19 Once complete, a message appears indicating that the Enterprise License Manager install has completed successfully.

Upgrade information
Use the following information to upgrade software in a standalone configuration.

Upgrade software through platform GUI

This section provides procedures for upgrading, via the platform GUI, using one of the following methods: Upgrade from a local source Upgrade from a remote source

Enterprise License Manager User Guide 8 OL-27040-01

Enterprise License Manager installation and upgrade Upgrade from local source

Note

Do not use the browser controls, such as Refresh/Reload, while you are accessing Cisco Unified Operating System Administration. Instead, use the navigation controls that are provided by the interface.

Upgrade from local source

Procedure
Step 1 If you do not have a Cisco-provided upgrade disk, create an upgrade disk by burning the upgrade file that you downloaded onto a DVD as an ISO image. Note Just copying the .iso file to the DVD will not work. Most commercial disk burning applications can create ISO image disks. Insert the new DVD into the disc drive on the local server that is to be upgraded. From the Administration Settings > OS Admin page, log in to Cisco Unified Communications Operating System Administration. Navigate to Software Upgrades > Install/Upgrade. The Software Installation/Upgrade window displays. From the Source list, select DVD. Enter a slash (/) in the Directory field. To continue the upgrade process, click Next. Choose the upgrade version that you want to install and click Next.

Step 2 Step 3 Step 4 Step 5 Step 6 Step 7 Step 8

Step 9 In the next window, monitor the progress of the download. Step 10 If you want to install the upgrade and automatically reboot to the upgraded partition, select Switch to new version after upgrad (system reboots). The system restarts and is running the upgraded software. Step 11 If you want to install the upgrade and then manually reboot to the upgraded partition at a later time, do the following steps: a) Select Do not switch to new version after upgrade (no system reboots). b) Click Next. The Upgrade Status window displays the Upgrade log. c) When the installation completes, click Finish. d) To restart the system and activate the upgrade, select Settings > Version; then, click Switch Version. The system restarts running the upgraded software.

Upgrade from remote source

To upgrade the software from a network location or remote server, use the following procedure.

Enterprise License Manager User Guide OL-27040-01 9

Enterprise License Manager installation and upgrade Upgrade from remote source

Procedure
Step 1 Step 2 Step 3 Step 4 Step 5 Put the upgrade file on an FTP or SFTP server that the server that you are upgrading can access. Log in to Cisco Unified Communications Operating System Administration. Navigate to Software Upgrades > Install/Upgrade. The Software Installation/Upgrade window displays. From the Source list, select Remote Filesystem. In the Directory field, enter the path to the directory that contains the patch file on the remote system. If the upgrade file is located on a Linux or Unix server, you must enter a forward slash at the beginning of the directory path. For example, if the upgrade file is in the patches directory, you must enter /patches If the upgrade file is located on a Windows server, remember that you are connecting to an FTP or SFTP server, so use the appropriate syntax, including: Begin the path with a forward slash (/) and use forward slashes throughout the path. The path must start from the FTP or SFTP root directory on the server, so you cannot enter a Windows absolute path, which starts with a drive letter (for example, C:). Step 6 Step 7 Step 8 Step 9 In the Server field, enter the server name or IP address. In the User Name field, enter your user name on the remote server. In the User Password field, enter your password on the remote server. Select the transfer protocol from the Transfer Protocol field.

Step 10 To continue the upgrade process, click Next. Step 11 Choose the upgrade version that you want to install and click Next. Step 12 In the next window, monitor the progress of the download. If you lose your connection with the server or close your browser during the upgrade process, you may see the following message when you try to access the Software Upgrades menu again:
Warning: Another session is installing software, click Assume Control to take over the installation.

If you are sure you want to take over the session, click Assume Control. If Assume Control does not display, you can also monitor the upgrade with the Real Time Monitoring Tool. Step 13 If you want to install the upgrade and automatically reboot to the upgraded partition, select Switch to new version after upgrad (system reboots). The system restarts and runs the upgraded software. Step 14 If you want to install the upgrade and then manually reboot to the upgraded partition at a later time, do the following steps: a) Select Do not switch to new version after upgrade (no system reboots). b) Click Next. The Upgrade Status window displays the Upgrade log. c) When the installation completes, click Finish. d) To restart the system and activate the upgrade, select Settings > Version; then, click Switch Version. The system restarts and is running the upgraded software.

Enterprise License Manager User Guide 10 OL-27040-01

Enterprise License Manager installation and upgrade Upgrade standalone Enterprise License Manager using CLI

Upgrade standalone Enterprise License Manager using CLI

To initiate an upgrade from a local or remote source using CLI commands, use the following procedures.

Upgrade from local source

Before You Begin
If you do not have a Cisco-provided upgrade disk, create an upgrade disk by burning the upgrade file that you downloaded onto a DVD as an ISO image. Just copying the .iso file to the DVD will not work. Most commercial disk burning applications can create ISO image disks.

Procedure
Step 1 Step 2 Insert the new DVD into the disc drive on the local server that is to be upgraded. Enter the utils system upgrade initiate command, as shown in the following example.
Example:
admin:utils system upgrade initiate

The following options appear:

Warning: Do not close this window without first exiting the upgrade command. Source: 1) Remote Filesystem via SFTP 2) Remote Filesystem via FTP 3) Local DVD/CD q) quit Please select an option (1 - 3 or "q" ):

Step 3

Select option 3. The following options appear:

1) UCSInstall_UCOS_9.0.0.98000-9004.iso q) quit Please select an option (1 - 3 or "q" ):

Step 4

Select option 1 to download upgrade file. The following messages appear:

Accessing the file. Please wait... Checksumming the file... Validating the file... A system reboot is required when the upgrade process completes or is canceled. This will ensure services affected by the upgrade process are functioning properly. Downloaded: UCSInstall_UCOS_9.0.0.98000-9004.iso File version: 9.0.0.98000-9004

Enterprise License Manager User Guide OL-27040-01 11

Enterprise License Manager installation and upgrade Upgrade from remote source

File checksum: 86:55:58:dc:c4:3a:82:88:ff:45:ae:e3:33:ca:c4:41

Step 5 Step 6

Enter yes to automatically switch versions if the upgrade was successful.

Automatically switch versions if the upgrade is successful (yes/no): yes

Enter yes to start installation.

Start installation (yes/no): yes

Upgrade from remote source

Procedure
Step 1 Enter the utils system upgrade initiate command, as shown in the following example.
Example:
admin:utils system upgrade initiate

The following options appear:

Warning: Do not close this window without first exiting the upgrade command. Source: 1) Remote Filesystem via SFTP 2) Remote Filesystem via FTP 3) Local DVD/CD q) quit Please select an option (1 - 3 or "q" ):

Step 2 Step 3

Select option 1. Enter Directory, Server, User Name, and Password information when prompted.
Example:
Directory: /ws/kradhal-rcd/kradhal-lic-cct-ccm/iso Server: se042c-94-193 User Name: kradhal Password: ******** Please enter SMTP Host Server (optional): Checking for valid upgrades. Please wait...

a) (Optional) Enter SMTP Host Server to receive email notification once upgrade is complete. The following options appear:
Available options and upgrades in "se042c-94-193:/ws/kradhal-rcd/kradhal-lic-cct-ccm/iso": 1) UCSInstall_UCOS_9.0.0.98000-9004.iso 2) ciscocm.dst-updater.2011h-1.el5.9.0.0.cop 3) cmterm-devicepack9.0.0.98000-9004.cop q) quit Please select an option (1 - 3 or "q" ):

Step 4

Select option 1 to download upgrade file. The following messages appear:

Accessing the file. Please wait... Downloaded 4829 MB.

Enterprise License Manager User Guide 12 OL-27040-01

Enterprise License Manager installation and upgrade License management CLI commands

Checksumming the file... Validating the file... A system reboot is required when the upgrade process completes or is canceled. This will ensure services affected by the upgrade process are functioning properly. Downloaded: UCSInstall_UCOS_9.0.0.98000-9004.iso File version: 9.0.0.98000-9004 File checksum: 86:55:58:dc:c4:3a:82:88:ff:45:ae:e3:33:ca:c4:41

Step 5 Step 6

Enter yes to automatically switch versions if the upgrade was successful.

Automatically switch versions if the upgrade is successful (yes/no): yes

Enter yes to start installation.

Start installation (yes/no): yes

License management CLI commands

Important

To use Enterprise License Manager CLI commands, you need a privilege level of 0 or higher.

The following CLI commands are available for Enterprise License Manager: license management list users license management change user{name| password} For detailed information on these commands, and additional CLI information, see Command Line Interface Reference Guide for Cisco Unified Solutions.

Post-upgrade tasks
After the upgrade, perform the following tasks: Check the version number in the About box to verify that it is the expected upgraded version. Perform a synchronization by selecting Inventory > Product Instances > Synchronize Now. Check the Dashboard to verify that there are no alerts.

Install COP files

Use the following procedure to install Cisco Option files (COP) files. COP files are used to enable additional functionality (for example: localization).

Enterprise License Manager User Guide OL-27040-01 13

Enterprise License Manager installation and upgrade Install COP files

Procedure
Step 1 Step 2 Step 3 Step 4 Step 5 Step 6 Obtain and store the COP file from Cisco.com by selecting Product/Technology Support > Download Software . Place the COP file on an FTP or SFTP server that the server that you are upgrading can access. Log in to Cisco Unified Communications Operating System Administration. Navigate to Software Upgrades > Install/Upgrade. The Software Installation/Upgrade window displays. From the Source list, select Remote Filesystem. In the Directory field, enter the path to the directory that contains the patch file on the remote system. If the upgrade file is located on a Linux or Unix server, you must enter a forward slash at the beginning of the directory path. For example, if the upgrade file is in the patches directory, you must enter /patches If the upgrade file is located on a Windows server, remember that you are connecting to an FTP or SFTP server, so use the appropriate syntax, including: a) Begin the path with a forward slash (/) and use forward slashes throughout the path. b) The path must start from the FTP or SFTP root directory on the server, so you cannot enter a Windows In the Server field, enter the server name or IP address. In the User Name field, enter your user name on the remote server. In the User Password field, enter your password on the remote server. Select the transfer protocol from the Transfer Protocol field. Select the COP file that you want to install from Software Location, Options/Upgrades and click Next.

Step 7 Step 8 Step 9 Step 10 Step 11

Step 12 In the next window, monitor the progress of the download. If you lose your connection with the server or close your browser during the upgrade process, you may see the following message when you try to access the Software Upgrades menu again:
Warning: Another session is installing software; click Assume Control to take over the installation.

If you are sure you want to take over the session, click Assume Control. Step 13 Once the download is complete, confirm the file checksum details and click Next. Step 14 In the next window, monitor the progress of the installation. Note The installation of a COP file may require a system restart. This restart requirement will be stated in the output section of the log. Cisco recommends that you perform this restart during an off-peak period.

Enterprise License Manager User Guide 14 OL-27040-01

CHAPTER

Enterprise License Manager operation

The following sections provide information on using Enterprise License Manager. Enterprise License Manager considerations, page 15 Log in to Enterprise License Manager, page 16 Add product instance, page 16 Edit product instance, page 17 Delete product instance, page 17 System status information, page 18 Dashboard view, page 18 License usage view, page 19 License fulfillment, page 20 Migrate licenses using Upgrade Licenses wizard, page 21 Use the Add Licenses wizard to determine new licensing requirements, page 22 Generate license request, page 22 Install license, page 23

Enterprise License Manager considerations

Follow these steps to begin using Enterprise License Manager: Log in to Enterprise License Manager. See Log in to Enterprise License Manager, on page 16. Add a product instance. See Add product instance, on page 16. Use the Dashboard or the License Usage page to determine what licenses are required for your product. For more information on the Dashboard or the License Usage pages, see System status information, on page 18.

Enterprise License Manager User Guide OL-27040-01 15

Enterprise License Manager operation Log in to Enterprise License Manager

Migrate your existing licenses if your Enterprise License Manager is managing any product instances that have been upgraded from a pre-9.0 version. See Migrate licenses using Upgrade Licenses wizard, on page 21. Perform new license fulfillment if you have Enterprise License Manager installed on a new standalone system. See Use the Add Licenses wizard to determine new licensing requirements, on page 22.

Log in to Enterprise License Manager

Procedure
Step 1 Step 2 Select Enterprise License Manager from the list of installed applications. Enter your username and password. Click Login. Note The initial login requires the application username and password that you created as part of the installation. If you are not sure what username and password to use for signing into Enterprise License Manager, see Troubleshooting, on page 39.

Add product instance

The following procedure describes how to add a product instance in Enterprise License Manager.
Important

Only the publisher node in a cluster can be added as a Product Instance. Attempting to add subscribers will result in an error.

Procedure
Step 1 Step 2 Step 3 Step 4 Log in to Enterprise License Manager. Choose Inventory > Product Instances. Click Add. The Add Product Instance dialog box appears. Enter the following information: Name Description (optional) Product Type Hostname/IP Address Username Password

Enterprise License Manager User Guide 16 OL-27040-01

Enterprise License Manager operation Edit product instance

Step 5 Step 6

Credentials are the OS Administration username and password of the product. Click OK to add the product instance.
Note

Once the product instance has been successfully added, the product appears in the Product Instances table. Note On the Product Instances page, click the Synchronize Now button to extract the licensing information from the new product. If you do not synchronize, current product instance information will not appear in Enterprise License Manager. Note An asterisk appears next to the version field of all product instances which have pre-9.0 licenses. To make pre-9.0 licenses available in the Enterprise License Manager, they must be migrated. For information on migrating licenses, see: Migrate licenses using Upgrade Licenses wizard, on page 21. Note If you wish to add a Cisco Unified Communications Manager Business Edition 5000, you need to add two product instances. The first time you enter the information detailed in Step 4, select Unified CM as the product type. The second time you add a product type, enter a unique name and select Unity Connection as the product type. All other information is the same.

Edit product instance

The following procedure describes how to edit a product instance in Enterprise License Manager.

Procedure
Step 1 Step 2 Step 3 To edit a product instance, select that instance from the Product Instance table. From the General tab of the Product Instance details page, edit the preferred settings for the product instance. If the hostname or IP address of the product instance changes, you need to delete the product instance from the Enterprise License Manager prior to changing the hostname/IP address. You then re-add it to the Enterprise License Manager once you have completed the hostname/IP address change.

Delete product instance

Procedure
Step 1 Step 2 Step 3 Step 4 Step 5 Select the radio button next to the product instance you wish to delete. Click the Delete button. A message appears stating that the Product Instance will be permanently deleted, and requesting confirmation to continue or cancel. Click Continue. A message appears, confirming that the product instance was successfully deleted. Following a successful deletion, click the Synchronize Now button to obtain the most up-to-date licensing information for all license types in the system.

Enterprise License Manager User Guide OL-27040-01 17

Enterprise License Manager operation System status information

System status information

The Monitoring section of the Enterprise License Manager interface provides the following views that enable you to monitor the system status: Dashboard view, on page 18 License usage view, on page 19

Dashboard view
The Dashboard provides an at-a-glance view of the system. Links in the Dashboard navigate to their related pages within Enterprise License Manager.

Note

When Enterprise License Manager is first installed, it operates in Demo mode until a license file is installed. While Enterprise License Manager is in Demo mode, a warning appears at the top of the GUI.

Note

Demo mode in Enterprise License Manager refers to the fact that no license file has been installed yet. During the first license file installation process, Enterprise License Manager is registered with the Cisco licensing back office and is no longer in Demo mode. Product instances managed by Enterprise License Manager are not in compliance as long as Enterprise License Manager is in Demo mode. Each product type (for example, Unified CM, Unity Connection) has its own version of "demo mode" that operates independently of Enterprise License Managers Demo mode. The Dashboard contains the following: Overview Provides information on Product Instances, Last License Update, and Last Synchronization date and time. License Usage Lists the product type and the number of licenses allocated to each of those products. License Alerts Lists alerts according to product type and the status of the alert. Alerts indicate: License types that are non-compliant Licenses that are nearing expiration Synchronization Failures Lists the product instance name, reason for failure, and last successful synchronization.

Enterprise License Manager User Guide 18 OL-27040-01

Enterprise License Manager operation License usage view

License usage view

The License Usage page identifies the licenses installed on the system and how those licenses have been used at the time of the last synchronization. There are two views available from the License Usage page: Table View Chart View Table View The Table View provides the following information for each license type: Type of licenses in use Product scope Number of licenses required Number of licenses installed Number of licenses unused Status of that license type (for example: in compliance, in violation, and so on) You can also view license properties and usage by selecting one of license types installed on the system. The License Type details page contains the following information: License Description Usage Chart Usage by Instance Installed Licenses by Type For a comprehensive view of all license types, click the View all license type descriptions on Cisco.com (new window) link under the License Description section. Chart View The Chart View tab presents a graphical view of the number of licenses used for a particular product. Placing your mouse over each of the chart's bars reveals license count information. The figure below shows a Chart View which illustrates the number of licenses: Installed Borrowed from Upper Tier Required Loaned to Lower Tier The Chart View also identifies, with a red x, instances where there are insufficient licenses.

Enterprise License Manager User Guide OL-27040-01 19

Enterprise License Manager operation License fulfillment

Substitution and tiering License types are categorized into license tiers, where the higher license tiers offer more functionality than the lower tiers. For example, CUWL Professional, the highest Unified CM-tiered type, offers more functionality than CUWL Premium or Advanced (the exact functionality is specified in the License Usage Details screen). The License Usage Table View and Chart View (as shown in the figure above) displays the types in order of tier, highest to lowest.

Note

TelePresence Room is separate from the other license types and cannot borrow from the others. License substitution refers to the Enterprise License Manager feature where a higher tier license type can be substituted for a lower-tiered type that would otherwise be in overage. In the Chart View example (in the above figure), there are 50 spare Basic licenses on loan to Essential. In this example, the 50 spare licenses are sufficient to cover the entire Essential overage. If the user installs a license file that adds Essential licenses, the spare Basic licenses would then be available for future Basic requirements.

License fulfillment
Once a product instance has been added (see Add product instance), you must then identify your licensing requirements and plan accordingly.

Note

You may wish to check your Dashboard or License Usage page first, to determine what licenses are required for your product. For more information on the Dashboard or the License Usage pages, see System status information. Once you have identified your specific licensing needs, choose from one of the following: 1 Migrate existing licenses (if applicable) into Enterprise License Manager. To migrate existing licenses, see Migrate licenses using Upgrade Licenses wizard

Enterprise License Manager User Guide 20 OL-27040-01

Enterprise License Manager operation Migrate licenses using Upgrade Licenses wizard

2 Once any existing licenses have been migrated, acquire new licenses using the following procedure: Use the Add Licenses wizard to determine new licensing requirements

Migrate licenses using Upgrade Licenses wizard

Use the following procedure to plan for migration from pre-9.0 licensing to 9.0 user-based licensing.

Procedure
Step 1 Step 2 Step 3 From the License Management > License Planning page in Enterprise License Manager, click the Upgrade Licenses button. The Upgrade Licenses wizard window appears. The first step involves choosing the product type. From the Choose Product Type section, select the type of product to upgrade from the drop-down menu. Click Next. The Choose Product Instances section appears. To upgrade a product instance, select it in the Available Product Instances window and click the arrow to move it to the Product Instances to Upgrade window. Click Next. The only products that appear in the Available Product Instances table are those that have been upgraded from a previous release and have not yet had their licenses migrated. The Specify License Counts section appears. Select the appropriate Recommendation Mode from the drop-down list to view the recommended license counts as either User Connect Licenses (UCL) or Cisco Unified Workshop Licenses (CUWL). In the License Allocation table, edit the Adjust Recommended Count column and click Save to save your change for that license type. You may also choose to run a compliance check by clicking the Run Compliance Check button, or reset the license values by clicking the Reset Values button. Once all license count values have been updated, click Next. Clicking the arrow next to each license type reveals additional information on that license type. The upgrade process can be completed only once per Unified CM product instance. You will not be able to upgrade any remaining DLUs on the selected product instances in the future. The Summary and Next Steps section appears. In this section you can view and save a summary of the changes you made. To view the summary, click View Summary. A default name for the summary also appears in the Name field using the format <productname>-add-<date-time-stamp> format. Instructions for placing your order and fulfilling your licenses also appear in this section. Click Finish & Generate Request
Caution

Step 4

Step 5

Step 6

Step 7 Step 8 Step 9

The License Migration Request and Next Steps window appears. Copy the selected text to your clipboard or click Save it to a file on your computer. Select License Migration Portal under Step 2 and paste the copied text in the designated field or select the saved file from your computer. Click Close to return to the License Planning page

Step 10 The license migration plan now appears in the table on the License Planning page.

Enterprise License Manager User Guide OL-27040-01 21

Enterprise License Manager operation Use the Add Licenses wizard to determine new licensing requirements

Use the Add Licenses wizard to determine new licensing requirements

Use the following procedure to plan the addition of new licenses.

Procedure
Step 1 Step 2 From the License Management > License Planning page in Enterprise License Manager, click the Add Licenses button. The Add Licenses wizard window appears. The first step involves choosing the product type. From the Choose Product section, from the drop-down menus, select the type and version of product to which you want to add a licence. Click Next. The Specify License Counts section appears. From this section, adjust the number of licenses that will be allocated to each type of license and click Save to save your changes for that license type. You may also choose to run a compliance check by clicking the Run Compliance Check button, or reset the license values by clicking the Reset Values button. Once the number of licenses has been set, click Next. Clicking the arrow next to each license type reveals additional information on that license type. The Summary and Next Steps section appears. In this section you can view and save a summary of the changes you made. You can also enter your own summary name and description. To view the summary, click View Summary. The Save Summary in Enterprise License Manager option is selected by default. A default name for the summary also appears in the Name field using the format <productname>-add-<date-time-stamp> format. Instructions for placing your order and fulfilling your licenses also appear in this section. Click Finish to complete Add Licenses wizard.

Step 3

Step 4 Step 5

Generate license request

To obtain a new license (using Manual fulfillment), you must first generate a license request through the License Management > Licenses page, and then use the information generated to submit a request. You will then receive your license file via email. Use the following procedure to generate a license request.

Procedure
Step 1 Step 2 Step 3 Log in to Enterprise License Manager. From the License Management > Licenses page, select Generate License Request from the drop-down list under Other Fulfillment Options. The License Request and Next Steps window appears. Copy the selected text to your clipboard or click Save the License Request File to your computer.

Enterprise License Manager User Guide 22 OL-27040-01

Enterprise License Manager operation Install license

What to Do Next
Once you have your license request information saved either to your clipboard or to your computer, you need to access the Cisco License Registration site and paste it into the appropriate field. When you receive your license file via email, install your new license file in Enterprise License Manager using the Install license, on page 23 procedure.

Install license
Before You Begin
Once you have obtained your license using the Migrate licenses using Upgrade Licenses wizard, on page 21 procedure or the Generate license request, on page 22 procedure, you can then install that license in Enterprise License Manager. Use the following procedure to install licenses.

Note

This procedure applies mainly to Manual fulfillment. Use of e-Fulfillment does not require use of the Install Licenses feature.

Procedure
Step 1 Step 2 Step 3 Step 4 Step 5 Step 6 Step 7 Log in to Enterprise License Manager. Select License Management > Licenses. Click the Install Licenses button. The Install New License File window appears. Click the Browse button. Choose the license file to upload and install, then click Open. The license file now appears in the License File field. Click the Install button. Once the license is correctly installed, a message appears indicting that the installation was successful. Click Close to return to the Licenses page.

Enterprise License Manager User Guide OL-27040-01 23

Enterprise License Manager operation Install license

Enterprise License Manager User Guide 24 OL-27040-01

CHAPTER

Enterprise License Manager setup

About window, page 25 Monitoring view settings, page 26 Dashboard settings, page 26 License Usage page settings, page 27 License Management view settings, page 29 Licenses page settings, page 29 License Planning page settings, page 31 Inventory view settings, page 33 Administration view settings, page 35

About window
Setting About Description The About dialog box contains the Enterprise License Manager version number and Registration ID number.
Note

This information can be used for re-hosting. Re-hosting is the process that customers must follow to move licenses from one instance of Enterprise License Manager to another. Licenses that have already been issued and fulfilled in one instance of Enterprise License Manager are moved to a new or different instance of Enterprise License Manager through the re-hosting process. As part of this process, it is suggested that the version number and Registration ID number be recorded in some fashion following any installation of Enterprise License Manager.

Enterprise License Manager User Guide OL-27040-01 25

Enterprise License Manager setup Monitoring view settings

Monitoring view settings

The Monitoring view contains two pages that allow you to view licensing information and configure product licenses: Dashboard settings, on page 26 License Usage page settings, on page 27

Dashboard settings
Setting Overview section Product Instances The total number of product instances managed by Enterprise License Manager. Clicking Product Instances takes you to the Inventory > Product Instances page. The date of the last license update. Clicking Last License Update takes you to the License Management > Licenses page. The date of the last successful synchronization. Clicking Last Synchronization takes you to the Inventory > Product Instances page where you can view the Synchronization Status and Last Successful Synchronization for each product instance. You can also perform a synchronization from this page by clicking the Synchronize Now button.
Note

Description

Last License Update

Last Synchronization

Synchronization occurs when Enterprise License Manager collects up-to-date licensing information for all license types in the system.

License Alerts section Type Status License types that are non-compliant Provides information about the alert (for example, insufficient licenses or when a license is due to expire)

License Usage section Type Required Synchronization Failures section Specifies the product type The number of licenses allocated to each of those product types

Enterprise License Manager User Guide 26 OL-27040-01

Enterprise License Manager setup License Usage page settings

Setting Name

Description The name of the system upon which the synchronization was attempted and failed Identifies the reason the synchronization failed The date and time of the last successful synchronization

Failure Reason Last Success

License Usage page settings

The License Usage page provides two distinct views of how licenses are being used: Table View Chart View

Note

In both Table and Chart views, you have the option of synchronizing the licenses by clicking the Synchronize Now button. Setting Table View Type The name of the license types supported within the product scope. For more information, click on a particular license type in the Type column to open a detailed license type page. The product type The number of licenses required by the product instances in order to deliver the services you have provisioned on those servers. The number of licenses currently installed The difference between the number of Required and Installed licenses. The numbers in this column are color-coded to represent the state of unused licenses for a particular license type. If the number is red, the number of licenses is considered insufficient. If the number is black, the number of licenses is considered to be in compliance. Status The license status (ex: Temp Licenses Nearing Expiration, In Compliance) Description

Product Scope Required

Installed Unused

Enterprise License Manager User Guide OL-27040-01 27

Enterprise License Manager setup License Usage page settings

Setting Synchronize Now button

Description Synchronizes Enterprise License Manager with the product instances to obtain the most up-to-date licensing information for all license types in the system

Chart View Available The Available licenses are categorized as: Installed Borrowed from Upper Tier Used The Used licenses are categorized as: Required Loaned to Lower Tier There are a number of license types under the Chart View. For detailed information on those license types, see http:// www.cisco.com/go/uclicensing. Synchronize Now button Synchronizes Enterprise License Manager with the product instances to obtain the most up-to-date licensing information for all license types in the system

License Usage details page

Note

Clicking on a license in the Table View in the License Usage page opens this License Usage details page The License Description section provides a description of that license type. There is also a link provided to view descriptions of all license types on Cisco.com. The Usage Chart section provides a graphical representation of how many of that particular license type are available, and of those, how many are installed or borrowed from the upper tier. It also indicates how many of that license type are being used, and of those, how many are required or loaned to the lower tier.

License Description section

Usage Chart section

Usage by Instance section

The Usage by Instance section lists the systems that are using that particular license type, and identifies the product type of the system, release version, and the number of licenses required for each of those systems. The Installed Licenses by Type section distinguishes between Permanent and Temporary licenses, the number of licenses that each is limited to, and the expiry date for the temporary licenses.

Installed Licenses by Type section

Enterprise License Manager User Guide 28 OL-27040-01

Enterprise License Manager setup License Management view settings

License Management view settings

The License Management view contains two pages that allow you to view licensing information and configure product licenses: Licenses page settings, on page 29 License Planning page settings, on page 31

Licenses page settings

Setting Licenses page Filename Specifies the filenames of installed licenses
Note

Description

The most recently installed license file is the active license file. The active license file contains the word "Active" at the end of the filename.

Description Installation Date Install License File button

Describes each of the installed licenses Specifies the date licenses were installed Opens the Install License File page

Generate License Request button Opens the License Request and Next Steps dialog box

Note

Install License File page

Enterprise License Manager User Guide OL-27040-01 29

Enterprise License Manager setup Licenses page settings

Setting Browse button Install button

Description Allows you to select license file from your computer. When the license file has been selected (using the Browse button), it appears in the License File field. The Install button is then used to install that license file.

License Request and Next Steps dialog box Copy the selected text The first step in the License Request and Next Steps dialog box provides the following options: copy the text in the text box to your clipboard or click the link to save the license request file to your computer. The second step instructs you to register your licenses by clicking the link provided. The third step advises you to return to Enterprise License Manager and install your licenses once you have received them. License files are generally obtained via email or downloaded from the Cisco portal. Clicking the Install button returns you to the Licenses page.

Register your Licenses

Install your Licenses

View <File ID> page File Details The File Details section contains the following information: File Name Description Installation Date Associated Summary

Enterprise License Manager User Guide 30 OL-27040-01

Enterprise License Manager setup License Planning page settings

Setting File Contents

Description The File Contents section contains a Licence File Contents table that lists license files under the following categories: Type Product Scope Count (the number of that particular license type) Expiration date

Edit <File ID> page Edit File Details Clicking the Edit File Details button on the View <File ID> window opens the Edit File Details window, which contains the following information: File Name Description Installation Date Associated Summary (the license plan associated with this license file) The Description and Associated Summary fields can be edited.

License Planning page settings

Setting License Planning page Name Specifies the name of the license plan Selecting a license plan name from the list in the History table opens the Details window for that license plan. This window contains the following information: Name (editable) Description (editable) Type Created Date Summary (includes a View Summary link that provides summary information for that license plan) Description

Enterprise License Manager User Guide OL-27040-01 31

Enterprise License Manager setup License Planning page settings

Setting Description Type Creation Date Action Add Licenses button

Description Provides a brief description of the license plan Specifies the license plan type Specifies the license plan creation date The Action column provides a Delete button to delete a license plan Clicking the Add License button opens the Add License wizard. For instructions on how to complete the Add License wizard, see the Enterprise License Manager User Guide. Clicking the Upgrade Licenses button opens the Upgrade Licenses wizard. For instructions on how to complete the Upgrade Licenses wizard, see the Enterprise License Manager User Guide.

Upgrade Licenses button

Add Licenses page Choose Product section From the Choose Product section of the Add Licenses window, you can select (from the drop-down menus) the Product Type and the Product Version to which you want to add licenses. From the Specify License Counts section of the Add Licenses window, you can adjust the number of licenses to be allocated to each type of license and save your changes for that license type. You may also choose to run a compliance check by clicking the Run Compliance Check button, or reset the license values by clicking the Reset Values button. Summary and Next Steps section From the Summary and Next Steps section of the Add Licenses window, you can view and save a summary of the changes you made in the Choose Product and Specify License Counts sections. The Save Summary in Enterprise License Manager option is selected by default. A default name for the summary also appears in the Name field using the format <productname>-add-<date-time-stamp> format. Upgrade Licenses page Choose Product Type From the Choose Product Type section of the Upgrade Licenses window, you can select the type of product to upgrade from the drop-down menu. From the Choose Product Instances section of the Upgrade Licenses window, you can upgrade a product instance by selecting it in the Available Product Instances window and click the arrow to move it to the Product Instances to Upgrade window.

Specify License Counts section

Choose Product Instances

Enterprise License Manager User Guide 32 OL-27040-01

Enterprise License Manager setup Inventory view settings

Setting Specify License Counts

Description From the Specify License Counts section of the Upgrade Licenses window, you can edit the license count in the Updated License Count column. You may also choose to run a compliance check by clicking the Run Compliance Check button, or reset the license values by clicking the Reset Values button.

Summary and Next Steps

From the Summary and Next Steps section of the Upgrade Licenses window, you can view and save a summary of the changes you made. The Save Summary in Enterprise License Manager option is selected by default. A default name for the summary also appears in the Name field using the format <productname>- migrate-<date-time-stamp> format. Instructions for placing your order and fulfilling your licenses also appear in this section. The Finish & Generate Request button completes the process and closes the Upgrade Licenses wizard.

License Migration Request and Next Clicking the Finish & Generate Request button in the Summary and Steps Next Steps section of the Upgrade Licenses window opens the License Migration Request and Next Steps dialog box. From this dialog box you can save the License Migration Request .zip file to your PC. Instructions for emailing your License Migration Request to Cisco and installing your licenses also appear in this section.

Inventory view settings

The Inventory view contains the Product Instances page, which allows you to view product license information. From this page, you can add, delete, and synchronize a product instance. Setting Product Instances Name Hostname/IP Address Product Type Version Synchronization Status Specifies the name of the product instance Specifies the hostname or IP address of the product instance Specifies the type of product instance (Unified CM or Unity Connection) Specifies the product release of the product instance Specifies the status of the product instance synchronization (for example, Success, Registration Conflict, Invalid Server Type) Description

Enterprise License Manager User Guide OL-27040-01 33

Enterprise License Manager setup Inventory view settings

Setting Last Successful Synchronization Add button

Description Specifies the date and time of the last successful synchronization.

Clicking the Add button on the Product Instances page opens the Add Product Instance dialog box. From this dialog box, you can enter the following information: Name Description (optional) Product Type Hostname/IP Address Username Password
Note

Once you have added your new product instance, be sure to click the Synchronize Now button to extract current licensing information from the product. If you do not synchronize, current product instance information may not appear in Enterprise License Manager.

Test Connection button

From the Product Add dialog box, you can click the Test Connection button to test the connection to the product instance prior to adding it. If the connection cannot be established, either through the connection test or by clicking OK to add a product instance, you may receive one of the following error messages: Instance Unreachable Login Failed Certificate Mismatch Registration Conflict Invalid Server Type Product Type Mismatch Duplicate Product Instance
Note

You may also skip the Test Connection button and click OK on the Add Product Instance dialog box.

Delete button

You can delete a product instance by selecting the check box next to the product instance and clicking Delete. You can open the administration GUI for a particular product instance by selecting the check box next to the product instance and clicking Launch Admin GUI.

Launch Admin GUI button

Enterprise License Manager User Guide 34 OL-27040-01

Enterprise License Manager setup Administration view settings

Setting Synchronize Now button

Description Synchronizes Enterprise License Manager with the product instances to obtain the most up-to-date licensing information for all license types in the system

Product Instance details page

Note

Clicking on a product instance in the Product Instance table opens the following details page The General tab is divided into two sections: Product Information Administrator Account The Product Information section contains the following information: Name Description Hostname/IP Address Product Type Product Version The Administrator Account section contains the following information: Username Password Clicking the Save button saves your changes.
Note

General tab

Prior to clicking the Save button, you have the option of clicking the Test Connection button to ensure that the connection is established.

License Usage tab

The License Usage tab contains a graphical representation of the license requests and a table illustrating the number of licenses requested by license type.

Administration view settings

The Administration view allows you to configure the following Enterprise License Manager settings: Administrator Accounts OS Administration Disaster Recovery Diagnostic Logs

Enterprise License Manager User Guide OL-27040-01 35

Enterprise License Manager setup Administration view settings

Restart Setting Administrator Accounts Add Administrator button Selecting the Add Administrator button in the Administrator Accounts window opens the Add Administrator Account window. From this window, you can add an administrator. You are prompted for the following information: User ID Password Re-enter Password Change Password Selecting the Change Password link in the Administrators table opens the Change Password page. From this page you can change the password of an existing administrator account. You are prompted for the following information: New Password Re-enter New Password Edit <User ID> Selecting the user ID of an existing administrator account in the Administrator Accounts Window opens an Edit <User ID> page. From this page you can edit the Name/Description of an administrator account. Description

OS Administration OS Administration The OS Administration page contains a link to the Cisco Unified OS Administration utility. Clicking this link opens the utility in a new window.
Note

The Cisco Unified OS Administration utility is common to Unified CM, Unity Connection, and Enterprise License Manager. It is not unique to Enterprise License Manager.

Disaster Recovery

Enterprise License Manager User Guide 36 OL-27040-01

Enterprise License Manager setup Administration view settings

Setting Disaster Recovery

Description The Disaster Recovery page contains a link to the Cisco Disaster Recovery Service utility. Clicking this link opens the utility in a new window. The Cisco Disaster Recovery Service utility is common to Unified CM, Unity Connection, and Enterprise License Manager. It is not unique to Enterprise License Manager. For documentation on the Cisco Disaster Recovery Service utility, see the following:
Note

Unified CM: http://www.cisco.com/en/US/products/sw/voicesw/ ps556/prod_maintenance_guides_list.html Unity Connection: http://www.cisco.com/en/US/docs/ voice_ip_comm/connection/8x/drs_administration/guide/ 8xcucdrsag.html Diagnostic Logs Log Settings tab The Log Settings tab lists the diagnostics categories and log levels. The Log Level drop-down list for each diagnostic category can be set to one of the following: Error Warning Info Debug Once the log level has been set for each diagnostic category, you can save your changes by clicking the Save button. You may also opt to reset your log settings by clicking the Reset button. Download Logs tab The Download Logs tab allows you to generate a log file, using the date and time range of your choice to include in the log file. The default range is from 12 AM of the current day until the current time. You can then generate the file by clicking the Generate Log File button. The log file is generated and downloaded to your computer.

Restart Restart The Restart button restarts all Enterprise License Manager services.

Enterprise License Manager User Guide OL-27040-01 37

Enterprise License Manager setup Administration view settings

Enterprise License Manager User Guide 38 OL-27040-01

CHAPTER

Troubleshooting
If an issue occurs with Enterprise License Manager, an error messages appears. The following status messages may display when there is an issue: Unknown username and password for Enterprise License Manager login , page 39 Configuration changes are not appearing in Enterprise License Manager, page 40 The following error message appears: The cause of the error is unknown, page 40 Product instance was modified, but changes are not reflected in license usage data, page 40 Product instance was deleted, but is still showing up in license usage data, page 41 Product instance is not showing up in license usage data, page 41 Product instance data in administration GUI does not match data Product Instances view in Enterprise License Manager, page 41 Overage alerts are not appearing when Enterprise License Manager goes into overage, page 42 Enterprise License Manager does not indicate a product overage, page 42 Licenses are missing following restoration of Enterprise License Manager on a different server, page 42 Cannot bring system into compliance using the Upgrade Licenses wizard, page 43

Unknown username and password for Enterprise License Manager login

Description I do not know the username and password of the system when it was originally installed, so I cannot log into Enterprise License Manager.

Enterprise License Manager User Guide OL-27040-01 39

Troubleshooting Configuration changes are not appearing in Enterprise License Manager

Resolution Log into the platform CLI with the OS administration credentials and use the license management list users command to view the username to use for signing into the Enterprise License Manager application. If you are not sure what the password is for this username, you can use the license management change user password command to change this password.

Configuration changes are not appearing in Enterprise License Manager

Description I made a configuration change in my products, but I am not seeing a change in the requested licenses reflected in Enterprise License Manager. Resolution Enterprise License Manager synchronizes products every 24 hours. If you wish to see the latest configuration changes, choose Inventory > Product Instances and click Synchronize Now.

The following error message appears: The cause of the error is unknown
Description I received the following error message: The cause of the error is unknown. Resolution Check the Enterprise License Manager log for details. If the cause of the error is not easily identifiable from these details, please open a Service Request using the TAC Service Request Tool, http://tools.cisco.com/ ServiceRequestTool/create/DefineProblem.do, or send an email to licensing@cisco.com. Please have your valid Cisco.com user Id and password available. As an alternative, you may also call our main Technical Assistance Center at 800-553-2447.

Product instance was modified, but changes are not reflected in license usage data
Description I modified the configuration of a product instance, but I do not see it reflected in the license usage data in Monitoring > Dashboard and Monitoring > License Usage.

Enterprise License Manager User Guide 40 OL-27040-01

Troubleshooting Product instance was deleted, but is still showing up in license usage data

Resolution When a product instance is added to the Enterprise License Manager, usage data is not available until the Enterprise License Manager synchronizes with the product instance. Synchronization happens once every 24 hours, or can be manually requested from Monitoring > License Usage using the Synchronize Now button.

Product instance was deleted, but is still showing up in license usage data
Description I deleted a product instance, but I do not see it reflected in the license usage data in Monitoring > Dashboard and Monitoring > License Usage. Resolution When a product instance is deleted from Enterprise License Manager, usage data is not available until the Enterprise License Manager synchronizes with the product instance. Synchronization happens once every 24 hours, or can be manually requested from Monitoring > License Usage using the Synchronize Now button.

Product instance is not showing up in license usage data

Description I added a product instance, but I do not see it reflected in the license usage data in Monitoring > Dashboard and Monitoring > License Usage. Resolution When a product instance is added to the Enterprise License Manager, usage data is not available until the Enterprise License Manager synchronizes with the product instance. Synchronization happens once every 24 hours, or can be manually requested from Monitoring > License Usage using the Synchronize Now button.

Product instance data in administration GUI does not match data Product Instances view in Enterprise License Manager
Description The data I see for a product instance in the administration GUI for that product (for example, when I select Inventory > Product Instances > Launch Admin GUI) does not match what I see when I select the same product instance in Inventory > Product Instances.

Enterprise License Manager User Guide OL-27040-01 41

Troubleshooting Overage alerts are not appearing when Enterprise License Manager goes into overage

Resolution Changes in the configuration of a product instance are not seen in the Enterprise License Manager until the next synchronization following the configuration change. Synchronization happens once every 24 hours, or can be manually requested from Monitoring > License Usage using the Synchronize Now button.

Overage alerts are not appearing when Enterprise License Manager goes into overage
Description I am not receiving any alerts when my Enterprise License Manager goes into overage. Resolution Overage alerts are generated by the product instances, not by Enterprise License Manager. Ensure that the product supports overage alerting. If a product supports overage alerting, it must be configured in the GUI for that product. For example, the administration interface in Unified CM allows you to specify which conditions are alerted and in what manner. Therefore, if you are not seeing overage alerts for Unified CM, you should verify that overage alerts are configured in Unified CM. If not, the alerts will be visible in the administration interface, but you will not receive those alerts via the mechanism you have selected (for example, email, SNMP, syslog).

Enterprise License Manager does not indicate a product overage

Description My product says it is in overage, but my Enterprise License Manager does not show overage. Resolution If a product instance is unable to synchronize with its Enterprise License Manager, it goes into overage because it is unable to confirm that there are licenses available. Please check the last synchronization date for the product instance under Inventory > Product Instances. If synchronization is not occurring, verify that the credentials in the Enterprise License Manager for the product instance are accurate and that there is network connectivity between your Enterprise License Manager and the product instance.

Licenses are missing following restoration of Enterprise License Manager on a different server
Description I have restored my Enterprise License Manager on a different server and I do not have any licenses.

Enterprise License Manager User Guide 42 OL-27040-01

Troubleshooting Cannot bring system into compliance using the Upgrade Licenses wizard

Resolution When you move your Enterprise License Manager to a different physical or virtual server, your licenses need to be rehosted to the new server and reinstalled. Please open a Service Request using the TAC Service Request Tool, http://tools.cisco.com/ServiceRequestTool/create/DefineProblem.do, or send an email to licensing@cisco.com for next steps. Please have your valid Cisco.com user Id and password available. As an alternative, you may also call our main Technical Assistance Center at 800-553-2447.

Cannot bring system into compliance using the Upgrade Licenses wizard
Description In the License Management > License Planning > Upgrade Licenses wizard, I am unable to bring the system into compliance. Resolution If, across all the product instances managed by your Enterprise License Manager, you are using more licenses than are already installed combined with those available from the product instances you are upgrading, you will not have sufficient licenses to upgrade to bring your Enterprise License Manager into compliance. You will need to purchase additional licenses to cover your needs, or reduce the number of licenses required by your product instances by changing their configuration.

Enterprise License Manager User Guide OL-27040-01 43

Troubleshooting Cannot bring system into compliance using the Upgrade Licenses wizard

Enterprise License Manager User Guide 44 OL-27040-01