cisco smart software licensing › c › en › us › td › docs › ios-xml › ios › ... ·...

Cisco Smart Software Licensing

Cisco Smart Software Licensing provides a simple cloud-based solution for managing and tracking the useof your licenses and entitlements across your business.

When purchased, licenses are automatically delivered to your company Smart Account, ready for use. Devicesreport license use by registering to your Smart Account either directly across the internet, through an internetproxy, or by using a Smart Software Manager satellite to mediate reporting from devices across the business.

Cisco Smart Software Manager (CSSM) is the secure, cloud-based portal used to:

• Assign licenses to business entities using Virtual Accounts.

• Register devices to Virtual Accounts.

• Manage license inventory and monitor use.

• Track device authorization for feature use.

For more information on Cisco Smart Licensing, see http://www.cisco.com/go/smartlicensing.

• Feature Information for Cisco UBE Smart Licensing, on page 1• Registration and License Compliance, on page 2• Smart Software Licensing Task Flow for Cisco UBE, on page 4• Smart License Consumption, on page 7• Verify Smart License Operation for Cisco UBE, on page 7• Cisco UBE High Availability Configurations, on page 16• Syslog Messages, on page 21

Feature Information for Cisco UBE Smart LicensingThe following table provides release information about the feature or features described in this module. Thistable lists only the software release that introduced support for a given feature in a given software releasetrain. Unless noted otherwise, subsequent releases of that software release train also support that feature.

Use Cisco Feature Navigator to find information about platform support and software image support. CiscoFeature Navigator enables you to determine which software images support a specific software release, featureset, or platform. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account onCisco.com is not required.

Cisco Smart Software Licensing1

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

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

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

Feature InformationReleasesFeature Name

Cisco UBE Smart Licensing is enhanced to requestlicenses periodically based on dynamic counting oflicenses consumed during that period.

Cisco IOS XE Amsterdam17.2.1r

Cisco UBE Smart licenseusage based on dynamiccall counting

License requirements for the use of Cisco UBE trunksessions are reported to Cisco Smart Licensing.

Cisco IOS XE GibraltarRelease 16.11.1a

Cisco Smart Licensingenhancements for CiscoUBE

In releases before Cisco IOS XE Gibraltar Release 16.11.1a, Cisco UBE license fails to get activated andreports "Invalid Tag" in the show license all command output. The following is the snippet the output:#show license all

License Usage==============

(CUBE-Standard):Description:Count: xxxxVersion: 1.0Status: INVALID TAG

Note

Registration and License ComplianceDevices are required to register with the Cisco Smart Software Manager or satellite to report feature usageand compliance with purchased entitlements. The Smart Agent running on the Cisco UBE platform transitionsbetween the following operational states to control the use of licensed features:

Smart Agent Licensing States

• Unregistered / Evaluation Mode—When the platform is first used, the Smart Agent is in the unregisteredstate. In this state, SIP services, including Cisco UBE licensed features may be used freely during a90-day evaluation period. You can check the SIP service status by using the show voice sip licensestatus command.

• Unregistered / Evaluation Expired—If the Smart Agent has not successfully registered by the end ofthe evaluation period, SIP services, including Cisco UBE licensed features, are disabled. You can checkthe SIP service status by using the show voice sip license status command.cube#show voice sip license status

Host Name: cubeCurrent Time: Nov 26 2019 05:03:08 ISTSIP service: blocked due to eval expiryLicense request interval: 5 Minute(s)Next request at: Nov 26 2019 05:04:53 ISTRecent request(s) for entitlement tag CUBE_T_STD-----------------------------------------------------------Timestamp Count Result-----------------------------------------------------------


Cisco Smart Software LicensingRegistration and License Compliance

Nov 26 2019 04:59:53 IST 15 Eval period

• Registered—To enable licensed features, the platform must be registered to CSSM or satellite using aregistration ID token. Once registered, the Smart Agent receives an Identity Certificate that is savedsecurely and used for all ongoing communications. The certificate is valid for one year and will berenewed automatically after six months to ensure continuous operation. While registered, the SmartAgent maintains one of the three authorization states relating to each license type by periodically reportinglicense usage to the CSSM or satellite:

• Authorized—If the associated Smart Account has enough licenses to reserve for the platform, itindicates to the Smart Agent that the features are fully authorized for use. The Smart Agent renewsthe authorization every 30 days.

• Out of Compliance—If the associated Smart Account does not have enough licenses to reserve forthe platform, it will indicate to the Smart Agent that the current feature use is Out of Compliance.Currently, Cisco UBE functionality is not limited in this state.

