Licensing

This feature module describes the licensing aspects of the Cisco ASR 901 Series Aggregation Services Router.

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the Feature Information for Licensing.

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

Feature Overview

The Cisco ASR 901 router license is similar to any other software license in Cisco. It is tied to the Unique Device Identifier (UDI) —where the license is integrated to the PID (Product Identifier) and SN (Serial Number). A license generated for one router cannot be shared or installed in any other router.

Complete these steps to obtain the license file:

  1. Purchase the required Product Authorization Key (PAK).
  2. Get the UDI from the device.
  3. Enter the UDI and PAK in the Cisco’s licensing portal.

You will receive a license file through email.

  1. Install the licenses on the device. For more information on how to install the license, see Installing the License.

In addition to using the router CLI, you can install the license using the Cisco License Manager (CLM) or the Callhome interface.

Licenses Supported on Cisco ASR 901 Router

The following licenses are supported:

Sl.No.

Chassis PID

License PID

License Description

License Type (Image or Feature)

1

A901-12C-FT-D

A901-12C-F-D

A901-4C-FT-D

A901-4C-F-D

A901-6CZ-FT-A

A901-6CZ-FT-D

A901-6CZ-F-A

A901-6CZ-F-D

A901-6CZ-FS-A

A901-6CZ-FS-D

SL-A901-A

AdvancedMetroIPAccess

Image

2

A901-12C-F-D

A901-12C-FT-D

A901-4C-FT-D

A901-4C-F-D

A901-6CZ-FT-A

A901-6CZ-FT-D

A901-6CZ-F-A

A901-6CZ-F-D

A901-6CZ-FS-A

A901-6CZ-FS-D

SL-A901-B

IPBase

Image (by default gets enabled)

3

A901-4C-FT-D

A901-4C-F-D

FLS-A901-4S

FLS-A901-4S= 1

L-FLS-A901-4S= 1

Gige4SfpUpgrade

Feature

4

A901-4C-FT-D

A901-4C-F-D

FLS-A901-4T

FLS-A901-4T= 1

L-FLS-A901-4T= 1

Gige4CuUpgrade

Feature

5

A901-6CZ-FT-A

A901-6CZ-FT-D

A901-6CZ-F-A

A901-6CZ-F-D

A901-6CZ-FS-A

A901-6CZ-FS-D

FLS-A901-2Z

FLS-A901-2Z= 1

L-FLS-A901-2Z= 1

10gigUpgrade

Feature

6

A901-6CZ-FT-A

A901-6CZ-FT-D

A901-6CZ-F-A

A901-6CZ-F-D

A901-6CZ-FS-A

A901-6CZ-FS-D

FLS-A901-4

FLS-A901-4= 1

L-FLS-A901-4= 1

Gige4portflexi

Feature

7

A901-12C-FT-D

A901-12C-F-D

A901-4C-FT-D

A901-4C-F-D

A901-6CZ-FT-A

A901-6CZ-FT-D

A901-6CZ-F-A

A901-6CZ-F-D

A901-6CZ-FS-A

A901-6CZ-FS-D

SL-A901-T

1588BC

Feature

8

A901-6CZ-FS-A

A901-6CZ-FS-D

SL-A901-I

SL-A901-I=

L-SL-A901-I=

IPsec

NAT

Feature

1 = variants are spares or represent the e-paper form.

The Cisco ASR 901 software uses the license description to resolve errors related to license availability. You need to map the proper license PID as per the table above and purchase the licenses. The Cisco ASR 901 router supports permanent licenses only.


Note

You can configure NAT and IPsec features on the router (A901-6CZ-FS-A and A901-6CZ-FS-D) without a valid license. The router issues a warning message and allows you to configure the feature. A warning message regarding the unlicensed feature is flashed every hour. However, this will not have any impact on the functionality.

You should install only a supported license for the proper chassis PID. You will get a “Not Supported” message while trying to install a wrong license. However, license installation process will go through and a confirmation message is displayed. When you run the show license command to display the details of this license, the output shows license state as “NOT IN USE”, and you cannot make it “IN USE”.

