Software Activation for Cisco Unity Express 7.1 and Later Versions
Software Activation of Cisco Unity Express for 7.1 and Later Versions
Download this chapter
Software Activation of Cisco Unity Express for 7.1 and Later VersionsSoftware Activation of Cisco Unity Express for 7.1 and Later Versions
Download the complete book
Software Activation for Cisco Unity Express 7.1 book-length PDFSoftware Activation for Cisco Unity Express 7.1 book-length PDF (PDF - 610 KB)
 Feedback

Table Of Contents

Software Activation of Cisco Unity Express 7.1 and Later Versions

Contents

Prerequisites for Software Activation of Cisco Unity Express

Overview of Software Activation of Cisco Unity Express

Selecting which Features You Want

Migrating to CSL Licenses

Where to Go Next

Adding More Mailboxes, Ports, IVR Sessions, and TimeCardView Users

Where to Go Next

RMA Licenses

Where to Go Next

Rehosting Licenses

Where to Go Next

Obtaining Software Licenses

Obtaining Migration Licenses

Required Information

Using the Migration Portal

Using Cisco License Manager

Obtaining New or Additional Licenses

Required Information

Using the Licensing Portal to Obtain Licenses for Additional Features or Applications

Where to Go Next

Using the Cisco License Manager to Obtain Licenses for Additional Features or Applications

Obtaining RMA Licenses

Required Information

Using the Licensing Portal to Obtain RMA Licenses

Using the Cisco License Manager to Obtain RMA Licenses

Where to Go Next

Obtaining Rehosting Licenses

Information that you Need

Using the Licensing Portal to Obtain Rehosting Licenses

Using the Cisco License Manager to Obtain Rehosting Licenses

Where to Go Next

Installing Licenses

Using CLI Commands to Install Licenses

Using the Cisco License Manager to Install Licenses

Where to Go Next

Activating Evaluation Licenses

Configuring the Call-Agent

Configuring the Call-Agent During the Post-Installation Process

Configuring the Call-Agent After Bootup

Additional References

Related Documents

Technical Assistance

Glossary


Software Activation of Cisco Unity Express 7.1 and Later Versions

First Published: August 24, 2009
Last Updated: November 7, 2012

This chapter describes the software activation process for Cisco Unity Express beginning with version 7.1. A similar process is used to activate Cisco IOS software. For detailed information about the software activation concepts, processes, tasks, and commands for installing, transferring, verifying, and managing licenses for Cisco IOS software see the Cisco Software Activation Conceptual Overview chapter in the Cisco IOS Software Activation Configuration Guide. and the Cisco Software Activation Tasks and Commands documents. Many of these concepts, tasks, and commands also apply to the software activation process for Cisco Unity Express.

Contents

This chapter contains the following topics:

•Prerequisites for Software Activation of Cisco Unity Express

•Overview of Software Activation of Cisco Unity Express

•Selecting which Features You Want

•Obtaining Software Licenses

•Installing Licenses

•Activating Evaluation Licenses

•Configuring the Call-Agent

•Additional References

•Glossary

Prerequisites for Software Activation of Cisco Unity Express

Before you install and activate Cisco Unity Express software, you must install and activate the appropriate Cisco IOS software. For more information, see the following guides:

•Cisco Software Activation Conceptual Overview chapter in the Cisco IOS Software Activation Configuration Guide

•Cisco Software Activation Tasks and Commands

•Software Activation on Cisco Integrated Services Routers

•Release Notes for Cisco Unity Express

Note If you have ordered a new router, it is shipped with the Cisco IOS software image and the corresponding licenses for the packages and features that you specified preinstalled. You do not need to activate or register the Cisco IOS software prior to use. The router stores the software license file on the flash memory.

Overview of Software Activation of Cisco Unity Express

Beginning with Cisco Unity Express 7.1, a new type of license called CSL licensing is supported. With CSL licenses, the mailbox license count includes both personal mailboxes and GDMs. The type of the mailbox is determined when it is configured. Also, the call-agent is no longer specified using licenses and can be configured either as part of post-install process or during bootup.

You can buy CSL licences for the following types of features:

•Mailboxes

•Ports

•IVR

•TimeCardView

As an example, if you purchase CSL licenses for 4 IVR sessions, 10 ports, and 265 mailboxes, then you can use 6 ports for either the Auto-Attendant or voice mail, and 4 ports for IVR.

