The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter includes the following sections:
Port licenses for each Cisco UCS fabric interconnect are factory installed and shipped with the hardware. At a minimum, each fabric interconnect ships with the following counted licenses pre-installed:
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.
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.
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.
The host ID is also known as the serial number.
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 #
Obtain the required licenses from Cisco.
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. |
Obtain the following:
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. |
Install the license on the fabric interconnect.
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. |
Obtain the required licenses from Cisco.
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# scope license | Enters license mode. |
Step 2 | UCS-A /license # download license from-filesystem | Downloads the license from its source location. For the from-filesystem: argument, use one of the following syntaxes: |
Step 3 | UCS-A /license # install file license_filename | Installs the license. |
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 #
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# scope license | Enters license mode. |
Step 2 | UCS-A /license # show file [license_filename | detail] | Displays the licenses installed on the fabric 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 #
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# scope license | Enters license mode. |
Step 2 | UCS-A /license # show usage | Displays the license usage table for all license files installed on the fabric interconnect.
|
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 Status 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 #
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. |
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.
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 #