The following is a sample confirmation message that is displayed on the router when you try to install a wrong license.


Install FLS-A901-4S  license on A901-6CZ-F-A  (10g) boards,
Router# license install flash:CAT1625U0EP_201307231358341640.lic
Installing licenses from "flash:CAT1625U0EP_201307231358341640.lic" 
Installing...Feature:Gige4SfpUpgrade...Successful:Not Supported
1/1 licenses were successfully installed 
0/1 licenses were existing licenses
0/1 licenses were failed to install

License Types

Cisco ASR 901 router supports the following types of licenses:

  • Image Level License
  • Feature Based License

Image Level License

An Image level license corresponds to the level of the IOS image that comes up based on the licenses present on the router. This license is enforced while booting and it uses a universal image. It activates all the subsystems corresponding to the license that you purchased. Image based licenses (SL-A901-A and SL-A901-B) need rebooting of the router.

Features Supported

In Cisco ASR 901 , IPBase (SL-A901-B) and AdvancedMetroIPAccess (SL-A901-A) are permanent; once installed they do not expire. Trial or temporary licenses are not supported on the Cisco ASR 901 router.

License

Features

IPBase / SL-A901-B

  • L2, EVC, 802.1Q, 802.1ad, QinQ, 802.3ah, H-Qos, IPv4 static routes, routing protocols, host connectivity, ACL, REP, VRF-Lite
  • E-OAM—CFM (BD, port level), IPSLA (barring LSP)
  • Clocking—SyncE, 1588-OC Slave, 10M, 1PPS/ToD, G.781 Priority based Clock Selection (no ESMC/SSM)
Note 
Time-division multiplexing (TDM) is unavailable.

AdvancedMetroIPAccess / SL-A901-A

  • All IPBase license features
  • MPLS—MPLS, L2VPN (EoMPLS), L3VPN, MPLS OAM, PW redundancy
  • E-OAM—IPSLA(LSP)
  • TDM —IPoPPP/HDLC, QoS, CESoPSNoMPLS, PPP/HDLCoMPLS, Clock Recovery from TDM interfaces, Y.1731PM

Feature Based License

Feature based licenses are licenses used to activate individual features once the image level licenses are used. Once the image level license is used and the appropriate subsystems are activated. Individual feature licenses are used to activate individual features. These include:

  • Port based licenses

    This license applies to the Ethernet ports of the Cisco ASR 901 series routers. Copper and SFP are applicable only to A901-4C-XX-X PIDs, Flexi and 10G licenses are applicable to A901-6CZ-XX-X PID.

    • Copper license
    • SFP license
    • Flexi license
    • 10G license
  • 1588BC license
  • IPsec/NAT-PAT license

Note

Copper (FLS-A901-4T), SFP (SL-A901-B), and 1588BC (SL-A901-T) licenses are feature-based licenses. Once they are installed, the licenses become active and there is no need to reboot the router.

Port Based/Mode License

The following table lists the port number, type, and the required license for those ports:

Port Number

Port Type

Chassis PID

License PIDs

0-3

Copper

A901-4C-FT-D

A901-4C-F-D

FLS-A901-4T

4-7

Combo

No license is required. These ports are enabled by default.

8-11

Small Form-Factor Pluggable(SFP)

A901-4C-FT-D

A901-4C-F-D

FLS-A901-4S

0-3 and 8-11

Copper and SFP

A901-6CZ-FT-A

A901-6CZ-FT-D

A901-6CZ-F-A

A901-6CZ-F-D

FLS-A901-4

TenGig0/1, TenGig0/2

SFP+

A901-6CZ-FT-A

A901-6CZ-FT-D

A901-6CZ-F-A

A901-6CZ-F-D

FLS-A901-2Z

By default, ports 4 to 7 are enabled on the router. When you purchase the copper or SFP port license, the corresponding ports are only enabled. Copper and SFP port licenses can co-exist.

1588BC License