Note You do not need to purchase IVR session licenses if you are only planning on using voicemail and auto attendant with basic IVR applications. IVR session licenses are only required if your application contains advanced IVR features such as email, fax, database access or VXML scripts. Each IVR session consumes one port and thus reduces the number of ports available for use by voicemail or auto-attendant applications. Please carefully consider how many IVR session licenses you need and only install or activate licenses for that number of IVR sessions.

If the number of IVR session licenses is greater than or equal to the number of ports, then voicemail and auto-attendant applications will be disabled due to the lack of available ports. The show license status application command will indicate this condition by stating the error message "voicemail disabled, ivr session quantity (x) is equal to or exceeds available ports (Y)" where X is the number of IVR sessions and Y is the number of ports. To change this condition, either reduce the number of IVR sessions via the command license activate ivr sessions N (where N is less than the number of ports and may be zero to deactivate all IVR sessions), or remove the IVR session licenses, or add more port licenses, and then issue the reload command.

The number of "ports" licenses purchased can be used for both voicemail and auto-attendant calls. You do not need to purchase any IVR port licenses if you are only planning on using voicemail and auto attendant. IVR port licenses are required if your application contains IVR features such as email, fax or database access.

If you ordered a new network module with Cisco Unity Express 7.1 or later included, it is shipped with the Cisco Unity Express image and the corresponding licenses preinstalled for the packages and features that you specified. You do not need to activate or register the software prior to use. The network module stores the software license file on the flash memory.

Otherwise, you must complete the following steps to install and activate Cisco Unity Express:

Step 1 Determine what functionality you want and which licenses you need.

For a detailed description, see the "Selecting which Features You Want" section.

Step 2 Obtain the appropriate CSL license file.

For a detailed description, see either the:

•"Obtaining Migration Licenses" section

•"Obtaining New or Additional Licenses" section

Note Typically, Step 3 and Step 4 are mutually exclusive.

Step 3 Install the license and reload the device.

For a detailed description, see the "Installing Licenses" section.

Step 4 If you want to use evaluation licenses, you must activate the license.

For a detailed description, see the "Activating Evaluation Licenses" section.

Step 5 Configure the Call-Agent.

For a detailed description, see the "Configuring the Call-Agent" section.

Selecting which Features You Want

To determine which SKUs to use to get the CSL licenses for the features you want, consider the following scenarios:

•To perform an upgrade from Cisco Unity Express 7.0.x and earlier versions to version 7.1 or later, for the same number of mailboxes, ports, and IVR sessions as before, see the following scenario:

Migrating to CSL Licenses

•To increase the number of licenses for mailboxes, ports, IVR sessions, and TimeCardView users after migration to version 7.1 is complete, see the following scenario:

Adding More Mailboxes, Ports, IVR Sessions, and TimeCardView Users

•To get a CSL license for RMAs, see the following scenario:

RMA Licenses

•To get a CSL license for rehosting, see the following scenario:

Rehosting Licenses

Migrating to CSL Licenses

When you upgrade to version 7.1 or later, you must replace your pre-CSL licenses with CSL licenses. You are required to migrate your licenses for mailbox features and port features. If you purchased the optional IVR features, you must also migrate your licenses for the IVR features. The migration procedure for each of these types of licenses are described in a separate section below.

Note If you are upgrading to the same of licensed features as before, the CSL licenses are free.

When you obtain licenses for features for Cisco Unity Express 7.1 or later, the licenses are available only in the increments shown below. The following types of licenses are available:

•Mailboxes (available only in increments of five)

•Ports (available only in increments of two)

•IVR (available only in increments of two)

Note CSL licenses are the same for all supported devices. See the Release Notes for Cisco Unity Express for a list of supported devices.

The corresponding SKUs for these licenses are:

•FL-CUE-MBX-5

•FL-CUE-PORT-2

•FL-CUE-IVR-2

•FL-TCV-USER-1

To migrate to CSL licenses, use the following procedure:

1. Use the show software license command to determine which pre-CSL licenses you have.

The name of the pre-CSL licenses include the incremental quantity of the license. For example SCUE-LIC-25CME.

2. For mailboxes, add the number of GDMs (Group Delivery Mailboxes) that you will be using because they were not included in the pre-CSL counts but are now being represented in the CSL counts.

3. Divide the total number of pre-CSL licensed features by the incremental quantity represented in the name of the appropriate CSL SKU.

