enable license

enable license {software} [key | capacity_key ]

Description

Enables software license or feature pack that allows you to use advanced features.

Syntax Description

key Specifies your hexadecimal license key in format xxxx-xxxx-xxxx-xxxx-xxxx.
capacity-key Specifies your Hexadecimal license key in format xxxx-xxxx-xxxx-xxxx-xxxx-xx.

Default

N/A.

Usage Guidelines

The software license levels that apply to ExtremeXOS software are described in the Feature License Requirements document.

To obtain a software license, specify the key in the format xxxx-xxxx-xxxx-xxxx-xxxx.

You obtain the software license key (or feature pack key) either by ordering it from the factory or by obtaining a license voucher from your Extreme Networks supplier. You can obtain a regular software license or a trial software license, which allows you use of the license for either 30, 60 or 90 days; you cannot downgrade software licenses.

The voucher contains all the necessary information on the software license, whether regular or trial, and number of days for trial software license.

After you enable the software license or feature pack by entering the software key, the system returns a message that you either successfully or unsuccessfully set the license.

Once you enable the software license (or if you do not use the correct key, attempt to downgrade the license, or already installed the software license) you see one of the following messages:

 Enabled license successfully. Error: Unable to set license using supplied key. Error: Unable to set license - downgrade of licenses is not supported. Error: Unable to set license - license is already enabled. Error: Unable to set license - trial license already enabled. 

If you enable a trial license, the system generates a daily message showing the number of days until expiry.

Once installed (or enabled), the software license goes with the switch chassis itself (not with the MSM/MM module on modular switches). The software license information is stored in EEPROM in the modular switches and NVRAM on the stand-alone switches and SummitStack; the information persists through reboots, software upgrades, power outages, and reconfigurations.

If you attempt to execute a command and you do not either have the required software license or have reached the limits defined by the current software license level, the system returns one of the following messages:

 Error: This command cannot be executed at the current license level. Error: You have reached the maximum limit for this feature at this license level. 

If you attempt to execute a command and you do not have the required feature pack, the system also returns a message.

To protect against attacks to install maliciously created license keys, the system has an exponential delay of each failed attempt to install a license.

To view the type of software license you are currently running on the switch, use the show licenses command. The license key number is not displayed, but the type of software license is displayed in the show licenses output. This command can be run on any node in a SummitStack, regardless of its node role (Master, Standby, or Backup).

Capacity license can be for either a switch or a blade, for example, TCAM license is per blade. The key is a hexadecimal value of 11 bytes, which contains all the necessary information regarding the type and nature of the license. The key length can be used to differentiate capacity license from existing software license whose length is 10 bytes.

For TCAM license change, the following warning message is displayed if the license is successfully enabled:

Warning: A reboot switch or disable and enable slot n is required before the new license takes effect.

Example

The following command enables a software license on the switch:

enable license 2d5e-0e84-e87d-c3fe-bfff
enable license 2d5e-0e84-e87d-c3fe-bfff-ae
Half External Tables Usage license successfully enabled on the BDXB-40G12X-XL module in Slot-3.
Warning: A reboot switch or disable and enable slot 3 is required beforethe new license takes effect.
Messages to user for different scenarios:
  • No module in the switch match the part # and serial # in the license key.
    "Error: No module in the switch matches the supplied key."
  • Key format is incorrect.
    "Error: Incorrect key format."
  • License key is re-applied.
    "Full External Tables Usage license is already enabled on the BDXB-40G12X-XL module in Slot-3".
  • EEPROM Read/Write failure.
    "Error: Failed to enable External Tables Usage license on the BDXB-40G12X-XL module in Slot-3. This may be due to damage or corruption of the EEPROM on the module and should be reported."

History

This command was first available in ExtremeXOS 11.1.

The software parameter was added in ExtremeXOS 11.6.

The capacity-key variable was added in ExtremeXOS 15.4.

Platform Availability

This command is available on all platforms.