![]() |
Software Activation Configuration Guide, Cisco IOS Release 15M&T
|
||||||||||||||||||||||||||||||||||||||||||||||||||
Configuring the Cisco IOS Software Activation Feature
![]() |
|||||||||||||||||||||||||||||||||||||||||||||||||||
Contents
Configuring the Cisco IOS Software Activation FeatureLast Updated: November 30, 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 caveats and feature information, see Bug Search Tool and 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 module. 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 ActivationNot all Cisco hardware platforms can use the Cisco IOS Software Activation feature. Use the Cisco Feature Navigator at http://www.cisco.com/go/cfn and the table in the Feature Information for Cisco IOS Software Activation section to determine which platforms and images support the Cisco IOS Software Activation feature. For the stackable switches that support the Cisco IOS Software Activation feature, one switch must act as primary and the others as secondaries. The primary switch performs management and administrative operations on itself as well as on the secondary switches. Information About the Cisco IOS Software ActivationLicense Activation MIB SupportThe Cisco IOS Software Activation feature introduces the CISCO-LICENSE-MGMT-MIB to allow SNMP-based license management and administrative tasks. A description of this MIB can be found by using tools at this URL: http://tools.cisco.com/ITDIT/MIBS/servlet/index Use the MIB Locator tool and the Search for MIB selection box to select CISCO-LICENSE-MGMT-MIB . The unique device identifier (UDI) is also associated with the Entity Name and Product Description data elements for the management information base (MIB) system. The MIB nomenclature for Entity Name is entPhysicalName and for Product Description is entPhysicalDescr. 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 process concepts in the in the "Cisco IOS Software Activation Conceptual Overview" module. 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 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. 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 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 saved in TFTP on the device. The display is truncated for easier readability: Device# license install tftp://infra-sun/<user>/license/5400/38a.lic Installing licenses from "tftp://infra-sun/<user>/license/5400/38a.lic" Loading <user>/license/5400/38a.lic from 172.19.211.47 (via GigabitEthernet0/0): ! [OK - 1192 bytes] Extension licenses are being installed in the device with UDI "AS54XM-AC-RPS:JAE0948QXKD" for the following features: Feature Name: gsmamrnb-codec-pack PLEASE READ THE FOLLOWING TERMS CAREFULLY. . . ACCEPT? [yes/no]: yes Issue 'license feature gsmamrnb-codec-pack' command to enable the license Installing...Feature:gsmamrnb-codec-pack...Successful:Supported 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. If a switch number is specified, this command is executed on the specified switch. As the example shows, when the license is present and multiple license lines are stored, you are prompted to select a license line. This action helps to distinguish licenses. Type the number at the Select Index to Add Comment prompt to select the license. Device# license comment add gsmamrnb-codec-pack "Use this permanent license" Feature: gsmamrnb-codec-pack 1 License Type: Evaluation License State: Inactive Evaluation total period: 20 hours 0 minute Evaluation period left: 20 hours 0 minute License Addition: Additive Comment: Store Index: 0 Store Name: Primary License Storage 2 License Type: Permanent License State: Active, Not in Use License Addition: Exclusive Comment: Store Index: 1 Store Name: Primary License Storage Select Index to Add Comment [1-2]: 2 % Success: Adding comment "Use this permanent license" succeeded Device# show license file License Store: Primary License Storage Store Index: 0 License: 11 gsmamrnb-codec-pack 1.0 LONG TRIAL DISABLED 20 DISABLED STANDA LONE ADD INFINITE_KEYS INFINITE_KEYS NEVER NEVER NiL SLM_CODE CL_ ND_LCK NiL *1YCHJRBMWKZAED2400 NiL NiL NiL 5_MINS <UDI><PID>AS54X M-AC-RPS</PID><SN>JAE0948QXKD</SN></UDI> ,Jx8qaVf:iXWaH9PsXjkVnmz 7gWh:cxdf9nUkzY6o8fRuQbu,7wTUz237Cz6g9VjfrCk,0a2Pdo,Ow6LWxcCRFL:x cTxwnffn9i,4,aUWv8rL50opDUdAsFnxLsvoFRkcAfm$<WLC>AQEBIQAB//9NA+1m Uwfs/lD0dmdF9kyX8wDrua1TZhnnAy6Mxs1dTboIcRaahKxJJdj4Oi1w3wscqvPiA mWSaEmUT56rstk6gvmj+EQKRfD9A0ime1czrdKxfILT0LaXT416nwmfp92Tya6vIQ 4FnlBdqJ1sMzXeSq8PmVcTU9A4o9hil9vKur8N9F885D9GVF0bJHciT5M=</WLC> Comment: Use this permanent license. Hash: E1WjIQo4qsl9g8cpnpoogP/0DeY= Device# Example: Removing LicensesThe following examples shows how to use the license clear command to remove a license entry from license storage once it has been verified that the license line is valid and was explicitly installed. You must select the index number of the license to clear. Type the number at the Select Index to Clear prompt as shown in this example. Device# license clear standard Feature: standard 1 License Type: Evaluation License State: Inactive Evaluation total period: 20 hours 0 minute Evaluation period left: 20 hours 0 minute License Addition: Additive Comment: Store Index: 0 Store Name: Primary License Storage 2 License Type: Permanent License State: Active, Not in Use License Addition: Exclusive Comment: Store Index: 1 Store Name: Primary License Storage Select Index to Clear [1-2]: 1 Are you sure you want to clear? (yes/[no]): yes Device# show license detail Feature: premium Period left: 1 hour 0 minute Index: 1 Feature: premium Version: 1.0 License Type: Evaluation License State: Active, Not in Use, EULA not accepted Evaluation total period: 1 hour 0 minute Evaluation period left: 1 hour 0 minute License Count: Non-Counted License Priority: None Store Index: 0 Store Name: Evaluation License Storage Example: Rehosting (Revoking and Transferring) a LicenseThe following example shows how to use the license revoke command to revoke a license stored in TFTP and how to transfer it to a license stored 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 tftp://infra-sun/ramanp/pt.lic flash:rt.lic Following Permanent license(s) will be revoked from this device Feature Name: gsmamrnb-codec-pack Following Extension license(s) will be installed in this device Feature Name: gsmamrnb-codec-pack PLEASE READ THE FOLLOWING TERMS CAREFULLY. . . ACCEPT? [yes/no]: yes Issue 'license feature gsmamrnb-codec-pack' command to enable the license Rehost ticket saved ..... to flash:rt.lic Example: Generic Command Enhanced with Licensing InformationreloadThe reload command shows the expired licenses, followed by expiring licenses sorted by the period left and end date:
Device# reload
The following license(s) are expiring or have expired.
Features with expired licenses may not work after Reload.
Feature: uc,Status: expiring, Period Left: 7 wks 5 days
Proceed with reload? [confirm]
show running-configThe show running-config command displays the UDI of the device. If the configuration file was copied from a different device, a warning is displayed upon reload. A UDI mismatch warning is also displayed during reload if the startup-config file has a different UDI than the platform UDI.
Device# show running-config
Building configuration...
Current configuration : 4772 bytes
!
version 12.4
no service pad
service timestamps debug datetime msec
service timestamps log datetime msec
no service password-encryption
service internal
!
hostname csl-xfr-enhance-2951
!
...
...
license udi pid CISCO2951 sn FHH1211P037
license boot module c2951 technology-package securityk9 disable
license boot module c2951 technology-package uc
license boot module c2951 technology-package data
license call-home url https://tools-stage.cisco.com/SWIFT/Licensing
license agent listener http plaintext /lic-agent authenticate none
!
!
archive
log config
hidekeys
!
.
.
.
show tech-supportThe show tech-support command displays the output of the show license udi, show license file, show license detail, show license status, and the show license statistics commands.
Device# show tech-support
------------------ show license udi ------------------
Device# PID SN UDI
-----------------------------------------------------------------------------
*0 CISCO2951 FHH1211P037 CISCO2951:FHH1211P037
------------------ show license feature ------------------
Feature name Enforcement Evaluation Subscription Enabled
ipbasek9 no no no no
securityk9 yes yes no no
uc yes yes no yes
data yes yes no no
gatekeeper yes yes no no
LI yes no no no
SSL_VPN yes yes no no
ios-ips-update yes yes yes no
SNASw yes yes no no
------------------ show license file ------------------
License Store: Primary License Storage
License Store: Evaluation License Storage
Store Index: 0
License: 11 securityk9 1.0 LONG TRIAL DISABLED 1440 DISABLED STANDALONE AD
D INFINITE_KEYS INFINITE_KEYS NEVER NEVER NiL SLM_CODE DEMO NiL N
iL Ni NiL NiL 5_MINS NiL GT5YVbrMAdt0NY50UcKGfvLTjQ17P2o3g84hE8Tq
sOfu3Xph0N:2AmMdpMNxxKXSVG$<WLC>AQEBIQAB//+FugzZgqFJn/XhIxoyelg63
YJD++i6Qx6vVp0MVqrX2EinbufbTfGzc7/GHNZaDZqRqwInXo3s+nsLU7rOtdOxoI
xYZAo3LYmUJ+MFzsqlhKoJVlPyEvQ8H21MNUjVbhoN0gyIWsyiJaM8AQIkVBQFzhr
10GYolVzdzfJfEPQIx6tZ++/Vtc/q3SF/5Ko8XCY=</WLC>
Comment:
Hash: CLWUVZgY84BMRTO3JIlYmIqwAQA=
------------------ show license detail ------------------
Index: 1 Feature: SNASw 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
Lock type: Non Node locked
Vendor info:
License Addition: Additive
License Generation version: 0x8100000
License Count: Non-Counted
License Priority: None
Store Index: 5
Store Name: Evaluation License Storage
------------------ show license status ------------------
License Type Supported
permanent Non-expiring node locked license
extension Expiring node locked license
evaluation Expiring non node locked license
paid subscription Expiring node locked subscription license
with valid end date
extension subscription Expiring node locked subscription license
evaluation subscription Expiring node locked subscription license
...
...
------------------ show license statistics ------------------
Administrative statistics
Install success count: 0
Install failure count: 0
Install duplicate count: 0
Comment add count: 0
Comment delete count: 0
Clear count: 0
Save count: 0
Save cred count: 1
Client statistics
Request success count: 1
Request failure count: 3
Release count: 0
Global Notify count: 4
show versionThe show version command displays the license UDI information:
Device> show version
Cisco IOS Software, C2951 Software (C2951-UNIVERSALK9-M), Experimental Version 12.4(20090326:052343)
[rifu-xformers_3_25 130]
Copyright (c) 1986-2009 by Cisco Systems, Inc.
Compiled Thu 26-Mar-09 21:49 by rifu
ROM: System Bootstrap, Version 12.4(20090303:092436) [BLD-xformers_dev.XFR_20090303-20090303_0101-53
107], DEVELOPMENT SOFTWARE
csl-xfr-enhance-2951 uptime is 3 days, 4 hours, 28 minutes
System returned to ROM by reload at 18:48:45 PST Mon Nov 26 1956
System image file is "flash0:c2951-universalk9-mz.SSA"
Last reload reason: Reload Command
...
...
Cisco C2951 (revision 1.0) with 1005568K/43008K bytes of memory.
Processor board ID FHH1211P037
3 Gigabit Ethernet interfaces
1 terminal line
1 cisco Special Services Engine(s)
DRAM configuration is 72 bits wide with parity enabled.
255K bytes of non-volatile configuration memory.
250880K bytes of ATA System CompactFlash 0 (Read/Write)
License Info:
License UDI:
-------------------------------------------------
Device# PID SN
-------------------------------------------------
*0 CISCO2951 FHH1211P037
Technology Package License Information for Module:'c2951'
----------------------------------------------------------------
Technology Technology-package Technology-package
Current Type Next reboot
-----------------------------------------------------------------
ipbase ipbasek9 None ipbasek9
security disable None disable
uc uc Evaluation uc
data None None None
Configuration register is 0x0
Additional ReferencesRelated Documents
MIBsTechnical 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.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
|
|