FOS LicenseGuide v721
FOS LicenseGuide v721
12 December 2013
Fabric OS
Software Licensing Guide
Document History
Title Publication number Summary of changes Date
Index
In this chapter
• Supported hardware and software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
• Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
• Notice to the reader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
• Additional information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
• Getting technical help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
• Document feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii
Document conventions
This section describes text formatting conventions and important notice formats used in this
document.
Text formatting
The narrative-text formatting conventions that are used are as follows:
bold text Identifies command names
Identifies the names of user-manipulated GUI elements
Identifies keywords and operands
Identifies text to enter at the GUI or CLI
italic text Provides emphasis
Identifies variables
Identifies paths and Internet addresses
Identifies document titles
code text Identifies CLI output
Identifies command syntax examples
For readability, command names in the narrative portions of this guide are presented in mixed
lettercase: for example, switchShow. In actual examples, command lettercase is all lowercase.
Command examples
This book describes how to perform configuration tasks using the Fabric OS command line
interface, but does not describe the commands in detail. For complete descriptions of all Fabric OS
commands, including syntax, operand description, and sample output, see the Fabric OS
Command Reference.
NOTE
A note provides a tip, guidance, or advice, emphasizes important information, or provides a
reference to related information.
ATTENTION
An Attention statement indicates potential damage to hardware or data.
CAUTION
A Caution statement alerts you to situations that can be potentially hazardous to you or cause
damage to hardware, firmware, software, or data.
DANGER
A Danger statement indicates conditions or situations that can be potentially lethal or extremely
hazardous to you. Safety labels are also attached directly to products to warn of these conditions
or situations.
Key terms
For definitions specific to Brocade and Fibre Channel, see the technical glossaries on MyBrocade.
See “Brocade resources” on page x for instructions on accessing MyBrocade.
Additional information
This section lists additional Brocade and industry-specific documentation that you might find
helpful.
Brocade resources
To get up-to-the-minute information, go to http://my.brocade.com and register at no cost for a user
ID and password.
For additional Brocade documentation, visit the Brocade SAN Info Center and click the Resource
Library location:
http://www.brocade.com
Release notes are available on the MyBrocade website and are also bundled with the Fabric OS
firmware.
*FT00X0054E9*
FT00X0054E9
In this chapter
• Licensing overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
• How software licensing works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
• License types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
• Licensing terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
• General notes about licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
• Obtaining a license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
• Viewing software license information from the Brocade licensing portal . . . 5
Licensing overview
Feature licenses are often part of the licensed paperpack supplied with your switch software; if not,
they can be purchased separately from your switch vendor, who provides the transaction keys to
activate the associated feature or features. Each product, each feature, and each individual switch
within a fabric requires its own license key.
Licenses may be associated with a feature version. If a feature has a version-based license, that
license is valid only for a particular version of the feature. If you want a newer version of the
feature, you must purchase a new license. If a license is not version-based, then it is valid for all
versions of the feature. Likewise, if you downgrade Fabric OS to an earlier version, some licenses
associated with specific features of the version you are downgrading may not work.
Fabric OS includes basic switch and fabric support software, and support for optionally licensed
software that is enabled using license keys.
Refer to “Available Fabric OS licenses” on page 7 for the list of the optionally licensed features that
are available in Fabric OS.
Once a license is installed on the Brocade Fabric OS switch, the licensed feature is generally
available immediately without requiring to reboot the switch. However, some licenses may require
that you reboot the switch to activate the license; the licenseAdd command will prompt you to
reboot the switch. For the port-related licenses, use the portEnable command to enable a port, or
disable and re-enable the switch to make all newly added ports available simultaneously.
When a temporary license expires, the commands and CLI related to the feature are disabled, but
the feature itself cannot be disabled until the system reloads.
License types
The following license types are supported in Fabric OS:
• Permanent license - A permanent license enables a license-controlled feature to run on the
switch indefinitely.
• Temporary license - A temporary license enables a license-controlled feature to run on the
switch on a temporary basis. A temporary license enables demonstration and evaluation of a
licensed feature and can be valid for a period of 45 days.
• Universal temporary license - A universal temporary license can only be installed once on a
switch, but can be applied to as many switches as required. Temporary use duration (the
length of time the feature will be enabled on a switch) is provided with the license keys.
• Slot-based licensing - A slot-based license allows you to select the slots that the license will
enable up to the capacity purchased and to increase the capacity without disrupting slots that
already have licensed features running. Each licensed feature supported on the blade has a
separate slot-based license key. Refer to “Slot-based licensing” on page 14 for more
information.
Licensing terminology
The following terms are used in this document:
• Entitlement certificate - The proof-of-purchase certificate (paperpack) issued by Brocade when
a license is purchased. The certificate contains a unique transaction key that is used in
conjunction with the LID of the Brocade switch to generate and download a software license
from the Brocade software licensing portal.
• License file - The file produced by the Brocade software licensing portal when the license is
generated. The license key is contained within the license file.
• License ID (LID) - The identification number that uniquely identifies the Brocade switch. The
LID is used in conjunction with a transaction key to generate a license key from the Brocade
software licensing portal. The license key is tied to the LID of the Brocade switch for which the
license was ordered and generated.
• Licensed feature - Any hardware or software feature or set of features that require a valid
software license in order to operate on the switch.
• Transaction key - A unique key, along with the LID, used to generate a software license key from
the Brocade software licensing portal. The transaction key is issued by Brocade when a license
is purchased. The transaction key is delivered according to the method specified when the
order is placed:
- Paperpack - The transaction key is recorded on an entitlement certificate, which is mailed
to the customer.
- Electronic - The transaction key is contained in an e-mail message, which is sent instantly
to the customer after the order is placed. The customer receives the e-mail message
within a few minutes after the order is placed, though the timing will vary depending on the
network, Internet connection, and so on.
If a delivery method is not specified at the time of the order, the key will be delivered by the way
of paperpack.
Obtaining a license
Use the following procedure to generate and obtain a software license.
1. Order a license for the desired licensed feature.
NOTE
To obtain a trial license, contact your Brocade representative.
2. When you receive the paperpack or electronic transaction key, retrieve the LID of your Brocade
switch by entering the licenseIdShow command on the switch. If you received a paperpack
transaction key, write the LID in the space provided on the entitlement certificate.
NOTE
Do not discard the entitlement certificate or e-mail with the electronic key. Keep it in a safe
place in case it is needed for technical support or product replacement (RMAs).
4. From the License Management menu, select Brocade FOS > License Generation With
Transaction Key.
The Brocade FOS License Generation window displays as shown in Figure 2.
5. Enter the requested information in the required fields. An asterisk (*) next to a field indicates
that the information is required.
NOTE
You can generate more than one license at a time. For each license request, enter the Unit's
Unique ID and Transaction Key, and click Add.
6. When you have finished entering the required information, read the Brocade End User License
Agreement, and select the I have read and accept check box.
7. Click the Generate button to generate the license.
The results window displays an order summary and the results of the license request.
• If the license request is successful, the Status field shows "Success" and the License File
field contains a hyperlink to the generated license file. The license file is automatically
sent by e-mail to the specified customer e-mail address.
• If the license request fails, the Status field indicates the reason it failed and the action to
be taken.
8. Download the license file to your PC by either clicking the hyperlink in the License File field or
saving the license file from the e-mail attachment.
9. Install the license on the Fabric OS switch by following the procedure in “Adding a licensed
feature” on page 20.
• To view software license information for a particular unit, enter the LID in the Unit ID field and
click Search.
• To view software license information for a particular transaction key, enter the unique number
in the Transaction key field and click Search.
In the FOS Unit License Query results window, the line items for Level 1 display hardware-related
information and the line items for Level 2 display software-related information. If the query was
performed before the transaction key was generated, the first row (Level 1) would not appear as
part of the search results. Similarly, if the query was performed before the license was generated,
some of the information in the second row would not be displayed.
Fabric OS Licenses 2
In this chapter
• Available Fabric OS licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
• Brocade 7800 Upgrade license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
• ICL licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
• 8G licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
• Slot-based licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
• 10G licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
• Temporary licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
10 Gigabit FCIP/Fibre Channel • Allows 10 Gbps operation of FC ports on the Brocade 6510 or
(10G license) 6520 switches or the FC ports of FC16-32 or FC16-48 port
blades installed on a Brocade DCX 8510 Backbone.
• Enables the two 10-GbE ports on the FX8-24 extension blade
when installed on the Brocade DCX, DCX-4S, DCX 8510-4, or
DCX 8510-8 Backbone.
• Allows selection of the following operational modes on the
FX8-24 blade:
- 10 1-GbE ports and 1 10-GbE port, or
- 2 10-GbE ports
• License is slot-based when applied to a Brocade Backbone. It is
chassis-based when applied to a Brocade 6510 or 6520 switch.
7800 Upgrade • Enables full hardware capabilities on the Brocade 7800 base
switch, increasing the number of Fibre Channel ports from four
to sixteen and the number of GbE ports from two to six.
• Supports up to eight FCIP tunnels instead of two.
• Supports advanced capabilities such as tape read/write
pipelining.
NOTE: The Brocade 7800 switch must have the 7800 Upgrade
license to add FICON Management Server (CUP) or Advanced
FICON Acceleration licenses. Refer to “Brocade 7800 Upgrade
license” on page 11 for details.
Adaptive Networking with QoS Provides a rich framework of capability, allowing a user to ensure that
high-priority connections obtain the bandwidth necessary for
optimum performance, even in congested environments. The QoS
SID/DID Prioritization and Ingress Rate Limiting features are included
in this license, and are fully available on all 8-Gb and 16-Gb platforms.
NOTE: The Brocade 6520 does not require an Adaptive Networking
with QoS license to enable the capabilities associated with
this license. These capabilities are included by default on the
Brocade 6520.
NOTE: This license is automatically enabled for new switches that
operate with only Fabric OS 7.2.0 or later and for existing
switches that are upgraded to Fabric OS 7.2.0 or later.
Advanced Extension • Enables two advanced extension features: FCIP Trunking and
Adaptive Rate Limiting.
• FCIP Trunking feature allows all of the following:
- Multiple (up to 4) IP source and destination address pairs
(defined as FCIP Circuits) using multiple (up to 4) 1-GbE or
10-GbE interfaces to provide a high bandwidth FCIP tunnel
and failover resiliency.
- Support for up to 4 of the following QoS classes: Class-F,
high, medium, and low priority, each as a TCP connection.
• The Adaptive Rate Limiting feature provides a minimum
bandwidth guarantee for each tunnel with full usage of available
network bandwidth without any negative impact to throughput
performance under high traffic load.
• Available on the Brocade 7800 switch, and the Brocade DCX and
DCX-4S and the Brocade DCX 8510 family for the FX8-24 on an
individual slot basis.
Advanced FICON Acceleration • Allows use of specialized data management techniques and
automated intelligence to accelerate FICON tape read and write
and IBM Global Mirror data replication operations over distance,
while maintaining the integrity of command and
acknowledgement sequences.
• Available on the Brocade 7800 switch, and the Brocade DCX and
DCX-4S and the Brocade DCX 8510 family for the FX8-24 on an
individual slot basis.
Brocade Advanced Performance • Enables performance monitoring of networked storage
Monitoring resources.
• Includes the Top Talkers feature.
Brocade Extended Fabrics Provides greater than 10 km of switched fabric connectivity at full
bandwidth over long distances (depending on the platform, this can
be up to 3000 km).
NOTE: This license is not required for long distance connectivity using
licensed 10G ports.
Brocade Fabric Watch • Monitors mission-critical switch operations.
• Includes Port Fencing capabilities.
Brocade ISL Trunking • Provides the ability to aggregate multiple physical links into one
logical link for enhanced network performance and fault
tolerance.
• Includes Access Gateway ISL Trunking on those products that
support Access Gateway deployment.
Brocade Ports on Demand Allows you to instantly scale the fabric by provisioning additional ports
using license key upgrades.
NOTE: Applies to the Brocade 300, 5100, 5300, M6505, 6505,
6510, 6520, 6547, 6548, and VA-40FC switches.
DataFort Compatibility Provides ability to read, write, decrypt, and encrypt the NetApp
DataFort-encrypted Disk LUNs and Tapes to all of the following:
• Brocade Encryption Switch
• Brocade enterprise platforms with FS8-18 blade
Includes metadata, encryption and compression algorithms.
NOTE: Availability is limited. Contact your vendor for details.
Encryption Performance Upgrade Provides additional encryption bandwidth on encryption platforms.
For the Brocade Encryption Switch, two Encryption Performance
Upgrade licenses can be installed to enable the full available
bandwidth. On a Brocade enterprise platform, a single Performance
License can be installed to enable full bandwidth on all FS8-18 blades
installed in the chassis.
Enhanced Group Management Enables full management of the device in a data center fabric with
deeper element management functionality and greater management
task aggregation throughout the environment. This license is used in
conjunction with Brocade Network Advisor application software. This
license is applicable to all of the Brocade 8G and 16G FC platforms.
NOTE: This license is enabled by default on all 16G FC platforms, and
on DCX and DCX-4S platforms that are running Fabric OS
v7.0.0 or later.
This license is not included by default on 8G FC fixed port
switches (300, 5100, 5300, VA-40FC, and 8G FC embedded
switches).
Enterprise ICL Allows you to connect more than four chassis in a fabric using ICLs.
You can connect up to four Brocade DCX 8510 Backbones via ICLs
without this license. If the number of interconnected chassis using
ICLs exceeds four, then all of the chassis using ICLs require the
Enterprise ICL license. Note that this license requirement does not
depend upon the total number of DCX 8510 chassis that exist in a
fabric, but only on how many chassis are interconnected via ICLs.
You must also have an ICL POD license on each Brocade DCX 8510 to
activate the ICL ports. The Enterprise ICL license only allows
connection of more than four chassis using ICLs in a fabric; it does not
enable the ICL ports on a chassis.
NOTE: Applies to the Brocade DCX 8510 Backbone family only.
Fabric Vision (FV) Allows you to activate the following features:
• Monitoring and Alerting Policy Suite (MAPS)
• Flow Vision
• Run D_Port tests between a switch and non-Brocade HBAs
This license replaces the Advanced Performance Monitor (APM) and
Fabric Watch (FW) licenses. If you have the Fabric Vision license, you
can use Advanced Performance Monitoring and Fabric Watch features
without the APM and FW licenses.
FCoE Enables Fibre Channel over Ethernet (FCoE) functions.
FICON Management Server Enables host-control of switches in mainframe environments.
(Also known as Control Unit Port or “CUP”)
NOTE
You must reboot the Brocade 7800 switch after installing the 7800 Upgrade license.
ICL licensing
Brocade ICL links operate between the core blades of the DCX 8510 Backbone family, or between
the core blades of the DCX and DCX-4S Backbones. Typically, if both core blades are installed, then
they are active on the DCX and DCX-4S (or DCX 8510 family) Backbones.
ICL ports on core blades of a DCX 8510-8 can be used only with an ICL (1st or 2nd) POD license.
ICL ports on core blades of a DCX 8510-4 can be used only with an ICL 1st POD license.
ICL ports on core blades of a DCX can be used only with an ICL 16-link or ICL 8-link license. ICL
ports on core blades of a DCX-4S can be used only with an ICL 8-link license.
After the addition or removal of a license, the license enforcement is performed on the ICL ports
only when the portDisable and portEnable commands are issued on the ports. An ICL license must
be installed on the enterprise platforms at both ends of the ICL connection.
8G licensing
ATTENTION
The 8G license is installed by default and you should not remove it. Port operation may become
disrupted, and ports may be prevented from operating at 8 Gbps when the license is removed.
The 8G license applies to the Brocade 300, 5100, 5300, and VA-40FC switches and the 8 Gbps
embedded switches; this license does not apply to the Brocade 6505, 6510, or 6520.
The following list describes the basic rules of using, adding, or removing 8G licenses:
• Without an 8G license, even if there is an 8 Gbps SFP plugged into a port in an applicable
platform, the port would be enabled to run at a maximum speed of 4 Gbps.
• To obtain an 8G license, only the license ID from the switch is required. When you add the 8G
license, you must enter either the portDisable and portEnable commands on each individual
port on the switch, or the switchDisable and switchEnable commands on the switch, to enable
8 Gbps features.
• When you remove the 8G license, the ports that are online and already running at 8 Gbps are
not disturbed until the port goes offline or the switch is rebooted. The switch ports return to
their pre-licensed state maximum speed of 4 Gbps.
Slot-based licensing
Slot-based licensing is used on the Brocade DCX and DCX 8510 Backbone families to support the
FX8-24 blade, and on the Brocade DCX 8510 Backbone family to support the 16-Gbps FC port
blades (FC16-24 and FC16-48). License capacity is equal to the number of slots. These licenses
allow you to select the slots that the license will enable up to the capacity purchased and to
increase the capacity without disrupting slots that already have licensed features running. Each
slot-based license key is for a single feature.
Features utilizing slot-based licenses on the FX8-24 blade include:
• 10 Gigabit FCIP/Fibre Channel
• Advanced Extension
• Advanced FICON Acceleration
NOTE
The 10 GbE feature on the FX8-24 blade and the 10 Gbps FC feature on the 16-Gbps FC blades are
both enabled by the same 10 Gigabit FCIP/Fibre Channel license (10G license). This license can also
enable the 10 Gbps FC feature on a Brocade 6510 or 6520 switch as a chassis-based license.
Any unassigned slot-based license will be automatically assigned to applicable blades that are
detected in the chassis when the license is installed. If you have more applicable blades than
available license capacity, then you can manually assign or re-assign the licenses as necessary.
Once a license is assigned to a slot, whether it has been automatically assigned or manually
assigned, the assignment will remain until you manually re-assign the license to another slot. This
design allows for various maintenance operations to occur without having the license move around
to other slots.
10G licensing
The 10 Gbps FCIP/Fibre Channel license (10G license) enables the following features:
• 10 Gbps access on the 16-Gbps FC ports on Brocade 6510 or 6520 switches, and FC16-32
and FC16-48 port blades.
• The two 10-GbE ports on the FX8-24 extension blade.
This 10G license is applied as a slot-based license on the FC16-32 and FC16-48 port blades and
on the FX8-24 extension blade; generic rules for adding slot-based licenses apply, as described in
“Slot-based licensing” on page 14. When this license is applied to a Brocade 6510 or 6520 switch,
it is applied to the whole chassis.
Whether you have a bladed (DCX, DCX-4S, DCX 8510-8, or DCX 8510-4) platform or nonbladed
(Brocade 6510 or 6520) switch, you add the 10G license to the chassis using the licenseAdd
command, as for any license.
For the bladed platforms, you can either allow automatic license assignment, or choose the blades
you want the licenses assigned to manually, as for any slot-based license. Automatic assignment is
done sequentially by slot number, beginning with the lowest numbered slot with an enabled blade
that supports this feature (FX8-24, FC16-32, or FC16-48 blade), and that does not already have the
license applied. If the automatic license assignment does not match your needs, you can use the
licenseSlotCfg --remove and licenseSlotCfg --add commands to remove the license manually from
a slot and assign it to a different slot with an FX8-24, FC16-32, or FC16-48 blade.
The same multiple slot-based 10G license can be applied to a mixture of 16-Gbps blades and
FX8-24 blades. For example, if you have a 10G license for two-slot capacity, and you have an
FX8-24 blade in one slot and an FC16-48 blade in a second slot, then the same license can
activate the 10GE ports on the FX8-24 blade and enable 10 Gbps operation on the 10-Gbps FC
ports on the FC16-48 blade.
After applying a 10G license to the Brocade 6510 or 6520 chassis or to a 16-Gbps FC blade, you
must also configure the port octet (portCfgOctetSpeedCombo command) with the correct port octet
speed group and configure each port to operate at 10 Gbps (portCfgSpeed command). It is
necessary to configure the port octet because only certain combinations of port speeds are
allowed within the port octet. No license is required for the octet group. If the speed configuration
operation succeeds and a 10G-capable SFP is inserted in the port connector, the port will allow
operation at 10 Gbps when the link becomes active at that speed.
Before removing a 10G license from an entire platform (licenseRemove command) or from a
specific blade (licenseSlotCfg --remove command), you must first deconfigure all affected FC ports
to no longer operate at 10 Gbps.
NOTE
An FC port that is operating at 10 Gbps FC speed on a 16-Gbps FC blade or 16-Gbps FC switch does
not need an Extended Fabrics license to be used for FC long distance connectivity.
FC ports licensed and configured to operate at 10 Gbps on a Brocade 6510 or 6520 switch or
16-Gbps FC port blade cannot interoperate with 10-Gbps FC ports on the M-6140 platform or the
FC10-6 blade. The new FC ports use different protocols and physical connections.
Temporary licenses
A temporary license applies a “try-before-you-buy” approach to certain features so that you can
experience the feature and its capabilities prior to buying the license. Once you have installed the
license, you are given a time limit to use the feature. A temporary license can be either a regular
temporary license or a universal temporary license.
• A regular temporary license is available on a per-switch basis.
• A universal temporary license can be installed on a switch, but can be applied to multiple
switches.
The following licenses are available as temporary or universal temporary licenses:
• 10 Gigabit FCIP/Fibre Channel license (slot-based)
• Adaptive Networking License (deprecated from Fabric OS v7.2.0)
• Advanced Extension license (slot-based)
• Advanced FICON Acceleration license (slot-based)
• Advanced Performance Monitoring license
• Enterprise ICL license
• Extended Fabrics license
• Fabric (E_Port) license
• Fabric Watch license
• FICON Management Server (CUP) license
• Full Fabric license
• High Performance Extension over FCIP/FC license
• Integrated Routing license
• ISL Trunking license
• Server Application Optimization license (deprecated from Fabric OS v7.2.0)
3. Remove the license from the original slots using the licenseSlotCfg --remove command.
4. Add the license to the new slots using the licenseSlotCfg --add command.
CAUTION
If you are using NTP to synchronize the time between your network devices, including switches or
Backbones, then do not attempt to change the system date and time when a temporary license is
installed.
Expired licenses
Once a temporary license has expired, you can view it through the licenseShow command. Expired
licenses have an output string of “License has expired”. RASlog warning messages are generated
every hour for licenses present in the database which have expired or are going to expire in the next
five days. An expired license may become unusable after a reboot, failover, firmware download, or a
port or switch disable or enable operation.
Licensing Tasks 3
In this chapter
• Software licensing configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
• Licensing commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
• Adding a licensed feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
• Activating a slot-based licensed feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
• Assigning a license to a slot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
• Assigning 10G licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
• Removing software licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
• Viewing information about software licenses . . . . . . . . . . . . . . . . . . . . . . . . 25
• Troubleshooting licensing issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
• Activating or removing licenses using Web Tools . . . . . . . . . . . . . . . . . . . . . 27
Licensing commands
Table 3 summarizes the Fabric OS CLI commands that can be used for licensed feature
management. For detailed information on these commands, refer to the Fabric OS Command
Reference.
licenseAdd Adds a license to the switch. The license key is case-sensitive and
must be entered exactly.
licenseIdShow Displays the license ID of the system.
licensePort Manages and displays Dynamic Ports on Demand (DPOD) license assignments.
licenseRemove Removes a license from the switch.
licenseShow Displays current license keys, along with a list of licensed products enabled by these
keys.
licenseSlotCfg Configures and manages licenses for the Brocade FX8-24 extension blade on the slot
where the blade is installed.
For the Brocade Backbones, licenses are effective on both control processor (CP) blades, but are
valid only when the CP blade is inserted into a Backbone that has an appropriate license ID stored
in the WWN card. If a CP is moved from one Backbone to another, the license works in the new
Backbone only if the WWN card is the same in the new Backbone. Otherwise, you must transfer
licenses from the old platform to the new platform by obtaining new licenses for the previously
licensed features using the new license ID.
For example, if you swap one CP blade at a time, or replace a single CP blade, then the existing CP
blade (the active CP blade) propagates the licenses to the new CP blade if the WWN card has been
moved to the new platform.
If you move a standby CP from one Backbone to another, then the active CP will propagate its
configuration (including license keys) onto that standby CP.
Use the following procedure to add a licensed feature.
1. Connect to the switch and log in using an account with admin permissions.
2. Activate the license using the licenseAdd license_key command. The license key is
case-sensitive and must be entered exactly as given. The quotation marks are optional.
3. Verify the license was added by entering the licenseShow command. The licensed features
currently installed on the switch are listed. If the feature is not listed, enter the licenseAdd
command again.
Some features may require additional configuration, or you may need to disable and re-enable
the switch to make them operational; refer to the feature documentation in Fabric OS
Administrator’s Guide for details.
switch:admin> licenseshow
aAYtMJg7tmMZrTZ9JTWBC4SXWLJMY3QfBJYHG:
Fabric license
Remote Switch license
Remote Fabric license
Entering the licenseShow command after the licenseRemove command displays the remaining
licenses.
switch:admin> licenseshow
SybbzQQ9edTzcc0X:
Fabric license
CAUTION
This procedure is disruptive to the switch.
Save the output to a text file in a secure location. If licenses are lost or removed from the switch,
you can use the saved output to recover or add the lost licenses.
Some licenses may display with the text “Obsolete license.” This happens because of changes in
licensing requirements of some features that no longer require a license key, yet are still installed
on a switch.
3. Paste or enter a license key in the License Key field and click Ok.
4. Click Refresh to display the new licenses in the License tab.
If the feature is listed, the licensed feature is installed and immediately available. When you
enable some licenses, such as ISL Trunking, you may need to change the state of the port to
enable the feature on the link. Some licenses, such as the Trunking or Brocade 7800 Upgrade
license do not take effect until the switch is restarted.
NOTE
You can enable slot-based licenses only on 10 Gigabit Ethernet (FTR_10G), Advanced Extension
(FTR_AE), and Advanced FICON Acceleration (FTR_AFA) features.
ATTENTION
Use care when removing licenses. If you remove a license for a feature, that feature no longer works.
1. Click Configure > Switch Admin to open the Switch Administration window.
The Switch Administration window displays as shown in Figure 5.
2. Select the License tab.
3. Select the license key you want to remove.
4. Click Remove.
In this chapter
• Ports on Demand Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
• Activating Ports on Demand using a Telnet session . . . . . . . . . . . . . . . . . . . 33
• Activating Ports on Demand using EZSwitchSetup . . . . . . . . . . . . . . . . . . . . 33
• Activating Ports on Demand using Web Tools . . . . . . . . . . . . . . . . . . . . . . . . 34
• Displaying installed licenses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
• Dynamic Ports on Demand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
ATTENTION
Licenses are not interchangeable between units. For example, if you bought a POD license for a
Brocade 300, you cannot use that license on a Brocade 5100 or VA-40FC. The licenses are based
on the switch license IDs (LIDs) and are not interchangeable.
Table 4 shows the ports that are enabled by default and the ports that can be enabled after you
install the first and second Ports on Demand licenses for each switch type.
Ports on Demand is ready to be unlocked in the switch firmware. Its license key may be part of the
licensed paperpack supplied with switch software, or you can purchase the license key separately
from your switch vendor. You may need to generate a license key from a transaction key supplied
with your purchase. Refer to “Obtaining a license” on page 3 for instructions to generate the license
key.
Each Ports on Demand license activates the next group of ports in numerical order in either 4-port
or 8- or 12-port increments, depending on the model. Before installing a license key, you must
insert transceivers in the ports to be activated. Remember to insert the transceivers in the lowest
group of inactive port numbers first. For example, if only 16 ports are currently active and you are
installing one Ports on Demand license key, make sure to insert the transceivers in ports 16
through 23. If you later install a second license key, insert the transceivers in ports 24 through 31.
For details on inserting transceivers, see the switch’s hardware reference manual.
3. Enter the license key in the License Key field to add the additional ports.
4. Click Add License.
5. Enable the ports using one of the following methods:
• Use the portDisable and portEnable commands on the command line interface.
• Reboot or power cycle the switch
When the switch is rebooted, the newly licensed ports come up as enabled.
• Use the Advanced Management tool. Refer to the EZSwitchSetup Administrator’s Guide for
information on accessing Web Tools for advanced management.
NOTE
Use Shift + click and Ctrl + click to select multiple ports. You can select multiple ports from
the table. You cannot select multiple ports from the tree.
ATTENTION
If you enable or disable an active port, you will disrupt any traffic and potentially lose data flowing
on that port.
If the port is connected to another switch, you will segment the switch from the fabric and all traffic
flowing between the disabled port and the fabric will be lost.
If you remove a Ports on Demand license, the licensed ports will become disabled after the next
platform reboot or the next port deactivation.
- Brocade 6547
- Brocade 6548
For the embedded switch modules, the Dynamic POD feature detects and assigns ports to a POD
license only if the server blade is installed with an HBA present. A server blade that does not have a
functioning HBA is treated as an inactive link during initial POD port assignment. For the non-server
blade switches, the dynamic assignment occurs when an attached Fibre Channel link transitions to
the “link active” state.
The Dynamic POD feature assigns the ports to the POD license as they come online. Typically,
assignments are sequential, starting with the lowest port number. However, variations in the
equipment attached to the ports can cause the ports to take different amounts of time to come
online. This means that the port assignment order is not guaranteed.
If the switch detects more active links than allowed by the current POD licenses, then some ports
will not be assigned a POD license. Ports that do not receive a POD assignment have a state of
No Sync or In Sync; these ports are not allowed to progress to the online state. Ports that cannot be
brought online because of insufficient POD licenses have a state of (No POD License) Disabled. You
can use the switchShow command to display the port states.
4. Enter the licensePort --show command to verify the switch started the Dynamic POD feature.
switch:admin> licenseport --show
24 ports are available in this switch
Full POD license is installed
Dynamic POD method is in use
24 port assignments are provisioned for use in this switch:
12 port assignments are provisioned by the base switch license
12 port assignments are provisioned by a full POD license
8 ports are assigned to installed licenses:
8 ports are assigned to the base switch license
0 ports are assigned to the full POD license
Ports assigned to the base switch license:
1, 2, 5, 6, 8*, 21, 22, 23
Ports assigned to the full POD license:
None
Ports not assigned to a license:
0, 3, 4, 7, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20
NOTE
If you click the Enable DPOD button on an unsupported switch, an error message displays.
To enable Dynamic Ports on Demand using Web Tools, perform the following steps.
1. Select a port in the Switch View to open the Port Admin tab.
2. Select the FC Ports tab.
3. From the tree on the left, select the switch or the slot that contains the port.
4. Click Enable DPOD to enable the licensing mechanism to be dynamic. If the button is labeled
Disable DPOD, the licensing mechanism is already set to dynamic.
The existing POD associations and assignments are set as the initial Dynamic POD
associations.
To disable the Dynamic POD feature using Web Tools, log in and perform the following steps.
1. Select a port in the Switch View to open the Port Admin tab.
2. Select the FC Ports or GigE Ports tab.
3. From the tree on the left, select the switch or the slot that contains the port.
4. Click Disable DPOD to set the licensing mechanism to static. If the button is labeled Enable
DPOD, the licensing mechanism is already set to static.
3. Take the following appropriate action based on whether port reservations are available:
• If a port reservation is available, then issue the licensePort --reserve command to reserve
a license for the port.
switch:admin> licenseport -reserve 0
• If all port reservations are assigned, select a port to release its POD license. Follow the
instructions in “Releasing a port from a POD set” to release a port from its POD
assignment. Once the port is released, you can reserve it.
5. Enter the licensePort --show command to verify the port is no longer assigned to a POD set.
switch:admin> licenseport --show
24 ports are available in this switch
Full POD license is installed
Dynamic POD method is in use
24 port assignments are provisioned for use in this switch:
12 port assignments are provisioned by the base switch license
12 port assignments are provisioned by a full POD license
10 ports are assigned to installed licenses:
10 ports are assigned to the base switch license
0 ports are assigned to the full POD license
Ports assigned to the base switch license:
1*, 2*, 3*, 4*, 5*, 6*, 8*, 21, 22, 23
Ports assigned to the full POD license:
None
Ports not assigned to a license:
0, 7, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20
Table 5 lists licensed features, each feature’s associated license name, and, if applicable, the
location on the local or any connecting switch on which the license must be installed.
FICON Tape Read and • FICON Tape Local and attached switches.
Write Emulation over an • High Performance Extension over FCIP/FC
FCIP Tunnel license or Advanced FICON Acceleration
license on Brocade 7800
FICON XRC Sequence • FICON XRC Local and attached switches.
Emulation over an FCIP • High Performance Extension over FCIP/FC
Tunnel license or Advanced FICON Acceleration
license on Brocade 7800
FIPS No license required. N/A
Firmware download No license required. N/A
NOTE: The firmwareDownload command is
provided automatically with Fabric OS
on the switch.
Flow Vision: Fabric Vision Local switch.
• Flow Generator NOTE: If you have both the Advanced
• Flow Performance Performance Monitoring and the Fabric
Monitor Watch licenses installed, you do not
• Flow Mirror need the Fabric Vision license.
Full fabric connectivity Full Fabric Local switch. May be required on
NOTE: Also called the Fabric license (visible in attached switches.
licenseShow output) and the E_Port
Upgrade license.
In-flight encryption and No license required. N/A
compression
In-band Management No license required. N/A
Ingress rate limiting No license required. N/A for local switches running
Adaptive Networking with QoS license is Fabric OS 7.2.0 or later.
required for switches running Fabric OS License required on local switches
versions earlier than 7.2.0. running Fabric OS versions earlier
The Brocade 6520 does not require a license than 7.2.0.
regardless of Fabric OS version.
Inter-chassis link (ICL) • ICL 1st POD (Ports on Demand) on the Local and attached platforms.
Brocade DCX 8510 Backbone family only.
• ICL 2nd POD on the Brocade DCX 8510-8
only.
• ICL 8-link on the Brocade DCX and DCX-4S
only.
• ICL 16-link on the Brocade DCX only.
• Enterprise ICL on the Brocade DCX 8510
Backbone family only, for topologies with
more than four chassis with ICLs.
IPsec No license required. N/A
IPsec for FCIP tunnels High Performance Extension over FCIP/FC NOTE: Local and attached
switches. License is needed
on both sides of tunnel.
LDAP No license required. N/A
Logical fabric No license required. N/A
Numerics C
10 Gbps operation on an FC port, enabling, 22 command
10G license, 15–23 bladeCfgGeMode, 23
16-link ICL license, 12 configDownload, 17
1st POD ICL license, 12 configUpload, 17
2nd POD ICL license, 12 licenseAdd, 20, 22, 23, 26
8G license, 13 licenseIdShow, 20, 25
licensePort, 20, 36, 37, 38, 39, 40
8-link ICL license, 12
licenseRemove, 20, 24
licenseShow, 17, 20, 22, 23, 24, 25, 26, 35
licenseSlotCfg, 15, 17, 20, 21, 22, 23, 24
A portCfgOctetSpeedCombo, 15, 22
portCfgSpeed, 15, 22
activating portDisable, 34, 40
licenses, 27 portEnable, 33, 34, 40
portShow, 33, 40
reboot, 25
B switchShow, 36
configDownload command, 17
bladeCfgGeMode command, 23 configUpload, 3
Brocade 6520, 8, 11 configUpload command, 17
Brocade 7800, upgrade license, 7, 11
Brocade DCX, 10
Brocade DCX 8510, 9 D
Brocade DCX 8510-4, 10
Brocade DCX 8510-8, 10 date change license restriction, 17
Brocade FX8-24
enabling 10-GbE ports, 23
Brocade software licensing portal, 1, 4, 5 E
Electronic, 3
enabling
10 Gbps operation on an FC port, 22
10-GbE ports on an FX8-24 blade, 23
enterprise ICL license, 13
Entitlement certificate, 2
entitlement certificate, 1, 3, 4
expired licenses, 17
removing, 25
extending a universal temporary license, 17
EZSwitchSetup, 33
I
ICL P
16-link license, 12
1st POD license, 12 Paperpack, 3
2nd POD license, 12 paperpack, 1
8-link license, 12 permanent license, 2
enterprise license, 13 portCfgOctetSpeedCombo command, 15, 22
licensing, 11–13 portCfgSpeed command, 15, 22
portDisable, 12
portDisable command, 34, 40
L portEnable, 2, 12
portEnable command, 33, 34, 40
license portShow command, 33, 40
10G, 15–23
8G, 13
Brocade 7800 upgrade, 11
date change restriction, 17 R
enterprise ICL, 13
reboot command, 25
expired, 17
removing
ICL, 11–13
ICL 16-link, 12 licensed features, 24
ICL 1st POD, 12 licenses, 28
ICL 2nd POD, 12 restrictions
ICL 8-link, 12 upgrading temporary slot-based licenses, 16
removing expired, 25
removing features, 24
slot-based, 14–?? S
temporary, 16–18
time-based, 16–18 shelf life of a universal temporary license, 18
universal temporary slot-based license, 2
extending, 17 slot-based licensing, 14–??
shelf life, 18 switchShow, 12
universal temporary, described, 17
switchShow command, 36
License file, 2
License ID (LID), 2
license ID (LID), 1
license key transfer, 3 T
License types, 2
temporary license, 2
U
universal temporary license, 2
defined, 16
described, 17
extending, 17
shelf life, 18
upgrading temporary slot-based licenses, restrictions, 16
V
version-based license, 1
W
Web Tools, 26, 27, 34, 37, 38