Managing Licenses

This chapter includes the following sections:

• Licenses, page 1
• Obtaining the Host ID for a Fabric Interconnect, page 2
• Obtaining a License, page 3
• Installing a License, page 4
• Viewing the Licenses Installed on a Fabric Interconnect, page 4
• Viewing License Usage for a Fabric Interconnect, page 5
• Uninstalling a License, page 7

Licenses
Each Cisco UCS fabric interconnect comes with several port licenses that are factory installed and shipped
with the hardware. Fabric interconnects can be purchased fully licensed or partially licensed. Additional
licenses can also be purchased after delivery.
At a minimum, each fabric interconnect ships with the following counted licenses pre-installed:
• Cisco UCS 6120XP fabric interconnect—pre-installed licenses for the first eight Ethernet ports enabled
in Cisco UCS Manager and any Fibre Channel ports on expansion modules
• Cisco UCS 6140XP fabric interconnect—pre-installed licenses for the first sixteen Ethernet ports enabled
in Cisco UCS Manager and any Fibre Channel ports on expansion modules
• Cisco UCS 6248 fabric interconnect—pre-installed licenses for the first twelve unified ports enabled in
Cisco UCS Manager. Expansion modules come with eight licenses that can be used on the expansion
module or the base module.
• Cisco UCS 6296 fabric interconnect—pre-installed licenses for the first eighteen unified ports enabled
in Cisco UCS Manager. Expansion modules come with eight licenses that can be used on the expansion
module or the base module.

Cisco UCS Manager CLI Configuration Guide, Release 2.0

OL-25721-05 1
 Managing Licenses
Obtaining the Host ID for a Fabric Interconnect

Note The eight default licenses that come with a 6200 series fabric interconnect expansion module can be used
to enable ports on the base module, but will travel with the expansion module if it is removed. Upon
removal of an expansion module, any default expansion module licenses being used by the base module
are removed from the ports on the base module, resulting in unlicensed ports.

Port licenses are not bound to physical ports. When you disable a licensed port, that license is then retained
for use with the next enabled port. If you want to use additional fixed ports, you must purchase and install
licenses for those ports.

Important Licenses are not portable across product generations. Licenses purchased for 6100 series fabric interconnects
cannot be used to enable ports on 6200 series fabric interconnects or vice-versa.

Grace Period
If you attempt to use a port that does not have an installed license, Cisco UCS initiates a 120 day grace period.
The grace period is measured from the first use of the port without a license and is paused when a valid license
file is installed. The amount of time used in the grace period is retained by the system.

Note Each physical port has its own grace period. Initiating the grace period on a single port does not initiate
the grace period for all ports.

If a licensed port is unconfigured, that license is transferred to a port functioning within a grace period. If
multiple ports are acting within grace periods, the license is moved to the port whose grace period is closest
to expiring.

High Availability Configurations

To avoid inconsistencies during failover, we recommend that both fabric interconnects in the cluster have the
same number of ports licensed. If symmetry is not maintained and failover occurs, Cisco UCS enables the
missing licenses and initiates the grace period for each port being used on the failover node.

Obtaining the Host ID for a Fabric Interconnect

The host ID is also known as the serial number.

Procedure

Command or Action Purpose

Step 1 UCS-A# scope license Enters license mode.

Step 2 UCS-A /license # show Obtains the host ID or serial number for the fabric
server-host-id interconnect.
Tip Use the entire host ID that displays after the
equal (=) sign.

Cisco UCS Manager CLI Configuration Guide, Release 2.0

2 OL-25721-05
 Managing Licenses
Obtaining a License

Command or Action Purpose

The following example obtains the host ID for a fabric interconnect:

UCS-A# scope license

UCS-A /license # show server-host-id
Server host id:
Scope Host Id
----- -------
A VDH=SSI12121212
B VDH=SSI13131313
UCS-A /license #

What to Do Next
Obtain the required licenses from Cisco.

Obtaining a License

Note This process may change after the release of this document. If one or more of these steps no longer applies,
contact your Cisco representative for information on how to obtain a license file.

Before You Begin

Obtain the following:
• Host ID or serial number for the fabric interconnect
• Claim certificate or other proof of purchase document for the fabric interconnect or expansion module

Procedure

Step 1 Obtain the product authorization key (PAK) from the claim certificate or other proof of purchase document.
Step 2 Locate the website URL in the claim certificate or proof of purchase document.
Step 3 Access the website URL for the fabric interconnect and enter the serial number and the PAK.
Cisco sends you the license file by email. The license file is digitally signed to authorize use on only the
requested fabric interconnect. The requested features are also enabled once Cisco UCS Manager accesses the
license file.

What to Do Next
Install the license on the fabric interconnect.

Cisco UCS Manager CLI Configuration Guide, Release 2.0

OL-25721-05 3
 Managing Licenses
Installing a License

Installing a License

Note In a cluster setup, we recommend that you download and install licenses to both fabric interconnects in
matching pairs. An individual license is only downloaded to the fabric interconnect that is used to initiate
the download.

Before You Begin

Obtain the required licenses from Cisco.

Procedure

Command or Action Purpose

Step 1 UCS-A# scope license Enters license mode.

Step 2 UCS-A /license # download license Downloads the license from its source location. For the
from-filesystem from-filesystem: argument, use one of the following
syntaxes:
• ftp:// server-ip-addr
• scp:// username@server-ip-addr
• sftp:// username@server-ip-addr
• tftp:// server-ip-addr : port-num