For mailboxes, divide by five. For ports, divide by two. For IVR sessions, divide by two.

If the result is not a whole number, round up. This will give you the explicit quantity of CSL incremental licenses that you need.

As an example, if you have the following pre-CSL licenses and you have 10 GDMs:

•SCUE-LIC-100CCM

•8 instances of SCUE-LIC-PORT-2

•SCUE-IVR-S16

You will need to choose:

•22 instances of FL-CUE-MBX-5

•8 instances of FL-CUE-PORT-2

•8 instances of FL-CUE-IVR-2

Note For more information about the maximum number of ports your hardware supports, see the Release Notes for Cisco Unity Express.

Where to Go Next

Continue with the "Using the Migration Portal" section to use your SKU to obtain a new license at no cost.

Adding More Mailboxes, Ports, IVR Sessions, and TimeCardView Users

When you buy licences for additional features on Cisco Unity Express 7.1 or later versions, the licences are available only in the increments shown below. These licenses are the same for all supported devices. See the Release Notes for Cisco Unity Express for a list of supported devices. The following types of licenses are available:

•Mailboxes (available only in increments of five)

•Ports (available only in increments of two)

•IVR (available only in increments of two)

•TimeCardView users (available only in increments of one)

The corresponding SKUs for these licenses are:

•FL-CUE-MBX-5

•FL-CUE-PORT-2

•FL-CUE-IVR-2

•FL-TCV-USER-1

To determine the total quantity of licenses you need, multiply the incremental quantity from the name of the CSL license with the explicit quantity of increments that you want to purchase. For instance, FL-CUE-MBX-5 represents an incremental quantity of five mailboxes. If you select an explicit quantity of four for the FL-CUE-MBX-5 feature, the total quantity will be five times four, or 20.

Note For more information about the maximum number of ports your hardware supports, see the Release Notes for Cisco Unity Express.

Where to Go Next

Continue with the "Obtaining New or Additional Licenses" section to use your SKU to obtain a CSL license.

RMA Licenses

For RMA licenses, there is no need to determine which features are needed. You just need the Product ID (PID) and Serial Number (SN) of the defective RMA devices.

Where to Go Next

Continue with the "Obtaining RMA Licenses" section to use your SKU to obtain a CSL license.

Rehosting Licenses

For rehosting licenses, there is no need to determine which features are needed. You just need the Product ID (PID) and Serial Number (SN) of the source and destination devices of the rehost operation.

Where to Go Next

Continue with the "Obtaining Rehosting Licenses" section to use your SKU to obtain a CSL license.

Obtaining Software Licenses

See the following sections for scenarios for obtaining licenses:

•Obtaining Migration Licenses

•Obtaining New or Additional Licenses

•Obtaining RMA Licenses

•Obtaining Rehosting Licenses

Obtaining Migration Licenses

There are two methods of obtaining CSL migration licenses:

•Required Information

•Using the Migration Portal

•Using Cisco License Manager

Note There is no cost to obtain migration licenses for CSL.

Required Information

To obtain CSL migration licenses you need to have the following information:

•The SKU for the features that you need.

This is the information that you determined in the "Selecting which Features You Want" section.

•The Product ID (PID)

•The Serial Number (SN) from the device.

Using the Migration Portal

Note You must have a Cisco.com password to access some of the URLs in the following procedure.

Follow these steps to obtain a migration license for your existing Cisco Unity Express 7.1 features:

Step 1 Go to the licensing portal at www.cisco.com/go/license and click the link at the bottom of the page to go to the license migration portal.

Step 2 On the router that is running the features that you want to migrate, enter the show inventory command to see the corresponding product IDs and serial numbers.

Step 3 Enter the appropriate product ID and the serial number and click Continue.

The product ID is the type of Network Module that you are using, such as AIM-CUE.

Step 4 Use the drop-down menus to select the product family, product, and feature (SKU), then click Continue.

For the product, use the SKU that you determined in the previous section for the features that you want to migrate.

Enter your registration information, including your company's name and e-mail address, then click Continue.

Step 5 Verify all of your license information and click Submit to receive the free CSL upgrade license file by e-mail.

Step 6 Repeat the appropriate steps above for each device that is running features that you want to migrate.

Step 7 Copy the license file(s) to a FTP or TFTP server.

Where to Go Next

Continue with the "Installing Licenses" section to install your CSL license.

Using Cisco License Manager

