cancel
Showing results for 
Search instead for 
Did you mean: 
cancel
Announcements

AMA-CUCM Troubleshooting: Best Practices for Reading Trace Files

Licensing for CUCM

20207
Views
5
Helpful
4
Comments

 

 

Introduction

 

Use licensing in Cisco Unified Communications Manager (CUCM) Administration, helps to accurately track the number of devices that are connected to Cisco Unified Communications Manager, including third-party phones that run SIP, and compare it with the number of unit licenses that have been purchased.

 

Licensing helps manage Cisco Unified Communications Manager licenses and enforces the licenses for Cisco Unified Communications Manager applications and the number of devices.Licenses get generated for requested Cisco Unified Communications Manager nodes (servers in a Cisco Unified Communications Manager cluster) and the devices that are associated with those nodes.Two types of licenses exist:-

 

  • Production licenses
  • Starter licenses

 

Production licenses for Cisco Unified Communications Manager comprise licenses for devices and nodes that are purchased from Cisco. License device types include physical devices such as IP phones and applications such as IP communicator.

 

New installations of Cisco Unified Communications Manager include starter licenses that get replaced when a production license file gets uploaded. Cisco does not provide starter licenses for upgrades or migrations.

 

Terminology

 

Use licensing in Cisco Unified Communications Manager Administration to accurately track the number of devices that are connected to Cisco Unified Communications Manager, including third-party phones that run SIP, and compare it with the number of unit licenses that have been purchased.

 

Licensing helps manage Cisco Unified Communications Manager licenses and enforces the licenses for Cisco Unified Communications Manager applications and the number of devices.Licenses get generated for requested Cisco Unified Communications Manager nodes (servers in a Cisco Unified Communications Manager cluster) and the devices that are associated with those nodes.

 

 

 

Licensing Terminology

 

Term

Description

Adjunct Licensing/Adjunct Device

With adjunct licensing, fewer device license units (DLUs) get consumed for adjunct (secondary) devices, such as Cisco IP Communicator, Cisco Unified Personal Communicator, and Cisco Unified Mobile Communicator, when these applications get used with a Cisco Unified IP Phone, which serves as the primary device. For adjunct licensing to work, the adjunct device must consume fewer or the same number of DLUs as the primary device.

Device License Unit (DLU)

Device license units are assigned to each device that is connected to Cisco Unified Communications Manager. Each device is assigned a unit number based on the type and capabilities of the device. Devices with more complex and high-end capabilities are assigned a higher number of units.

Product Authorization Key (PAK)

When you place an order for Cisco devices, Cisco provides a Product Authorization Key (PAK). Using PAK, you can split the licenses across multiple clusters when over 1,000 device license unit bundles are purchased.

For example, you request 20 Cisco Unified Communications ManabManager nodes and 15000 phone units and another license file with 5 Cisco Unified Communications Manager nodes and 5000 phone units.

Production License

Production licenses for Cisco Unified Communications Manager comprise licenses for devices and nodes that are purchased from Cisco.

Starter License (also called demo license)

Cisco Unified Communications Manager contains a starter license that you can use to begin new installations of Cisco Unified Communications Manager before you install the production license. Starter licenses, which are available in limited quantities, have no expiration date. You can use starter licenses only for fresh installations; you cannot use them for upgrades or migrations from previous releases. Starter licenses support only one Cisco Unified Communications Manager node and up to 50 device license units.

The system overwrites the starter licence when you obtain and upload your production licenses.

 

 

 

License related Windows

 

Term

 

Description

Main window

After you log in to Cisco Unified Communications Manager Administration, messages may display that indicate the current state of licenses for Cisco Unified Communications Manager. For example, Cisco Unified Communications Manager may identify the following situations:

Cisco Unified Communications Manager currently operates with starter licenses, so upload the appropriate license files.

Cisco Unified Communications Manager currently operates with an insufficient number of licenses, so upload additional license files.

Cisco Unified Communications Manager does not currently use the correct software feature license. In this case, the Cisco CallManager service stops and does not start until you upload the appropriate software version license and restart the Cisco CallManager service.

System > Licensing > License Unit Report

This window displays the total license capacity and the number of licenses in use. Cisco Unified Communications Manager generates a report that lists the total number of available licenses. The license unit report also displays the software license version that is installed on the Cisco Unified Communications Manager server.

This window displays the status of a license file. For example, the Status column for each license type may display Demo, Missing, Invalid, or Uploaded.

System > Licensing > License Unit Calculator

This window allows you to calculate the number of device license units that are required for a phone model or application.

System > Licensing > License File Upload

This window allows you to upload the license file that you obtained. In addition, this window displays a message that uploading the license file removes the starter licenses for the feature. You can also view the license file from this window.