1588BC (SL-A901-T) license is a feature based license. This license does not need rebooting of the router for activation. The following table lists the features supported

License PID

Features

SL-A901-T

Clocking—1588V2 PTP boundary clock

Port or Interface Behavior

The following sections describe the port or interface behavior of the licenses:

Port Based License

When a port based license is not present, ports 4 to 7 are enabled. Ports 0 to 3, and ports 8 to 11 are disabled. This is the expected behavior. Interfaces that are disabled are in the administrative down state.

Example: When Port Based License is not Installed

The following error message appears when the port based license is not installed and you use the no shutdown command on the interface:


Router# show ip interface brief

Interface              IP-Address      OK? Method Status                Protocol
GigabitEthernet0/0     unassigned      YES unset  administratively down down    
GigabitEthernet0/1     unassigned      YES unset  administratively down down    
GigabitEthernet0/2     unassigned      YES unset  administratively down down    
GigabitEthernet0/3     unassigned      YES unset  administratively down down    
GigabitEthernet0/4     unassigned      YES unset  down                  down    
GigabitEthernet0/5     unassigned      YES unset  down                  down    
GigabitEthernet0/6     unassigned      YES unset  down                  down    
GigabitEthernet0/7     unassigned      YES unset  down                  down    
GigabitEthernet0/8     unassigned      YES unset  administratively down down    
GigabitEthernet0/9     unassigned      YES unset  administratively down down    
GigabitEthernet0/10    unassigned      YES unset  administratively down down    
GigabitEthernet0/11    unassigned      YES unset  administratively down down    
FastEthernet0/0        unassigned      YES NVRAM  administratively down down    
Vlan1                  unassigned      YES unset  down                  down    
Router#
Router(config-if)# interface gig 0/0
Router(config-if)# no shutdown
 
 Router(config-if)#
*Oct  5 14:22:27.743: %LICENSE-1-REQUEST_FAILED: License request for feature fls-a901-4t 1.0 failed. UDI=MWR-3941:FHAK13101A1

Router# show interface gigabitEthernet 0/0
     
GigabitEthernet0/0 is administratively down, line protocol is down (disabled)
.......
reliability 255/255, txload 1/255, rxload 1/255
  Encapsulation ARPA, loopback not set
  Keepalive set (10 sec)
  Full Duplex, 1000Mbps, link type is force-up, media type is RJ45
  output flow-control is unsupported, input flow-control is unsupported
  LICENSE not available! Interface disabled
  ARP type: ARPA, ARP Timeout 04:00:00
  Last input never, output never, output hang never

Example: When Port Based License is Installed

The following example shows how to install the port based license:


Router# license install flash:FHAK13101A1_20110811190230024_fls-a901-4t.lic

Installing licenses from "flash:FHAK13101A1_20110811190230024_fls-a901-4t.lic" 
Installing...Feature:Fls-a901-4t...Successful:Supported
1/1 licenses were successfully installed 
0/1 licenses were existing licenses
0/1 licenses were failed to install
Router#*Oct  5 17:23:14.487: %LICENSE-6-INSTALL: Feature Fls-a901-4t 1.0 was installed in this device. UDI=MWR-3941-TEST:FHAK13101A1; StoreIndex=2:Primary License Storage
Router(config)# interface gig 0/0
Router(config-if)# no shutdown

When the port based license is installed for copper or SFP ports, the corresponding ports are enabled. Following is a sample output from the show ip interface command:


Router# show ip interface brief
 
Interface              IP-Address      OK? Method Status                Protocol
GigabitEthernet0/0     unassigned      YES unset  up                    up      
GigabitEthernet0/1     unassigned      YES unset  administratively down down    
GigabitEthernet0/2     unassigned      YES unset  administratively down down    
.....

Note

Combo ports are either copper or SFP ports depending on the configuration specified in the media-type command.

10gigUpgrade License