Cisco License Manager is a software application that assists you in obtaining licenses from Cisco, deploying the licenses to the Cisco devices in your network, discovering the devices, and managing and viewing your inventory of licenses and devices.

Restrictions for Using Cisco License Manager

•Cisco License Manager (CLM) only runs on a server with Windows XP.

•Firewalls are not allowed between the Cisco License Manager server and a GUI client.

•For device notification to be successful, ensure that the Cisco License Manager hostname exists in the Domain Name Service (DNS) or that the device has the Cisco License Manager hostname and IP address configured to receive messages.

Note For a summary of these commands, see the Getting Started with Cisco License Manager on Windows XP guide. For detailed instructions about enabling Cisco License Agent on your device, see the Cisco License Agent documentation.

•Make sure that there is a valid connection from the Cisco License Manager server to Cisco.com.

Note For additional requirements and guidelines, see the Cisco License Manager Documentation on Cisco.com.

Information About Using Cisco License Manager

For a network-wide deployment, the Cisco License Manager can automate all license-related work flows by securely communicating to the licensing back-end fulfillment systems at Cisco.com and deploying the obtained licenses to managed devices on a network-wide basis. The application also keeps an inventory of deployed licenses and generates license reports.

You can use the Cisco License Manager application programming interface (API) to write programs for your specific licensing tasks. Cisco License Manager runs on Windows XP and uses Java to connect to Cisco.com and to Cisco devices.

For information about downloading and installing the free Cisco License Manager Client and Server applications or ordering the optional Cisco License Manager software development kit (SDK), go to this URL:

http://www.cisco.com/go/clm

Cisco License Manager supports devices running either the cryptographic universal software image or the noncryptographic universal software images. If your router runs the cryptographic software image, your router needs a device certificate to communicate with the Cisco License Manager server. For more information, see these documents on Cisco.com:

http://www.cisco.com/en/US/products/ps7138/tsd_products_support_series_home.html

Where to Go Next

If you have not yet installed your license, continue with the "Installing Licenses" section. Otherwise, continue with either the "Activating Evaluation Licenses" section or "Configuring the Call-Agent" section.

Obtaining New or Additional Licenses

There are two methods of obtaining CSL migration licenses:

•Required Information

•Using the Licensing Portal to Obtain Licenses for Additional Features or Applications

•Using the Cisco License Manager to Obtain Licenses for Additional Features or Applications

Required Information

To obtain new or additional CSL licenses you need to have the following information:

•The SKU for the features that you need.

This is the informatory that you determined in the "Selecting which Features You Want" section.

•The Product ID (PID)

•The Serial Number (SN) from the device.

Using the Licensing Portal to Obtain Licenses for Additional Features or Applications

Note You must have a Cisco.com password to access some of the URLs in the following procedure.

Follow these steps to obtain additional licenses for Cisco Unity Express 7.1or later features:

Step 1 Go to www.cisco.com/go/ordering and choose one of the ordering processes (via partner, Cisco direct, etc.) to order licenses. The SKU is used in the ordering process to specify the desired licenses for the Cisco Unity Express features that you want. When you purchase a license, you will receive a product activation key (PAK), which is an alphanumeric string that represents the purchase.

Step 2 To get your license file, return to the Cisco Product License Registration Portal at www.cisco.com/go/license and enter the appropriate information.

You must enter the PAK and the unique device identifier (UDI) of the device where the license will be installed. The UDI is printed on a label located on the back of most Cisco hardware devices or on a label tray visible on the front panel of field-replaceable motherboards. The UDI can also be viewed via software using the show license udi command in privileged Exec mode. The UDI has two main components: the product ID (PID) and the serial number (SN).

Step 3 Download the license file or receive the license file by e-mail.

Step 4 Repeat the appropriate steps above for each device you want to obtain a license.

Step 5 Copy the license file(s) to a FTP or TFTP server.

Where to Go Next

If you have not yet installed your license, continue with the "Installing Licenses" section. Otherwise, continue with either the "Activating Evaluation Licenses" section or "Configuring the Call-Agent" section.

Using the Cisco License Manager to Obtain Licenses for Additional Features or Applications

See the "Using Cisco License Manager" section.

Obtaining RMA Licenses

There are two methods of obtaining CSL RMA licenses:

•Required Information

•Using the Cisco License Manager to Obtain RMA Licenses

•Using the Licensing Portal to Obtain RMA Licenses