System > Licensing > License Capabilities Assignment

This window triggers licensing to consume device license units for Cisco Unified Presence (CUP) and Cisco Unified Personal Communicator (CUPC) users.

User Management > End User

This window displays the Enable Mobility check box, which triggers licensing to consume device license units for Cisco Unified Mobility.

Device > Phone

This window displays the Device Is Active message, which triggers licensing to consume device license units for the phone.This window displays the Primary Phone drop-down list box for Cisco IP Communicator, Cisco Unified Mobile Communicator, Cisco Unified Personal Communicator, and Client Services Framework. Configuring the Primary Phone setting triggers licensing to consume fewer device license units for the application because it serves as an adjunct device, not the primary device.

 

 

Contents of the License File

 

The license file, which you can view from the License File Upload window, contains the following information:

 

  • Number of Cisco Unified Communications Manager nodes that are licensed—This indicates number of Cisco Unified Communications Manager servers in a cluster that are licensed to the customer.

 

  • Versions of the Cisco Unified Communications Manager that are supported.

 

  • Number of phone units that are licensed—Instead of creating a separate license for each phone type, the system uses the concept of license units. Each phone type corresponds to a fixed number of license units.

 

 

Note To determine the number of license units that are required for each device, choose System > Licensing > License Unit Calculator. This window lists the number of license units that are required for each type of device.

 

  • MAC address of the server, where the license file can be installed.

 

Few Samples

 

1) Permanent IP Phone Licenses

 

 

INCREMENT PHONE_UNIT cisco 6.0 permanent uncounted \

 

VENDOR_STRING=<Count>1000</Count><OrigMacId>000BCD4EE59D</OrigMacId><LicFileVersion>1.0</L

icFileVersion> \

HOSTID=000bcd4ee59d OVERDRAFT=50 \

NOTICE="<LicFileID>20050826140539162</LicFileID><LicLineID>2</LicLineID> \

<PAK></PAK>" SIGN="112D 17E4 A755 5EDC F616 0F2B B820 AA9C \

0313 A36F B317 F359 1E08 5E15 E524 1915 66EA BC9F A82B CBC8 \

4CAF 2930 017F D594 3E44 EBA3 04CD 01BF 38BA BF1B"

 

 

The preceding license file includes following information:

 

 

•No expiration date for this license exists as indicated by the keyword permanent.

 

 

•This license file provides 1000 PHONE_UNIT licenses.

 

 

OVERDRAFT=50 indicates (5 percent of 1000) allowed overdraft. Cisco determines the overdraft value.

 

 

•The Cisco-specific field LicFileID identifies this license file.

 

 

•You can add multiple increment lines for same feature (phone unit license or node license) in a license file to increase the license count. Identical INCREMENT lines should not exist, and each line should be signed independently.

 

 

•To use 5.0 device licenses with Cisco Unified Communications Manager 6.0(1) or later, make sure that you obtain the software feature license for the Cisco Unified Communications Manager version that is running on your system.

 

2) Permanent CCM_Node licenses

 

 

# Optional usage agreement, legal language, tracking information

# Some other comments

 

INCREMENT CCM_NODE cisco 6.0 permanent uncounted \

VENDOR_STRING=<Count>2</Count><OrigMacId>000e7feeebbd</OrigMacId><LicFileVersion>1.0</LicF

ileVersion> \

HOSTID=000e7feeebbd \

NOTICE="<LicFileID>20060309193216861</LicFileID><LicLineID>1</LicLineID> \

<PAK></PAK>" SIGN="1375 87CA 021E 6ABD C2EF C1D2 1E1A 9A08 \

6A0C 6624 1F21 E5CC 8D83 E154 202F 0A2A 4F75 00D6 C102 E5B9 \

5DA2 A3F9 AE38 CD9A CC86 3F14 9455 28F9 CBC8 31CC"

 

The preceding license file includes the following information:

 

 

•No expiration date for this license exists as indicated by the keyword permanent. Permanent indicates that the license file is not temporary. A temporary license would have a date here instead.

 

 

•This license file provides two licenses for the version 5.0 of the feature CCM_NODES.

 

 

Original Mac Id specifies the Mac ID for which license file was first issued.

 

 

Host ID specifies the MAC ID of the publisher server. This would differ from the OrigMacID only if a rehost procedure was done for the license file.

 

 

•The Cisco specific field LicFileID identifies this license file.

 

 

SIGN represents the signature that FlexLM generates, and the FlexLM validation package uses it in Cisco Unified Communications Manager to detect whether license file tampering occurred.

 

 

•You can add multiple increment lines for same feature in a license file to increase the license count. Ensure that none of the INCREMENT lines is identical, and ensure that each of them is signed independently.

 

3) Software Feature licenses

 

 

