Guest

Cisco Unity Connection

Troubleshoot the Licensing Issues in Unity Connection 7.x/8.x

Cisco - Troubleshoot the Licensing Issues in Unity Connection 7.x/8.x

Document ID: 111056

Updated: Jun 19, 2012

   Print

Introduction

This document provides information on how to troubleshoot some of the common licensing issues that occur in Cisco Unity Connection 7.x/8.x.

Prerequisites

Requirements

There are no specific requirements for this document.

Components Used

The information in this document is based on these software and hardware versions:

  • Cisco Unity Connection 7.x/8.x

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.

Conventions

Refer to Cisco Technical Tips Conventions for more information on document conventions.

Error: The requested operation would result in a license violation

When trying to import users to Cisco Unity Connection, the The requested operation would result in a license violation error message is received.

Solution

This error message is related to the license issue. In order to resolve this issue, you need to make sure that the number of users imported has not exceeded the limit that is mentioned in the license report. Complete these steps in order to ensure this:

  1. You can check the license report via Cisco Unity Connection Administration > System Settings > Licenses.

    tshoot-error-ucl-01.gif

    Each license file is registered to the MAC address of the network interface card (NIC) on the Cisco Unity Connection server. The license file provided is based on the entitlements associated with your Cisco sales order.

  2. Click on the license file (for this example, it is CXN120070803132405016.lic) and run this license report. A sample of the report is shown here:

    SERVER this_host ANY
    DAEMON cisco
    INCREMENT LicSubscribersMax cisco 1.1 18-feb-2008 permanent 50 \
    	HOSTID=001871e4dfc5 \
    	NOTICE="<LicFileID>20070911100835792</LicFileID><LicLineID>1</LicLineID> \
    	<PAK>11621232CD0</PAK>" SIGN=74577B96089C

    In your license report , there is a field called LicSubscribersMax which contains the total number of subscribers you can have in your system. If the number of users you are going to import exceeds the number in the LicSubscribersMax field, you will receive a license violation error message. As per this example report, if the number of users you are trying to import exceeds 50, then you will receive a license violation error message.

  3. The solution for this is to either upgrade the license or make sure that the number of users imported is less than the maximum limit mentioned in the Cisco Unity Connection license report.

Error: A license tag in a license file was found to be invalid

After you upgrade to Cisco Unity Connection 7.x, this error message appears when you attempt to update the new license file:

A license tag in a license file was found to be invalid. Tag
LicSubscribersMax in file XYZ.lic has a missing orinvalid host id. 
This tag will be ignored, but the remainder of the license file will be processed.
If you believe the tag in this file should be valid, please contact support personnel.

Solution

As a solution, check these issues:

  1. Make sure that you have entered the correct License MAC address in order to obtain the license key. If not, you need to run the show status CLI command and obtain the License MAC value, then request a new license based on this value.

  2. The subscriber voice port license needs to be installed on the subscriber server.

  3. Make sure that the feature license is correct.

COS Misconfiguration Leads to License Violation

Problem

For a Cisco Unified messaging account, this status message is displayed:

"A license violation has occurred:you have configured this Connection user for single inbox,
  but you have assigned the user to a class of service in which single inbox is not enabled. 
If you do not either enable single inbox for the class of service or reassign the user
 to a class of service in which single inbox is enabled, Connection will stop functioning. 
For more information, see the Licenses page."

On System Settings licenses, this message is displayed:

"A license violation related to the LicIMAPSubscribersMax license 
tag has occurred. You have configured Connection users for single inbox and assigned them to a class of service
 in which single inbox is not enabled. Assign the users to a class of service in which single inbox is enabled, 
or Connection will stop functioning in [number of] days. You can restore functionality by restarting the server,
 but Connection will stop functioning again every 24 hours until the license violation is resolved."

Solution

The Cisco Unity Connection stopped operations due to a license violation. This occurs because single inbox is enabled for the users account, but single inbox is not on the class of service of the user. This can also occur to the subscribers with the single inbox feature, and the connection IMAP feature is not enabled in each and every class of service.

In order to resolve this issue:

  • Enable single inbox on the class of service of the user, or disable single inbox on the Cisco Unified messaging account.

  • Enable IMAP functionality in every class of service, then reboot the server.

This is documented in Cisco bug ID CSCtk01560 (registered customers only) .

Error: insufficient license violation has occurred beyond the grace period

Problem

There are error messages that state there is a licensing violation.

Solution

Complete these steps in order to resolve this issue:

  1. Delete the extra user, which removes the license errors.

  2. Restart the Conversation Managers service in order to make the Call handler work.

Error: The license file(s) that you have installed do not allow you to use U.S. English for the system default language

With Cisco Unity Connection 7.x , the The license file(s) that you have installed do not allow you to use U.S. English for the system default language..... If you want to use a language that is not in the list, install that language, and then restart Cisco Unity Connection. error message is received when the Cisco Unity license files are loaded.

Solution

This error message is received when the connection licenses do not include the LicRegionIsUnrestricted tag.

If you want to use United States English for the Cisco Unity Connection conversation or you want users to be able to create personal call transfer rules, the Connection license must include the LicRegionIsUnrestricted license tag. Refer to Release Notes for Cisco Unity Connection Release 7.0(1) for more information on how to determine whether the tag is present or not.

Note: Licenses without this tag are intended only for use outside the United States.

Error: Install script of option /common/download//UC-locale-es_ES-7.0.1.0-323.cop failed

When you attempt to upload a license on Cisco Unity Connection, this error message is received:

Error Encountered : Error : Install script of option /common/download//UC-locale-es_ES-7.0.1.0-323.cop failed.

Solution

In order to resolve this issue, you need to stop these services on Cisco Unity Connection before you upload the UC Locale:

  • Connection Conversation Manager

  • Connection Mixer

Error: A license file or license directory was found to be invalid and will not be installed

With Cisco Unity Connection 7.1, when you attempt to install a license file, this error message is received:

A license file or license directory was found to be invalid and will 
 not be installed. Ignoring the license file: CXNxxxxxxx.lic. 
If you believe this file or directory should be valid, please contact support personnel.

Solution

Refer to Cisco bug ID CSCte58452 (registered customers only) for a possible fix and workaround.

Error: There was an unexpected failure during license reevaluation

Cisco Unity Connection 8 displays this error after the license files are uploaded:

There was an unexpected failure during license reevaluation. Please
restart your system or contact support personnel if this failure continues

Solution

The workaround is to restart the License Service on Publisher server after uploading the license.

Related Information

Updated: Jun 19, 2012
Document ID: 111056