Cisco Nexus 4001I and 4005I Switch Module for IBM BladeCenter NX-OS Configuration Guide
Managing Licenses
Downloads: This chapterpdf (PDF - 153.0KB) The complete bookPDF (PDF - 4.46MB) | Feedback

Managing Licenses

Table Of Contents

Managing Licenses

Licensing Terminology

Licensing Model

License Installation

Obtaining a Factory-Installed License

Performing a Manual Installation

Obtaining the License Key File

Installing the License Key File

Backing Up License Files

Identifying License Features in Use

Uninstalling Licenses

Grace Period Alerts

License Transfers Between Switches

Verifying the License Configuration


Managing Licenses


This chapter describes how to manage licenses for a Cisco Nexus 4001I and 4005I Switch Module for IBM BladeCenter.

Licensing allows you to access specified premium features on the switch after you install the appropriate license for that feature. This chapter contains information related to licensing types, options, procedures, installation, and management for the Cisco NX-OS software.

This chapter includes the following sections:

Licensing Terminology

Licensing Model

License Installation

Obtaining the License Key File

Installing the License Key File

Backing Up License Files

Identifying License Features in Use

Uninstalling Licenses

Grace Period Alerts

License Transfers Between Switches

Verifying the License Configuration

Licensing Terminology

The following terms are used in this chapter:

Licensed feature—Permission to use a particular feature through a license file, a hardware object, or a legal contract. This permission is limited to the number of users, number of instances, time span, and the implemented switch.

Licensed application—A software feature that requires a license to be used.

License enforcement—A mechanism that prevents a feature from being used without first obtaining a license.

Node-locked license—A license that can only be used on a particular switch using the unique host ID of the switch.

Host IDs—A unique chassis serial number that is specific to each switch.

Proof of purchase—A document entitling its rightful owner to use licensed features on one switch as described in that document. The proof of purchase document is also known as the claim certificate.

Product Authorization Key (PAK)—The PAK allows you to obtain a license key from one of the sites listed in the proof of purchase document. After registering at the specified website, you will receive your license key file and installation instructions through e-mail.

License key file—A switch-specific unique file that specifies the licensed features. Each file contains digital signatures to prevent tampering and modification. License keys are required to use a licensed feature. License keys are enforced within a specified time span.

Missing license—If the bootflash has been corrupted after you have installed a license, that license shows as "missing." The feature still works, but the license count is inaccurate. You should reinstall the license as soon as possible.

Incremental license—An additional licensed feature that was not in the initial license file. License keys are incremental. If you purchase some features now and others later, the license file and the software detect the sum of all features for the specified switch.

Evaluation license—A temporary license. Evaluation licenses are time bound (valid for a specified number of days) and are not tied to a host ID (switch serial number).

Permanent license—A license that is not time bound is called a permanent license.

Grace period—The amount of time the features in a license package can continue functioning without a license.

Support—If you purchased Cisco support through a Cisco reseller, contact the reseller directly. If you purchased support directly from Cisco Systems, contact Cisco TAC at the following URL:

http://www.cisco.com/en/US/support/tsd_cisco_worldwide_contacts.html

Licensing Model

The licensing model for the Cisco NX-OS software is feature-based. Feature-based licenses make features available to the entire physical switch.

If asked by the tool to generate the license, the feature is BASIC_STORAGE_SERVICES_PKG. The BASIC_STORAGE_SERVICES_PKG includes the FIP snooping feature license.

License Installation

You can either obtain a factory-installed license (only applies to new orders) or perform a manual license installation of the license (applies to an existing switch in your network).

This section includes the following topics:

Obtaining a Factory-Installed License

Performing a Manual Installation

Obtaining a Factory-Installed License

You can obtain factory-installed licenses for a new switch.

To obtain a factory-installed license, perform the following steps:


Step 1 Contact your reseller or Cisco representative and request this service.


Note If you purchased Cisco support through a Cisco reseller, contact the reseller directly. If you purchased support directly from Cisco Systems, contact Cisco TAC at this URL:

http://www.cisco.com/en/US/support/tsd_cisco_worldwide_contacts.html


Your switch is shipped with the required licenses installed in the system. The proof of purchase document is sent along with the switch.

Step 2 Obtain the host ID from the proof of purchase document for future use.

You can now start to use the switch and the licensed features.


Performing a Manual Installation

All switch licenses are factory-installed. Manual installation is not required.

Obtaining the License Key File

