Cisco IOS Software Activation Tasks and Commands [Cisco IOS Software]

Table Of Contents

Cisco IOS Software Activation Tasks and Commands

Contents

Restrictions for Cisco IOS Software Activation

Information About the Cisco IOS Software Activation

Cisco IOS Software Activation Command Line Interface

License Activation MIB Support

Software End User License Agreement

How to Use Cisco IOS Commands for Software Licensing

Installing and Upgrading Licenses Using Software Activation Commands

Managing Licenses Using Software Activation Commands

Adding a Comment to a License

Saving All Licenses

Saving License Credential Information

Displaying All Licenses

Displaying License Details

Verifying License Feature Sets

Removing Licenses Using Software Activation Commands

Clearing a License

Rehosting (Revoking and Transferring) a License

Troubleshooting Licensing

Examples of Cisco IOS Commands for Software Licensing

Additional References

Related Documents

Standards

MIBs

RFCs

Technical Assistance

Command Reference

Feature Information for Cisco IOS Software Activation

Cisco IOS Software Activation Tasks and Commands

First Published: July 5, 2008

Last Updated: September 29, 2008

This document describes the tasks and commands used to activate software using the Cisco IOS Software Activation feature, license keys, and Cisco EXEC commands. Activating software from a Cisco device has the benefit of being able to license software without the need for additional application software.

Finding Feature Information in This Module

Your Cisco IOS software release may not support all of the features documented in this module. To reach links to specific feature documentation in this module and to see a list of the releases in which each feature is supported, use the "Feature Information for Cisco IOS Software Activation" section.

Finding Support Information for Platforms and Cisco IOS Software Images

Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.

Contents

•Restrictions for Cisco IOS Software Activation

•Information About the Cisco IOS Software Activation

•How to Use Cisco IOS Commands for Software Licensing

•Examples of Cisco IOS Commands for Software Licensing

•Additional References

•Command Reference

•Feature Information for Cisco IOS Software Activation

Restrictions for Cisco IOS Software Activation

Not all Cisco router and switch 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 Activation

You need to understand the following concepts before using the Cisco IOS Software Activation feature and License Call Home commands:

•Cisco IOS Software Activation Command Line Interface

•License Activation MIB Support

•Software End User License Agreement

Cisco IOS Software Activation Command Line Interface

The Cisco IOS Software Activation EXEC commands support the following licensing processes:

•Install a license.

•Add a comment to a license.

•Back up all licenses.

•Remove unused licenses.

•Save device credentials.

•Rehost (revoke and transfer) a license.

•Troubleshoot license messages.

•Verify software image feature sets.

All control subsystems on a Cisco router or switch must have the license line to perform the necessary control and enforcement operations. You must have obtained the license file from either Cisco's Product License Registration portal at http://www.cisco.com/go/license or by using the license save EXEC command.

For manual license fulfillment case, you enter a Product Activation Key (PAK) into the Cisco Product License Registration portal, which retrieves the Stock Keeping Units (SKUs) associated with the PAK. You then select the SKU and enter the Universal Device Identifier (UDI), a unique and unchangeable identifier of the device where the license should be installed. A license key is then e-mailed to you and you use that key to install the license.

License Activation MIB Support

The 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 using tools at the following URL: http://tools.cisco.com/ITDIT/MIBS/servlet/index Use the MIB Locator tool and the Search for MIB selection box, to select CISCO-ENHANCED-LICENSING-MIB.

The 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.

Software End User License Agreement

You can read the terms and conditions of the End User License Agreement online at the following URL: http://www.cisco.com/en/US/products/prod_warranties_item09186a008088e31f.html

How to Use Cisco IOS Commands for Software Licensing

This section contains the following procedures:

•Installing and Upgrading Licenses Using Software Activation Commands

•Managing Licenses Using Software Activation Commands

•Removing Licenses Using Software Activation Commands

•Troubleshooting Licensing