When you do not have the 10gigUpgrade license, the 10 Gigabit Ethernet ports are enabled in 1 Gigabit Ethernet mode. Install the 10gigUpgrade license to enable new 10 Gigabit Ethernet ports in 10Gigabit Ethernet mode. To enable 1 Gigabit Ethernet mode, 1 Gigabit Ethernet SFPs have to be used on both the ends. There is no speed command to control the speed and this depends on the type of the SFP. The 10 Gigabit Ethernet ports does not support 100M speed. You can connect 10 Gigabit Ethernet SFP+ to 10 Gigabit Ethernet ports only.

Example: When 10gigUpgrade License is not Installed

The following error message appears when the 10gigUpgrade license is not installed and you use the show interface command:


Router# show interface Ten0/1

TenGigabitEthernet0/1 is down, line protocol is down (notconnect)
  Hardware is TenGigabit Ethernet, address is 2c54.2dd6.c10e (bia 2c54.2dd6.c10e)
  MTU 9216 bytes, BW 10000000 Kbit/sec, DLY 10 usec, 
     reliability 255/255, txload 1/255, rxload 1/255
  Encapsulation ARPA, loopback not set
  Keepalive set (10 sec)
  Unknown, Unknown, media type is H10GB-CU3M
  output flow-control is unsupported, input flow-control is unsupported
  LICENSE not available or 1G SFP ( Interface in 1G mode )
  ARP type: ARPA, ARP Timeout 04:00:00
  Last input never, output never, output hang never
  Last clearing of "show interface" counters never
  Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
  Queueing strategy: fifo
  Output queue: 0/40 (size/max)
  5 minute input rate 0 bits/sec, 0 packets/sec
  5 minute output rate 0 bits/sec, 0 packets/sec
     0 packets input, 0 bytes, 0 no buffer
     Received 0 broadcasts (0 multicasts)
     0 runts, 0 giants, 0 throttles 
     0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
     0 watchdog, 0 multicast, 0 pause input
     0 packets output, 0 bytes, 0 underruns
     0 output errors, 0 collisions, 0 interface resets
     0 unknown protocol drops
     0 babbles, 0 late collision, 0 deferred
     0 lost carrier, 0 no carrier, 0 pause output
     0 output buffer failures, 0 output buffers swapped out

Example: When 10gigUpgrade License is Installed

The following example shows how to install the 10gigUpgrade license:


Router# license install flash:10G-ac.lic

Installing licenses from "flash:10G-ac.lic" 
Installing...Feature:10gigUpgrade...Successful:Supported
1/1 licenses were successfully installed 
0/1 licenses were existing licenses
0/1 licenses were failed to install

Following is a sample output from the show license command:


Router# show license

Index 1 Feature: AdvancedMetroIPAccess          
        Period left: Life time
        License Type: Permanent
        License State: Active, In Use
        License Count: Non-Counted
        License Priority: Medium
Index 2 Feature: IPBase                         
Index 3 Feature: Gige4portflexi                 
Index 4 Feature: 10gigUpgrade                   
        Period left: Life time
        License Type: Permanent
        License State: Active, In Use
        License Count: Non-Counted
        License Priority: Medium

Flexi License

When a flexi license is not present, ports 4 to 7 are enabled. Ports 0 to 3, and ports 8 to 11 are disabled. This is the expected behavior. Interfaces that are disabled are in the administrative down state.

FLS-A901-4 flexi license is a combination of copper and SFP ports. This license is not tied to any port types. If you purchase a single FL-A901-4 license and install it, four ports are enabled and if you have two licenses, all the eight ports are enabled. You can purchase and install two flexi licenses in a router.

Flexi license is also called Count-based license, with a maximum count of two. In a normal license, if the license is already installed and when you try to install the same license again, the installation fails and router displays Duplicate License error message. With flexi license (as it is count based), you can install the same license twice. Anything above this will throw an error.


Note

Flexi license is supported only on the Cisco ASR 901 10G Router.

Example: When Flexi License is not Installed

The following error message appears when the flexi license is not installed and you use the show ip interface command on the interface:


