Configure Cisco Smart Software Licensing

This chapter contains the following sections:

–blank.gif Configure Call Home (Optional)

–blank.gif Register a Device

–blank.gif Unregister a Device

–blank.gif Renew Device Registration

–blank.gif Renew License Authorization

–blank.gif Verify Cisco Smart Software Licensing

–blank.gif Debug Cisco Smart Software Licensing

–blank.gif Example

About Cisco Smart Software Licensing

Cisco Smart Software Licensing is a standardized licensing platform that facilitates you to deploy and manage Cisco software licenses easily and quickly. Cisco Smart Software Licensing establishes a pool of software licenses that can be used across your network in a flexible and automated manner. It also provides visibility to your purchased and deployed licenses in your network. Cisco Smart Software Licensing removes the need for Product Activation Keys (PAKs) and reduces your license activation and registration time.

Cisco Smart Software Licensing is enabled by default for Cisco Unity Express. However, if the product instance is not yet registered with Cisco Smart Software Manager (CSSM) or Smart Software Manager satellite, the device enters an evaluation period of 90 days. After the evaluation period expires, you must register the device with CSSM, otherwise Cisco Unity Express functions stop working.

From Cisco Unity Express Release 9.0.5 onwards, only Cisco Smart Software Licensing is supported. Cisco Software Licensing (CSL) is no longer supported.

Configure Cisco Smart Software Licensing

Configure Call Home (Optional)

Prerequisites

  • Cisco Smart Software Licensing is enabled.

Summary Steps

1.blank.gif configure terminal

2.blank.gif call-home destination address http url (Optional)

3.blank.gif call-home http-proxy proxy_address port port number (Optional)

4.blank.gif end

DETAILED STEPS

Command or Action
Purpose

Step 1

configure terminal

 

se-10-0-0-0# configure terminal

 

Enters configuration mode.

Step 2

call-home destination address http url

 

se-10-0-0-0(config)# call-home destination address http http://10.22.22.22:2080/ddce/services/DDCEService

(Optional) Defines the destination URL to which Call Home messages, including licensing requests are sent. The destination URL can be the URL for Transport Gateway or Smart Software Manager satellite.

If you do not configure Call Home feature, default URL to Cisco Smart Licensing production server is used.

Step 3

call-home http-proxy proxy_address port port-number

 

se-10-64-86-104(config)# call-home http-proxy 7.7.7.7 port 3218

(Optional) Specifies the proxy server for the HTTP request.

Step 4

end

 

se-10-64-86-104(config)# end

Exits to privileged EXEC mode.

Register a Device

Prerequisites

  • Cisco Smart Software Licensing is enabled.
  • Ensure that you have the token that is used to register with the device. To generate a token ID, log in to your Smart Account in Cisco Smart Software Manager or Smart Software Manager satellite. Navigate to the virtual account containing the licenses to be used by this product instance. Generate a product instance Registration Token, and copy or save the token ID. For more information on generating a Registration Token, see Cisco Smart Software Manager User Guide.

Summary Steps

1.blank.gif license smart register idtoken token [force]

DETAILED STEPS

Command or Action
Purpose

license smart register idtoken token [force]

 

se-10-0-0-0# license smart register idtoken MjgxZjdkY2RtMWY5Ny00YTk4LOI2N2MtNjcxNmYaMTkzZGFhLHE0MjA3MjY0%0AMjI5N34Z8OVAOdmNzSjdIeG4MMHIzTmZubNFzMHhKOTYyeHlUZWQzQzVIM3Jk%0AHVk3MD0A3D%0N force

Registers the device instance with the Cisco Smart Software Manager (CSSM) or Smart Software Manager satellite.

  • force: Registers your device forcefully by overriding the existing registration information.

The license agent registers the product with Cisco and receives back an identity certificate. This certificate is saved and automatically used for all future communications with Cisco. The license agent automatically renews the registration information every 180 days.

Unregister a Device

Prerequisites

  • Cisco Smart Software Licensing is enabled.
  • The device is registered with CSSM or Smart Software Manager satellite.

Summary Steps

1.blank.gif license smart deregister

DETAILED STEPS

Command or Action
Purpose

license smart deregister

 

se-10-0-0-0# license smart deregister

Unregisters a device.

Renew Device Registration

Once the device is registered, the communication messages are signed by a certificate, and the certificate is used to identify Cisco Unity Express to CSSM or Smart Software Manager satellite. The validity period of the registration is one year, and the license agent automatically renews the registration with CSSM or Smart Software Manager satellite every 180 days. If the automatic registration renewal does not occur for some reason, you can manually renew the registration to reflect the updated license usage on Cisco Unity Express. Also, it helps to keep the communication with CSSM or Smart Software Manager satellite.