Installing and Upgrading Licenses Using Software Activation Commands

A license is obtained and installed following these basic steps:

•Purchase a PAK for the desired type of license.

•Submit the PAK code and UDI of the switch to Cisco's online license portal.

•Install the license file returned from license portal to the device using Cisco IOS commands. (This step can also be done using the Cisco License Manager application, which can be downloaded at http://www.cisco.com/go/clm.)

•Reboot the device (if required). The new feature set is enabled.

Perform this task to manually install or upgrade a license using the Cisco IOS install license command. The license file must have already been received from Cisco's licensing portal or have been backed up using the Cisco IOS license save command.

SUMMARY STEPS

1. Obtain the PAK.

2. enable

3. show license udi

4. Convert the PAK to a license.

5. license install stored-location-url

6. Reboot if required.

DETAILED STEPS

Step 1 Obtain the PAK.

PAKs are purchasable items, ordered in the same manner as other Cisco equipment. PAKs are used to obtain license files for feature sets on specific classes of Cisco devices.

Step 2 enable

Use this command to enable privileged EXEC mode:

Router> enable
Enter your password if prompted.

Step 3 show license udi

Display all licensable UDIs in the system. The following example shows the type of information displayed:
Router# show license udi
Device#                  PID             SN            UDI
-----------------------------------------------------------------------------
*0 AS54XM-AC-RPS         JAE0948QXKD     AS54XM-AC-RPS:JAE0948QXKD
Step 4 Convert the PAK to a license (www.cisco.com/go/license).

After entering the appropriate information at the above URL, you will receive an email containing the license information that you can use to install the license. Or you can simply click the Install button on the web page.

Step 5 license install stored-location-url

Install the license. As shown in the following example (which is truncated for easier readability), the command initiates several actions that result in either the printing of an end user license agreement with prompts to accept the agreement (evaluation/extension licenses only) or messages indicating that the license is installed. When a license is successfully installed, a message will confirm the installation and state whether or not the licensed feature is present in the current image.

Router# 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
The installation process does not install duplicate licenses. The following message is displayed when duplicate licenses are detected:

Installing...Feature:xxx-xxx-xxx...Skipped:Duplicate
Step 6 Reboot if required.

Managing Licenses Using Software Activation Commands

The following sections describe how to manage software licenses:

•Adding a Comment to a License

•Saving All Licenses

•Saving License Credential Information

•Displaying All Licenses

•Displaying License Details

•Verifying License Feature Sets

Adding a Comment to a License

Perform this task to add comments to a license file.

SUMMARY STEPS

1. enable

2. license comment {add feature-name comment | delete} (Cisco router and Catalyst 3560-E switch platforms)
or
license comment {add feature-name comment switch switch-num | delete} (Cisco Catalyst 3750-E switch platforms)

3. show license file [switch switch-num]

DETAILED STEPS

Step 1 enable

Use this command to enable privileged EXEC mode:

Router> enable
Enter your password if prompted.

Step 2 license comment {add feature-name comment | delete}
or
license comment {add feature-name comment | switch switch-num | delete}

You can use this 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 following 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.
Router# 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
Step 3 show license file [switch switch-num]

Use this command to display comments added to a Cisco software license file. If the device is a switch, this command obtains statistics from the specified switch. Following is an example of the type of information displayed:
Router# 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=
Saving All Licenses

Perform this task to save copies of all licenses in a specified storage area. Saved licenses are restored using the license install command.

SUMMARY STEPS

1. enable

2. license save lic-location-url [switch switch-num]

DETAILED STEPS

Step 1 enable

Use this command to enable privileged EXEC mode:

Router> enable
Enter your password if prompted.

Step 2 license save lic-location-url [switch switch-num]

Use this command to save copies of all licenses in a device and store them in a format required by the license install command, in the specified storage location.

The license storage location can be a directory or a URL that points to a file system. Use the ? command to see the storage locations supported by your device.

The optional switch switch-num keyword and argument send this request to a specific switch in a switch stack.

Router# license save flash:all_licenses.lic
license lines saved ..... to flash:all_licenses.lic
Saving License Credential Information

To enact the rehost or resend process, a Device Credential is required. Cisco IOS licensing requires that the license files generated by Cisco's licensing back end 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, Cisco's licensing back end requires the device credential information.

Perform this task to save license credential information associated with a device to a specified storage area.

SUMMARY STEPS

1. enable

2. license save credential location-to-save [switch switch-num]

DETAILED STEPS

Step 1 enable

Use this command to enable privileged EXEC mode:

Router> enable
Enter your password if prompted.

Step 2 license save credential location-to-save [switch switch-num]

Use this command to save credential information associated with a device to a specified URL. Use the ? command to see the storage locations supported by your device. The optional switch switch-num keyword and argument send this request to a specific switch in a switch stack.

Switch# license save credential flash:cred.lic
Device credential saved ..... to flash:cred.lic
Displaying All Licenses

Perform this task to display all licenses in a device.

SUMMARY STEPS

1. enable

2. show license all

DETAILED STEPS

Step 1 enable

Use this command to enable privileged EXEC mode:

Router> enable
Enter your password if prompted.

Step 2 show license all

The following example shows the type of information displayed:
Router# show license all
License Store: Primary License Storage 
StoreIndex: 0 Feature: TEST_FEATURE_1 Version: 1.0 
License Type: Trial 
License State: Active, Not in Use, EULA accepted 
Trial total period: 1 day 0 hour  
Trial period left: 0 second 
Lock type: Node locked 
Vendor info <PID>AS54XM-AC-RPS</PID><SN>JAE0948QXJW</SN> 
License Addition: Additive 
License Generation version 135266304 
License Precedence: 1
Displaying License Details

Perform this task to display information about licenses associated with a feature name.

Note The feature name is optional. If a feature name is not provided, details of all licenses will be displayed.

SUMMARY STEPS

1. enable

2. show license detail

DETAILED STEPS

Step 1 enable

Use this command to enable privileged EXEC mode:

Router> enable
Enter your password if prompted.

Step 2 show license detail

The following example shows the type of information displayed:
Router# show license detail
Index: 1 	Feature: gsmamrnb-codec-pack   Version: 1.0
	License Type: Evaluation
	License State: Active, Not in Use, EULA 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 135266304
	License Priority: Low
	Store Index: 0
	Store Name: Evaluation License Storage
Verifying License Feature Sets

Perform this task to display the list of licensed features that are available in an image.

SUMMARY STEPS

1. enable

2. show license feature

DETAILED STEPS

Step 1 enable

Use this command to enable privileged EXEC mode:

Router> enable
Enter your password if prompted.

Step 2 show license feature

The following example shows the type of information displayed:
Router# show license feature
Feature name             Enforcement  Evaluation  Clear Allowed  Enabled
gsmamrnb-codec-pack      yes          yes         no             no   
Removing Licenses Using Software Activation Commands

The following sections describe how to remove software licenses:

•Clearing a License

•Rehosting (Revoking and Transferring) a License

Clearing a License

Perform this task to remove a license entry from a permanent license file. Keep the following in mind when performing the steps:

•When executed, the license clear command lists all licenses, but some licenses such as built-in licenses cannot be cleared.

•Only licenses that have been added using the license install command are removed. Evaluation licenses are not removed.

•If a license is not in use, the license clear command displays all the licenses related to this feature and prompts you to make a selection. Different prompts are displayed, depending upon whether there are single or multiple licenses available in the device. The selected licenses are removed from the router or switch.

•If a license is in use, the license clear command may fail, although, depending upon the application policy using the license, some licenses may cleared.

•When a switch is specified, the license clear command is issued on that switch. When a mixed stack platform is used, the primary switch must have installed the minimum licensing features required to support the licensing operations of the secondary switches. When this command is issued from a primary switch, the switch number is required to clear a license on that switch.

SUMMARY STEPS

1. enable

2. license clear feature-name
or
license clear feature-name switch switch-num (Cisco Catalyst 3750-E mixed stack switch and Cisco Catalyst 3560-E switch and switch stack platforms)

3. show license detail

DETAILED STEPS

Step 1 enable

Use this command to enable privileged EXEC mode:

Router> enable
Enter your password if prompted.

Step 2 license clear feature-name [switch switch-num]

Use this command to remove a license entry from license storage once it has been verified that the license line is valid and was explicitly installed.

The optional switch switch-num keyword and argument send this request to a specific switch in a switch stack.

You must select the index number of the license to clear. Type the number at the Select Index to Clear prompt, as shown in the following example:
Router# license clear gsmamrnb-codec-pack
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 Clear [1-2]: 1
Are you sure you want to clear? (yes/[no]): yes
Step 3 show license detail

Use this command to verify that the license has been cleared.
Router# show license detail
Index: 1 	Feature: gsmamrnb-codec-pack   Version: 1.0
	License Type: Permanent
	License State: Active, Not in Use
	Lock type: Node locked
	Vendor info <UDI><PID>AS54XM-AC-RPS</PID><SN>JAE0948QXKD</SN></UDI>
	License Addition: Exclusive
	License Generation version 135266304
	License Priority: Medium
	Store Index: 1
	Store Name: Primary License Storage
Index: 2 	Feature: gsmamrnb-codec-pack   Version: 1.0
	License Type: Evaluation
	License State: Inactive
	    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 135266304
	License Priority: Low
	Store Index: 0
	Store Name: Evaluation License Storage
Rehosting (Revoking and Transferring) a License

Perform this task to rehost (revoke and transfer) a license. The command removes the original, permanent license from the device and provides a license for the new device by accomplishing the following operations:

•Obtains a permission ticket from the Cisco licensing infrastructure portal that will allow the license to be moved.

•Parses the permission ticket file to extract data related to generating the rehosting ticket.

•Uploads the rehost ticket to the Cisco licensing infrastructure portal, so the customer can obtain the final license.

•The license security application processes the data and offers a grace-period license.

•Once an end user license agreement is accepted, the licensing infrastructure processes the permission ticket and generates the rehost ticket.

•If there is a counted license in the permission ticket and a grace period-license for the counted feature, the user must respond to a prompt asking whether to use the grace period-license. If the selection is to use the grace period-license, it is used immediately.

Note Cisco IOS licensing requires that the license files generated by Cisco's licensing back end 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, Cisco's licensing back end requires the device credential information. Use the license save credential command to save device credential information to a specified file system.

SUMMARY STEPS

1. enable

2. license revoke permission-file-url output-rehost-ticket-url

DETAILED STEPS

Step 1 enable

Use this command to enable privileged EXEC mode:

Router> enable
Enter your password if prompted.

Step 2 license revoke permission-file-url output-rehost-ticket-url

Use this command to revoke and transfer a license using the permission ticket provided by Cisco's back end licensing system.

An end user license agreement is displayed for all grace-period licenses in the permission ticket. You must read and accept an end user license agreement, (which is truncated in the following example for easier readability). Type "yes" at the ACCEPT? prompt, as shown in the following example. If you do not accept the agreement, the rehost operation stops.
Router# 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
Troubleshooting Licensing

This section describes the Cisco IOS EXEC commands used to troubleshoot license operations.

SUMMARY STEPS

1. enable

2. show license file [switch switch-num]

3. show license statistics

4. show license status [switch switch-num]

5. debug license {all | core | errors | events}

6. no debug license

DETAILED STEPS

Step 1 enable

Use this command to enable privileged EXEC mode:

Router> enable
Enter your password if prompted.

Step 2 show license file [switch switch-num]

Use this command to display license entries and license details stored in a Cisco software license file. If the device is a switch, this command obtains statistics from the specified switch. Following is an example of the type of information displayed:
Router# 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: 
       Hash: E1WjIQo4qsl9g8cpnpoogP/0DeY=
License Store: Evaluation License Storage
  Store Index: 0
    License: 11 gsmamrnb-codec-pack 1.0 LONG TRIAL DISABLED 1440 DISABLED STAN
             DALONE ADD INFINITE_KEYS INFINITE_KEYS NEVER NEVER NiL SLM_CODE D
             EMO NiL NiL Ni NiL NiL 5_MINS NiL v:v87LOPTP81Kxf7eIXJfj7JeYSI,vf
             3eQefsQqNBELX1L9I4qkescUsSc8iUTW33:$<WLC>AQEBIQAB///9yMZkgcwLeVoO
             52FBJbjBGsDsQwOpmggu2ARMqN4hj77A8uk20wzahdXfClp3E2YcqvPiAmWSaEmUT
             56rstk6gvmj+EQKRfD9A0ime1czrdKxfILT0LaXT416nwmfp92Tya6vIQ4FnlBdqJ
             1sMzXeSq8PmVcTU9A4o9hil9vKur8N9F885D9GVF0bJHciT5M=</WLC>
   Comment: 
       Hash: f8M0YeFxX9uUbYKToh5vJMTtcs0=
Step 3 show license statistics

Use this command to display license statistics information. The display will include relevant statistics for error counts and is useful for troubleshooting licensing related problem. See the following example.
Router# show license statistics
		Administrative statistics
	Install success count:   4    
	Install failure count:   1    
	Install duplicate count: 12   
	Comment add count:       2    
	Comment delete count:    0    
	Clear count:             10   
	Save count:              1    
	Save cred count:         6    
		Client statistics
	Request success count 0    
	Request failure count 0    
	Release count         0    
	Global Notify count   21   
		SWIFT url status 
	Swift value changed by user 
	Current Value : https://cisco.com/SWIFT/Licensing 
	Default Value : https://cisco.com/SWIFT/Licensing
Step 4 show license status [switch switch-num]

Use this command to display the status of licenses in the system to include the total of number of licenses installed, cleared, revoked, requested, and released. If the device is a switch, this command obtains status from the specified switch. Following is an example of the display seen:
Router# show license status
License Type Supported
	permanent  Non-expiring node locked license
	extension  Expiring node locked license
	evaluation Expiring non node locked license
		License Operation Supported
	install    Install license
	clear      Clear license
	annotate   Comment license
	save       Save license
	revoke     Revoke license
	call-home  License call-home
		Call-home Operation Supported
	show pak   Display license pak via call-home
	install    Install license via call-home
	revoke     Revoke license via call-home
	resend     Fetch license via call-home
		Device status
	Device Credential type: IMAGE
	Device Credential Verification: PASS
	Rehost Type: DC_OR_IC
Step 5 debug license {all | core | errors | events}

Use this command to enable controlled Cisco IOS software license debugging activity on a device.

Router# debug license errors
Step 6 no debug license

Use this command to disable license debugging activity on a device.

Examples of Cisco IOS Commands for Software Licensing

Examples for the EXEC commands used for the Cisco IOS Software Activation function are provided in the sections describing the tasks to use these features.

Additional References

The following sections provide references related to the Cisco IOS Software Activation feature.

Related Documents

Related Topic

Document Title

Cisco License Manager application

User Guide for Cisco License Manager.

Cisco IOS Software Activation overview

Cisco IOS Software Activation Conceptual Overview feature module

Cisco Software License Agent

Cisco IOS Software License Agent feature module

GateKeeper licensing

IP-to-IPGwy Feature Guide

Integrated Services Routers licensing

Software Activation on Cisco Integrated Services Routers feature module

Standards

Standard

Title

None

—

MIBs

MIB

MIBs Link

CISCO-LICENSE-MGMT-MIB

To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:

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

RFCs

RFC

Title

None

—

Technical Assistance

Description

Link

The Cisco Support website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies.

To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds.

Access to most tools on the Cisco Support website requires a Cisco.com user ID and password.

http://www.cisco.com/techsupport

Command Reference

The following commands are introduced or modified in the feature or features documented in this module. For information about these commands, see the Cisco IOS Software Activation Command Reference at http://www.cisco.com/en/US/docs/ios/csa/command/reference/csa_book.html. For information about all Cisco IOS commands, use the Command Lookup Tool at http://tools.cisco.com/Support/CLILookup or a Cisco IOS master commands list.

•debug license

•license boot module

•license clear

•license comment

•license install

•license revoke

•license save

•license save credential

•show license

•show license statistics

•show subsys

•show subsys license

•snmp-server enable traps

•snmp-server host

Feature Information for Cisco IOS Software Activation

Table 9 lists the release history for this feature.

Not all commands may be available in your Cisco IOS software release. For release information about a specific command, see the command reference documentation.

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

Note Table 9 lists only the Cisco IOS software release that introduced support for a given feature in a given Cisco IOS software release train. Unless noted otherwise, subsequent releases of that Cisco IOS software release train also support that feature.

Table 9 Feature Information for Cisco IOS Software Activation

Feature Name

Releases

Feature Information

Cisco IOS Software Activation

12.4(15)XZ 12.4(20)T

Cisco IOS Software Activation EXEC commands support basic licensing processes.

This feature is platform-independent.

The following sections provide information about this feature:

•Cisco IOS Software Activation Command Line Interface

•Installing and Upgrading Licenses Using Software Activation Commands

•Managing Licenses Using Software Activation Commands

•Removing Licenses Using Software Activation Commands

•Troubleshooting Licensing

The following commands were introduced or modified by this feature: debug license, license clear, license comment, license install, license revoke, license save, license save credential, show license all, show license detail, show license feature, show license file, show license statistics, show license status, show license udi.

CISL-SNMP support (MIB)

12.4(20)T

SNMP support for the CISCO-LICENSE-MGMT-MIB was added.

The following sections provide information about this feature:

•License Activation MIB Support

•MIBs

The following commands were introduced or modified by this feature: snmp-server enable traps, snmp-server host.

Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.

© 2008 Cisco Systems, Inc. All rights reserved.

Hierarchical Navigation

Cisco IOS Software

Cisco IOS Software Activation Tasks and Commands

Downloads

Table Of Contents

Cisco IOS Software Activation Tasks and Commands

Contents

Restrictions for Cisco IOS Software Activation

Information About the Cisco IOS Software Activation

Cisco IOS Software Activation Command Line Interface

License Activation MIB Support

Software End User License Agreement

How to Use Cisco IOS Commands for Software Licensing

Installing and Upgrading Licenses Using Software Activation Commands

SUMMARY STEPS

DETAILED STEPS

Managing Licenses Using Software Activation Commands

Adding a Comment to a License

SUMMARY STEPS

DETAILED STEPS

Saving All Licenses

SUMMARY STEPS

DETAILED STEPS

Saving License Credential Information

SUMMARY STEPS

DETAILED STEPS

Displaying All Licenses

SUMMARY STEPS

DETAILED STEPS

Displaying License Details

SUMMARY STEPS

DETAILED STEPS

Verifying License Feature Sets

SUMMARY STEPS

DETAILED STEPS

Removing Licenses Using Software Activation Commands

Clearing a License

SUMMARY STEPS

DETAILED STEPS

Rehosting (Revoking and Transferring) a License

SUMMARY STEPS

DETAILED STEPS

Troubleshooting Licensing

SUMMARY STEPS

DETAILED STEPS

Examples of Cisco IOS Commands for Software Licensing

Additional References

Related Documents

Standards

MIBs

RFCs

Technical Assistance

Command Reference

Feature Information for Cisco IOS Software Activation