This document provides information on how to troubleshoot some of the
common licensing issues that occur in Cisco Unity Connection 7.x/8.x.
There are no specific requirements for this document.
The information in this document is based on these software and
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.
Technical Tips Conventions for more information on document
When trying to import users to Cisco Unity Connection, the
The requested operation would result in a license
violation error message is received.
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:
You can check the license report via Cisco Unity Connection
Administration > System Settings >
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
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
INCREMENT LicSubscribersMax cisco 1.1 18-feb-2008 permanent 50 \
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
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.
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.
As a solution, check these issues:
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
The subscriber voice port license needs to be installed on the
Make sure that the feature license is
For a Cisco Unified messaging account, this status message is
"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."
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
This is documented in Cisco bug ID
(registered customers only)
There are error messages that state there is a licensing
Complete these steps in order to resolve this issue:
Delete the extra user, which removes the license
Restart the Conversation Managers service in order to make the Call
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.
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
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
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-188.8.131.52-323.cop failed.
In order to resolve this issue, you need to stop these services on
Cisco Unity Connection before you upload the UC Locale:
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.
Refer to Cisco bug ID
(registered customers only)
for a possible fix and workaround.
Cisco Unity Connection 8 displays this error after the license files
There was an unexpected failure during license reevaluation. Please
restart your system or contact support personnel if this failure continues
The workaround is to restart the License Service on Publisher server
after uploading the license.