Cisco IOS Licensing Guide
Cisco IOS Licensing Guide
Contents
• Additional References
• Command Reference
• Feature Information for Cisco IOS Software Licensing
Additional References
The following sections provide references related to Cisco IOS Software
Licensing.
Related Documents
http://www.cisco.com/c/en/us/td/docs/ios/12_2/12_2se/feature/guide/se_cisl.html#wp1063894 1/13
1/23/2015 Cisco IOS Software Licensing - Cisco
Catalyst 3750E and Catalyst 3750E and 3560E
3560E switches Switches
MIBs
Technical Assistance
Description Link
The Cisco Support http://www.cisco.com/techsupport
website provides
extensive online
resources, including
documentation and
tools for
troubleshooting and
resolving technical
issues with Cisco
products and
technologies.
Access to most tools
on the Cisco Support
website requires a
Cisco.com user ID
and password. If you
have a valid service
contract but do not
have a user ID or
password, you can
register on
Cisco.com.
Command Reference
This section documents only commands that are new or modified.
• debug license
• license clear
• license comment
• license install
• license save
• license save credential
• show license
• show subsys
• show subsys license
debug license
To enable controlled Cisco IOS software license debugging activity on a
device, use the debug license command in privileged EXEC mode.
debug license {agent {all | error} | core {all | error | event} |
errors | events | ipc}
Syntax Description
http://www.cisco.com/c/en/us/td/docs/ios/12_2/12_2se/feature/guide/se_cisl.html#wp1063894 2/13
1/23/2015 Cisco IOS Software Licensing - Cisco
errors Debugs license warnings and errors.
Command Default
Debugging activity does not occur.
Command Modes
Privileged EXEC
Command History
Release Modification
12.2(35)SE2 This command was introduced.
Usage Guidelines
Use this command to help troubleshoot issues with licenses on a
device.
Examples
The following example shows how to enable debugging for license
warnings and errors on a router:
Router# debug license errors
The following example shows how to enable debugging for all license
agent information on a switch:
Switch# debug license agent all
license clear
http://www.cisco.com/c/en/us/td/docs/ios/12_2/12_2se/feature/guide/se_cisl.html#wp1063894 3/13
1/23/2015 Cisco IOS Software Licensing - Cisco
To remove a license entry from license storage, use the license clear
command in privileged EXEC mode. This command does not have a no
form.
Cisco Router Platforms
license clear featurename
Cisco Catalyst 3560E Switch Platforms
license clear featurename
Cisco Catalyst 3750E Switch and Switch Stack Platforms
license clear featurename [switch switchnum]
Cisco Catalyst 3750E Switch Mixed Stack Platforms
license clear featurename switch switchnum
Syntax Description
Command Default
Licenses are not removed.
Command Modes
Privileged EXEC
Command History
Release Modification
12.2(35)SE2 This command was introduced.
Usage Guidelines
The license clear command verifies that the license line is valid and
explicitly installed. Only explicit licenses that have been added using the
license install command are removed. Implicit 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 master
switch has installed the minimum licensing feature needed to support
the licensing operations of the slave switches. The license clear
command is used to clear a license from license storage, which a
master switch does not have. When the command is issued from the
master 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. For image
based licensing, the infrastructure has a dedicated callback to check in
the license, so the clear command could succeed. In this case, after the
license is cleared, error messages indicate that the device is running
without a valid license. This option is not available for feature licenses.
Examples
The following example shows how to clear a license associated with
feature12:
Router# license clear feature12
license comment
To add or remove a comment about a feature license, use the license
comment command in privileged EXEC mode. This command does not
have a no form.
Cisco Router Platforms
license comment {add featurename comment | delete}
Cisco Catalyst 3560E Switch Platforms
license comment {add featurename comment | delete}
Cisco Catalyst 3750E Switch Platforms
http://www.cisco.com/c/en/us/td/docs/ios/12_2/12_2se/feature/guide/se_cisl.html#wp1063894 4/13
1/23/2015 Cisco IOS Software Licensing - Cisco
license comment {add featurename comment switch switchnum
| delete}
Syntax Description
Command Default
Comments are not added or deleted.
Command Modes
Privileged EXEC
Command History
Release Modification
12.2(35)SE2 This command was introduced.
Usage Guidelines
This command checks if a license associated with the specified feature
is present in license storage. If a license is present and multiple license
lines are stored, you are prompted to select a license line. If a comment
exists in the license line, the comment is displayed before you are
prompted to delete a comment or enter a new one.
This command is useful for both tracking a license when multiple
licenses are stored on a device and for clarifying or adding information
about a specific license.
Related Commands
Command Description
show Displays information about a Cisco IOS
license software license.
license install
To install a license stored in a license file, use the license install
command in privileged EXEC mode. This command does not have a no
form.
license install filesys:filesys://liclocation
Syntax Description
Command Default
http://www.cisco.com/c/en/us/td/docs/ios/12_2/12_2se/feature/guide/se_cisl.html#wp1063894 5/13
1/23/2015 Cisco IOS Software Licensing - Cisco
A license is not installed.
Command Modes
Privleged EXEC
Command History
Release Modification
12.2(35)SE2 This command was introduced.
Usage Guidelines
When a license is successfully installed, an informational message is
displayed. This message states that the license installation is
successful and says whether or not the licensed feature is present in
the current image.
Examples
The following example shows how to install a license named test.lic
from a flash file system:
Switch# license install flash:flash//test.lic
Related Commands
Command Description
license Adds or removes a comment about a
comment feature license.
license save
To save a copy of a permanent license in a Cisco IOS device to a
specified license file, use the license save command in privileged
EXEC mode. This command does not have a no form.
license save filesys:filesys://liclocation
Syntax Description
Command Default
Licenses are not saved.
Command Modes
Privileged EXEC
Command History
Release Modification
12.2(35)SE2 This command was introduced.
Usage Guidelines
Issuing this command stores the license line and comment in Extensible
Markup Language (XML) format as required by the command. Issuing
this command saves copies of all permanent licenses.
Saved licenses may be restored using the license install command.
http://www.cisco.com/c/en/us/td/docs/ios/12_2/12_2se/feature/guide/se_cisl.html#wp1063894 6/13
1/23/2015 Cisco IOS Software Licensing - Cisco
Examples
The following example shows how to save a license named feat1.lic in
the FTP file system:
Router# license save ftp:feat1.lic
Related Commands
Command Description
license Installs a license stored in a license file
install on a device.
Command Default
License credentials are not saved.
Command Modes
Privileged EXEC
Command History
Release Modification
12.2(35)SE2 This command was introduced.
Usage Guidelines
Use this command to save credential information about a device.
Examples
The following example shows how to save identity information about a
license named feat1.lic in the http file system:
Switch# license save credential http:feat1.lic
Related Commands
Command Description
license Installs a license stored in a license file on
install a device.
http://www.cisco.com/c/en/us/td/docs/ios/12_2/12_2se/feature/guide/se_cisl.html#wp1063894 7/13
1/23/2015 Cisco IOS Software Licensing - Cisco
save Cisco IOS device to a specified license
file.
show license
To display information about a Cisco IOS software license, use the
show license command in either user EXEC or privileged EXEC mode.
Cisco Router Platforms
show license {all | detail featurename | feature | file | handle |
parser schema | status | udi}
Cisco Catalyst 3560E and 3750E Switch Platforms
show license {agent {counters | schema | session} | {all | detail
featurename | feature | file | handle | status | udi} switch
switchnum | parser schema}
Cisco Catalyst 3750E Mixed Switch Stacks
show license {agent {counters | schema | session} | detail
{featurename switch switchnum | switch switchnum} | {all |
feature | file | handle | status | udi} switch switchnum |
parser schema}
Syntax Description
Command Default
Licenserelated information is not displayed.
Command Modes
User EXEC
Privileged EXEC
Command History
Release Modification
12.2(35)SE2 This command was introduced.
Usage Guidelines
http://www.cisco.com/c/en/us/td/docs/ios/12_2/12_2se/feature/guide/se_cisl.html#wp1063894 8/13
1/23/2015 Cisco IOS Software Licensing - Cisco
Use this command to display license information and to help with
troubleshooting issues related to Cisco IOS software licenses. This
command displays all the licenses in the system.
This command also displays the features that are available but not
licensed to execute. Output is grouped according to how the features
are stored in license storage.
If a switch ID is specified, information from that switch is displayed. If a
switch ID is not specified, details of the local switch are displayed.
Examples
Following is sample output from the show license all command:
Router# show license all
Field Description
License Storage name; for example, Primary
Storage License Storage
show subsys
To display the subsystem information, use the show subsys command
in privileged EXEC mode.
show subsys [class class | name name]
Syntax Description
Command Modes
Privileged EXEC
Command History
Release Modification
http://www.cisco.com/c/en/us/td/docs/ios/12_2/12_2se/feature/guide/se_cisl.html#wp1063894 9/13
1/23/2015 Cisco IOS Software Licensing - Cisco
Usage Guidelines
Use the show subsys command to confirm that all required features
are in the running image.
Examples
Following is sample output from the show subsys command:
Router# show subsys
Field Description
Name Name of the subsystem.
http://www.cisco.com/c/en/us/td/docs/ios/12_2/12_2se/feature/guide/se_cisl.html#wp1063894 10/13
1/23/2015 Cisco IOS Software Licensing - Cisco
license.
Command Default
Subsystem information is not displayed.
Command Modes
User EXEC
Privileged EXEC
Command History
Release Modification
12.2(35)SE2 This command was introduced.
Usage Guidelines
Use this command to display license information and to help with
troubleshooting issues related to Cisco IOS software licenses.
Examples
Following is sample output that shows the subsystem running for the IP
base feature set:
Router# show subsys license ipbase
http://www.cisco.com/c/en/us/td/docs/ios/12_2/12_2se/feature/guide/se_cisl.html#wp1063894 11/13
1/23/2015 Cisco IOS Software Licensing - Cisco
fib_ios_chain Pre-Driver 1.000.001
transceiver Pre-Driver 1.000.002
fib_ios_predriver Pre-Driver 1.000.001
license_client License 1.000.001
hulc_flash License 1.000.001
ios_licensing_image_application License 1.000.001
ifs License 1.000.001
sdb License 1.000.001
boot_upgrade License 1.000.001
hulc_universal_only License 1.000.001
Field Description
License Feature set for which the license is issued; for
level example, Advanced IP services, IP services,
or IP base.
Note Table 4 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.
Feature
Name Releases Feature Information
Cisco 12.2(35)SE2 This document describes CLI
IOS commands for managing
Software Cisco IOS software licenses
Licensing on Cisco Catalyst 3560E and
3750E switches.
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.
http://www.cisco.com/c/en/us/td/docs/ios/12_2/12_2se/feature/guide/se_cisl.html#wp1063894 12/13
1/23/2015 Cisco IOS Software Licensing - Cisco
Contacts | Feedback | Help | Site Map | Terms & Conditions | Privacy Statement | Cookie Policy | Trademarks
http://www.cisco.com/c/en/us/td/docs/ios/12_2/12_2se/feature/guide/se_cisl.html#wp1063894 13/13