Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    Working with License Keys for SRX Series Devices

    This topic includes the following sections:

    Generating a License Key

    To generate a license key:

    1. Gather the authorization code that you received when you purchased your license as well as your device serial number.
    2. Go to the Juniper Networks licensing page at:

      https://www.juniper.net/lcrs/generateLicense.do

    3. Enter the device serial number and authorization code in the webpage and click Generate. Depending on the type of license you purchased, you will receive one of the following responses:
      • License key—If you purchased a perpetual license, you will receive a license key from the licensing management system. You can enter this key directly into the system to activate the feature on your device.
      • License key entitlement—If you purchased a subscription-based license, you will receive a license key entitlement from the licensing management system. You can use this entitlement to validate your license on the Juniper Networks licensing server and download the feature license from the server to your device.

    Downloading License Keys

    To download license keys installed on the device:

    1. In the J-Web interface, select Maintain>Licenses.
    2. Under Installed Licenses, click Download Keys to download all the license keys installed on the device to a single file.
    3. Select Save it to disk and specify the file to which the license keys are to be written.

    Displaying License Keys in J-Web

    To display license keys installed on the device:

    1. In the J-Web interface, select Maintain>Licenses.
    2. Under Installed Licenses, click Display Keys to display all the license keys installed on the device.

      A screen displaying the license keys in text format appears. Multiple licenses are separated by a blank line.

    Saving License Keys

    To save license keys installed on the device:

    1. From operational mode, save the installed license keys to a file or URL.
      user@host>request system license save filename | url

    For example, the following command saves the installed license keys to a file named license.config:

    request system license save ftp://user@host/license.conf

    Updating License Keys

    To update a license key from the device:

    1. From operational mode, do one of the following tasks:

      • Update the license keys automatically.
        user@host> request system license update

        Note: The request system license update command will always use the default Juniper license server https://ae1.juniper.net

        You can only use this command to update subscription-based licenses (such as UTM).

      • Update the trial license keys automatically.
        user@host>request system license update trial

    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 configure this section of the example, copy the following commands, paste them into a text file, remove any line breaks, change any details necessary to match your network configuration, copy and paste the commands into the CLI at the [edit] hierarchy level, and then enter commit from configuration mode.

    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.

    Example: Deleting a License Key

    This example shows how to delete a license key.

    Requirements

    Before you delete a license key, confirm that it is no longer needed.

    Overview

    You can delete a license key from the CLI or J-Web user interface. In this example, the license ID is G0300000xxxx.

    Configuration

    CLI Quick Configuration

    To quickly configure this section of the example, copy the following commands, paste them into a text file, remove any line breaks, change any details necessary to match your network configuration, copy and paste the commands into the CLI at the [edit] hierarchy level, and then enter commit from configuration mode.

    user@host> request system license delete G0300000xxxx

    GUI Step-by-Step Procedure

    To delete a license key:

    1. In the J-Web user interface, select Maintain>Licenses.
    2. Select the check box of the license or licenses you want to delete.
    3. Click Delete.

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

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

    Step-by-Step Procedure

    To delete a license key:

    1. From operational mode, for each license, enter the following command and specify the license ID. You can delete only one license at a time.
      user@host> request system license delete G0300000xxxx

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

    Results

    From configuration mode, confirm your deletion by entering the show system license command. The license key you deleted will be removed. If the output does not display the intended configuration, repeat the configuration instructions in this example to correct it.

    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 removed from the device.

    Action

    From operational mode, enter the show system license command.

    Modified: 2016-09-28