• Authorization Expired—If the Smart Agent is not able to communicate with the CSSM or satellitefor 90 days or more, authorization expires. Currently, Cisco UBE functionality is not limited in thisstate.

You can check the status by executing show license status command.

Device#show license statusSmart Licensing is ENABLED...Transport:Type: Callhome

Registration:Status: REGISTEREDSmart Account: BU Production TestVirtual Account: CUBE Sat TestExport-Controlled Functionality: AllowedInitial Registration: SUCCEEDED on Feb 18 12:57:04 2019 UTCLast Renewal Attempt: NoneNext Renewal Attempt: Aug 17 12:57:03 2019 UTCRegistration Expires: Feb 18 12:51:49 2020 UTC

License Authorization:Status: AUTHORIZED on Mar 04 15:11:54 2019 UTCLast Communication Attempt: SUCCEEDED on Mar 04 15:11:54 2019 UTCNext Communication Attempt: Apr 03 15:11:53 2019 UTCCommunication Deadline: Jun 02 15:06:21 2019 UTC...

• Registration Expired—If the Smart Agent is not able to contact the CSSM or satellite before the IdentityCertificate expires, the platform returns to the unregistered state. The platform resumes the remainingevaluation period, only if available. After registration expires, registration to the CSSM or satellite usinga new registration ID token is required.

Each platform provides a single 90-day evaluation period. This period is persistent across the reloads.Note


Cisco Smart Software LicensingRegistration and License Compliance

Smart Software Licensing Task Flow for Cisco UBEThe process for using and validating Smart Licensing for Cisco UBE is common to the host platform. Tasksare summarized to highlight requirements specific to the Cisco UBE application.

Task Flow:

1. Obtain a registration ID token from the Virtual Account to which you wish to register the platform. SeeObtain the Registration ID Token, on page 4.

2. If using an internet proxy or Smart Software Manager satellite, update the Smart Licensing transportsettings. See Configure Smart Licensing Transport Settings , on page 4.

3. Register the Host Platform with CSSM or Satellite, on page 5.

4. Configure Cisco UBE Licensed Features, on page 6.

Obtain the Registration ID Token

Detailed Steps

1. Log in to your Smart Account in either CSSM or satellite.

2. Navigate to the Virtual Account with which you want to register the Cisco UBE.

3. Generate a registration ID token.

Configure Smart Licensing Transport Settings

Step 1 hostname hostname

Example:Device(config)# hostname cubecube(config)#

Ensure that hostname and the PID of the platform are not the same. For example, if the hostname of an ASR1006 routeris configured as "ASR1006", registration will be unsuccessful.

Step 2 ip name-server IP Address

Example:cube(config)# ip name-server 10.0.0.1 10.0.0.10

Configures valid DNS servers to ensure the correct resolution of the CSSM or satellite hostname.

Step 3 ip http client source-interface interface name

Example:cube(config)# ip http client source-interface GigabitEthernet0/0/0

Binds the platform HTTP client to the interface used to access the CSSM or satellite.


Cisco Smart Software LicensingSmart Software Licensing Task Flow for Cisco UBE

Step 4 call-home

Example:cube(config)# call-home

Access call-home configuration to change the internet proxy and license server URL if necessary.

Step 5 http-proxy hostname proxy-port port-number

Example:cube(cfg-call-home)# http-proxy proxy.mybiz.com proxy-port 80

If necessary, configure a proxy-server for the platform when a direct HTTP connection to CSSM is not permitted.

Step 6 profile profile-name

Example:cube(cfg-call-home)# profile CiscoTAC-1

If registering to a Smart Software Manager satellite, edit the default profile (CiscoTAC-1) to configure the registrationURL.

Step 7 destination address http url

Example:cube(cfg-call-home-profile)# destination address http http://ssat.mybiz.com/Transportgateway/services/DeviceRequestHandler

If registering to a satellite, configure the registration URL. The default configuration must be used when registeringdirectly to CSSM. If an HTTP address has already been configured, it can be removed using no destination addresshttp all command.

Register the Host Platform with CSSM or SatelliteTo report license usage, the host platformmust be registered to either CSSM or satellite. The platform remainsin evaluation mode until registered.

Before you begin

1. Obtain the registration ID token from your Smart Account.

2. Configure Smart Licensing transport settings.

license smart register id_token id_token

Example:Device# license smart register id_token XXXXXXXXXTnVhaUZlRHorQjJERT0%3D

Registers the Cisco UBEwith the CSSM or satellite using a registration ID token that you obtain from your Smart Account.


Cisco Smart Software LicensingRegister the Host Platform with CSSM or Satellite

Configure Cisco UBE Licensed Features

Step 1 enable

