Cisco IOS XR software contains all the supported features for a given release. Before the introduction of software entitlement on Cisco IOS XR software, you could freely activate all available software packages on your network devices and could enable all the bundled features. To enable the pay-as-you-grow model—where you pay only for the features that you need today—but can upgrade when necessary while keeping your investment safe, software entitlement has been introduced. Licensing enables you to purchase individual software features and upgrade hardware capacity in a safe and reliable way.
For complete descriptions of the commands listed in this module, see Related Documents. To locate documentation for other commands that might appear in the course of performing a configuration task, search online in Cisco IOS XR Commands Master List for the Cisco XR 12000 Series Router.
Table 1 Feature History for Software Entitlement
The software entitlement feature was introduced.
Support for the following features was added to software entitlement:
Prerequisites for Configuring Software Entitlement
You must be in a user group associated with a task group that includes the proper task IDs. The command reference guides include the task IDs required for each command. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Restrictions for Cisco IOS XR Software Entitlement
The following features may not work as expected unless the appropriate licenses are installed:
Cisco XR 12000 SIP-401 bandwidth
Cisco XR 12000 SIP-501 bandwidth
Cisco XR 12000 SIP-601 bandwidth
If you configure and remove VRFs after installing the license, any VRFs configured prior to installing the license are not recognized. You need to reconfigure these VRFs.
Information About Cisco IOS XR Software Entitlement
To configure process placement policies, you need to understand the concepts described in this module.
Software entitlement is a system that consists of a license manager on a Cisco IOS XR device that manages licenses for various software and hardware features. The license manager parses and authenticates a license before accepting it. The software features on the router use the license manager APIs to check out and release licenses. Licenses are stored in persistent storage on the router.
Core routing features are available for use without any license. The following features can be enabled on your router using licenses:
Throughput on Cisco XR 12000 SIP
By default, Cisco XR 12000 SIPs operate at either 2.5 Gbps or 5 Gbps. To increase the throughput from 2.5 Gbps to 5 Gbps a 2.5 G to 10 G license must be available. To increase the throughput from 5 Gbps to 10 Gbps, a 5 G to 10 G license must be available. In addition, you must use the hw-module linecard throughput command once a license is available.
The following types of licenses are currently defined:
Permanent licenses—Licenses that enable a designated feature permanently, as long as the license resides on the router.
Evaluation or metered licenses—Licenses that enable a feature for a limited period of time. The feature stops working immediately on license expiry. If multiple evaluation licenses are added for the same feature, the expiry period is counted from when the first evaluation license is added to the router.
Implicit evaluation licenses—Set of evaluation licenses that are included with the software image (upgrade or initial install). Like regular evaluation licenses, these are valid for a period of ninety days, but the countdown to expiry starts as soon as the router is booted with an image containing these licenses.
SDR License Pools
License pools are maintained according to secure domain router (SDR). By default, all added licenses are allocated to the owner SDR license pool, and they can be freely allocated to any slot in any SDR. Features on cards belonging to the owner SDR are granted licenses based on availability in the owner SDR license pool.
You can create SDR-specific license pools by using the licensepoolcreate command. License requests for features running on cards belonging to SDRs with SDR-specific pools are not served from the owner license pool, even if the owner SDR license pool has licenses available. You must allocate licenses from the owner SDR to other SDRs explicitly for these license requests to succeed. Similarly, if a slot in the owner SDR had a feature license and subsequently was moved to some other SDR with an SDR-specific license pool, the feature license stays with the original SDR license pool.
You can explicitly add new licenses to a particular SDR license pool or move available licenses from the owner SDR license pool to any other SDR.
Licenses are locked to a unique device identifier (UDI). The UDI is comprised of the chassis serial number, along with a license operation ID number. The license operation ID is incremented by the license manager every time there is a successful license add or remove operation. The complete set of UDI information can be displayed using the showlicenseudi command. The license manager parses the user-provided license and verifies that it is valid for the chassis it is running on and determines if the license is being readded.
Feature licenses are allocated to router slots and not cards. Therefore, if a card is replaced, the existing license is applied to the newly inserted card. For example, if you have eight licenses for Layer 3 VPN in the system, you can configure Layer 3 VPN features on any eight cards in an SDR , and the licenses are allocated to the slots within which the cards are installed. If a card is removed from one of these licensed slots, say slot 3, and entered into an empty slot with no license, say slot 5, the license remains with slot 3 and the feature cannot be activated on slot 5 with the permanent license entered earlier by the user. In this case, you can release the license to the appropriate license pool by removing the configuration of the card (while it is inserted), or by using the licensemoveslot command. When you configure the feature on slot 5, the license is checked out.
Using Implicit Licenses After a Software Image Upgrade
When you upgrade your Cisco IOS XR software image from a release that does not support software entitlement to one that does, you are provided with implicit licenses to use for all configured features in your original configuration. This enables you to upgrade your software without worrying about the implications of software entitlement.
Implicit licenses are good for a period of 90 days. As soon as the new image boots, the license manager displays a syslog message to the console once a day, indicating that an implicit license is being used and must be replaced with a permanent license. This frequency increases to once an hour on the last day before the expiry of the implicit licenses, to ensure that you do not miss it.
Before your implicit licenses expire, you should purchase licenses for all features that you want to keep running.
How to Configure Cisco IOS XR Software Entitlement
Adding a License for a New Feature
This task describes how to acquire a permanent license for a feature that you have purchased or an evaluation license for a feature that you have arranged with your sales representative to try. Use this procedure to replace implicit or evaluation licenses with permanent licenses.
Evaluation licenses cannot be installed if permanent licenses for the same feature are valid on the chassis. Also note that if you add a permanent license to a chassis, all evaluation or implicit licenses of the same type are disabled.
Before You Begin
You must have purchased the feature for which you are adding the license. When you purchase the feature, you are provided with a product authorization key (PAK) that you use to download the license.
All implicit or evaluation licenses for a feature are disabled when at least one permanent license for a feature is added to the router. This is true even if you had more evaluation licenses than permanent licenses.
Go to the license tool on Cisco.com. You must log in to the site before you can access the license tool. Follow the instructions for product license registration. You are required to enter the feature PAK and the chassis UDI to acquire the license.
If you are installing a permanent license, you should have received the PAK when you purchased the feature. If you are installing an evaluation license, your sales representative should provide you with the PAK.
Copy the license to your TFTP server.
You will be issued a license. You can copy the license and store it on your computer, or alternatively, you can request that the license be sent to you in an e-mail. When you have received the license, copy it to a TFTP server that is accessible by your router.
Adds the license to the SDR license pool. By default, the license is added to the owner SDR license pool.
Exits administration EXEC mode.
What to Do Next
To use the feature associated with the added license, you must configure it on your router. To configure Layer 3 VPN, see the Implementing MPLS Layer 3 VPNs on Cisco IOS XR Software module in Cisco IOS XR MPLS Configuration Guide for the Cisco XR 12000 Series Router.
To verify that your Layer 3 VPN configuration is operational, use the showrsiinterfaceallglobal command.
Enabling 10-Gbps Throughput on a SIP
The default throughput for the Cisco XR 12000 SIP-401 is 2.5 Gbps; for the Cisco XR 12000 SIP-501 it is 5 Gbps. 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-400 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.
The Cisco XR 12000 SIP-601 operates at 10 Gbps throughput by default and does not require any additional configuration or license.
To configure a Cisco XR 12000 SPA interface processor (SIP) to operate at increased throughput, perform the following task. This must be performed when you add permanent licenses to your router or use implicit licenses.
When you upgrade your image from an image that does not support software entitlement to one that does, all existing SIPs default to their default throughput.
Before You Begin
You must have a license on your system for increased throughput to enable this feature. This could be an implicit license, evaluation license, or permanent license.
Enables 5-Gpbs or 10-Gbps throughput on the SIP in the specified node ID. If this command is not added to your configuration, the SIP continues to work at the default throughput, even if you have a valid license.
Use one of the following commands:
Saves configuration changes.
When you issue the end command, the system prompts you to commit changes:
Uncommitted changes found, commit them
before exiting(yes/no/cancel)? [cancel]:
Entering yes saves configuration changes to the running configuration file, exits the configuration session, and returns the router to EXEC mode.
Entering no exits the configuration session and returns the router to EXEC mode without committing the configuration changes.
Entering cancel leaves the router in the current configuration session without exiting or committing the configuration changes.
Use the commit command to save the configuration changes to the running configuration file and remain within the configuration session.
RP/0/0/CPU0:router# show hw-module linecard throughput
Displays the operational throughput of the line cards in the router.
The following example shows sample output from the showhw-modulelinecardthroughput command. In this example, the line cards in slots 1, 3, and 5 are configured to operate at increased throughput.
RP/0/0/CPU0:router# show hw-module linecard throughput
--------------------- Throughput ----------------------
Location Lic Acquired Operating Configured Default
0/4/CPU0 No 10G -- 10G
0/2/CPU0 No 10G -- 10G
0/3/CPU0 Yes 10G 10G 2.5G
0/1/CPU0 Yes 5G 5G 2.5G
0/5/CPU0 Yes 10G 10G 5G
0/6/CPU0 No 2.5G -- 2.5G
0/7/CPU0 No 5G -- 5G
Backing Up Licenses
When your router is configured with the licenses that you require, you should perform this task to back up all licenses. Backing up licenses makes it easier to restore them if there is a problem.
Restores all licenses on the router from a backup file in the specified location. This can be a local file, or a remote file on a TFTP or RCP server.
The following example shows sample output from the licenserestore command.
RP/0/0/CPU0:router(admin)# license restore disk1:/license_back
Info: This command will erase all existing licenses.
Info: It is strongly recommended to backup existing licenses first.
Do you wish to proceed? [yes/no]: y
License command "license restore disk1:/license_back" completed successfully.
Troubleshooting License Issues after a Software Upgrade
In the instance that you were running Cisco IOS XR Release 3.9.0 and had the optic feature enabled on a interface and the A9K-ADV-OPTIC-LIC license was active on a particular slot, when you upgrade to Cisco IOS XR Release 4.0.0, the A9K-ADV-OPTIC-LIC license is still active, but you may get the following warning message:
RP/0/RSP0/CPU0:Jul 27 14:22:22.594 : licmgr:
Feature associated to package A9K-ADV-OPTIC-LIC configured
on node 0/4/CPU0 without a valid license
To solve this issue, configure the license command in administration EXEC mode. This binds the A9K-ADV-OPTIC-LIC license to the slot on which you are using the license. For example:
No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.
The Cisco Technical Support website contains thousands of pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content.