Step 3 UCS-A /license # install file Installs the license.

license_filename

The following example uses FTP to download and install a license:

UCS-A # scope license
UCS-A /license # download license ftp://192.168.10.10/license/port9.lic
UCS-A /license # install file port9.lic
UCS-A /license #

Viewing the Licenses Installed on a Fabric Interconnect

Procedure

Command or Action Purpose

Step 1 UCS-A# scope license Enters license mode.

Cisco UCS Manager CLI Configuration Guide, Release 2.0

4 OL-25721-05
 Managing Licenses
Viewing License Usage for a Fabric Interconnect

Command or Action Purpose

Step 2 UCS-A /license # show file Displays the licenses installed on the fabric
[license_filename | detail] interconnect with the level of detail specified in
the command.

The following example displays the full details for the licenses installed on a fabric interconnect:

UCS-A# scope license

UCS-A /license # show file detail

License file: UCSFEAT20100928112305377.lic

Id: 1212121212121212
Version: 1.0
Scope: A
State: Installed
Features
Feature Name: ETH_PORT_ACTIVATION_PKG
Vendor: cisco
Version: 1.0
Quantity: 24
Lines
Line Id: 1
Type: Increment
Expiry Date: Never
Pak:
Quantity: 24
Signature: B10101010101

License file: UCSFEAT20100928112332175.lic

Id: 1313131313131313
Version: 1.0
Scope: B
State: Installed
Features
Feature Name: ETH_PORT_ACTIVATION_PKG
Vendor: cisco
Version: 1.0
Quantity: 24
Lines
Line Id: 1
Type: Increment
Expiry Date: Never
Pak:
Quantity: 24
Signature: F302020202020

UCS-A /license #

Viewing License Usage for a Fabric Interconnect

Procedure

Command or Purpose
Action
Step 1 UCS-A# scope Enters license mode.
license

Cisco UCS Manager CLI Configuration Guide, Release 2.0

OL-25721-05 5
 Managing Licenses
Viewing License Usage for a Fabric Interconnect

Command or Purpose
Action
Step 2 UCS-A /license # Displays the license usage table for all license files installed on the fabric
show usage interconnect.
This following are included:
• Feat Name

The name of the feature to which the license applies.

• Scope

The fabric associated with the license.

• Default

The default number of licenses provided for this Cisco UCS domain.

• Total Quant

The total number of licenses available. This value is the sum of the
number of default licenses plus the number of purchased licenses.

• Used Quant

The number of licenses currently being used by the system. If this

value exceeds the total number of licenses available, then some ports
will stop functioning after their associated grace period expires.

• State

The operational state of the license.

• Peer License Count Comparison

The number of licenses on the peer fabric interconnect compared to

this fabric interconnect. This can be one of the following:
• exceeds—the peer fabric interconnect has more licenses installed
than this fabric interconnect
• lacks—the peer fabric interconnect has fewer licenses installed
than this fabric interconnect
• matching—the same number of licenses are installed on both
fabric interconnects

Cisco UCS Manager CLI Configuration Guide, Release 2.0

6 OL-25721-05
 Managing Licenses
Uninstalling a License

Command or Purpose
Action
• Grace Used

The number of grace period days that this license has used. After the
grace period ends, Cisco UCS sends alert messages until a new license
is purchased.

The following example displays full details of the licenses installed on a fabric interconnect:

UCS-A# scope license

UCS-A /license # show usage
Feat Name Scope Default Total Quant Used Quant State Peer Count
Comparison Grace Used
------------------------------ ----- ------- ----------- ---------- ----------
----------------------- ----------
ETH_PORT_ACTIVATION_PKG A 16 40 11 License Ok Matching
0
ETH_PORT_ACTIVATION_PKG B 16 40 11 License Ok Matching
0
UCS-A /license #

Uninstalling a License

Note Permanent licenses cannot be uninstalled if they are in use. You can only uninstall a permanent license
that is not in use. If you try to delete a permanent license that is being used, Cisco UCS Manager rejects
the request with an error message.

Before You Begin

• Back up the Cisco UCS Manager configuration.
• Disable the feature or port associated with the license you want to uninstall.

Procedure

Command or Action Purpose

Step 1 UCS-A# scope license Enters license mode.

Step 2 UCS-A /license # clear file license-filename Uninstalls the specified license.

Cisco UCS Manager deactivates the license, removes the license from the list of licenses, and deletes the
license from the fabric interconnect. In a cluster setup, you must uninstall the license from the other fabric
interconnect.

Cisco UCS Manager CLI Configuration Guide, Release 2.0

OL-25721-05 7
 Managing Licenses
Uninstalling a License

The following example shows the uninstallation of port9.lic:

UCS-A # scope license
UCS-A /license # clear file port9.lic
Clearing license port9.lic:
SERVER this_host ANY
VENDOR cisco
INCREMENT ETH_PORT_ACTIVATION_PKG cisco 1.0 permanent 1 \
VENDOR_STRING=<LIC_SOURCE>UCS_SWIFT</LIC_SOURCE><SKU>N10-L001=</SKU> \
HOSTID=VDH=FLC12360025 \
NOTICE="<LicFileID>20090519200954833</LicFileID><LicLineID>1</LicLineID> \
<PAK></PAK>" SIGN=C01FAE4E87FA

Clearing license ........done

UCS-A /license #

Cisco UCS Manager CLI Configuration Guide, Release 2.0

8 OL-25721-05