Example:

Device> enable

Enables privileged EXEC mode. Enter your password if prompted.

Step 2 configure terminal

Example:

Device# configure terminal

Enters global configuration mode.

Step 3 voice service voip

Example:Device(config)# voice service voip

Enters global VoIP cofiguration mode.

Step 4 mode border-element license [capacity sessions | periodicity {mins value | hours value | days value} ]

Example:Device(cfg)# mode border-element license capacity 25

Device(cfg)# mode border-element license perodicity days 15

• Effective from Cisco IOS XE Amsterdam 17.2.1r, the capacity keyword and sessions argument are deprecated.However, the keyword and argument are available in the Command Line Interface (CLI). If you try to configurelicense capacity using CLI, the following error message is displayed:

Error: CUBE SIP trunk licensing is now based on dynamic session counting. Static license capacity configuration has beendeprecated.

• Effective from Cisco IOS XE Amsterdam 17.2.1r, the periodicity keyword and [mins | hours| days] argument areintroduced. The periodicity keyword configures periodicity interval for license entitlement requests for Cisco UBE.If you do not configure license periodicity, the default license period of 7 days is enabled.

We recommend you to configure interval in days. Configuring interval in minutes or hours increases thefrequency of entitlement requests and thereby increases the processing load on Cisco Smart SoftwareManager (CSSM). License periodicity configuration of minutes or hours is recommended to be used onlywith Cisco Smart SoftwareManager On-Prem (formerly known as Cisco Smart SoftwareManager satellite)mode.

Note


Cisco Smart Software LicensingConfigure Cisco UBE Licensed Features

Smart License ConsumptionFromCisco IOSXEAmsterdam 17.2.1r onwards, Cisco UBE smart license consumption is based on dynamiccall counting.

Smart licenses are consumed only for active calls (In-Leg and Out-Leg) involving SIP Trunk. Cisco UBE lineside calls are not considered for license consumption. If calls involve media recording, forked call legs do notconsume extra licenses.

Cisco UBE requests entitlements only after completing the periodicity. If the peak license usage increases ordecreases within the set periodicity, then Cisco UBE waits until the end of periodicity to request entitlements.

For example, consider that the periodicity is set to 7 days and entitlements requested are 10. During the fourthday, if the license usage increases to 20, then the licenses reach “out of compliance” state. However, the callsstill work as the SIP service is still up. The license status “out of compliance” remains the same for the entireperiodicity. Cisco UBE requests new entitlement requests after completing the periodicity of 7 days.

Execute the show voice sip license command to view the smart license usage over time. For detailed informationon show voice sip license, see the Cisco IOS Voice Command Reference Guide.

Verify Smart License Operation for Cisco UBEUse the following commands to verify the platform registration and license usage:

• show cube status—Displays Cisco UBE license capacity and a count of calls that are blocked when theevaluation period has expired.

Effective fromCisco IOSXEAmsterdam 17.2.1r, Licensed-Capacity and blockedcall information is no longer included in the output.

Note

cube#show cube statusCUBE-Version : 12.5.0SW-Version : 16.11.1, Platform CSR1000VHA-Type : noneLicensed-Capacity : 10Calls blocked (Smart Licensing Not Configured) : 0Calls blocked (Smart Licensing Eval Expired) : 0

• show license status—Displays the platform registration and authorization status.cube#show license statusSmart Licensing is ENABLED...Transport:Type: Callhome

Registration:Status: REGISTEREDSmart Account: BU Production TestVirtual Account: CUBE Sat TestExport-Controlled Functionality: AllowedInitial Registration: SUCCEEDED on Feb 18 12:57:04 2019 UTCLast Renewal Attempt: NoneNext Renewal Attempt: Aug 17 12:57:03 2019 UTC


Cisco Smart Software LicensingSmart License Consumption

https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/voice/vcr4/vcr4-cr-book/vcr-s9.html

Registration Expires: Feb 18 12:51:49 2020 UTC

License Authorization:Status: AUTHORIZED on Mar 04 15:11:54 2019 UTCLast Communication Attempt: SUCCEEDED on Mar 04 15:11:54 2019 UTCNext Communication Attempt: Apr 03 15:11:53 2019 UTCCommunication Deadline: Jun 02 15:06:21 2019 UTC

...

• show voice sip license stats—Displays Cisco UBE license usage over time in histogram format. Licensesare consumed only for active calls (In-Leg and Out-Leg) involving SIP Trunk. In case of calls involvingmedia recording, forked call legs do not consume extra license. show voice sip license stats table displaysCisco UBE license usage over time in table format. The command is available from Cisco IOS XEAmsterdam 17.2.1r.cube#show voice sip license stats