Required Information

To obtain new or additional CSL licenses you need to have the following information:

•The Product ID (PID)

•The Serial Number (SN) from the device.

Using the Licensing Portal to Obtain RMA Licenses

Note You must have a Cisco.com password to access some of the URLs in the following procedure.

Follow these steps to obtain additional licenses for Cisco Unity Express features:

Step 1 Go to the licensing portal at www.cisco.com/go/license and click the link for RMAs.

Step 2 Enter the unique device identifier (UDI) of the RMA device.

The UDI is printed on a label located on the back of most Cisco hardware devices or on a label tray visible on the front panel of field-replaceable motherboards. The UDI can also be viewed via software using the show license udi command in privileged Exec mode. The UDI has two main components: the product ID (PID) and the serial number (SN).

Step 3 Download the license file or receive the license file by e-mail.

Step 4 Repeat the appropriate steps above for each device you want to obtain a license.

Step 5 Copy the license file(s) to a FTP or TFTP server.

Step 6 See the "Where to Go Next" section.

Using the Cisco License Manager to Obtain RMA Licenses

See the "Using Cisco License Manager" section, then see the "Where to Go Next" section.

Where to Go Next

If you have not yet installed your license, continue with the "Installing Licenses" section. Otherwise, continue with "Configuring the Call-Agent" section.

Obtaining Rehosting Licenses

There are two methods of obtaining CSL rehosting licenses:

•Using the Cisco License Manager to Obtain RMA Licenses

•Using the Licensing Portal to Obtain RMA Licenses

Information that you Need

To obtain new or additional CSL licenses you need to have the following information:

•The Product ID (PID)

•The Serial Number (SN) from the device.

•Device credentials

Using the Licensing Portal to Obtain Rehosting Licenses

Note You must have a Cisco.com password to access some of the URLs in the following procedure.

Follow these steps to obtain additional licenses for Cisco Unity Express features:

Step 1 Go to the licensing portal at www.cisco.com/go/license and click the link labeled Upload a Rehost Ticket.

Step 2 Click the link labeled Look Up a License.

Step 3 Enter the unique device identifier (UDI) and credentials of the device, then click Continue.

The UDI is printed on a label located on the back of most Cisco hardware devices or on a label tray visible on the front panel of field-replaceable motherboards. The UDI can also be viewed via software using the show license udi command in privileged Exec mode. The UDI has two main components: the product ID (PID) and the serial number (SN).

Step 4 Enter the rehost ticket and click Continue.

Step 5 Verify that the rehost ticket covers the correct features and click Continue.

Step 6 Enter the required information for the owner of the license and click Continue.

Step 7 Review all of the license information and click Submit.

Step 8 Download the license file or receive the license file by e-mail.

Step 9 Repeat the appropriate steps above for each device you want to obtain a license.

Step 10 Copy the license file(s) to a FTP or TFTP server.

Step 11 See the "Where to Go Next" section.

Using the Cisco License Manager to Obtain Rehosting Licenses

See the "Using Cisco License Manager" section, then see the "Where to Go Next" section.

Where to Go Next

If you have not yet installed your license, continue with the "Installing Licenses" section. Otherwise, continue with either the "Activating Evaluation Licenses" section or "Configuring the Call-Agent" section.

Installing Licenses

There are two methods of installing licenses:

•Using CLI Commands to Install Licenses

•Using the Cisco License Manager to Install Licenses

Using CLI Commands to Install Licenses

After you obtain a license file from Cisco's licensing portal and copy it to a FTP or TFTP server, use the following CLI commands to install the license. Only the use of FTP is shown below.

SUMMARY STEPS

1. license install ftp://username:password@ip_address/path/license_file

2. reload

3. enable

4. show license all

5. show license in-use

6. show license status application

DETAILED STEPS

Step 1 license install ftp://username:password@ip_address/path/license_file.

Use this command to install all of your licenses. As shown in the following example (which is truncated for easier readability), the command initiates several actions that result in either the printing of an end user license agreement with prompts to accept the agreement (for extension licenses only) or messages indicating that the license is installed. When a license is successfully installed, a message will confirm the installation and state whether or not the licensed feature is present in the current image.

service-module# license install ftp://192.1.1.53/lic/nme-159/nme-159.lic

Installing...Feature:VMIVR-IVR-SESS...Successful:Supported

License Note:

Application will evaluate this change upon next reload

