![]() |
Software Activation Configuration Guide, Cisco IOS XE Release 3S
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Configuring the Cisco IOS Software Activation Feature
![]() |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Contents
Configuring the Cisco IOS Software Activation FeatureLast Updated: May 16, 2012
This document describes the tasks used to activate software by using the Cisco IOS Software Activation feature, license keys, and Cisco EXEC commands. When you activate software from a Cisco device, you can license software without the need for additional application software. Finding Feature InformationYour software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the Feature Information Table at the end of this document. Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required. Restrictions for Cisco IOS Software Activation
How to Activate Software from a Cisco IOS Device
Installing and Upgrading Licenses by Using Software Activation CommandsBefore You Begin
SUMMARY STEPS
Read and understand the license activation processes in the "Cisco IOS Software Activation Conceptual Overview" module. You can perform this task to install or upgrade a license by using the license install command. You must have already received the license file from the Cisco Product License Registration portal at http://www.cisco.com/go/license (or you already backed up the license by using the license save command). If you use Microsoft Entourage and receive the license file from Cisco in an e-mail attachment, the license file will contain UTF-8 marking. These extra bytes in the license file cause it to be unusable during license installation. To work around this issue, you can use a text editor to remove the extra characters and then install the license file. For more information about UTF-8 encoding, go to this URL: http://www.w3.org/International/questions/qa-utf8-bom.
DETAILED STEPS
Managing Licenses by Using Software Activation Commands
Adding a Comment to a License FileSUMMARY STEPS
DETAILED STEPS Saving All Licenses to a Specified Storage AreaSUMMARY STEPS
DETAILED STEPS
Saving License Credential Information Associated with a Device to a Specified Storage AreaBefore You Begin
SUMMARY STEPS
Before you can start the rehost or resend process, a device credential is required. Cisco IOS licensing requires that the license files generated by the Cisco back-end licensing system for its devices be secure and tamper-resistant. Security features are in place to authenticate a license by means of encrypted license credentials. If it becomes necessary to transfer a license from one device to another (which is called rehosting), a permission ticket is required. To generate the permission ticket, the Cisco back-end licensing system requires the device credential information. DETAILED STEPS Displaying All Licenses in a DeviceSUMMARY STEPS
DETAILED STEPS Displaying Detailed Information about Licensed FeaturesSUMMARY STEPS
DETAILED STEPS Displaying Licensed Feature Sets Available in an ImageSUMMARY STEPS
DETAILED STEPS Removing Licenses by Using Software Activation Commands
Removing a License Entry from a Permanent License FileDETAILED STEPS Removing an In-Use License
DETAILED STEPS
Rehosting (Revoking and Transferring) a LicenseBefore You Begin
SUMMARY STEPS
Read and understand the license transfer between devices concepts in the "Cisco IOS Software Activation Conceptual Overview" module. Cisco software licensing requires that the license files generated by the Cisco back-end licensing system for its devices be secure and tamper-resistant. Security features are in place to authenticate a license by means of encrypted license credentials. Rehosting requires a permission ticket. To generate the permission ticket, the Cisco back-end licensing system requires the device credential information. Use the license save credential command to save device credential information to a specified file system. DETAILED STEPS Troubleshooting License Operations by Using Software Activation CommandsSUMMARY STEPS
DETAILED STEPS Configuring Examples for Software Licensing
Example: Installing and Upgrading LicensesThe following example shows how to use the license install command to install a license from the bootflash system on Cisco ASR 1000 Series Aggregation Services Routers:
Device# license install file bootflash:1ru_bu2-throughput-license
Installing...Feature:throughput...
1/1 licenses were successfully installed
0/1 licenses were existing licenses
0/1 licenses failed to install
Example: Adding a Comment to a License FileThe following example shows how to use the license comment command to add or delete information about a specific license. The command checks that a license associated with the specified feature is present in license storage. Device# license comment add feature throughput "the latest one" Feature: throughput 1 License Type: Permanent License State: Active, In Use License Addition: Exclusive License Count: Non-Counted Comment: -- Store Name: Primary License Storage % Success: Updating comment "--" with "the latest one" succeeded Device# *Aug 16 13:29:38.351 EDT: %LICENSE-6-ANNOTATED: R0/0: licensed: License for feat ure throughput 1.0 has been annotated, UDI=ASR1001:JAE14020AT5, StoreIndex=0:Pri mary License Storage, Comment=the latest one Device# show license file License Store: Primary License Storage Store Index: 0 License: 11 throughput 1.0 LONG NORMAL STANDALONE EXCL INFINITE_KEYS INFIN ITE_KEYS NEVER NEVER NiL SLM_CODE CL_ND_LCK NiL *12MDFXFBE6TEQR54 00 NiL NiL NiL 5_MINS <UDI><PID>ASR1001</PID><SN>JAE14020AT5</SN> </UDI> :0oy5aopCvhfLBBk3:l0fBb4Kr3EwMLaYAHDV93ClpLXhJGOUE1ZuBusC, 0B2QIQLvo6eUrKn27faF3zOYTTyjLRCGA8UMkemMyqmvjcg0Jhfm$<WLC>AQEBIQA B//8szae77QGOnFBXBoP02Obx6Fq2XtGPUJnh5pGplTkDzw9J5aqkkUjTNkuO4sv4 FYORqwInXo3s+nsLU7rOtdOxoIxYZAo3LYmUJ+MFzsqlhKoJVlPyEvQ8H21MNUjVb hoN0gyIWsyiJaM8AQIkVBQFzhr10GYolVzdzfJfEPQIx6tZ++/Vtc/q3SF/5Ko8XC Y=</WLC> Comment: the latest one Hash: ZJJz5MveEOPePQA3ATs6+OxF4bw= Store Index: 1 License: 11 adventerprisek9 1.0 LONG NORMAL STANDALONE EXCL INFINITE_KEYS INFINITE_KEYS NEVER NEVER NiL SLM_CODE CL_ND_LCK NiL *12MDFXFBE6T EQR5400 NiL NiL NiL 5_MINS <UDI><PID>ASR1001</PID><SN>JAE14020AT5 </SN></UDI> dFCG4MGqCj5nRQGYuTNELNjulmgkdTIxsGBaysKmB1f8it6t76IbU 1nDky:q5h843EeHBw9JMwZWcMfbveX8j93UWZckXYU8gSablS79TVo5Vg$<WLC>AQ EBIQAB///Y5fwUA9AySxZ1dkpw8MgMeMEbPYi4rEAcdDnsmUIwbp0xMUblmtUwhaC QMd/pCaGRqwInXo3s+nsLU7rOtdOxoIxYZAo3LYmUJ+MFzsqlhKoJVlPyEvQ8H21M NUjVbhoN0gyIWsyiJaM8AQIkVBQFzhr10GYolVzdzfJfEPQIx6tZ++/Vtc/q3SF/5 Ko8XCY=</WLC> Comment: Hash: 7AlBc9W0+DqIdv/3EgOMsXW19Xs= Device# Example: Removing a Not-In-Use LicenseThe following example shows how to display the installed licenses on an ASR 1001 router and how to clear the throughput license, which is not-in-use. Note that active, in-use licenses cannot be cleared: Device# show license all License Store: Primary License Storage StoreIndex: 0 Feature: throughput Version: 1.0 License Type: Evaluation License State: Active, Not in Use, EULA accepted Evaluation total period: 4 weeks 2 days Evaluation period left: 0 minute 0 second License Count: Non-Counted License Priority: Low Device# license clear throughput Feature: throughput 1 License Type: Evaluation License State: Active, Not in Use, EULA accepted Evaluation total period: 4 weeks 2 days Evaluation period left: 0 minute 0 second License Addition: Additive License Count: Non-Counted Comment: Store Name: Primary License Storage Are you sure you want to clear? (yes/[no]): yes Device# Example: Removing an In-Use LicenseThe following example shows how to display the installed licenses on an ASR 1001 router and remove the advipservices license that is in-use. To remove the in-use license, the device is configured to boot the ipbase level after reloading, which means that the advipservices license is no longer in-use. The following example is truncated for readability: Device# show license all License Store: Primary License Storage StoreIndex: 0 Feature: advipservices Version: 1.0 License Type: Permanent License State: Active, In Use License Count: Non-Counted License Priority: Medium License Store: Primary License Storage StoreIndex: 1 Feature: adventerprise Version: 1.0 License Type: Permanent License State: Active, Not in Use License Count: Non-Counted License Priority: Medium Device# license clear advipservices Feature: advipservices 1 License Type: Permanent License State: Active, In Use License Addition: Exclusive License Count: Non-Counted Comment: Store Name: Primary License Storage Are you sure you want to clear? (yes/[no]): yes %Clear failed due to license in use Device# configure terminal Device(config)# license boot module asr1001 group all level ipbase Device(config)# exit Device# reload . . . Device> enable Device# show license all License Store: Primary License Storage StoreIndex: 0 Feature: advipservices Version: 1.0 License Type: Permanent License State: Active, Not in Use License Count: Non-Counted License Priority: Medium License Store: Primary License Storage StoreIndex: 1 Feature: adventerprise Version: 1.0 License Type: Permanent License State: Active, Not in Use License Count: Non-Counted License Priority: Medium Device# license clear advipservices Feature: advipservices 1 License Type: Permanent License State: Active, Not in Use License Addition: Exclusive License Count: Non-Counted Comment: Store Name: Primary License Storage Are you sure you want to clear? (yes/[no]): yes Device# *Oct 13 11:31:58.844 EDT: %LICENSE-6-REMOVE: R0/0: licensed: Feature advipservices 1.0 was removed from this device, UDI=ASR1001:JAE14140D8L, StoreIndex=0:Primary License Storage Device# show license all License Store: Primary License Storage StoreIndex: 1 Feature: adventerprise Version: 1.0 License Type: Permanent License State: Active, In Use License Count: Non-Counted License Priority: Medium Example: Rehosting (Revoking and Transferring) a LicenseThe following example shows how to use the license revoke command to revoke a license stored in flash memory and transfer it to another location in flash memory. You might need to read and accept the terms and conditions of the license type being transferred. The following example is truncated for readability: Device# license revoke bootflash:/ramanp/pt.lic bootflash:rt.lic Following Permanent license(s) will be revoked from this device Feature Name: standard Following Extension license(s) will be installed in this device Feature Name: standard PLEASE READ THE FOLLOWING TERMS CAREFULLY. . . ACCEPT? [yes/no]: yes Issue 'license feature standard' command to enable the license Rehost ticket saved ..... to bootflash:rt.lic Example: Generic Commands Enhanced with Licensing Informationshow tech-supportThe show tech-support command displays the output of the show license udi and the show license image-levels commands. The display is truncated to focus on only these sections:
Device# show tech-support
License Info:
License UDI:
Device# PID SN UDI
--------------------------------------------------------------------------------
*0 ASR1001 JAE14020AT5 ASR1001:JAE14020AT5
License Package Information for Module:'asr1001'
Module name Image level Priority Configured Valid license
asr1001 adventerprise 1 NO adventerprise
advipservices 2 YES advipservices
ipbase 3 NO ipbase
Current License Level: ipbase
cisco ASR1001 (1RU) processor with 3869710K/6147K bytes of memory.
4 Gigabit Ethernet interfaces
1 Ten Gigabit Ethernet interface
32768K bytes of non-volatile configuration memory.
8388608K bytes of physical memory.
7782399K bytes of eUSB flash at bootflash:.
78085207K bytes of SATA hard disk at harddisk:.
Configuration register is 0x0
show versionThe show version command displays the license UDI information:
Device# show version
Cisco IOS Software, IOS-XE Software (X86_64_LINUX_IOSD-UNIVERSALK9-M), Experimen
tal Version 15.1(20100825:030133) [mcp_dev-BLD-BLD_MCP_DEV_LATEST_20100825_01011
7-ios 132]
Copyright (c) 1986-2010 by Cisco Systems, Inc.
Compiled Tue 24-Aug-10 21:21 by mcpre
Cisco IOS-XE software, Copyright (c) 2005-2010 by cisco Systems, Inc.
All rights reserved. Certain components of Cisco IOS-XE software are
licensed under the GNU General Public License ("GPL") Version 2.0. The
software code licensed under GPL Version 2.0 is free software that comes
with ABSOLUTELY NO WARRANTY. You can redistribute and/or modify such
GPL code under the terms of GPL Version 2.0. For more details, see the
documentation or "License Notice" file accompanying the IOS-XE software,
or the applicable URL provided on the flyer accompanying the IOS-XE
software.
ROM: IOS-XE ROMMON
1ru_bu2 uptime is 1 day, 46 minutes
Uptime for this control processor is 1 day, 47 minutes
System returned to ROM by reload
System image file is "bootflash:asr10001ru-universalk9.BLD_MCP_DEV_LATEST_201008
25_01"
Last reload reason: Reload Command
This product contains cryptographic features and is subject to United
States and local country laws governing import, export, transfer and
use. Delivery of Cisco cryptographic products does not imply
third-party authority to import, export, distribute or use encryption.
Importers, exporters, distributors and users are responsible for
compliance with U.S. and local country laws. By using this product you
agree to comply with applicable laws and regulations. If you are unable
to comply with U.S. and local laws, return this product immediately.
A summary of U.S. laws governing Cisco cryptographic products may be found at:
http://www.cisco.com/wwl/export/crypto/tool/stqrg.html
If you require further assistance please contact us by sending email to
export@cisco.com.
License Info:
License UDI:
Device# PID SN UDI
--------------------------------------------------------------------------------
*0 ASR1001 JAE14020AT5 ASR1001:JAE14020AT5
License Package Information for Module:'asr1001'
Module name Image level Priority Configured Valid license
asr1001 adventerprise 1 NO adventerprise
advipservices 2 YES advipservices
ipbase 3 NO ipbase
Current License Level: ipbase
cisco ASR1001 (1RU) processor with 3869710K/6147K bytes of memory.
4 Gigabit Ethernet interfaces
1 Ten Gigabit Ethernet interface
32768K bytes of non-volatile configuration memory.
8388608K bytes of physical memory.
7782399K bytes of eUSB flash at bootflash:.
78085207K bytes of SATA hard disk at harddisk:.
Configuration register is 0x0
Device#
Additional ReferencesRelated DocumentsTechnical Assistance
Feature Information for Cisco IOS Software ActivationThe following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. 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 Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R) Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental. © 2012 Cisco Systems, Inc. All rights reserved.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|