Router# show ip interface brief
Interface              IP-Address      OK? Method Status                Protocol
GigabitEthernet0/0     unassigned      YES unset  administratively down down    
GigabitEthernet0/1     unassigned      YES unset  administratively down down    
GigabitEthernet0/2     unassigned      YES unset  administratively down down    
GigabitEthernet0/3     unassigned      YES unset  administratively down down    
GigabitEthernet0/4     unassigned      YES unset  down                  down    
GigabitEthernet0/5     unassigned      YES unset  down                  down    
GigabitEthernet0/6     unassigned      YES unset  down                  down    
GigabitEthernet0/7     unassigned      YES unset  down                  down    
GigabitEthernet0/8     unassigned      YES unset  administratively down down    
GigabitEthernet0/9     unassigned      YES unset  administratively down down    
GigabitEthernet0/10    unassigned      YES unset  administratively down down    
GigabitEthernet0/11    unassigned      YES unset  administratively down down    
FastEthernet0/0        unassigned      YES NVRAM  administratively down down    
Vlan1                  unassigned      YES unset  down                  down    

Example: When Flexi License is Installed

Following is a sample output from the show license command:


Router# show license
Index 1 Feature: AdvancedMetroIPAccess          
        Period left: Life time
        License Type: Permanent
        License State: Active, In Use
        License Count: Non-Counted
        License Priority: Medium
Index 2 Feature: IPBase                         
Index 3 Feature: Gige4portflexi                    Version: 1.0
        License Type: Permanent
        License State: Active, Not In Use
        License Count: 2/0/0  (Active/In-use/Violation)
        License Priority: Medium
        Store Index: 1
        Store Name: Primary License Storage

1588BC License

When the SL-A901-T 1588BC license is not installed, the PTP boundary clock cannot be configured. For more information on configuring the PTP boundary clock, see PTP Boundary Clock.

Example: When 1588BC License is not Installed

The following error message appears on configuring the PTP boundary clock, when the 1588BC license is not installed:


Note

Though an error message appears on configuring the PTP boundary clock, the running-config file accepts the PTP boundary clock configuration. This configuration can be saved. However, the PTP boundary clock is not configured in the hardware, and is inactive.

Router(config)# ptp clock boundary domain 0

%ERROR: Boundary Clock needs a separate license. Please install license and reconfigure PTP.
Router(config-ptp-clk)#

Example: When 1588BC License is Installed

The following example shows how to install the 1588BC license:


Router# license install flash:CAT1632U029_20121005013805577.lic

Installing licenses from "flash:CAT1632U029_20121005013805577.lic"
Installing...Feature:1588BC...Successful:Supported
1/1 licenses were successfully installed
0/1 licenses were existing licenses
0/1 licenses were failed to install

Following is a sample output from the show license command:


Note

When the 1588BC license is installed and PTP boundary clock is not configured, the license state is displayed as Active, Not in Use . When the 1588BC license is installed and PTP boundary clock is configured, the license state is displayed as Active, In Use .

Router# show license

Index 1 Feature: AdvancedMetroIPAccess
Index 2 Feature: IPBase
Index 3 Feature: Gige4portflexi
Index 4 Feature: 10gigUpgrade
Index 5 Feature: 1588BC
        Period left: Life time
        License Type: Permanent
        License State: Active, In Use
        License Count: Non-Counted
        License Priority: Medium

Removing the License

If PTP boundary clock is configured, then the following error message appears when removing the 1588BC license:


Note

Removing license is mainly used for development purpose.

Router# yes 
Feature: 1588BC
        License Type: Permanent
        License State: Active, In Use
        License Addition: Exclusive
        License Count: Non-Counted
        Comment:
        Store Index: 2
        Store Name: Primary License Storage
Are you sure you want to clear? (yes/[no]): &;
Handling Event, Unknown event type: 3
% Error: Could not delete in-use license

Complete the following steps to remove the license.

Procedure

Step 1

Use the yes command to remove the PTP boundary clock configuration.

Router(config-ptp-clk)# yes

Step 2