Installing...Feature:VMIVR-VM-MBX...Successful:Supported

License Note:

Application will evaluate this change upon next reload

Installing...Feature:TCV-USER...Successful:Supported

License Note:

Application will evaluate this change upon next reload

Installing...Feature:VMIVR-PORT...Successful:Supported

License Note:

Application will evaluate this change upon next reload

4/4 licenses were successfully installed

0/4 licenses were existing licenses

0/4 licenses were failed to install

The installation process does not install duplicate licenses. The following message is displayed when duplicate licenses are detected:

Installing...Feature:xxx-xxx-xxx...Skipped:Duplicate

Note Install all of your licenses before continuing to the next step.

Step 2 reload

Use this command to reboot the module:

service-module# reload

Step 3 enable

Use this command to enter Privileged Exec Mode:

service-module# enable

Enter Your Password If Prompted.

Step 4 show license all

Use this command to display a summary of all of the licenses installed on your module: 

service-module# show license all

StoreIndex:  0  Feature: VMIVR-PORT                        Version: 1.0

 License Type: Permanent

 License State: Active, In Use

 License Count: 4 / 4

 License Priority: Medium

License Store: Evaluation License Storage

StoreIndex:  0  Feature: VMIVR-VM-MBX                      Version: 1.0

 License Type: Evaluation

 License State: Active, Not in Use, EULA not accepted

     Evaluation total period:  8 weeks  4 days 

     Evaluation period left:  8 weeks  4 days 

 License Count: 600 / 0

 License Priority: None

License Store: Evaluation License Storage

StoreIndex:  1  Feature: VMIVR-PORT                        Version: 1.0

 License Type: Evaluation

 License State: Inactive

     Evaluation total period:  8 weeks  4 days 

     Evaluation period left:  8 weeks  4 days 

 License Count: 60 / 0

 License Priority: None

License Store: Evaluation License Storage

StoreIndex:  2  Feature: VMIVR-IVR-SESS                    Version: 1.0

 License Type: Evaluation

 License State: Active, Not in Use, EULA not accepted

     Evaluation total period:  8 weeks  4 days 

     Evaluation period left:  8 weeks  4 days 

 License Count: 60 / 0

 License Priority: None

Note If your module was shipped with Cisco Unity Express 7.1 or later, the output will display CSL-based evaluation licenses, as shown above.

Step 5 show license in-use

Use this command to display information about the licenses that are in use on your module: 

service-module# show license in-use

StoreIndex:  0  Feature: VMIVR-PORT                        Version: 1.0

 License Type: Permanent

 License State: Active, In Use

 License Count: 4 /4

 License Priority: Medium

StoreIndex:  1  Feature: VMIVR-VM-MBX                      Version: 1.0

 License Type: Permanent

 License State: Active, In Use

 License Count: 5 /5

 License Priority: Medium

Step 6 show license status application application-name

Use this command to display information about the applications that are installed on your module. If you do not supply an application name, information is displayed for voice mail and IVR. 

service-module# show license status application

voicemail enabled: 4 ports, 4 sessions, 5 mailboxes

ivr disabled, no activated ivr session license available

Using the Cisco License Manager to Install Licenses

See the "Using Cisco License Manager" section.

Where to Go Next

If you want to use an evaluation license, continue with the "Activating Evaluation Licenses" section. Otherwise, continue with the "Configuring the Call-Agent" section.

Activating Evaluation Licenses

Starting with Cisco Unity Express 7.1, the software image includes evaluation licenses. These licenses allow you to evaluate the feature before you purchase a permanent license, but they expire after a certain amount of time. To see when a license will expire, use the show license evaluation command.

Cisco recommends that you install and activate the permanent licenses before the expiration of your evaluation licenses. To install the permanent licenses, see the "Obtaining Software Licenses" section and the "Installing Licenses" section section. Permanent licenses are activates automatically when they are installed.

The following procedure includes commands that were introduced in version 7.1 and enable you to:

•Display the evaluation licenses present on the service module

•Activate the mailbox evaluation license, accept EULA

•Activate the port evaluation license

•Activate the IVR session evaluation license

•Verify which evaluation licenses are active

SUMMARY STEPS

1. show license evaluation

2. license activate voicemail mailboxes # of mailboxes to be activated

3. license activate ports # of ports to be activated

4. license activate ivr sessions # of ivr sessions to be activated

5. license activate timecardview # of TimeCardView users to be activated