Prerequisites

  • Cisco Smart Software Licensing is enabled.
  • The device is registered with CSSM or Smart Software Manager satellite.

Summary Steps

1.blank.gif license smart renew idcert

DETAILED STEPS

Command or Action
Purpose

license smart renew idcert

 

se-10-0-0-0# license smart renew idcert

Renews the registration and ID certificate.

Renew License Authorization

After license registration, Cisco Unity Express sends an authorization request to CSSM or Smart Software Manager satellite whenever a license consumption changes. This authorization is valid for 90 days. Cisco Unity Express license agent automatically sends a renewal request every 30 days as required by Cisco Smart Software Licensing. If Cisco Unity Express does not contact CSSM or Smart Software Manager satellite for 90 days to renew authorization, license consumed by Cisco Unity Express are reclaimed and restored in the pool. Thus, you can manually renew the license authorization if the automatic 30-day renewal does not occur.

Prerequisites

  • Cisco Smart Software Licensing is enabled.
  • The device is registered with CSSM or Smart Software Manager satellite.

Summary Steps

1.blank.gif license smart renew auth

DETAILED STEPS

Command or Action
Purpose

license smart renew auth

 

se-10-0-0-0# license smart renew auth

Renews the license authorization.

Verify Cisco Smart Software Licensing

You can verify Cisco Smart Software Licensing using the following commands:

Commands
Purpose

show license all

Displays all Smart Licensing information.

show license status

Displays overall Smart Licensing status.

show license summary

Displays Smart Licensing status summary.

show license udi

Displays the Unique Device Identification (UDI) of the device.

show license usage

Displays Smart Licensing usage.

show license techsupport

Displays Smart Licensing technical support information.

For more details on the show commands, see Cisco Unity Express Command Reference.

Debug Cisco Smart Software Licensing

You can enable or disable debugging for Cisco Smart Software Licensing using the following commands:

Command or Action
Purpose

debug smart_lic {error | trace | debug | all}

 

se-10-0-0-0# debug smart_lic trace

Enables debugging for Smart Licensing.

  • Error—Logs errors encountered in the Smart Agent
  • Trace—Logs trace messages during normal agent operations
  • Debug—Logs debug messages. This option is enabled by default.
  • All—Enables all three levels

no debug smart_lic {error | trace | debug | all}

 

se-10-0-0-0# no debug smart_lic trace

Disables debugging for Smart Licensing.
note.gif

Noteblank.gif Smart Licensing debug logs are stored in the smartagent.log file.

Example

The following is sample output from the show license all CLI command:

se-10-104-50-199# show license all
 
Smart Licensing Status
=======================
Smart Licensing is ENABLED
 
Registration:
Status: REGISTERED
Smart Account: Cisco-Unity-Express
Virtual Account: Default
Export-Controlled Functionality: Allowed
Initial Registration: SUCCEEDED on Jul 4 14:38:59 2017 IST
Last Renewal Attempt: SUCCEEDED on Jul 4 14:38:59 2017 IST
Next Renewal Attempt: Dec 31 14:38:59 2017 IST
Registration Expires: Jul 4 14:36:54 2018 IST
 
License Authorization:
Status: AUTHORIZED on Jul 4 14:39:04 2017 IST
Last Communication Attempt: SUCCEEDED on Jul 4 14:39:04 2017 IST
Next Communication Attempt: Aug 3 14:39:04 2017 IST
Communication Deadline: Oct 2 14:37:00 2017 IST
 
Evaluation Period:
Evaluation Mode: Not In Use
Evaluation Period Remaining: 89 days, 23 hr, 51 min, 55 sec
 
License Usage
=============
License Authorization Status: AUTHORIZED as of Jul 4 14:39:04 2017 IST
 
regid.2016-04.com.cisco.CUE_VM,1.0_e911e9b4-dadf-4eb6-9ee0-e3d07bcea3fd (regid.2016-04.com.cisco.CUE_VM,1.0_e911e9b4-dadf-4eb6-9ee0-e3d07bcea3fd)
Description: This entitlement tag was created via Alpha Extension application
Count: 1
Version: 1.0
Status: InCompliance
 
regid.2016-04.com.cisco.CUE_IVR,1.0_06cc4190-a9ca-48fb-8011-56662275cb9b (regid.2016-04.com.cisco.CUE_IVR,1.0_06cc4190-a9ca-48fb-8011-56662275cb9b)
Description: This entitlement tag was created via Alpha Extension application
Count: 2
Version: 1.0
Status: InCompliance
 
Product Information
===================
UDI: PID:VMW00000000,SN:05056871705
 
Agent Version
=============
Smart Agent for Licensing: 1.3.2