To obtain new or updated license key files, perform the following steps:


Step 1 Use the show license host-id command to obtain the serial number for your switch. The host ID is also referred to as the switch serial number.

switch# show license host-id
License hostid: VDH=JAB1309001K
 
   

Tip Use the ID that appears after the equal (=) sign. In this example, the host ID is JAB1309001K.


Step 2 Obtain either your claim certificate or your proof of purchase document. This document accompanies every switch.

Step 3 Get the product authorization key (PAK) from either the claim certificate or the proof of purchase document.

Step 4 Locate the website URL from either the claim certificate or the proof of purchase document.

Step 5 Access the specified URL that applies to your switch and enter the switch serial number and the PAK.

The license key file is sent to you by e-mail. The license key file is digitally signed to only authorize use on the requested switch. The requested features are also enabled once the Cisco NX-OS software on the specified switch accesses the license key file.


Caution Install the license key file in the specified switch without making any modifications.

A license is either permanent or it expires on a fixed date. If you do not have a license, the grace period for using that feature starts from the first time you start using a feature offered by that license (see the "Grace Period Alerts" section).

Step 6 Use the copy licenses command in EXEC mode to save your license file to one of two locations; either the bootflash: or the volatile: directory (see the "Backing Up License Files" section).


Installing the License Key File


Tip If you need to install multiple licenses in any switch, be sure to provide unique file names for each license key file.


To install a license key file in any switch, perform the following steps:


Step 1 Log in to the switch.

Step 2 Copy the license file to bootflash.

switch# copy scp://root@10.0.0.0/root/nexus4000-licenses.lic 
bootflash:nexus4000-licenses.lic vrf management
 
   

Step 3 Perform the installation by entering the install license command:

switch# install license bootflash:nexus4000-licenses.lic
Installing license ......done
 
   

Note If you provide a target name for the license key file, the file is installed with the specified name. Otherwise, the filename specified in the license key file is used to install the license.


Step 4 Back up the license file to a .tar file on bootflash: using the copy licenses command:

switch# copy licenses bootflash:/basic_license.tar  
Backing up license done 

Step 5 Exit the switch console and open a new terminal session to view the license file installed on the switch using the show license usage command:

switch# show license usage 
Feature                      Ins  Lic   Status Expiry Date Comments
 
   
                                 Count
 
   
--------------------------------------------------------------------------------
 
   
BASIC_STORAGE_SERVICES_PKG    Yes   -   In use Never       -
 
   
--------------------------------------------------------------------------------

Note If the license meets all guidelines when the install license command is entered, all features continue functioning as configured.



Backing Up License Files

All installed license files can be backed up as a .tar file in the user specified location. Use the copy licenses command in EXEC mode to save your license file to one of two locations; bootflash: or volatile:. The following example saves all licenses to a file named basic_license.tar.

switch# copy licenses bootflash:/basic_license.tar  
Backing up license done 


Tip We recommend backing up your license files immediately after installing them and just before running a write erase command.



Caution If you erase any existing licenses, you can only install them using the install license command.

Identifying License Features in Use

When a Cisco NX-OS software feature is enabled, it can activate a license grace period. To identify the features active for a specific license, use the show license usage license-name command.

Use the show license usage command to identify all of the active features on your switch:

switch# show license usage 
 
   
Feature                      Ins  Lic   Status Expiry Date Comments
 
   
                                 Count
 
   
--------------------------------------------------------------------------------
 
   
BASIC_STORAGE_SERVICES_PKG    Yes   -   In use Never       -
 
   
--------------------------------------------------------------------------------

Uninstalling Licenses

You can only uninstall a permanent license that is not in use. If you try to delete a permanent license that is currently being used, the software rejects the request with an error message. Uninstalling an unused license initiates the grace period. The grace period is measured from the first use of the feature without a license and is reset when a valid license file is installed.


Note Permanent licenses cannot be uninstalled if they are currently being used. Features turned on by permanent licenses must first be disabled, before that license is uninstalled.



Tip If you are using an evaluation license and would like to install a new permanent license, you can do so without service disruption and before the evaluation license expires. Removing an evaluation license immediately triggers a grace period without service disruption.



Caution Disable related features before uninstalling a license. The delete procedure fails if the license is in use.

To uninstall a license, perform the following steps:


Step 1 Save your running configuration to a remote server using the copy command (see Chapter 2 "Configuring the Switch").