6. reload

7. show license in-use

DETAILED STEPS

Step 1 show license evaluation

Use this command to display which evaluation licenses are on your system, as shown in the following output: 

service-module# show license evaluation

StoreIndex:  0  Feature: VMIVR-VM-MBX                      Version: 1.0

 License Type: Evaluation

 License State: Active, Not in Use, EULA not accepted

     Evaluation total period:  8 weeks  4 days 

     Evaluation period left:  8 weeks  4 days 

 License Count: 600 / 0

 License Priority: None

StoreIndex:  1  Feature: VMIVR-PORT                        Version: 1.0

 License Type: Evaluation

 License State: Active, Not in Use, EULA not accepted

     Evaluation total period:  8 weeks  4 days 

     Evaluation period left:  8 weeks  4 days 

 License Count: 60 / 0

 License Priority: None

StoreIndex:  2  Feature: VMIVR-IVR-SESS                    Version: 1.0

 License Type: Evaluation

 License State: Active, Not in Use, EULA accepted

     Evaluation total period:  8 weeks  4 days 

     Evaluation period left:  8 weeks  4 days 

 License Count: 60 / 0

 License Priority: Low

Step 2 license activate voicemail mailboxes # of mailboxes to be activated

Use this command to activate the license for mailboxes. It presents the End User License Agreement if it was not accepted earlier, as shown in the following output: 

service-module# license activate voicemail mailboxes 275

Evaluation licenses are being activated in the device for the following feature(s): 

 Feature Name: VMIVR-VM-MBX

PLEASE  READ THE  FOLLOWING TERMS  CAREFULLY. INSTALLING THE LICENSE OR

LICENSE  KEY  PROVIDED FOR  ANY CISCO  PRODUCT  FEATURE  OR  USING SUCH

PRODUCT  FEATURE  CONSTITUTES  YOUR  FULL ACCEPTANCE  OF  THE FOLLOWING

TERMS. YOU MUST NOT PROCEED FURTHER IF YOU ARE NOT WILLING TO  BE BOUND

BOUND BY ALL THE TERMS SET FORTH HEREIN.

You hereby  acknowledge  and  agree that  the  product feature  license

is terminable and that the product  feature  enabled  by  such  license

may  be  shut  down or  terminated by  Cisco  after  expiration of  the

applicable  term  of  the license  (e.g., 30-day  trial  period). Cisco

reserves the  right to terminate or shut down  any such product feature

electronically  or by  any other  means available. While alerts or such

messages  may  be provided, it is  your sole  responsibility to monitor

your terminable  usage of any  product  feature enabled by  the license

and to ensure that your systems and  networks are prepared for the shut

down of the product feature. You acknowledge  and agree that Cisco will

not have any liability  whatsoever for  any damages, including, but not

limited to, direct, indirect, special, or consequential damages related

to any product  feature  being shutdown or terminated. By clicking  the

"accept" button  or typing "yes" you are  indicating  you have read and

agree to be bound by all the terms provided herein.

ACCEPT? [y/n]? yes

License activation count saved for use at next reload

Step 3 license activate ports # of ports to be activated

Use this command to activate the license for ports. The output is similar to the output for activating the license for mailboxes shown above. 

service-module# license activate ports 4

Step 4 license activate ivr sessions # of ivr sessions to be activated

Use this command to activate the license for IVR sessions. The output is similar to the output for activating the license for mailboxes shown above. 

service-module# license activate ivr sessions 2

Step 5 license activate timecardview users

Use this command to activate the license for TimeCardView users. You must install the TimeCardView add-on package before performing this step.

Step 6 reboot

Step 7 show license in-use

Use this command to verify that the evaluation license is being active. 

service-module# show license in-use

StoreIndex:  0  Feature: VMIVR-VM-MBX                      Version: 1.0

 License Type: Evaluation

 License State: Active, In Use

     Evaluation total period:  8 weeks  4 days 

     Evaluation period left:  8 weeks  3 days 

     Expiry date: Sun Jul  5 16:08:06 2009

 License Count: 600 /275

 License Priority: Low

Note To disable mailboxes, ports, or IVR sessions after a reboot, use the no form of the appropriate license activate command without specifying the quantity.

Configuring the Call-Agent

Beginning with Cisco Unity Express version 7.1 and the use of CSL licenses, the call agent is no longer determined by the license.