11:01:01 AM Thursday Aug 29 2019 IST

109876543210....5....1....1....2....2....3....3....4....4....5....5....6

0 5 0 5 0 5 0 5 0 5 0CUBE Trunk License Usage (last 60 seconds)

36986314664188809004400443330922440011

910 **820 #*730 ##640 *##* **550 ###* ##460 #### *##*370 *#### *##*280 #####* ####190 ###### ####100 *######*####*10 #############0....5....1....1....2....2....3....3....4....4....5....5....6

0 5 0 5 0 5 0 5 0 5 0CUBE Trunk License Usage (last 60 minutes)* = maximum # = average

90


Cisco Smart Software LicensingVerify Smart License Operation for Cisco UBE

0970890 *810 *730 *650 *570 *490 *410 *330 *250 *170 #

0....5....1....1....2....2....3....3....4....4....5....5....6....6....7..0 5 0 5 0 5 0 5 0 5 0 5 0

CUBE Trunk License Usage (last 72 hours)* = maximum # = average

109876543210....5....1....1....2....2....3....3....4....4....5....5....6....6....7..

0 5 0 5 0 5 0 5 0 5 0 5 0CUBE Trunk License Usage (last 72 days)* = maximum # = average

1110987654321 ##0....5....1....1....2....2....3....3....4....4....5....5....6

0 5 0 5 0 5 0 5 0 5 0TDM-SIP Trunk Sessions (last 60 seconds)

1109876



54321 *0....5....1....1....2....2....3....3....4....4....5....5....6

0 5 0 5 0 5 0 5 0 5 0TDM-SIP Trunk Sessions (last 60 minutes)* = maximum # = average

1110987654321 **0....5....1....1....2....2....3....3....4....4....5....5....6....6....7..

0 5 0 5 0 5 0 5 0 5 0 5 0TDM-SIP Trunk Sessions (last 72 hours)* = maximum # = average

109876543210....5....1....1....2....2....3....3....4....4....5....5....6....6....7..

0 5 0 5 0 5 0 5 0 5 0 5 0TDM-SIP Trunk Sessions (last 72 days)* = maximum # = average

cube#show voice sip license stats table

02:50:16 PM Wednesday Nov 13 2019 UTC

CUBE Trunk License Usage (last 60 seconds)Period Average Max----------------------------1-5 0 06-10 0 011-15 0 016-20 0 021-25 0 0



26-30 0 031-35 0 036-40 0 041-45 0 046-50 0 051-55 0 056-60 0 0

CUBE Trunk License Usage (last 60 minutes)Period Average Max----------------------------1-5 0 06-10 0 011-15 0 016-20 0 021-25 0 026-30 0 031-35 0 036-40 0 041-45 0 046-50 324 90051-55 343 89956-60 292 600

CUBE Trunk License Usage (last 72 hours)Period Average Max----------------------------1-5 35 9006-10 0 011-15 0 016-20 0 021-25 0 026-30 0 031-35 0 036-40 0 041-45 0 046-50 0 051-55 0 056-60 0 061-65 0 066-70 0 071-72 0 0

CUBE Trunk License Usage (last 72 days)Period Average Max----------------------------1-5 0 06-10 0 011-15 0 016-20 0 021-25 0 026-30 0 031-35 0 036-40 0 041-45 0 046-50 0 051-55 0 056-60 0 061-65 0 066-70 0 071-72 0 0



TDM-SIP Trunk Sessions (last 60 seconds)Period Average Max----------------------------1-5 0 06-10 0 011-15 0 016-20 0 021-25 0 026-30 0 031-35 0 036-40 0 041-45 0 046-50 0 051-55 0 056-60 0 0

TDM-SIP Trunk Sessions (last 60 minutes)Period Average Max----------------------------1-5 0 26-10 0 111-15 0 116-20 0 121-25 0 026-30 0 031-35 0 036-40 0 041-45 0 046-50 0 051-55 0 056-60 0 0

TDM-SIP Trunk Sessions (last 72 hours)Period Average Max----------------------------1-5 0 06-10 0 011-15 0 016-20 0 021-25 0 026-30 0 031-35 0 036-40 0 041-45 0 046-50 0 051-55 0 056-60 0 061-65 0 066-70 0 071-72 0 0

TDM-SIP Trunk Sessions (last 72 days)Period Average Max----------------------------1-5 0 06-10 0 011-15 0 016-20 0 021-25 0 026-30 0 031-35 0 036-40 0 0



41-45 0 046-50 0 051-55 0 056-60 0 061-65 0 066-70 0 071-72 0 0

