 Feedback
|
Table Of Contents
Software Entitlement Commands on Cisco IOS XR Software
hw-module linecard throughput (Cisco XR 12000 Series Router)
hw-module linecard throughput (CRS-1)
show hw-module linecard throughput
Software Entitlement Commands on Cisco IOS XR Software
For detailed information about software entitlement concepts, configuration tasks, and examples, refer to the Software Entitlement on Cisco IOS XR Software module in Cisco IOS XR System Management Configuration Guide.
clear license
To delete all licenses from the router persistent storage, use the clear license command in administration EXEC mode.
clear license
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Administration EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The clear license command removes all licenses from the router persistent storage.
Task ID
Examples
In the following example, all licenses are removed from the router:
RP/0/RP0/CPU0:router# adminRP/0/RP0/CPU0:router(admin)# clear licenseclear license log
To clear the operational or administrative logs for the license system, use the clear license log command in administration EXEC mode.
clear license log {operational | administration}
Syntax Description
operational
Clears the operational logs for the license system.
administration
Clears the administration logs for the license system.
Defaults
No default behavior or values
Command Modes
Administration EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the clear license log command to clear either the operational or administrative logs for the license system. To view the logs, use the show license log command. The license log does not persist between reloads.
Task ID
Examples
The following example illustrates how to use the clear license log command to clear the operational logs:
RP/0/0/CPU0:router# adminRP/0/0/CPU0:router(admin)# clear license log operationalRelated Commands
hw-module linecard throughput (Cisco XR 12000 Series Router)
To configure the throughput for a Cisco XR 12000 SIP-401 or Cisco XR 12000 SIP-501, use the hw-module linecard throughput command in global configuration mode. To revert to the default linecard throughput, use the no form of this command.
hw-module linecard throughput location node-id throughput
no hw-module linecard throughput location node-id
Syntax Description
location node-id
Specifies the node to configure. The node-id argument is expressed in rack/slot/module notation.
throughput
Specifies the throughput, in Gbps, at which the SIP should operate.
Defaults
The default throughput for the Cisco XR 12000 SIP-501 is 5 Gbps.
The default throughput for the Cisco XR 12000 SIP-401 is 2.5 Gbps.Command Modes
Global configuration
Command History
Release 3.6.0
This command was introduced on the Cisco XR 12000 Series Router.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The default throughput for the Cisco XR 12000 SIP-401 is 2.5 Gbps; for the Cisco XR 12000 SIP-501 is 5 Gbps. To raise the allowable throughput of your SIP to a maximum of 10 Gbps, you must have an available license on the router, and use the hw-module linecard throughput command.
You can configure a Cisco XR 12000 SIP-401 to run at 5 Gbps, using a single 2.5 G to 5 G license. You can configure the Cisco XR 12000 SIP-401 to run at 10 Gbps, using a single 2.5 G to 10 G license, or using a 2.5 G to 5 G license together with a 5 G to 10 G license. A Cisco XR 12000 SIP-501 can be configured to run at 10 Gbps, using a single 5 G to 10 G license. A Cisco XR 12000 SIP cannot be configured to run at a rate less than its default rate.
You should install permanent licenses for all SIPs that you want to operate at an increased throughput. Refer to the Software Entitlement on Cisco IOS XR Software module in Cisco IOS XR System Management Configuration Guide.
Task ID
Examples
The following example shows how to configure a SIP to operate at 10 Gbps:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# hw-module linecard throughput location 0/6/CPU0 10gRelated Commands
hw-module linecard throughput (CRS-1)
To configure the throughput for a modular services card (MSC), use the hw-module linecard throughput command in global configuration mode. To revert to the default throughput, use the no form of this command.
hw-module linecard throughput {20g | 40g} location node-id
no hw-module linecard throughput {20g | 40g} location node-id
Syntax Description
20g | 40g
Specifies whether the node should operate at 40 Gbps or 20 Gbps.
location node-id
Specifies the node to configure. The node-id argument is expressed in rack/slot/module notation.
Defaults
The default throughput is 20 Gbps.
Command Modes
Global configuration
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The default throughput is 20 Gbps. If you upgrade your release from one that does not support software entitlement to one that does, and you have MSCs in your router operating at 40 Gbps, an implicit license is added to your router so that you can continue to operate at 40 Gbps for a limited period of time. You must, however, use the hw-module linecard throughput command to enable the MSC thoughput to 40 Gbps. Otherwise, your cards continue to operate at 20 Gbps.
Implicit licenses expire after a set period of time. You should install permanent licenses for all MSCs that you want to operate at 40 Gbps. Refer to the Software Entitlement on Cisco IOS XR Software module in Cisco IOS XR System Management Configuration Guide.
Task ID
Examples
The following example shows how to configure a node to operate at 40 Gbps:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# hw-module linecard throughput 40 location 0/6/0Related Commands
license add
To add a license to a secure domain router (SDR) license pool, use the license add command in administration EXEC mode.
license add license-name [sdr sdr-name]
Syntax Description
Defaults
License is added to the owner SDR.
Command Modes
Administration EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the license add command to add a license to an SDR license pool. The license file can be local to the system or a remote file on a TFTP server. The license file is stored in persistent storage on the router.
To acquire a license file, you must provide a manufacturing supplied product authorization key (PAK) and the license unique device identifier (UDI) of the chassis to the license registration tool located at the following URL: https://tools.cisco.com/SWIFT/Licensing/RegistrationServlet. To obtain the UDI of your chassis, use the show license udi command.
By default, there is one license pool available. You can create specific license pools using the license pool create command. If a license is available for a specific SDR license pool, it cannot be used in another SDR, unless it is moved from one SDR license pool to another. Use the license move command.
Task ID
Examples
In the following example, a software license is added to the owner SDR:
RP/0/RP0/CPU0:router# adminRP/0/RP0/CPU0:router(admin)# license add disk1:/P1-CRS-8_TBA09370035_ 20070207195224661.licLicense command "license add disk1:/P1-CRS-8_TBA09370035_20070207195224661.lic sdr Owner" completed successfully.Related Commands
license backup
To back up all licenses contained on the persistent storage of the router, use the license backup command in administration EXEC mode.
license backup backup-file
Syntax Description
backup-file
Name and location of the backup file to be created or modified. This can be a local file, or a remote file on a TFTP or rcp server.
Defaults
No default behavior or values
Command Modes
Administration EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the license backup command to back up the licenses stored in the persistent storage on the router. We recommend this so that you can restore the licenses at one time while recovering from a failed disk situation. The destination location can be local to the system; in other words, a flash disk or hard disk. Alternatively, it can be a remote file on a TFTP or rcp server. The license information includes the licenses as well as the operational information, such as the slot the licenses are allocated to and the current license operation identifier.
If the backup file already exists, you are prompted to confirm before the file is overwritten.
When licenses are backed up, they can be restored as required using the license restore command.
Task ID
Examples
The following example shows how to back up the licenses on a router:
RP/0/0/CPU0:router# adminRP/0/RP0/CPU0:router(admin)# license backup disk1:/license_backLicense command "license backup disk1:/license_back" completed successfully.Related Commands
Restores licenses on the router from a previously created backup file.
Displays the backup license file.
license move
To move a license from one secure domain router (SDR) license pool to another, use the license move command in administration EXEC mode.
license move feature-id {all | count} sdr source-sdr-name sdr dest-sdr-name
Syntax Description
feature-id
Identifier for the feature entitled in the licenses to be moved. You can display available licenses using the show license command.
all
Specifies to move all available licenses with the specific feature identifier.
count
Number of licenses to move.
sdr source-sdr-name
Specifies the SDR license pool from which to move the specified licenses. The source-sdr-name argument is the name assigned to the SDR.
sdr dest-sdr-name
Specifies the SDR license pool to which the license should be moved. The source-sdr-name argument is the name assigned to the SDR.
Defaults
No default behavior or values
Command Modes
Administration EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
By default, there is only one license pool available. If you have created multiple license pools, you can use the license move command to move the license to a different SDR license pool.
The license move command is used only to move licenses between SDR license pools on the same router. To move licenses between routers, you must first remove the license from the original router using the license remove command, and then add it to the new router using the license add command. To move licenses between routers, you also need to generate a new license key on Cisco.com. The license registration tool is located at the following URL: https://tools.cisco.com/SWIFT/Licensing/RegistrationServlet.
Licenses can be moved only if they are in the available state. In other words, you have to clear the feature configuration before a license can be released back to the appropriate license pool.
Task ID
Examples
The following example shows how to move a license from one license pool to another:
RP/0/0/CPU0:router# adminRP/0/0/CPU0:router(admin)# license move crs-msc-40g sdr owner sdr mysdrRelated Commands
Adds a license to a secure domain router (SDR) license pool.
Displays all licenses on the router.
license move slot
To move a license from one slot to another, use the license move slot command in EXEC or administration EXEC mode.
license move feature-id slot [count] from {node-id | allocated} to {node-id | available}
Syntax Description
feature-id
Identifier for the feature entitled in the licenses to be moved. You can display available licenses using the show license command.
count
Number of licenses to move. This argument cannot be used in conjunction with the allocated and available keywords.
from
Specifies from where to move the specified licenses.
node-id
Specific node from which to move the license.
allocated
Specifies to move all allocated licenses with the specific feature identifier. This keyword must be used in conjunction with the available keyword.
to
Specifies to where to move the specified licenses.
node-id
Specific node to which to move the license.
available
Specifies to move the specified allocated licenses into the available state. This keyword must be used in conjunction with the allocated keyword.
Defaults
One license is moved.
Command Modes
Administration EXEC
EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
Support was added for EXEC mode.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The license move slot command moves slot-based licenses from one slot to another slot on the same router.
Use the allocated keyword to move all allocated licenses into the available state. The allocated keyword must be used in conjunction with the available keyword. If no allocated licenses are available that match the feature identifier, the license move slot command revokes used licenses on the given slot.
If licenses are going to be revoked on the source card, a warning prompt is displayed.
Licenses can be moved only if they are in the available state. In other words, you have to clear the feature configuration before a license can be released back to the appropriate license pool.
Task ID
Examples
The following example shows how to move a license from one slot to another:
RP/0/0/CPU0:router# adminRP/0/0/CPU0:router(admin)# license move crs-msc-40g slot 1 from 0/1/cpu0 to 0/4/cpu0The following example shows how to move all licenses to the available state:
RP/0/0/CPU0:router# adminRP/0/0/CPU0:router(admin)# license move crs-msc-40g slot from allocated to availableRelated Commands
Adds a license to a secure domain router (SDR) license pool.
Displays all licenses on the router.
license pool create
To create a new secure domain router (SDR) license pool, use the license pool create command in administration EXEC mode.
license pool create sdr sdr-name
Syntax Description
sdr sdr-name
Creates a license pool on the specified SDR. The sdr-name argument is the name assigned to the SDR.
Defaults
No default behavior or values
Command Modes
Administration EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Before the license pool create command can be used, the SDR must exist.
By default, there is only one license pool available. You can create a license pool for each SDR on the router. If there were any licenses in use on nodes in the SDR prior to creating the pool, the licenses are automatically moved to the newly created license pool.
When a license is associated with a specific SDR license pool, you cannot use it for entitlement on another SDR. To move a license from one license pool to another, use the license move command. Use the license add command to add licenses to the newly created license pool.
To remove an SDR license pool, use the license pool remove command.
Task ID
Examples
The following example shows how to create a new license pool for an SDR:
RP/0/0/CPU0:router# adminRP/0/0/CPU0:router(admin)# license pool create sdr mysdrLicense command "license pool create mysdr" completed successfully.Related Commands
Adds a license to a secure domain router (SDR) license pool.
Moves a license from one SDR license pool to another.
Removes an SDR license pool.
license pool remove
To remove a secure domain router (SDR) license pool, use the license pool remove command in administration EXEC mode.
license pool remove sdr sdr-name
Syntax Description
sdr sdr-name
Creates a license pool on the SDR specified by sdr-name. The sdr-name argument is the name assigned to the SDR.
Defaults
No default behavior or values
Command Modes
Administration EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
By default, there is only one license pool available. If you have created multiple license pools, you can use the license pool remove command to remove them as desired. You cannot remove the default license pool in the owner SDR.
If you remove a license pool that contains licenses, the licenses are automatically returned to the owner SDR license pool.
Task ID
Examples
The following example shows how to remove an SDR license pool:
RP/0/0/CPU0:router# adminRP/0/0/CPU0:router(admin)# license pool remove sdr mysdrLicense command "license pool remove sdr mysdr" completed successfully.Related Commands
license restore
To restore the licenses on a router using an earlier backup copy, use the license restore command in administration EXEC mode.
license restore backup-file
Syntax Description
backup-file
Name and location of the backup file to be used for the license restore. This can be a local file, or a remote file on a TFTP or rcp server.
Defaults
No default behavior or values
Command Modes
Administration EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The license restore command restores the licenses on the router using an earlier backup copy that was created using the license backup command. The source location can be local to the system, in other words, a flash disk or hard disk. Alternatively, it can be a remote file on a TFTP or rcp server.
Before the licenses are restored, the license manager verifies the following:
•
The backup format is valid.
•
•
Task ID
Examples
The following example shows how to move a license from one license pool to another:
RP/0/0/CPU0:router# adminRP/0/RP0/CPU0:router(admin)# license restore disk1:/license_backInfo: This command will erase all existing licenses.Info: It is strongly recommended to backup existing licenses first.Do you wish to proceed? [yes/no]: yLicense command "license restore disk1:/license_back" completed successfully.Related Commands
show hw-module linecard throughput
To display the throughput of modular services cards (MSCs) in the Cisco CRS-1 router, or SPA interface processors (SIPs) in the Cisco XR 12000 Series Router, use the show hw-module linecard throughput command in EXEC mode.
show hw-module linecard throughput [location node-id]
Syntax Description
location node-id
Specifies the node for which to display the throughput. The node-id argument is expressed in rack/slot/module notation.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1.
Release 3.6.0
This command was first supported on the Cisco XR 12000 Series Router.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the show hw-module linecard throughput command on the Cisco CRS-1 to determine if MSCs are running at 40 Gbps or 20 Gbps throughput. Use the show hw-module linecard throughput command on the Cisco XR 12000 Series Router to determine at what throughput SIPs are operating.
Task ID
Examples
The following example displays sample output from the show linecard throughput command on the Cisco CRS-1:
RP/0/RP0/CPU0:router# show hw-module linecard throughput-------------------- Throughput --------------------Location Configured Lic Acquired Operating0/6/CPU0 no config No 20G0/1/CPU0 no config Yes 40GThe following example displays sample output from the show linecard throughput command on the Cisco XR 12000 Series Router:
RP/0/0/CPU0:router# show hw-module linecard throughput--------------------- Throughput ----------------------Location Lic Acquired Operating Configured Default0/4/CPU0 No 10G -- 10G0/2/CPU0 No 10G -- 10G0/3/CPU0 Yes 10G 10G 2.5G0/1/CPU0 Yes 5G 5G 2.5G0/5/CPU0 Yes 10G 10G 5G0/6/CPU0 No 2.5G -- 2.5G0/7/CPU0 No 5G -- 5GTable 23 describes the significant fields shown in the display.
Related Commands
hw-module linecard throughput (Cisco XR 12000 Series Router)
Configures a SPA interface processor (SIP) card to operate at either 5 Gbps or 10 Gbps.
Configures a modular services card (MSC) to operate at either 20 Gbps or 40 Gbps.
show license
To display all license information, use the show license command in EXEC or administration EXEC mode.
show license [feature-id | location node-id | sdr sdr-name]
Syntax Description
Defaults
No default behavior or values
Command Modes
Administration EXEC
EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
Support was added for EXEC mode.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The show license command displays all license information. Alternatively, you can display license information for a specific feature identifier, slot location, or SDR by using the available options.
If the feature process has supplied an opaque string while checking out the license, that string is displayed next to the feature identifier in the command output.
Task ID
Examples
The following example displays sample output from the show license command:
RP/0/0/CPU0:router# adminRP/0/0/CPU0:router(admin)# show licenseFeatureID: CRS-MSC-40G (Slot based, Implicit[Remaining time: 81 days])Total licenses 2Available for use 0Allocated to location 2Active 0Pool: OwnerTotal licenses in pool: 2Status: Available 0 Operational: 2Locations with licenses: (Active/Allocated) [SDR]0/0/CPU0 (0/1) [Owner]0/1/CPU0 (0/1) [Owner]Table 24 describes the significant fields shown in the display.
show license active
To display license information for all licenses that are currently checked out or being used by an application, use the show license active command in EXEC or administration EXEC mode.
show license active [feature-id | location node-id | sdr sdr-name]
Syntax Description
Defaults
No default behavior or values
Command Modes
Administration EXEC
EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
Support was added for EXEC mode.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The show license active command displays all license information regarding licenses that are currently checked out or being used by an application. You can display the information for a specific feature identifier, slot location, or SDR by using the available options.
Task ID
Examples
The following example displays sample output from the show license active command:
RP/0/0/CPU0:router# adminRP/0/0/CPU0:router(admin)# show license activeFeatureID: CRS-MSC-40G (Slot based, Implicit[Remaining time: 90 days])Status: Active 2SDR: OwnerOperational: 2Location: 0/1/CPU0 10/6/CPU0 1See Table 24 for a description of the significant fields shown in the display.
show license allocated
To display license information for all licenses allocated to a slot but not used, use the show license allocated command in EXEC or administration EXEC mode.
show license allocated [feature-id | location node-id | sdr sdr-name]
Syntax Description
Defaults
No default behavior or values
Command Modes
Administration EXEC
EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
Support was added for EXEC mode.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The show license allocated command displays all license information regarding licenses that are allocated to a slot but are not currently being used. You can display the information for a specific feature identifier, slot location, or SDR by using the available options.
Task ID
Examples
The following example displays sample output from the show license allocated command:
RP/0/0/CPU0:router# adminRP/0/0/CPU0:router(admin)# show license allocatedFeatureID: CRS-MSC-40G (Slot based, Permanent)Status: Allocated 1SDR: OwnerStatus: Operational: 1Locations with licenses: (Active/Allocated)0/1/CPU0 (0/1)FeatureID: XC-L3VPN (Slot based, Permanent)No allocated licenses.See Table 24 for a description of the significant fields shown in the display.
show license available
To display all licenses that are not currently in use or allocated to specific slots, use the show license available command in EXEC or administration EXEC mode.
show license available {feature-id | location node-id | sdr sdr-name}
Syntax Description
Defaults
No default behavior or values
Command Modes
Administration EXEC
EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
Support was added for EXEC mode.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The show license available command displays all licenses that currently are not being used or allocated to a specific slot. You can display only licenses with a specific feature identifier, slot location, or SDR by using the available options.
Task ID
Examples
The following example displays sample output from the show license available command with only implicit licenses available:
RP/0/0/CPU0:router# adminRP/0/0/CPU0:router(admin)# show license availableFeatureID: CRS-MSC-40G (Slot based, Implicit[Remaining time: 90 days])Status: Available 0SDR: OwnerStatus: Available 0Location: 0/1/CPU0 10/6/CPU0 1The following example displays sample output from the show license available command with permanent licenses installed:
RP/0/0/CPU0:router# adminRP/0/0/CPU0:router(admin)# show license availableFeatureID: CRS-MSC-40G (Slot based, Permanent)Status: Available 7SDR: OwnerStatus: Available 7FeatureID: XC-L3VPN (Slot based, Permanent)Status: Available 8SDR: OwnerStatus: Available 8See Table 24 for a description of the significant fields shown in the display.
show license backup
To display the backup license file, use the show license backup command in administration EXEC mode.
show license backup file-name
Syntax Description
Defaults
No default behavior or values
Command Modes
Administration EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The show license backup command displays the UDI information and license summary of a backup database, so that you can confirm the contents of a particular backup file before restoring it. Create the backup license file using the license backup command. Restore licenses from a backup using the license restore command.
Task ID
Examples
The following example displays sample output from the show license evaluation command:
RP/0/0/CPU0:router# adminRP/0/0/CPU0:router(admin)# show license backup disk1:/license_backLocal Chassis UDI Information:S/N : TBA09370035Operation ID: 5Licenses :FeatureID Type #installedCRS-MSC-40G Slot based, Permanent 2XC-L3VPN Slot based, Permanent 1Table 25 describes the significant fields shown in the display.
Related Commands
Backs up all licenses contained on the persistent storage of the router.
Restores licenses on the router from a previously created backup file.
show license evaluation
To display information about any evaluation licenses currently allocated, available, or in use, use the show license evaluation command in EXEC or administration EXEC mode.
show license evaluation [feature-id | location node-id | sdr sdr-name]
Syntax Description
Defaults
No default behavior or values
Command Modes
Administration EXEC
EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
Support was added for EXEC mode.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The show license evaluation command displays information regarding any evaluation licenses that are currently allocated, available, or in use, including the number of days left until they expire. You can display the information for a specific feature identifier, slot location, or SDR by using the available options.
Task ID
Examples
The following example displays sample output from the show license evaluation command:
RP/0/0/CPU0:router# adminRP/0/0/CPU0:router(admin)# show license evaluationFeatureID: XC-L3VPN (Non slot based, Evaluation[Valid])Valid for 2day(s) from 15:13:16 Nov 17 2006Remaining time: 1day(s) 21:07:46Status: Available 6 Allocated 0 Active 0SDR: OwnerStatus: Available 6 Operational: 0See Table 24 for a description of the significant fields shown in the display.
show license expired
To display information regarding evaluation licenses that have expired, use the show license expired command in EXEC or administration EXEC mode.
show license expired [feature-id | location node-id | sdr sdr-name]
Syntax Description
Defaults
No default behavior or values
Command Modes
Administration EXEC
EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
Support was added for EXEC mode.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The show license expired command displays information regarding evaluation licenses that have expired. You can display the information for a specific feature identifier, slot location, or SDR by using the available options.
Task ID
Examples
The following example displays sample output from the show license expired command:
RP/0/0/CPU0:router# adminRP/0/0/CPU0:router(admin)# show license expiredFeatureID: XC-L3VPN (Non slot based, Evaluation[Expired])Status: Available 6 Allocated 0 Active 0SDR: OwnerStatus: Available 6 Operational: 0See Table 24 for a description of the significant fields shown in the display.
show license log
To display the operational or administrative logs for the license system, use the show license log command in EXEC or administration EXEC mode.
show license log {operational | administration} {request-id | feature-id | sdr sdr-name}
Syntax Description
Defaults
No default behavior or values
Command Modes
Administration EXEC
EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
Support was added for EXEC mode.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The show license log command displays the operational or administrative logs for the license system. The administrative log displays all licenses that are added, removed, or moved along with a timestamp and username of the person who initiated the request. This log persists across reloads. The operation log displays when a license was checked out or released by a feature. The license release can be done by the license manager if it detects that the feature is not responding. This log does not persist between reloads.
You can display license information for a specific feature identifier or SDR by using the available options.
Task ID
Examples
The following example displays sample output from the show license log command:
RP/0/0/CPU0:router# adminRP/0/0/CPU0:router(admin)# show license log operational#ID :SDR :FeatureID :NodeID :Time: Log1 :Owner :CRS-MSC-40G :0/6/CPU0 :Tue Feb 6 21:33:16 2007: license_acquire: opaque_string , result(No error)2 :Owner :CRS-MSC-40G :0/1/CPU0 :Tue Feb 6 21:33:16 2007: license_acquire: opaque_string , result(No error)See Table 24 for a description of the significant fields shown in the display.
show license pools
To display the currently configured set of license pools, use the show license pools command in administration EXEC mode.
show license pools [detail]
Syntax Description
Defaults
No default behavior or values
Command Modes
Administration EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The show license pools command displays all license pools, and the features that are enabled with the licenses in each pool. By default, all licenses are contained in the owner SDR pool. If you have created SDR license pools with the license pool create command, you can place licenses in separate pools.
Task ID
Examples
The following example displays sample output from the show license pools command. In this example, the owner SDR has both 40-Gbps and Layer_3 VPN licenses, while the SDR sdr2 has only 40-Gbps licenses.
RP/0/0/CPU0:router# adminRP/0/0/CPU0:router(admin)# show license poolsPool Name Feature==============================================Owner CRS-MSC-40G XC-L3VPNsdr2 CRS-MSC-40GTable 26 describes the significant fields shown in the display.
Table 26 show license pools Field Descriptions
Owner
SDR license pool.
Feature
Feature that is enabled in the specified license pool.
Related Commands
show license udi
To display unique device identifier (UDI) information for the router, use the show license udi command in administration EXEC mode.
show license udi
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Administration EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The show license udi command displays the complete UDI of the router to which any license will be associated. The UDI comprises the chassis serial number, along with a license operation ID number. The UDI is used to acquire a license file using the license registration tool on CCO. The license tool is located at the following URL: https://tools.cisco.com/SWIFT/Licensing/RegistrationServlet.
Task ID
Examples
The following example displays sample output from the show license udi command:
RP/0/0/CPU0:router# adminRP/0/0/CPU0:router(admin)# show license udiLocal Chassis UDI Information:PID : CRS-8-LCCS/N : TBA09370035Operation ID: 1Table 27 describes the significant fields shown in the display.