Table Of Contents
Cisco IOS Software Activation Commands
Cisco IOS Software Activation Commands
license boot module
To configure a new software license, use the license boot module command in global configuration mode.
license boot module module-name level license-level switch-id
Cisco uBR10012 Universal Broadband Router
license boot module module-name technology-package package-name {disable}
no license boot module module-name technology-package package-name {disable}
Syntax Description
Command Modes
Global configuration mode
Command History
Usage Guidelines
The license boot module command is used for the following purposes:
•
Downgrade or upgrade licenses
•
•
This command forces the licensing infrastructure to boot the configured license level instead of the license hierarchy maintained by the licensing infrastructure for a given module.
1.
2.
3.
To make the evaluation license inactive, use the no license boot module technology-package command. To re-activate the evaluation license, use the license boot module technology-package command.
If the show license all command displays the license as "Active, Not in Use, EULA not accepted," you can use the license boot module module-name level license-level command to enable the license and accept the EULA. Do not confuse the license boot module global configuration command with a similarly named command available in privileged EXEC mode.
Examples
The following example shows how to configure a license:
Router(config)# license boot module c880-data level advipservicesThe following example shows how to enable an evaluation license:
Router(config)# license boot module c3900 technology-package dataThe following example shows how to make an evaluation license inactive:
Router(config)# no license boot module c3900 technology-package dataRelated Commands
license install
Installs a license stored in a license file on a device.
license save
Saves a copy of a permanent license in a specified license file.
license call-home install pak
To install a license using a product authorization key (PAK) and the Cisco License Call Home feature, use the license call-home install command in privileged EXEC mode.
license call-home install pak pak-id
Note
Syntax Description
pak
The product authorization key.
pak-id
A product authorization key sent via e-mail or regular mail by manufacturing to authorize software upgrades.
Command Modes
Privileged EXEC (#)
Command History
Usage Guidelines
This command requires the following:
•
•
•
•
The PAK is a unique token supplied to allow partial fulfillment of licenses. A PAK is not tied to any particular device, but rather to a product identifier (PID).
Issuing the license call-home install command initiates several actions, as follows:
1.
2.
3.
Examples
The following example shows the commands, prompts, and responses required to install a license using a PAK and the Cisco License Call Home feature. Use the show license feature command to verify the installation.
Router# license call-home install pak 3XPXR9E7D30CCO User name: User1CCO password : ************Pak Number : 3XPXR9E7D30Pak Fulfillment type: SINGLE1. SKU Name : GatekeeperSKU Type : ProductDescription : GatekeeperOrdered Qty : 1Available Qty : 1Feature List :Feature name: gatekeeper Count: UncountedPlatform Supported : N/A5400535028003800Do you want to install the above listed SKU(s)? [yes/no]: yesPlease enter the user's detail:First Name : First-nameLast Name : Last-nameTitle : Software EngineerCompany Name : Cisco SystemsAddress1 : 510 McCarthy Blvd.Address2 [Optional]:City : MilpitasState : CAProvince [Optional]:Zipcode : 95134Country : USAPhone : 408 526-4000Fax [Optional]:Email : User1@cisco.comInstalling...Feature:gatekeeper...SuccessfulRelated Commands
license call-home resend
To request a license be resent using the Cisco License Call Home feature, use the license call-home resend command in privileged EXEC mode.
license call-home resend dest-lic-location
Note
Syntax Description
Command Modes
Privileged EXEC (#)
Command History
Usage Guidelines
This command contacts Cisco's licensing back end and obtains licenses that are valid for a specified Universal Device Identifier (UDI). The license call-home resend command also stores the received license lines in the specified destination URL.
This command requires the following:
•
•
•
•
Use this command to obtain licenses stored in the specified destination URL. Following is a summary of the actions initiated by this command:
1.
2.
3.
Examples
The following example shows the commands, prompts, and responses required to request a license be sent from the Cisco licensing infrastructure and store it in the requested destination using the License Call Home feature:
Router# license call-home resend flash:licenseresend.xmlCCO User name: User1CCO password : ************Email Address: User1@cisco.comAlternate Email Address: User1@cisco.comGetting Licenses from SWIFT ..........Saving it to flash:licenseresend.xml.....DoneRelated Commands
license call-home revoke
To rehost (revoke and transfer) a license using Universal Device Identifiers (UDIs) and the Cisco License Call Home feature, use the license call-home revoke command in privileged EXEC mode.
license call-home revoke [target-udi] output-of-rehosted-license-url [permission-ticket-url] [rehost-ticket-url]
Note
Syntax Description
Command Modes
Privileged EXEC (#)
Command History
12.4(15)XZ
This command was introduced.
12.4(20)T
This command was integrated into Cisco IOS Release 12.4(20)T.
Usage Guidelines
If you do not specify a target UDI, the rehost ticket is stored at the specified URL. If you do specify a target UDI, this command sends the rehost ticket to the Cisco licensing infrastructure with the target UDI, converts it to a license file, and stores it in the URL specified. If one of the operation fails in the callhome revoke operations, then the intermediate results are stored at the specified URL and a message explaining what to do next is displayed.
This command requires the following:
•
•
•
•
The license call-home revoke EXEC command performs following sequence of operations:
1.
2.
3.
4.
5.
6.
7.
8.
Examples
The following example shows the commands, prompts, and responses to revoke a license, with the Cisco License Call Home feature, using UDIs:
Router# $license call-home revoke udi CISCO887W:FHH1124P02Y flash:REHOSTED_LICENSECCO User name : xxxxxCCO password :Retrieving the sku from swift ..........!.....................1. SKU Name : SA-LWAPPSKU Type : ProductDescription : For Internal purposes onlyOrdered Qty : 1Available Qty : 1Feature List :Feature name: lwapp Count: UncountedPlatform Supported : N/A2. SKU Name : SA880-AISSKU Type : ProductDescription : For Internal purposes onlyOrdered Qty : 1Available Qty : 1Feature List :Feature name: advipservices Count: UncountedPlatform Supported : N/A3. SKU Name : SL-LWAPP=SKU Type : ProductDescription : For Internal purposes onlyOrdered Qty : 1Available Qty : 1Feature List :Feature name: lwapp Count: UncountedPlatform Supported : N/A4. SKU Name : SL-AVSKU Type : ProductDescription : For Internal purposes onlyOrdered Qty : 1Available Qty : 1Feature List :Feature name: advsecurity Count: UncountedPlatform Supported : N/A5. All of the abovePlease select the sku number you want to revoke : 3Retrieving the permission ticket from swift ..........!... Output file saved ..... to flash: REHOSTED_LICENSERetrieving the rehost ticket from the device ....................!.Following Permanent license(s) will be revoked from this deviceFeature Name: lwappFollowing Extension license(s) will be installed on this deviceFeature Name: lwappPLEASE READ THE FOLLOWING TERMS CAREFULLY. INSTALLING THE LICENSE ORLICENSE KEY PROVIDED FOR ANY CISCO PRODUCT FEATURE OR USING SUCHPRODUCT FEATURE CONSTITUTES YOUR FULL ACCEPTANCE OF THE FOLLOWINGTERMS. YOU MUST NOT PROCEED FURTHER IF YOU ARE NOT WILLING TO BE BOUNDBOUND BY ALL THE TERMS SET FORTH HEREIN.You hereby acknowledge and agree that the product feature licenseis terminable and that the product feature enabled by such licensemay be shut down or terminated by Cisco after expiration of theapplicable term of the license (e.g., 30-day trial period). Ciscoreserves the right to terminate or shut down any such product featureelectronically or by any other means available. While alerts or suchmessages may be provided, it is your sole responsibility to monitoryour terminable usage of any product feature enabled by the licenseand to ensure that your systems and networks are prepared for the shutdown of the product feature. You acknowledge and agree that Cisco willnot have any liability whatsoever for any damages, including, but notlimited to, direct, indirect, special, or consequential damages relatedto any product feature being shutdown or terminated. By clicking the"accept" button or typing "yes" you are indicating you have read andagree to be bound by all the terms provided herein.ACCEPT? [yes/no]: yesOutput file saved ..... to flash: REHOSTED_LICENSERetrieving the revoked license line from the swift ..........Output file saved ..... to flash: REHOSTED_LICENSERelated Commands
license call-home url
To configure a new URL for accessing the Cisco licensing infrastructure, use the license call-home url command in global configuration mode. To change the URL, use the no form of this command.
license call-home url licensing-infrastructure-url
no license call-home url
Syntax Description
licensing-infrastructure-url
The HTTP address where the Cisco licensing infrastructure can be accessed.
Command Modes
Global configuration (config)
Command History
12.4(15)XZ
This command was introduced.
12.4(20)T
This command was integrated into Cisco IOS Release 12.4(20)T.
Usage Guidelines
Use this command to configure a new URL for accessing the Cisco licensing infrastructure.
This feature requires that:
•
•
•
•
Examples
The following example shows how to change the URL to http://cisco.com/newserver:
license call-home url http://cisco.com/newserverRelated Commands
license clear
To remove a license entry from license storage, use the license clear command in privileged EXEC mode.
Cisco Router Platforms
license clear feature-name
Cisco Catalyst 3560-E Switch Platforms
license clear feature-name
Cisco Catalyst 3750-E Switch and Switch Stack Platforms
license clear feature-name [switch switch-num]
Cisco Catalyst 3750-E Switch Mixed Stack Platforms
license clear feature-name switch switch-num
Syntax Description
Command Default
Licenses are not removed.
Command Modes
Privileged EXEC (#)
Command History
Usage Guidelines
The license clear command verifies that the license line is valid and explicitly installed. Only licenses that have been added using the license install command are removed. Evaluation licenses are not removed.
When a switch is specified, the license clear command is executed only on that switch. When a mixed stack platform is used, the primary switch has installed the minimum licensing feature needed to support the licensing operations of the secondary switches. The license clear command is used to clear a license from license storage, which a primary switch does not have. When the command is issued from the primary switch, the switch number is required to clear a license on a specific switch.
If a license line is in use, the license clear command fails.
Examples
The following example shows how to clear a license associated with the advsecurity feature:
Router# license clear advsecurityFeature: advsecurity1 License Type: PermanentStart Date: N/A, End Date: Jan 01 2010License State: Active, In UseLicense Addition: ExclusiveComment: Permanent LicenseStore Index: 0Store Name: Primary License Storage2 License Type: EvaluationLicense State: InactiveEvaluation total period: 8 weeks 4 daysEvaluation period left: 8 weeks 4 daysLicense Addition: AdditiveComment:Store Index: 1Store Name: Primary License StorageSelect Index to Clear [1-2]: 2Are you sure you want to clear? (yes/[no]): yesRelated Commands