• show voice sip license status—Displays the license status.cube#show voice sip license status

Host Name: cubeCurrent Time: Nov 25 2019 14:46:41 ISTSIP service: UpLicense request interval: 5 Minute(s)Next request at: Nov 25 2019 14:50:44 ISTRecent request(s) for entitlement tag CUBE_T_STD-----------------------------------------------------------Timestamp Count Result-----------------------------------------------------------Nov 25 2019 14:45:44 IST 10 Out of complianceNov 25 2019 14:40:44 IST 4 AuthorizedNov 25 2019 14:35:44 IST 2 Authorized

• show license usage—Displays the license usage and authorization status.cube#show license usageLicense Authorization:Status: AUTHORIZED on Mar 04 15:11:54 2019 UTC

CSR 1KV APPX 500M (appx_500M):Description: CSR 1KV APPX 500MCount: 1Version: 1.0Status: AUTHORIZEDExport status: NOT RESTRICTED

CUBE_Trunk_Standard_Session (CUBE_T_STD):Description: Cisco Unified Border Element (CUBE) Trunk Standard Session LicenseCount: 10Version: 1.0Status: AUTHORIZEDExport status: NOT RESTRICTED

• show license summary—Displays a summary of registration and license usageDevice#show license summarySmart Licensing is ENABLED

Registration:Status: REGISTEREDSmart Account: BU Production TestVirtual Account: CUBE Sat TestExport-Controlled Functionality: AllowedLast Renewal Attempt: NoneNext Renewal Attempt: Aug 17 12:57:04 2019 UTC

License Authorization:Status: AUTHORIZEDLast Communication Attempt: SUCCEEDEDNext Communication Attempt: Apr 03 15:11:54 2019 UTC



License Usage:License Entitlement tag Count Status-----------------------------------------------------------------------------CUBE_Trunk_Standard_... (CUBE_T_STD) 10 AUTHORIZED

• show license all—Displays all the information that is related to licensing.Device#show license allSmart Licensing Status======================

Smart Licensing is ENABLED

Registration:Status: REGISTEREDSmart Account: BU Production Test 1Virtual Account: CUBE_VAExport-Controlled Functionality: AllowedInitial Registration: SUCCEEDED on May 21 07:15:09 2018 ISTLast Renewal Attempt: NoneNext Renewal Attempt: Nov 17 07:15:08 2018 ISTRegistration Expires: May 21 07:09:26 2019 IST

License Authorization:Status: AUTHORIZED on May 21 07:22:09 2018 ISTLast Communication Attempt: SUCCEEDED on May 21 07:22:09 2018 ISTNext Communication Attempt: Jun 20 07:22:08 2018 ISTCommunication Deadline: Aug 19 07:16:27 2018 IST

Utility:Status: DISABLED

Data Privacy:Sending Hostname: yesCallhome hostname privacy: DISABLEDSmart Licensing hostname privacy: DISABLED

Version privacy: DISABLED

Transport:Type: Callhome

License Usage==============

CUBE_Standard_Session (CUBE_T_STD):Description: Cisco Unified Border Element (CUBE) Standard Session LicenseCount: 5Version: 1.0Status: AUTHORIZED

Product Information===================UDI: PID:CSR1000V,SN:9RTYVZ9LKZ4

Agent Version=============Smart Agent for Licensing: 4.4.4_rel/66Component Versions: SA:(1_3_dev)1.0.15, SI:(dev22)1.2.1, CH:(rel5)1.0.3, PK:(dev

18)1.0.3

Reservation Info================

License reservation: DISABLED



• show license tech support—Displays the license technical support information.Device#show license tech supportSmart Licensing Tech Support info

Smart Licensing Status======================

Smart Licensing is ENABLED

Registration:Status: REGISTEREDSmart Account: BU Production Test 1Virtual Account: CUBE_VAExport-Controlled Functionality: AllowedInitial Registration: SUCCEEDED on May 21 07:15:09 2018 ISTLast Renewal Attempt: NoneNext Renewal Attempt: Nov 17 07:15:08 2018 ISTRegistration Expires: May 21 07:09:26 2019 IST

License Authorization:Status: AUTHORIZED on May 21 07:22:09 2018 ISTLast Communication Attempt: SUCCEEDED on May 21 07:22:09 2018 ISTNext Communication Attempt: Jun 20 07:22:08 2018 ISTCommunication Deadline: Aug 19 07:16:27 2018 IST

Utility:Status: DISABLED

Data Privacy:Sending Hostname: yesCallhome hostname privacy: DISABLEDSmart Licensing hostname privacy: DISABLED

Version privacy: DISABLED

Transport:Type: Callhome