INCREMENT SW_FEATURE cisco 6.0 permanent uncounted \

 

VENDOR_STRING=<Count>1</Count><OrigMacId>111222333444</OrigMacId><LicFileVersion>1.0</LicF

ileVersion> \

HOSTID=111222333444 \

NOTICE="<LicFileID>20070911134257196</LicFileID><LicLineID>1</LicLineID> \

<PAK></PAK>" SIGN="15CF FEF2 BB28 3A61 014F AEC1 7F18 8F8D \

6EC8 7BA7 8ACE 0267 BA34 DE1D BF94 0230 96A6 6DA6 83B6 D0CC \

1E53 E091 1304 9246 C7A3 CCEB 12E6 6FA3 E95C 6C92"

 

 

The preceding license file includes the following information:

 

 

•No expiration date for this license exists as indicated by the keyword permanent.

 

 

•The INCREMENT SW_FEATURE line indicates that this license provides feature support for Cisco Unified Communications Manager 6.0.

 

 

•To use 5.0 device licenses with Cisco Unified Communications Manager 6.0(1) or later, make sure that you obtain the software feature license for the Cisco Unified Communications Manager version that is running on your system.

 

How Licensing Works?

 

For Phones

 

Each phone type requires a fixed number of device license units. For example, Cisco Unified IP Wireless Phone 7920 requires four device license units, and Cisco Unified IP Phone 7970 requires five device license units. If you want licenses for four 7920 phones and four 7970 phones, you require 36 device license units.

 

Before you configure a phone in the Phone Configuration window, consider the following information:

 

  • If the Cisco Unified Communications Manager database contains a real MAC address for a phone, not the dummy MAC address that is created via the Bulk Administration Tool (BAT), licensing immediately consumes device license units for the phone after the phone gets added to the database.

 

If the number of used device license units and number of pending device licensing units do not exceed the total number of device license units that are available for use, the phone with the real MAC address gets added to the database.

 

If the number of used device license units and number of pending device licensing units exceed the total number of device license units that are available for use, the phone with the real MAC address does not get added to the database.

The Device Is Active message in the Phone Configuration window in Cisco Unified Communications Manager Administration displays when a phone consumes device license units and when a phone can register with Cisco Unified Communications Manager.

 

For a phone that uses a real MAC address, not the dummy MAC address that is created via BAT, the Device Is Active message displays, which indicates that the phone uses device license units and can register with Cisco Unified Communications Manager.

 

For a phone that uses the dummy MAC address that is created via BAT, the Device Is Active message does not display. If you manually convert the dummy MAC address to a real MAC address in the Phone Configuration window, the Device Is Active message displays after you save the configuration; this ensures that the phone can register with Cisco Unified Communications Manager and that licensing consumes device license units for the phone.

 

Cisco Unified Communications Manager allows you to provision phones with dummy MAC addresses via BAT as long as the number of used device license units and the number of pending device license units do not exceed the total number of device license units that are available for use.

 

If you use the Cisco Unified Communications Manager Auto-Register Phone Tool (TAPS) to associate an auto-registered phone with the BAT dummy settings, the Cisco Unified Communications Manager Auto-Register Phone Tool deletes the auto-registered phone from the database, and licensing gives you credits for the device license units for the deleted phone. After the Cisco Unified Communications Manager Auto-Register Phone Tool applies the device name to the phone that uses the dummy MAC address, the Device Is Active message displays in Phone Configuration window. Licensing consumes device license units for the phone, and the phone can register with Cisco Unified Communications Manager, unless the number of used device license units exceeds the total number of device license units that are available for use.

 

When a phone auto-registers for use with the Cisco Unified Communications Manager Auto-Register Phone Tool, it gets inserted into the database as long as the number of used device license units is less than the number of device license units that are available for use.

 

You can view the number of pending, used, and available device license units in the License Unit Report and the License Unit Calculator in Cisco Unified Communications Manager Administration.

 

Adjunct Licensing

 

With adjunct licensing, fewer device license units (DLUs) get consumed for adjunct (secondary) devices, such as Cisco IP Communicator, Cisco Unified Personal Communicator, and Cisco Unified Mobile Communicator, when these applications get used with a Cisco Unified IP Phone, which serves as the primary device. For adjunct licensing to work, the adjunct device must consume fewer or the same number of DLUs as the primary device.

 

For example, if you configure Cisco IP Communicator as a secondary device for the Cisco Unified IP Phone 7970, Cisco IP Communicator consumes only one DLU. Adjunct licensing works because the Cisco Unified IP Phone 7970 consumes five DLUs and Cisco IP Communicator consumes three DLUs.

 