However, you must configure the call agent by selection whether you are using Cisco Unified CME or Cisco Unified Communications Manager, using one of the two following methods:

•During the post-installation process

•After the service module boots up using the call-agent command

These methods are explained in the following sections:

•Configuring the Call-Agent During the Post-Installation Process

•Configuring the Call-Agent After Bootup

Configuring the Call-Agent During the Post-Installation Process

The following output shows how to configure the call agent for Cisco Unified CME as part of the post-installation process of the Cisco Unity Express 7.1 or later image.

Note The post-installation process is not supported on all devices. 

Would you like to manually adjust the system time (y,n)? no

executing app post_install

Enter Call Agent

       1) Cisco Unified Communications Manager (CUCM) -- default

       2) Cisco Unified Communications Manager Express (CUCME)

       #? : 1

       Setting Call Agent to CUCM

You can use the following show command to view the call-agent selection: 

service-module# show call-agent 

Call-agent:         CUCM

Configuring the Call-Agent After Bootup

The following output shows how to configure the call agent for Cisco Unified Communications Manager after the service module boots up. Because this operation is not reversible, you should use this method with caution. 

service-module# call-agent ccm

!!!WARNING!!!: This operation will

    a. permanently delete all non-local site related configuration

    b. reboot the system automatically

This operation is not reversible.

Do you wish to continue[n]? : yes

Additional References

The following sections provide references related to the Cisco Software Activation feature.

Related Documents


Technical Assistance

Description
Link

The Cisco Support website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies.

To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds.

Access to most tools on the Cisco Support website requires a Cisco.com user ID and password.

http://www.cisco.com/techsupport


Glossary

Cisco License Manager—Software tool that provides a graphical user interface (GUI) to track and manage licenses.

license file—File generated by Cisco licensing tools, which is used to install a license on product. The license file contains of one or more license lines.

license key—A unique value that enables usage and entitlement for a set of Cisco IOS features.

license line—Characters arranged in a particular format that hold the license for a single feature within it. A line has all the necessary fields and attributes that make it a valid, tamper-proof, and complete license. A single line can exist independently.

license manager—An application used to keep track and manage licenses for customers.

license server—Software tool at the hardware manufacturing site that generates product licenses.

license storage—File that stores a collection of license lines. A license file exists on a licensed device such as a router or a switch. This file exists in permanent storage.

node locked—The explicit binding of a unique license to a unique hardware platform. Node-locked licenses are locked to one of the UDIs in the system. Non-node locked licenses are not locked to any UDI.

PAK—Product Authorization Key, which is provided to customers when they order and purchase the right to use a feature set for a particular platform. The PAK serves as a receipt and is used as part of the process to obtain a license.

permissions file—Same as license line file.

perpetual license—License where use rights are permanent. These licenses can be used as long as required.

persistence storage—This is a file that lives for the lifetime of the device that has a license and survives image changes. This file should ideally exist in a write once storage area. The persistence file holds the license history for that device, along with certain information about license removals, expiries, rehost, and so on.

rehost—Process where a valid license is transferred from one platform to another. This implies the license is no longer valid on the original platform.

removable storage—Portable device used to store and access data such as compact Flash or USB.

RMA—Return Merchandise Authorization, which is the process whereby a customer returns a defective product.

signature server—Generates the licenses for products and is found at Cisco manufacturing sites. Also called a permission file generator.

SKU—Stock Keeping Unit, a unique, individual part number used to track and monitor inventory. A Cisco software licensing SKU maps to one or more software features.

stack—A switch stack is a set of up to nine Catalyst 3750 switches connected through their StackWise ports.

subscription-based licenses—Time-based licenses that require the subscriber to periodically renew or the license will expire after an agreed-upon time.

SWIFT—Software Infrastructure and Fulfillment Technology, the Cisco licensing infrastructure that is accessed via HTTPS over the Internet. The Cisco License Manager application interacts with the Cisco licensing infrastructure on behalf of many devices. Customers can interact directly with the Cisco licensing infrastructure service using Cisco IOS software commands.

UDI—Unique device identifier, which is a Cisco-wide schema to identify products. The UID contains Product ID, Version ID, and Serial Number. The UDI does not change during deployment in the field. Note that, when the term UDI is used in the context of licensing, it typically refers to only the Product ID and Serial Number.

universal image—A single software image containing all Cisco IOS functionality levels. These levels can be enabled by installing the appropriate license.