Evaluation Period:Evaluation Mode: EXPIREDEvaluation Period Remaining: Expired on May 10 01:44:42 2018 IST

License Usage=============Handle: 1License: CUBE_Standard_SessionEntitlement tag:

regid.2018-03.com.cisco.CUBE_T_STD,1.0_20e2edcc-6fbd-4b7e-be8c-d6d46f37473fDescription: Cisco Unified Border Element (CUBE) Standard Session LicenseCount: 5Version: 1.0Status: AUTHORIZED(3)Status time: May 21 07:22:03 2018 ISTRequest Time: May 21 07:20:53 2018 IST

Product Information===================UDI: PID:CSR1000V,SN:9RTYVZ9LKZ4

Agent Version=============Smart Agent for Licensing: 4.4.4_rel/66Component Versions: SA:(1_3_dev)1.0.15, SI:(d



• show call-home smart-licensing statistics—Displays the details of the data that is exchanged betweenthe Cisco UBE and the CSSM.Device#show call-home smart-licensing statisticsSuccess: Successfully sent and response received.Failed : Failed to send or response indicated error occurred.Inqueue: In queue waiting to be sent.Dropped: Dropped due to incorrect call-home configuration.

Msg Subtype Success Failed Inqueue Dropped Last-sent (GMT+05:30)----------------------------------------------------------------------ENTITLEMENT 6 0 0 0 2018-05-18 15:04:30DEREGISTRATION 1 0 0 0 2018-05-18 14:51:45REGISTRATION 1 0 0 0 2018-05-18 14:57:17ACKNOWLEDGEMENT 1 0 0 0 2018-05-18 14:57:22

• show call-home smart-licensing—Displays the destination URL that is configured.Device#show call-home smart-licensingCurrent smart-licensing transport settings:Smart-license messages: enabledProfile: CiscoTAC-1 (status: ACTIVE)Destination URL(s): https://tools.cisco.com/its/service/oddce/services/DDCEService

Use the following commands to debug any issues that are related to your Smart License:

• debug license feature cube all

• debug call-home smart-licensing all

Cisco UBE High Availability Configurations

Smart Licensing with Cisco UBE Box-to-Box High AvailabilityBox-to-Box redundancy uses the Redundancy Group (RG) Infrastructure to form High Availability (HA) pairof platforms.

For Smart License configurations on the HA pair of platforms, see Smart Software Licensing Task Flow forCisco UBE, on page 4. When reporting license usage, the Smart Agent includes details of its HA group and,if it is in the active or standby state. Thus allowing the CSSM or satellite to group license requirements forthe HA pair.

Box-to-Box High Availability requires Cisco UBE Trunk Redundant Session licenses. From Cisco IOS XEAmsterdam 17.2.1r onwards, license usage is based on dynamic call counting.

Before Failover

• Register both the platforms in the High Availability configuration to the same Smart Virtual Account onCSSM or satellite.

• The CSSM or satellite authorizes license usage requests for both active and standby platforms.

• Only licenses that are requested by the active server are reserved from the license pool.

• Only the active platform runs the license request interval timer and requests licenses.


Cisco Smart Software LicensingCisco UBE High Availability Configurations

After Failover

• The platform that switches to active mode reports license usage to the CSSM or satellite.

• The CSSM or satellite switches the license reservation to the new active server, ensuring that no additionallicenses are used from the Smart Account during failover.

• The new active platform starts a new license request interval timer. For example, if a request interval of5 days is configured and failover occurs after three days, the next request will occur 5 days later.

• When the originally active platform recovers, it is authorized as a standby server without consumingmore licenses from the Smart Account.

Verify Smart License Operation for Box-to-Box High AvailabilityYou can use all the commands that are given in the section Verify Smart License Operation for Cisco UBE,on page 7 to verify the licensing status in High Availability mode. The following commands specificallyreflect Smart License information that is related to Box-to-Box High Availability (HA):

• show cube status—Displays Cisco UBE license capacity and High Availability mode.


Note

cube-1# show cube statusCUBE-Version : 12.5.0SW-Version : 16.11.1, Platform CSR1000VHA-Type : hot-standby-chassis-to-chassisLicensed-Capacity : 10Calls blocked (Smart Licensing Eval Expired) : 0

• show license usage—Displays license usage and authorization statuscube-1#show license usageCUBE_Trunk_Standard_Session (CUBE_T_RED):Description: Cisco Unified Border Element (CUBE) Trunk Redundant Session LicenseCount: 10Version: 1.0Status: AUTHORIZEDExport status: NOT RESTRICTED

cube-2#show license usageCUBE_Trunk_Standard_Session (CUBE_T_RED):Description: Cisco Unified Border Element (CUBE) Trunk Redundant Session LicenseCount: 10Version: 1.0Status: AUTHORIZEDExport status: NOT RESTRICTED

• show license summary—Displays the license summary information.

Following is the sample output from the active instance of Cisco UBE.Device_CUBE1# show license summarySmart Licensing is ENABLED

Registration:Status: REGISTERED


Cisco Smart Software LicensingVerify Smart License Operation for Box-to-Box High Availability

Smart Account: BU Production Test 1Virtual Account: CUBE_VAExport-Controlled Functionality: AllowedLast Renewal Attempt: NoneNext Renewal Attempt: Jan 07 22:10:20 2019 IST

License Authorization:Status: AUTHORIZEDLast Communication Attempt: SUCCEEDEDNext Communication Attempt: Aug 12 10:02:43 2018 IST

License Usage:License Entitlement tag Count Status-----------------------------------------------------------------------------CUBE_Redundant_Session (CUBE_T_RED) 20 AUTHORIZED

• show license all—Displays active and standby states.cube-1#show license allCUBE_Redundant_Session (CUBE_T_RED):Description: Cisco Unified Border Element (CUBE) Redundant Session LicenseCount: 10Version: 1.0Status: AUTHORIZEDApplication HA Info:Application Name: CUBEApplication Id: 1Application Role: Active

cube-2#show license allCUBE_Redundant_Session (CUBE_T_RED):Description: Cisco Unified Border Element (CUBE) Redundant Session LicenseCount: 10Version: 1.0Status: AUTHORIZEDApplication HA Info:Application Name: CUBEApplication Id: 1Application Role: Standby

• show license tech support—Displays the details of the application HA and the High Availability pair.cube-1# show license tech supportSmart Licensing Tech Support infoSmart Licensing Status======================Smart Licensing is ENABLED...License Usage=============Handle: 1License: CUBE_Redundant_SessionEntitlement tag:regid.2018-03.com.cisco.CUBE_T_RED,1.0_c3de23c1-4e60-4342-a25f-021d709a462cDescription: Cisco Unified Border Element (CUBE) Redundant Session LicenseCount: 20Version: 1.0Status: AUTHORIZED(3)Status time: Jul 13 10:02:44 2018 ISTRequest Time: Jul 13 10:02:11 2018 ISTApplication HA Info:Application Name: CUBEApplication Id: 1Application Role: ActiveInfo For Peer: 227{AHa1Ver}{1}{AHa1Name}{cube-1}{AHa1AppID}{1}{AHa1Role}{Active}


Cisco Smart Software LicensingVerify Smart License Operation for Box-to-Box High Availability

{AHa1PHost}{cube-1}{AHa1PUDI}{P:CSR1000V,S:9ECXABN104R}{AHa1PPIID}{0826fdff-71bf-4af6-a998-c1bc8091b06c}{AHa1PSAcc}{BU Production Test 1}{AHa1PVAcc}{CUBE_VA}Peer Info:Application Name: CUBEApplication Id: 1Application Role: StandbyHostname: cube-2PIID: e8107548-2851-42cf-bb44-33479104aef0UDI: P:CSR1000V,S:9RTYVZ9LKZ4Smart Account Name: BU Production Test 1Virtual Account Name: CUBE_VAInfo From Peer: 228{AHa1Ver}{1}{AHa1Name}{CUBE}{AHa1AppID}{1}{AHa1Role}{Standby}{AHa1PHost}{cube-2}{AHa1PUDI}{P:CSR1000V,S:9RTYVZ9LKZ4}{AHa1PPIID}{e8107548-2851-42cf-bb44-33479104aef0}{AHa1PSAcc}{BU Production Test 1}{AHa1PVAcc}{CUBE_VA}...

Smart Licensing with Cisco UBE Inbox High AvailabilityYou can configure a Cisco ASR 1000 Series Router platform with two Route Processors for Inbox HighAvailability using Stateful Switchover (SSO). In this configuration, one Route Processor is active while theother is in standby mode.

For Smart License configuration, see Smart Software Licensing Task Flow for Cisco UBE, on page 4. Onlythe active Route Processor in the SSO configuration reports license usage, so CSSM reserves one set oflicenses for the platform.

Inbox High Availability requires Cisco UBE Trunk Standard Session licenses.

Before Failover

• Smart License configuration is synchronized between the two Route Processors. Only the active RouteProcessor registers with CSSM or satellite.

• The CSSM or satellite authorizes license usage requests for the active Route Processor.

After Failover

• The Route Processor that switches to active mode, reports license usage to the CSSM or satellite.

• As the new report appears to come from the same device, the CSSM or satellite retains the originalreservation for the platform.

Verify Smart License Operation for Inbox High AvailabilityYou can use all the commands that are given in the section Verify Smart License Operation for Cisco UBE,on page 7 to verify the licensing status in the High Availability mode. The following commands specificallyreflect Smart License information that is related to Inbox High Availability (HA):

• show cube status—Displays Cisco UBE license capacity and High Availability mode.


Cisco Smart Software LicensingSmart Licensing with Cisco UBE Inbox High Availability


Note

cube-1#sh cube statusCUBE-Version : 12.5.0SW-Version : 16.11.1, Platform Platform ASR1006HA-Type : hot-standby-card-to-cardLicensed-Capacity : 10Calls blocked (Smart Licensing Not Configured) : 0Calls blocked (Smart Licensing Eval Expired) : 0

• show redundancy states—Displays the redundancy state of the Route Processors.cube-1# show redundancy statesmy state = 13 -ACTIVEpeer state = 8 -STANDBY HOTMode = DuplexUnit = SecondaryUnit ID = 49Redundancy Mode (Operational) = ssoRedundancy Mode (Configured) = ssoRedundancy State = ssoMaintenance Mode = DisabledManual Swact = enabledCommunications = Upclient count = 131client_notification_TMR = 30000 millisecondsRF debug mask = 0x0

cube-2# show redundancy statesmy state = 8 -STANDBY HOTpeer state = 13 -ACTIVEMode = DuplexUnit = PrimaryUnit ID = 48Redundancy Mode (Operational) = ssoRedundancy Mode (Configured) = ssoRedundancy State = ssoMaintenance Mode = DisabledManual Swact = cannot be initiated from this the standby unitCommunications = Upclient count = 131client_notification_TMR = 30000 millisecondsRF debug mask = 0x0

• show license summary—Displays license summary information.cube-1# show license summarySmart Licensing is ENABLEDRegistration:Status: REGISTEREDSmart Account: BU Production Test 1Virtual Account: CUBE_VAExport-Controlled Functionality: AllowedLast Renewal Attempt: NoneNext Renewal Attempt: Jan 02 09:06:22 2019 ISTCUBE Smart LicensingLicense Authorization:Status: Authorized


Cisco Smart Software LicensingVerify Smart License Operation for Inbox High Availability

Last Communication Attempt: SUCCEEDEDNext Communication Attempt: Aug 02 00:48:00 2018 ISTLicense Usage:License Entitlement tag Count Status-----------------------------------------------------------------------------ASR_1000_AdvEnterprise (ASR_1000_AdvEnterprise) 1 AUTHORIZEDCUBE_Standard_Session (CUBE_T_STD) 10 AUTHORIZED

cube-2# show license summarySmart Licensing is ENABLEDRegistration:Status: REGISTEREDSmart Account: BU Production Test 1Virtual Account: CUBE_VAExport-Controlled Functionality: AllowedLast Renewal Attempt: NoneLicense Authorization:Status: AuthorizedLast Communication Attempt: SUCCEEDEDNext Communication Attempt: NoneLicense Usage:License Entitlement tag Count Status-----------------------------------------------------------------------------ASR_1000_AdvEnterprise (ASR_1000_AdvEnterprise) 1 PENDING

Syslog Messages• For each entitlement request sent by Cisco UBE for SIP-to-SIP call, a syslong message is generated inthe following format:

%CUBE-5-LICENSING: Requested <count> <entitlement tag> licenses and the result is <status>

Example:

%CUBE-5-LICENSEING: Requested 31 CUBE_T_RED licenses and the result is Authorized

• For each entitlement request sent by Cisco UBE for TDM-to-SIP call, a syslong message is generatedin the following format:

%SIP-5-REPORTING: Reported use of <count> CUBE_T_VGW TDM-SIP sessions

Example:

%SIP-5-REPORTING: Reported use of 31 CUBE_T_VGW TDM-SIP sessions

• When Cisco UBE license evaluation mode expires, SIP service enters blocking mode and generates thefollowing syslog message:

%SIP-1-LICENSING: SIP service is blocked due to license eval expiry

• When Cisco UBE gets valid license, SIP service comes out of blocking mode and generates syslogmessage in the following format:


Cisco Smart Software LicensingSyslog Messages

%SIP-1-LICENSING: SIP service is unblocked as license status is changed to <status>

Example:

%SIP-1-LICENSING: SIP service is unblocked as license status is changed to Authorized


Cisco Smart Software LicensingSyslog Messages

cisco smart software licensing › c › en › us › td › docs › ios-xml › ios › ... ·...

Documents