To enable controlled Cisco IOS software license debugging activity on a device, use the
debug license command in privileged EXEC mode. To disable debugging, use the
no form of this command.
debug license {agent {all | error} | core {all | errors | events} | errors | events | ipc}
no debug license {agent {all | error} | core {all | errors | events} | errors | events | ipc}
Cisco ASR 903 Router Platforms
debug license {agent {all | errors} | core {all | errors | events} | errors | events | feature atm | ipc}
no debug license {agent {all | errors} | core {all | errors | events} | errors | events | feature atm | ipc}
Cisco ASR 1001 Router Platforms
debug license {core {all | errors | events} | errors | ipc}
no debug license {core {all | errors | events} | errors | ipc}
Syntax Description
agent
|
Debugs license agent information.
|
core
|
Debugs messages from a license core module.
-
all --Debugs all license core messages.
-
errors --Debugs only license core error messages.
-
events --Debugs only license core event messages.
|
errors
|
Debugs license warnings and errors.
|
events
|
Debugs license event messages.
|
feature atm
|
Debugs the ATM feature license.
|
ipc
|
Debugs license interprocess communication (IPC) messages.
|
Command Default
Debugging is disabled.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(35)SE2
|
This command was introduced.
|
12.4(15)XZ
|
This command was integrated into Cisco IOS Release 12.4(15)XZ.
|
12.4(20)T
|
This command was integrated into Cisco IOS Release 12.4(20)T.
|
Cisco IOS XE Release 3.2S
|
This command was integrated into Cisco IOS XE Release 3.2S and implemented on the Cisco ASR 1001 router.
|
Cisco IOS XE Release 3.5S
|
This command was modified. The
feature atm keywords were added for the Cisco ASR 903 router.
|
Usage Guidelines
Use this command to help troubleshoot issues with licenses on a device.
On the Cisco ASR 1001 router, the output from the
debug license command is not in standard IOS format. You must execute the
request platform software trace rotate all privileged EXEC command to make the output in the log files in the bootflash:tracelogs directory.
Examples
The following example shows how to enable debugging for license warnings and errors on a router:
Router# debug license errors
License warnings and errors debugging is on
The following example shows how to enable debugging for all license agent information on a switch:
Switch# debug license agent all
license agent app https[0x43FBC7C]: urlhook function
license agent app https[0x43FBC7C]: https action function
LIC_AGENT:Processing XML message
<?xml version="1.0" encoding="UTF-8"?>
<SOAP:Envelope xmlns:SOAP="http://www.w3.org/2003/05/soap-envelope">
<SOAP:Header>
<clm:Header version="1.0" xmlns:clm="http://www.cisco.com/clm">
<clm:Time>2003-04-23T20:27:19.827Z</clm:Time>
</clm:Header>
</SOAP:Header>
<SOAP:Body>
<lica:request xmlns:lica="http://www.cisco.com/clm">
<lica:installRequest>
<lica:license encoding="BASE64">
PENJU0NPX1dUX0FSVElGQUNUUyB2ZXJzaW9uPSIxLjAiPjxDSVNDT19XVF9MSUNFTlNFIHZlcnNp
b249IjEuMCI+PEZFQVRVUkVfTkFNRT5pcGJhc2U8L0ZFQVRVUkVfTkFNRT48RkVBVFVSRV9WRVJT
SU9OPjEuMDwvRkVBVFVSRV9WRVJTSU9OPjxVREk+PFBJRD5CVUxMU0VZRTI0PC9QSUQ+PFNOPkNB
VDEwMDZSMEU4PC9TTj48L1VEST48U09VUkNFPkNpc2NvIEhRPC9TT1VSQ0U+PENSRUFURV9EQVRF
PjIwMDYtMTEtMjJUMDA6MzM6NTA8L0NSRUFURV9EQVRFPjxMSUNFTlNFX0xJTkVfSEFTSCBoYXNo
QWxnbz0iU0hBMSI+NDJiNFVWWFpOd3pJK0ZNdEV6QlNZSDRWdzFFPTwvTElDRU5TRV9MSU5FX0hB
U0g+PFRZUEU+UkVHVUxBUjwvVFlQRT48TElDRU5TRV9MSU5FPjwhW0NEQVRBWzExIGlwYmFzZSAx
LjAgTE9ORyBOT1JNQUwgU1RBTkRBTE9ORSBFWENMIElORklOSVRFX0tFWVMgSU5GSU5JVEVfS0VZ
UyBORVZFUiBORVZFUiBOaUwgU0xNX0NPREUgQ0xfTkRfTENLIE5pTCAqMVZBUlY5WlJESzREOU5U
NDAwIE5pTCBOaUwgTmlMIDVfTUlOUyA8VURJPjxQSUQ+QlVMTFNFWUUyNDwvUElEPjxTTj5DQVQx
MDA2UjBFODwvU04+PC9VREk+IGUxWW8wS1U2VnJLOnBJZXRib1dJVkEyZlVaVGdieUlEaklHWERR
VXc3dkxOYWlXRzZ0dUJOMG5lTXpKaHpzQ2tMN1l3TWFxS2paem05YW5FbVJHUUVPTHlDdmRVZksw
QmNLN0pPcnZsUkw0VjMyJDxXTEM+QVFFQklRQUIvLy9GbS8vWDkybThNb0NOZkVMSHJiVzRjWDFM
ZGNpdDNMVU5GWlV1OWppT0phcXB5Q2N6TTFpaUlKbVE3NEd5WHJFY3F2UGlBbVdTYUVtVVQ1NnJz
dGs2Z3ZtaitFUUtSZkQ5QTBpbWUxY3pyZEt4ZklMVDBMYVhUNDE2bndtZnA5MlR5YTZ2SVE0Rm5s
QmRxSjFzTXpYZVNxOFBtVmNUVTlBNG85aGlsOXZLdXI4TjlGODg1RDlHVkYwYkpIY2lUNU09PC9X
TEM+XV0+PC9MSUNFTlNFX0xJTkU+PFVTRVJfTU9ESUZJQUJMRV9DT01NRU5UIGZpZWxkUmVzdHJp
Y3Rpb25zPSJNYXggOTkgQVNDSUkgY2hhcmFjdGVycyBpbiBsZW5ndGguIj48L1VTRVJfTU9ESUZJ
QUJMRV9DT01NRU5UPjwvQ0lTQ09fV1RfTElDRU5TRT48L0NJU0NPX1dUX0FSVElGQUNUUz4=
</lica:license>
</lica:installRequest>
</lica:request>
</SOAP:Body>
</SOAP:Envelope>
LIC_AGENT: XML received opcode(1)
LIC_AGENT: License ipbase
%IOS_LICENSE_IMAGE_APPLICATION-6-LICENSE_LEVEL: Next reboot level = ipbase and License = ipbase
LIC_AGENT: Notification Event type = 1 License Installed
LIC_AGENT: Notification Event type = 13 License Annotate