Step 2 Disable the features provided by the license to be uninstalled. Enter the show license usage command to view the enabled features.

switch# show license usage 
 
   
Feature                      Ins  Lic   Status Expiry Date Comments
 
   
                                 Count
 
   
--------------------------------------------------------------------------------
 
   
BASIC_STORAGE_SERVICES_PKG    Yes   -   In use Never       -
 
   
--------------------------------------------------------------------------------
 
   

Step 3 Uninstall the license file using the clear license filename command, where filename is the name of the installed license key file:

switch# clear license nexus4000-licenses.lic 
 
   
Clearing license nexus4000-licenses.lic:
 
   
SERVER this_host ANY
 
   
VENDOR cisco
 
   
FEATURE BASIC_STORAGE_SERVICES_PKG cisco 1.0 permanent uncounted \
 
   
        HOSTID=VDH=JAB1309001K \
 
   
        NOTICE="<LicFileID>dc3-licenses.lic</LicFileID><LicLineID>0</LicLineID> \
 
   
        <PAK>dummyPak</PAK>" SIGN=5E8D227654E2 

Step 4 Enter yes (yes is the default) to continue with the license update:

Do you want to continue? (y/n) y
Clearing license failed: License is in use
 
   

The license is in use in the example.

Step 5 Disable all license features before you uninstall:

switch# no feature fip-snooping 
 
   
switch(config)# show license usage 
 
   
Feature                      Ins  Lic   Status Expiry Date Comments
 
   
                                 Count
 
   
--------------------------------------------------------------------------------
 
   
BASIC_STORAGE_SERVICES_PKG    Yes   -   Unused Never       -
 
   
--------------------------------------------------------------------------------
 
   
switch(config)# clear license nexus4000-licenses.lic
Clearing license nexus4000-licenses.lic:
 
   
SERVER this_host ANY
 
   
VENDOR cisco
 
   
FEATURE BASIC_STORAGE_SERVICES_PKG cisco 1.0 permanent uncounted \
 
   
        HOSTID=VDH=JAB1309001K \
 
   
        NOTICE="<LicFileID>dc3-licenses.lic</LicFileID><LicLineID>0</LicLineID> \
 
   
        <PAK>dummyPak</PAK>" SIGN=5E8D227654E2
 
   
 
 
   
Do you want to continue? (y/n) y
 
   
Clearing license .....done
 
   

The license file is now uninstalled.


Grace Period Alerts

Cisco NX-OS gives you a 120-day grace period. This grace period starts or continues when you are evaluating a feature for which you have not installed a license.

The grace period stops if you disable a feature you are evaluating, but if you enable that feature again without a valid license, the grace period countdown continues from when it had stopped.

The grace period operates across all features in a license package. License packages can contain several features. If you disable a feature during the grace period and there are other features in that license package that are still enabled, the countdown does not stop for that license package. To suspend the grace period countdown for a license package, you must disable every feature in that license package.

Use the show license usage command to display grace period information for a switch:

switch# show license usage
Feature                      Ins  Lic   Status Expiry Date Comments
                                 Count
--------------------------------------------------------------------------------
BASIC_STORAGE_SERVICES_PKG    No    -   In use             Grace 119D 22H

--------------------------------------------------------------------------------

The Cisco NX-OS license counter keeps track of all licenses on a switch. If you are evaluating a feature and the grace period has started, you will receive console messages, SNMP traps, system messages, and Call Home messages on a daily basis.

The frequency of these messages become hourly during the last seven days of the grace period.


Note You cannot modify the frequency of the grace period messages.



Caution After the final seven days of the grace period, the feature is turned off and your network traffic may be disrupted. Any future upgrade will enforce license requirements and the 120-day grace period.

License Transfers Between Switches

A license is specific to the switch for which it is issued and is not valid on any other switch. If you need to transfer a license from one switch to another, contact your customer service representative.


Note If you purchased Cisco support through a Cisco reseller, contact the reseller directly. If you purchased support directly from Cisco Systems, contact Cisco TAC at this URL:

http://www.cisco.com/en/US/support/tsd_cisco_worldwide_contacts.html


Verifying the License Configuration

To display the license configuration information, perform one of the following tasks:

Command
Purpose

switch# show license [brief]

Displays information for all installed license files.

switch# show license file

Displays information for a specific license file.

switch# show license host-id

Displays the host ID for the physical switch.

switch# show license usage

Displays the usage information for installed licenses.


.