Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
 

Related Documentation

 

Junos OS Feature License Keys

Some Junos OS software features require a license to be activated. To enable each licensed feature, you must purchase, install, manage, and verify a license key that corresponds to the licensed feature.

Release-Tied License Keys and Upgrade Licenses on MX Series Routers

The Junos OS licensing infrastructure currently associates a license feature with attributes such as date, platform, and validity. In addition to these attributes, for MX Series routers running Junos OS Release 12.2 and later, a licensed feature can be associated with a release number at the time of generating the license key. This type of release-tied license key is used to validate a particular licensed feature while attempting a software upgrade. The upgrade process aborts if the release number in the license key is earlier than the Junos OS release number to which the system is being upgraded.

Additionally, an upgrade license key can be generated for a release-tied licensed feature. An upgrade license key is used for carrying forward a capacity license to the upgrade release. Although an upgrade license might be an acceptable license on the current release, it does not add to the existing capacity limit. The capacity added in the upgrade license key is valid for the upgrade software release only.

The release number embedded in the license key indicates the maximum release number up to which Junos OS can be upgraded.

As an example, assume that your system is running Junos OS Release 12.2 and is using the scale-subscriber licensed feature with a later release-tied upgrade license key installed. If you request a software upgrade to the later release of Junos OS, the software upgrade operation fails and the following error message is displayed:

mgd: error: No valid upgrade license found for feature 'scale-subscriber'.
Aborting Software upgrade.
Validation failed

In this example, to successfully upgrade to the later release of Junos OS, the release number included in the upgrade license key should be greater than or equal to the later release number. Also, you can perform software upgrades up to the previous release without any additional license keys to retain the existing scale limit.

Note:

When you install a release-tied license, the following apply:

  • You can purchase an upgrade capacity license only if a base capacity license for the same scale-tier has already been generated or purchased.
  • You cannot install an upgrade license if the capacity does not match any of the existing base capacity licenses on the system.
  • The license installation fails when you install a lower release number license key on a higher software release number.
  • A release-tied license can be installed on a Junos OS release number that is lower than or equal to the release number included in the license key. For example, a 12.2 license key is valid on Junos OS Release 12.1.
  • An upgrade license is valid only on the target release number specified in the license key, but can be installed on an earlier Junos OS release. For example, a 4 K scale-tier upgrade license for Junos OS Release 12.2 can be installed on an earlier release, and the installed count of licenses remains unaltered.
  • Release-tied licenses of the previous release are not deleted on upgrading Junos OS to a newer release version.

Licensable Ports on MX5, MX10, and MX40 Routers

Starting with Junos OS Release 12.2, license keys are available to enhance the port capacity on MX5, MX10, and MX40 routers up to the port capacity of an MX80 router. The MX5, MX10, and MX40 routers are derived from the modular MX80 chassis with similar slot and port assignments, and provide all functionality available on an MX80 router, but at a lower capacity. Restricting port capacity is achieved by making a set of MIC slots and ports licensable. MICs without a license are locked, and are unlocked or made usable by installing appropriate upgrade licenses.

The base capacity of a router is identified by the Ideeprom assembly ID (I2C ID), which defines the board type. However, the Junos OS licensing infrastructure allows the use of restricted ports without a license for a grace period of 30 days. After the grace period expires, the router reverts back to the base capacity if no upgrade license is purchased and installed for the locked ports. The I2C ID along with an upgrade license determine the final capacity of an MX5, MX10, or MX40 router.

The MX5, MX10, MX40, and MX80 routers support the following types of MICs:

  • A built-in 10-Gigabit Ethernet MIC with four 10-Gigabit Ethernet ports
  • Two front-pluggable MICs

A feature ID is assigned to every license upgrade for enhancing port capacity. Table 1 displays the chassis types and their associated port capacity, I2C ID, base capacity, feature ID, feature name, and the final capacity after a license upgrade.

Table 1: Upgrade Licenses for Enhancing Port Capacity

Chassis Type

Port Capacity

I2C ID

Base Capacity

Feature ID and Feature Name

Upgrade Capacity

MX5

20G

0x556

Slot 1

  • 1/MIC0

f1—MX5 to MX10 upgrade

Slot 1 and 2

  • 1/MIC0
  • 1/MIC1

MX10

40G

0x555

Slot 1 and 2

  • 1/MIC0
  • 1/MIC1

f2—MX10 to MX40 upgrade

Slot 2 and first 2 ports on Slot 0

  • 1/MIC1
  • First 2 ports on 0/MIC0

MX40

60G

0x554

Slot 1, SLot 2 and first 2 ports on Slot 0

  • 1/MIC0
  • 1/MIC1
  • First 2 ports on 0/MIC0

f3—MX40 to MX80 upgrade

Slot 2 and all ports on Slot 0

  • 1/MIC1
  • All 4 ports on 0/MIC0

When installing an upgrade license for enhancing port capacity on MX5, MX10 and MX40 routers, consider the following:

  • To upgrade an MX5 router to MX80 router capacity, licenses for all three features (f1, f2, f3) must be installed. All three features can be provided in a single license key.
  • To upgrade an MX10 router to MX40 router capacity, installing a license key with f2 feature is sufficient.
  • Non-applicable feature IDs in a license key reject the upgrade license. For example:
    • An f1 feature ID on an MX10 upgrade license key rejects the license.
    • Feature IDs f1 and f2 on an MX40 upgrade license key reject the entire license.
 

Related Documentation

 

Published: 2014-07-23

 

Related Documentation

 

Published: 2014-07-23