In another example, if you configure Cisco IP Communicator as a secondary device for the Cisco Unified IP Phone 7906, adjunct licensing fails because the Cisco Unified IP Phone 7906 consumes two DLUs and Cisco IP Communicator consumes three DLUs. An error occurs when you configure an application, for example, Cisco IP Communicator, as the adjunct device, and the adjunct device requires more device license units (DLUs) than the primary device; for example, the Cisco Unified IP Phone 7906.

 

To ensure that Cisco Unified Communications Manager treats Cisco IP Communicator, Cisco Unified Personal Communicator, and Cisco Unified Mobile Communicator as adjunct (secondary) devices, configure the Primary Phone setting in the Phone Configuration window for Cisco IP Communicator, Cisco Unified Personal Communicator, and Cisco Unified Mobile Communicator.

 

The License Unit Calculator window displays (Adjunct) next to the applications that work as adjunct devices.

 

Licenses for Cisco Unified Mobility

 

Checking the Enable Mobility check box in the End User Configuration window triggers licensing to consume device license units for Mobile Connect. The number of device license units that are consumed depends on whether you assign the end user an adjunct device, that is, a desktop phone, for example, specifically for Cisco Unified Mobility. You assign the end user an adjunct device for Cisco Unified Mobility by choosing a device from the Primary User Device drop-down list box in the Mobility Information pane in the End User Configuration window, not by clicking the Device Association button in the same window.

Before you enable Mobile Connect, consider the following information:

 

  • Cisco Unified Communications Manager Administration does not allow you to assign the same device for Cisco Unified Mobility to multiple users.

 

  • When you plan your configuration, determine whether the user uses both a desktop phone and a cell phone. If the user uses both a cell phone and a desktop phone, make sure that you assign an adjunct device to the user after you enable Mobile Connect in the End User Configuration window.

 

The device that you assign serves as the adjunct device; that is, the device, such as a desktop phone, that the user uses in addition to the cell phone for Cisco Unified Mobility.

  • If you enable Mobile Connect and fail to assign the end user an adjunct device for Cisco Unified Mobility, four DLUs get consumed, as indicated in the Mobility Enabled End Users row in the License Unit Calculator window.

 

  • If you enable Mobile Connect and assign the end user an adjunct device for Cisco Unified Mobility, two DLUs get consumed, as indicated in the Mobility Enabled End Users (Adjunct) row in the License Unit Calculator window.

 

  • If you enable Mobile Connect and later decide to assign an adjunct device for the feature to the end user, the system credits you with two DLUs, as indicated in the Mobility Enabled End Users row in the License Unit Calculator window.

 

For example, if you enable Mobile Connect, forget to assign the end user an adjunct device for the feature, and click Save, the system consumes four DLUs. If you then assign the end user an adjunct device for the feature and click Save, the system credits you with two DLUs

 

  • If you delete the device from Cisco Unified Communications Manager Administration or remove the assignment after you enable Mobile Connect, two DLUs get consumed after you delete the device or remove the assignment, as indicated in the Mobility Enabled End Users row in the License Unit Calculator window.

 

  • Cisco   Unified Communications Manager on VMware on Cisco UCS B-Series Blade   Servers uses a different licensing model than Cisco Unified Communications Manager on an MCS server. The MAC address of the NIC  card  is no longer used to associate the license to the server.Instead,   the license gets associated to a license MAC, which is a 12 digit HEX   value created by hashing the following parameters that you configure on   the server:-

 

    • Time zone
    • NTP server 1 (or "none")
    • NIC speed (or "auto")
    • Hostname
    • IP Address (or "dhcp")
    • IP Mask (or "dhcp")
    • Gateway Address (or "dhcp")
    • Primary DNS (or "dhcp")
    • SMTP server (or "none")
    • Certificate Information (Organization, Unit, Location, State, Country)

 

 

This hash of these fields is called the LICENSE MAC.

 

Note : Once there is a change in any of the parameters that creates the License MAC, it will give you 30 day grace period to generate a new license file for the CM based on new license MAC.

 

For VM migration and licensing refer https://supportforums.cisco.com/message/3736856#3736856

 

 

Related Information & discussions

 

 

 

 

Comments
Explorer

Hello,

the PDF version of this document doesn't work.

When I click on the link, this message appears: "System Error - We're sorry but a serious error has occurred in the system".

What's wrong?

TIA and regards.

Rising star

Thanks for pointing out this issue Emanuele. We are trying to fix this issue. Once this is resolved, I will update you.

Regards,

Vinay Sharma

Community Manager

Beginner

Hi Vinay Sharma,

The issue is still there. Cant view as pdf.

As a work around:  Click View Print Preview

Then Print from your Browser; and select Print as PDF.

Give it a file name and a location to save on your PC.

CreatePlease to create content
Content for Community-Ad
August's Community Spotlight Awards