Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation

Example: Adding a New License Key

This example shows how to add a new license key.

Requirements

Before you begin, confirm that your Junos OS feature requires you to purchase, install, and manage a separate software license.

Overview

You can add a license key from a file or URL, from a terminal, or from the J-Web user interface. Use the filename option to activate a perpetual license directly on the device. (Most feature licenses are perpetual.) Use the url to send a subscription-based license key entitlement (such as UTM) to the Juniper Networks licensing server for authorization. If authorized, the server downloads the license to the device and activates it.

In this example, the file name is bgp-reflection.

Configuration

CLI Quick Configuration

To quickly add a new license key, copy the following commands, paste them in a text file, remove any line breaks, and then copy and paste the commands into the CLI.

From operational mode, you can add a license key in either way:

  • From a file or URL:
    user@hostname> request system license add bgp-reflection
  • From the terminal:
    user@hostname> request system license add terminal

GUI Step-by-Step Procedure

To add a new license key:

  1. In the J-Web user interface, select Maintain>Licenses.
  2. Under Installed Licenses, click Add to add a new license key.
  3. Do one of the following, using a blank line to separate multiple license keys:
    • In the License File URL box, type the full URL to the destination file containing the license key to be added.
    • In the License Key Text box, paste the license key text, in plain-text format, for the license to be added.
  4. Click OK to add the license key.

    Note: If you added the SRX100 Memory Upgrade license, the device reboots immediately and comes back up as a high-memory device.

  5. Click OK to check your configuration and save it as a candidate configuration.
  6. If you are done configuring the device, click Commit Options>Commit.

Step-by-Step Procedure

To add a new license key:

  1. From operational mode, add a license key in either way:

    • From a file or URL:
      user@host> request system license add bgp-reflection
    • From the terminal:
      user@host>request system license add terminal
  2. When prompted, enter the license key, separating multiple license keys with a blank line. If the license key you enter is invalid, an error is generated when you press Ctrl-D to exit license entry mode.

    Note: If you added the SRX100 Memory Upgrade license, the device reboots immediately and comes back up as a high-memory device.

Results

From operational mode, confirm your configuration by entering the show system license command. If the output does not display the intended configuration, repeat the configuration instructions in this example to correct it.

user@hostname> show system license
License usage: 
                   Licenses     Licenses    Licenses 		Expiry
  Feature name         used    installed      needed 				
  bgp-reflection          0            1           0		permanent
  

Licenses installed: 
  License identifier: G0300000xxxx
  License version: 2
  Valid for device: JN001875AB
  Features:
    bgp-reflection   - Border Gateway Protocol route reflection
		permanent

    License identifier: G0300000xxxx
  License version: 2
  Valid for device: JN001875AB
  

If you are done configuring the device, enter commit from configuration mode.

Verification

Confirm that the configuration is working properly.

Verifying Installed Licenses

Purpose

Verify that the expected licenses have been installed and are active on the device.

Action

From operational mode, enter the show system license command.

The output shows a list of the licenses used and a list of the licenses installed on the device and when they expire.

Verifying License Usage

Purpose

Verify that the licenses fully cover the feature configuration on the device.

Action

From operational mode, enter the show system license usage command.

user@hostname> show system license usage
                         Licenses     Licenses    Licenses   	Expiry
  Feature name            used       installed      needed 
  bgp-reflection             1            1           0		   permanent
                        

The output shows a list of the licenses installed on the device and how they are used.

Verifying Installed License Keys

Purpose

Verify that the license keys were installed on the device.

Action

From operational mode, enter the show system license keys command.

user@hostname> show system license keys
XXXXXXXXXX xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx
             xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx
             xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx
             xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx

The output shows a list of the license keys installed on the device. Verify that each expected license key is present.

Modified: 2016-07-01