Use the license clear command to remove the 1588BC license.

Router# yes

Feature: 1588BC

License Type: Permanent

License State: Active, Not in Use

License Addition: Exclusive

License Count: Non-Counted

Comment:

Store Index: 3

Store Name: Primary License Storage

Are you sure you want to clear? (yes/[no]): &;


Generating the License

Complete the following steps to generate the license:

Procedure


Step 1

Use the show license udi command on the router

Step 2

Save the output.

The output contains the UDI with the Product Identifier (PID) and Serial Number (SN).

Step 3

Go to the SWIFT tool at https://tools.cisco.com/SWIFT/Licensing/PrivateRegistrationServlet.

Step 4

Enter the PAK and UDI.

Step 5

Click Submit .

You will receive the license file through email.


Installing the License

Complete the following steps to install the license:

Procedure

  Command or Action Purpose
Step 1

enable

Example:


Router> enable

Enables the privileged EXEC mode.

  • Enter your password if prompted.
Step 2

license install ?

Example:


Router# license install ?

(Optional) License can be installed either by placing the license file in the tftp boot directory or by copying the license to the flash: directory.

Step 3

copy tftp: flash:

Example:


Router# copy tftp: flash:

Copies the license file to the flash: directory.

Step 4

show flash:

Example:


Router# show flash:

Displays the contents of the flash: directory.

Step 5

license install &;

Example:


Router# license install 
FHK10LLL021_20110530015634482.lic

Installs the license from the flash: directory.

Step 6

reload

Example:


Router# reload

Reboots the system to activate the new license.

Note 
The license is activated after installation. Rebooting the router is required only for AdvancedMetroIPAccess.

Changing the License

The license boot level command is used only to select the required image-based licensing. For the Cisco ASR 901 Series Routers, only one image based license (AdvancedMetroIPAccess) is available. Installing this license and reloading the router takes care of this license. If the license install does not work properly, use the license boot level command for AdvancedMetroIPAccess in the global configuration mode, to change the license and reboot the system to activate the new license.


Note

If you do not install a license, the router starts with the lowest level license by default.

Note

After installing the AdvancedMetroIPAccess license and reloading the router, the AdvancedMetroIPAccess license will be activated by default.

Verifying the License

To verify the new license, use the show license command.


Router# show license
Index 1 Feature: AdvancedMetroIPAccess  
    Period left: Lifetime 
    License Type: Permanent 
    License State: Active, In Use
    License Priority: High
    License Count: 1/1/0  (Active/In-use/Violation)
 
Index 2 Feature:.....
    Period left: 0  minute  0  second  

Where to Go Next

For additional information on Licensing, see the documentation listed in the Additional References section.

Additional References

Related Documents

Related Topic

Document Title

Cisco IOS commands

Cisco IOS Master Commands List, All Releases

Cisco ASR 901 Command Reference

Cisco ASR 901 Series Aggregation Services Router Command Reference

Cisco IOS Interface and Hardware Component Commands

Cisco IOS Interface and Hardware Component Command Reference

Cisco Software Licensing Concepts

Cisco IOS Software Activation Conceptual Overview

Cisco ASR 901 Software Configuration Guide

Cisco ASR 901 Series Aggregation Services Router Software Configuration Guide

Standards

Standard

Title

None

MIBs

MIB

MIBs Link

None

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

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

RFCs

RFC

Title

No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.

Technical Assistance

Description

Link

The Cisco Support and Documentation website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies. Access to most tools on the Cisco Support and Documentation website requires a Cisco.com user ID and password.

http://www.cisco.com/cisco/web/support/index.html

Feature Information for Licensing

The following table lists the release history for this feature and provides links to specific configuration information.

Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which 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

The following table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.
Table 1. Feature Information for Licensing

Feature Name

Releases

Feature Information

Licensing

15.2(2)SNH1

The following sections provide information about this feature:

1588BC Licensing

15.2(2)SNI

The following sections provide information about this feature:

Licensing

15.4(2)S

New PIDs were added to the document.