Brocade Basics PDF
Brocade Basics PDF
53-1005247-02
31 December 2017
Copyright © 2017 Brocade Communications Systems LLC. All Rights Reserved.
Brocade and the stylized B logo are among the trademarks of Brocade Communications Systems LLC. Broadcom, the pulse logo, and Connecting
everything are among the trademarks of Broadcom. The term "Broadcom" refers to Broadcom Limited and/or its subsidiaries
Brocade, a Broadcom Limited Company, reserves the right to make changes without further notice to any products or data herein to improve reliability,
function, or design. Information furnished by Brocade is believed to be accurate and reliable. However, Brocade does not assume any liability arising out of
the application or use of this information, nor the application or use of any product or circuit described herein, neither does it convey any license under its
patent rights nor the rights of others.
The product described by this document may contain open source software covered by the GNU General Public License or other open source license
agreements. To find out which open source software is included in Brocade products, view the licensing terms applicable to the open source software, and
obtain a copy of the programming source code, please visit [Link]
Fabric OS Licenses.......................................................................................................................................................................................................... 15
Available Fabric OS licenses.............................................................................................................................................................................................................. 15
ICL licensing..............................................................................................................................................................................................................................................18
ICL 1st POD license.................................................................................................................................................................................................................... 18
ICL 2nd POD license...................................................................................................................................................................................................................18
ICL POD license on Brocade X6 platforms....................................................................................................................................................................... 19
Enterprise ICL license.................................................................................................................................................................................................................. 19
10G licensing........................................................................................................................................................................................................................................... 20
Slot-based licensing.............................................................................................................................................................................................................................. 20
Temporary licensing...............................................................................................................................................................................................................................21
Restrictions on upgrading temporary slot-based licenses...........................................................................................................................................22
Date change restriction................................................................................................................................................................................................................22
Configuration upload and download considerations.......................................................................................................................................................22
Expired licenses..............................................................................................................................................................................................................................22
Universal temporary licenses....................................................................................................................................................................................................23
Licensing Tasks.................................................................................................................................................................................................................25
Software licensing configuration tasks........................................................................................................................................................................................... 25
Licensing commands............................................................................................................................................................................................................................25
Adding a licensed feature.................................................................................................................................................................................................................... 26
Activating a slot-based licensed feature........................................................................................................................................................................................27
Assigning a license to a slot................................................................................................................................................................................................................28
Assigning 10G licenses....................................................................................................................................................................................................................... 28
Enabling 10-Gbps operation on an FC port......................................................................................................................................................................28
Enabling the 10-GbE ports on an FX8-24 blade...........................................................................................................................................................29
Removing software licenses............................................................................................................................................................................................................... 30
Removing a licensed feature.....................................................................................................................................................................................................30
Although many different software and hardware configurations are tested and supported by Brocade for Fabric OS 8.2.0, documenting
all possible configurations and scenarios is beyond the scope of this document.
Fabric OS support for the Brocade Analytics Monitoring Platform (AMP) device depends on the specific version of the software running
on that platform. For more information, refer to the Brocade Analytics Monitoring Platform documentation and release notes.
Document conventions
The document conventions describe text formatting conventions, command syntax conventions, and important notice formats used in
Brocade technical documentation.
hazards.
NOTE
A Note provides a tip, guidance, or advice, emphasizes important information, or provides a reference to related information.
ATTENTION
An Attention statement indicates a stronger note, for example, to alert you when traffic might be interrupted or the device might
reboot.
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.
Format Description
bold text Identifies command names.
Identifies variables.
Convention Description
bold text Identifies command names, keywords, and command options.
italic text Identifies a variable.
value In Fibre Channel products, a fixed value provided as input to a command option is printed in plain text, for
example, --show WWN.
[] Syntax components displayed within square brackets are optional.
In Fibre Channel products, square brackets may be used instead for this purpose.
x|y A vertical bar separates mutually exclusive elements.
<> Nonprinting characters, for example, passwords, are enclosed in angle brackets.
... Repeat the previous element, for example, member[member...].
\ Indicates a “soft” line break in command examples. If a backslash separates two lines of a command
input, enter the entire command at the prompt without the backslash.
Document feedback
Quality is our first concern at Brocade, and we have made every effort to ensure the accuracy and completeness of this document.
However, if you find an error or an omission, or you think that a topic needs further development, we want to hear from you.
Provide the publication title, part number, and as much detail as possible, including the topic heading and page number if applicable, as
well as your suggestions for improvement.
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 require its own license key.
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 15 for the list of the optionally licensed features available in Fabric OS.
If a delivery method is not specified at the time of order, the key will be delivered by way of paperpack.
When a license is ordered separately (not preinstalled), an entitlement certificate or e-mail message along with a transaction key is issued
to you by Brocade as proof of purchase. The transaction key and license ID (LID) of the Brocade switch are used to generate a license
key from the Brocade software licensing portal. The license key is contained within the license file, which is downloaded to your PC. You
can add the license key to a switch using the licenseAdd command.
Once a license is installed on the Brocade Fabric OS switch, the licensed feature is generally available immediately without requiring a
switch reboot. 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 port-related licenses, use the portEnable command to enable a port or to 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
Fabric OS supports the following license types:
• 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 be installed only once on a switch, but it can be applied to as
many switches as required. The temporary use duration (the length of time for which the feature will be enabled on a switch) is
provided with the license keys.
• Slot-based license—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 20 for more information.
Generating a license
Before you can use a software license, you must generate it from the Brocade software portal. The following procedure demonstrates
how to generate and obtain a software license.
1. Order a license.
You will receive the license transaction key in the form of a paperpack or electronic transaction key. When you receive the
paperpack or electronic transaction key, retrieve the LID of your Brocade device by entering the licenseidshow command on
the device. If you have received a paperpack transaction key, write the LID in the space provided on the entitlement certificate
and on the unit ID label.
NOTE
To order and obtain a trial license, contact your Brocade representative.
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).
2. Log in to the Brocade software portal at [Link] and complete the software license request. If you do not
have a login ID and password, request access by following the online instructions.
The following figure shows the Software Licensing portal login window.
3. Enter your user name and password, and click Login.
The License Generation window appears. All Gen 6 platforms (except the Brocade G620 that run Fabric OS 8.2.0 will need
v2.0 licenses. Gen 5 platforms still use v1.0 licenses only.
4. Enter the licensing transaction key, token, or certificate, and click Next.
The License Information window displays.
7. Click Generate.
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 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 reason it failed and the action to be taken are display on the page.
8. Click the hyperlink in the License field to download the license file to your PC.
9. Upload the license file to the Brocade device. You can refer to the e-mail sent with the license file for instruction on installing the
license.
10. Click Export to Excel to export the results to a Microsoft Excel file, or click Generate Another License to generate a new license.
Querying a license
To view software license information for a particular product, you can use the License Query option with an activation key or license ID
(LID).
1. To display the License Query window, from the License Management Welcome window, select License Management >
Brocade NOS > Unit License Query.
Click Input Guidelines for more information on the input value.
2. Enter the license ID, serial number or activation Key to query a particular product.
3. Click Search. Depending on the status of the license (for example, whether the license was generated), the report includes the
following product information:
• Product name SKU
• ID value
• Activation key
• License
• Created date
• Capacity
• Customer name
• Description
In the figure, the first row under PRODUCT INFORMATION displays hardware-related information, and the second row
displays software-related information. If the query is performed before the transaction key is generated, the hardware-related
information will not appear as part of the search results. Similarly, if the query is performed before the license is generated,
some of the software-related information will not be displayed.
4. Click more or less in ID value to view the license ID.
5. Click the License hyperlink to download the license information.
6. Click Export to Excel to download the report for sharing or archiving purposes, or click Search Another Unit to query another
product.
10 Gigabit FCIP/Fibre Channel • Allows 10-Gbps operation of FC ports on the Brocade 6510 or 6520 switches or the FC ports of
(10G license) 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 a Brocade DCX
8510-4 or Brocade DCX 8510-8 Backbone.
• Allows selection of the following operational modes on the FX8-24 blade:
– Ten 1-GbE ports and one 10-GbE port
– Two 10-GbE ports
• The license is slot-based when applied to a Brocade DCX Backbone. It is chassis-based when applied to
a Brocade 6510 or 6520 Switch.
NOTE
Not applicable on Brocade Gen 6 platforms.
Advanced Extension • Enables two advanced extension features: FCIP Trunking and Adaptive Rate Limiting.
• The FCIP Trunking feature allows the following:
– Multiple (up to four) IP source and destination address pairs (defined as FCIP circuits) using multiple
(up to four) 1-GbE or 10-GbE interfaces to provide a high-bandwidth FCIP tunnel and failover
resiliency.
– Support for up to four 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 a
high traffic load.
• Available on the Brocade 7840 Extension Switch and Brocade DCX 8510 Backbone for the FX8-24
on an individual slot basis.
• This license is not required on Brocade Gen 6 platforms with a Brocade SX6 blade.
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 acknowledgment sequences.
• Available on the Brocade 7840 Extension Switch and Brocade DCX 8510 Backbone for the FX8-24
on an individual slot basis.
NOTE
This license is not required on a Brocade X6 Director with a Brocade SX6 blade.
Brocade Advanced Performance The Advanced Performance Monitor features are deprecated, but the license is available for upgrade to Fabric
Monitoring Vision features on Brocade Gen 5 platforms.
The Fabric Vision license is equivalent to the combination of the Advanced Performance Monitor (APM) and Fabric
Watch (FW) licenses. If you have both the Advanced Performance Monitoring and the Fabric Watch licenses
installed, you do not need the Fabric Vision license.
NOTE
Applies to Brocade Gen 5 platforms only.
Brocade Extended Fabrics Provides greater than 10 km of switched fabric connectivity at full bandwidth over long distances (depending on
the platform, the distance can be up to 3000 km).
NOTE
This license is not required for long-distance connectivity using licensed 10-Gb ports.
Brocade Fabric Watch The Fabric Watch feature is deprecated, but the license is available for upgrade to Fabric Vision features on
Brocade Gen 5 platforms.
The Fabric Vision license is equivalent to the combination of the Advanced Performance Monitor (APM) and Fabric
Watch (FW) licenses. If you have both the Advanced Performance Monitoring and the Fabric Watch licenses
installed, you do not need the Fabric Vision license.
NOTE
Applies to Brocade Gen 5 platforms only.
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 G610, G620, G630, M6505, 6505, 6510, 6520, and 6547 switches.
Enterprise ICL Allows you to connect four or more chassis to a Brocade DCX 8510 using ICLs. For each Brocade DCX 8510
Backbone, you can connect up to three chassis via ICLs without this license. This license is required only on a
chassis that is connected to four or more chassis.
This license requirement does not depend on the total number of chassis that exist in a fabric, but only on the
number of chassis connected directly to a device via ICLs.
You must also have an ICL POD license on each chassis to activate the ICL ports. The Enterprise ICL license
allows only connection of more than four chassis using ICLs; it does not enable the ICL ports on a chassis.
NOTE
Applies to the Brocade DCX 8510 Backbones only.
The Fabric Vision license is equivalent to the combination of the Advanced Performance Monitor (APM) and Fabric
Watch (FW) licenses. If you have both the Advanced Performance Monitoring and the Fabric Watch licenses
installed, you do not need the Fabric Vision license.
On Brocade Gen 6 platforms, this license enables the IO Insight capability and is displayed as "Fabric Vision and
IO Insight" in the licenseshow output.
FICON Management Server Enables host control of switches in mainframe environments.
On the Brocade X6 Director, each ICL POD license activates the specified number of QSFP ports in a trunk group.
• For the Brocade X6-8, each license has a capacity of 32 links, which activates 16 QSFP ports across
both core blades. The QSFP port numbers that can be activated on each X6-8 core blade are 0, 1, 2, 3,
8, 9, 10, and 11. With a license that has a capacity of 64, all QSFP ports on each core blade can be
activated.
• For the Brocade X6-4, each license has a capacity of 16 links, which activates 8 QSFP ports across
both core blades. The number of links enabled via ICL on a single core blade is displayed as the capacity
for this license. The QSFP port numbers that can be activated on each X6-4 core blade are 0, 1, 4, and
5. With a license that has a capacity of 32, all QSFP ports on each core blade can be activated.
Available on the Brocade DCX 8510 Backbone and the Brocade X6 Director only.
Inter-Chassis Link (ICL) 2nd Activates the remaining ICL bandwidth on a Brocade DCX 8510-8 Backbone. Each chassis must have this ICL
POD license installed in order to enable all available ICL connections.
Upgrade licenses do not impose restrictions on the number of physical ports used as long as the aggregate
bandwidth of all configured FCIP tunnels does not exceed the licensed limit.
WAN Rate Upgrade 2 Provides unlimited WAN transmission throughput (other than the physical port limit) and enables two 40-GbE
ports on a Brocade 7840 Extension Switch. You cannot use the 40-GbE ports without the WAN Rate Upgrade 2
license.
You must have the WAN Rate Upgrade 1 license installed to install and activate the WAN Rate Upgrade 2 license.
You cannot remove the WAN Rate Upgrade 1 license before removing the WAN Rate Upgrade 2 license.
ICL licensing
Brocade ICL links operate between the core blades of the Brocade DCX 8510 and Brocade X6 family. ICL ports on core blades of a
Brocade DCX 8510-8 can be used only with an ICL (1st or 2nd) POD license. ICL ports on core blades of a Brocade DCX 8510-4 can
be used only with an ICL 1st POD license. ICL ports on core blades of a Brocade X6 Director can be used only with an ICL POD license
up to the capacity specified within the 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.
On the Brocade DCX 8510-8, this license enables QSFP ports 0-7; QSFP ports 8-15 are disabled. (QSFP ports 0-7 correspond to
core blade port numbers 0-31, and QSFP ports 8-15 correspond to core blade port numbers 32-63, as observed in switchShow
output.)
This license allows you to initially purchase half the bandwidth of the Brocade DCX 8510-8 ICL ports and then upgrade with an
additional ICL license to use the full ICL bandwidth later. This license is also useful for environments with ICL connections between a
Brocade DCX 8510-8 and a Brocade DCX 8510-4 as the latter platform supports half the bandwidth of the Brocade DCX 8510-8 on
each ICL port.
This license is available on the Brocade DCX 8510-8 and Brocade DCX 8510-4 only.
A message such as the following displays if a required EICL license is not installed:
A message such as the following displays if the maximum number of supported chassis is reached:
10G licensing
The 10-Gbps FCIP/Fibre Channel license (10G license) enables the following:
• 10-Gbps access on 16-Gbps FC ports on Brocade 6510 or Brocade 6520 switches and on 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 20. When this license is applied to a
Brocade 6510 or Brocade 6520 Switch, it is applied to the whole platform.
Whether you have a director or fixed-port switch, you add the 10G license to the platform using the licenseAdd command, as for any
license.
For bladed platforms, you can either allow automatic license assignment or choose the blades that 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 Brocade 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 you must 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 Brocade 6520 switch or 16-Gbps FC port blade cannot interoperate with 10-Gbps FC ports on
the M6140 platform or FC10-6 blade. The new FC ports use different protocols and physical connections.
Slot-based licensing
Slot-based licensing is used on the Brocade DCX 8510 Backbone family to support the FX8-24 blade and the 16-Gbps FC port
blades (FC16-32, FC16-48, and FC16-64).
Slot-based 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.
• 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 Brocade 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, 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 reassign the license to another slot. This design allows for various maintenance operations to occur without having the
license move around to other slots.
The 10 Gigabit FCIP/Fibre Channel, Advanced Extension, Advanced FICON Acceleration, WAN Rate Upgrade 1, and WAN Rate
Upgrade 2 licenses are slot-based features. After running the configDefault command, you must explicitly remove and add these slot-
based licenses for the license slot assignment to be activated on non-DCX 8510 and non-X6 platforms. Running the configDefault -all
command, returns the license slot assignments to default and FX8-24 blades/slots will not have 10 Gigabit (FTR_10G) or Advanced
Extension (FTR_AE) licenses assigned.
Temporary licensing
A temporary license uses a "try-before-you-buy" approach for certain features so that you can experience the feature and its capabilities
before 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 one switch, but it can be applied to multiple switches.
A regular temporary license can be added to replace a universal temporary license and vice-versa, but neither can be added when a
permanent license for the feature is already installed.
The following licenses are available as regular temporary or universal temporary licenses:
• 10 Gigabit FCIP/Fibre Channel (slot-based)
• Advanced Extension (slot-based)
• Advanced FICON Acceleration (slot-based)
• Advanced Performance Monitoring
• Enterprise ICL
• Fabric Watch
• FICON Management Server (CUP)
• Integrated Routing
• Integrated Routing Ports on Demand
• ISL Trunking
• WAN Rate Upgrade 1
• WAN Rate Upgrade 2
NOTE
To obtain a trial license, contact your Brocade representative.
NOTE
On Brocade Gen 5 platforms, a combination of Advanced Performance Monitoring and Fabric Watch licenses is equivalent to
the Fabric Vision license.
If the permanent license is for fewer slots than the temporary license and does not match the associated criteria, you must do the
following:
CAUTION
If you are using NTP to synchronize the time between your network devices, including switches and backbones, do not
attempt to change the system date and time when a temporary license is installed.
Expired licenses
The licenseShow command allows you to see installed temporary licenses, even after they have expired. Expired licenses have the
output string "License has expired." RASLog warning messages are generated every hour for licenses present in the database that 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 disable or enable operation for a port or switch.
The expiration date is based on the system time at installation of the license plus the number of days for which the universal temporary
license is valid. Universal temporary licenses cannot be removed and reinstalled on the same switch.
Universal temporary licenses are always retained in the product's license database even though they can be explicitly deleted from any
user interface.
NOTE
To obtain a trial license, contact your Brocade representative.
2. When you receive the transaction key, retrieve the license ID (LID) of the switch. For instructions on viewing the LID, refer to the
Viewing information about software licenses on page 31 task.
If you received the transaction key in a paperpack, record the LID on the entitlement certificate in the space provided.
3. Log in to the Brocade software portal to generate and obtain the license key. For instructions on obtaining a license, refer to the
Generating a license on page 10 task.
4. Install the license on the switch. For instructions on adding a license, refer to the Adding a licensed feature on page 26 task.
5. Verify that the license is installed. For instructions on viewing an installed license, refer to the Viewing licenses installed on a
switch on page 31 task.
Licensing commands
The following table summarizes the Fabric OS CLI commands that can be used to manage licensed features. For detailed information on
these commands, refer to the Brocade 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.
For Brocade backbones and directors, licenses are effective on both control processor (CP) blades, but are valid only when the CP blade
is inserted into a backbone or director 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 or director only if the WWN card is the same in the new backbone or director. 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, 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, the active CP will propagate its configuration (including license keys) onto that
standby CP.
1. Connect to the switch, and log in using an account with admin permissions.
2. Activate the license using the licenseAdd license_key command.
3. Verify that the license was added by entering the licenseShow command. The licensed features that are 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 the Brocade Fabric OS Administration Guide for details.
The following is an example of adding all possible other licenses besides the Ports on Demand licenses for the Brocade G630
Switch running Fabric OS 8.2.0, including a combination license for the noncapacity licensed features supported by the
Brocade G630 Switch. Note that any capacity license is overwritten when a license with equal or higher capacity for that same
feature is added. Removing a newly added license leaves the switch without any license for the feature, as the prior license is not
retained.
switch:admin> licenseshow
No licenses installed.
switch:admin> licenseidshow
[Link]
switch:admin> licenseadd R7NgAQZ3m4FWYMJaK7JrH7DaJDDYFPfKBAYHA
1. Install a slot-based license on the platform with a sufficient slot count for the number of slots on which you plan to activate the
feature.
If an incorrect license is entered, a 10-second pause will be initiated by the switch.
2. Configure the slots so that the licensed feature is assigned to the slots. No more slots can be configured than specified in the
license.
3. Configure the application that uses the licensed feature to use the blade in the licensed slot. This operation verifies that the
previous two steps have been successfully completed.
Once these steps are complete, the feature will work on the blade.
1. Connect to the switch, and log in using an account with admin permissions or an account with OM permissions in the license
class of RBAC commands.
2. Use the licenseSlotCfg --add command to add the license to the appropriate slot.
1. Connect to the switch, and log in using an account with admin permissions or an account with OM permissions for the license
and SwitchPortConfiguration classes of RBAC commands.
2. Use the licenseAdd command to add the 10G license.
3. Use the licenseShow command to verify the license.
Chassis platforms only: If the results of the automatic license assignment are not what you intended, use the licenseSlotCfg
command to reassign the license to the desired blades.
4. Use the portCfgOctetSpeedCombo command to set the combination speed for the port octet to a setting that supports 10-
Gbps operations. Valid settings for 10-Gbps operations include:
• 2—Auto-negotiated or fixed-port speeds of 10 Gbps, 8 Gbps, 4 Gbps, and 2 Gbps
• 3—Auto-negotiated or fixed-port speeds of 16 Gbps and 10 Gbps
5. Use the portCfgSpeed command to set the port speed on each port that you want to operate at 10-Gbps.
The following example assigns a license to slot 4 on a Brocade DCX 8510-8 Backbone and enables 10-Gbps operation on
port 2 of the port blade in that slot. In this example, the 10G license was first automatically assigned to slot 1.
The following example assigns a license to a Brocade 6510 Switch and enables 10-Gbps operation on port 2.
1. Connect to the chassis, and log in using an account with admin permissions or an account with OM permissions for the license
class of RBAC commands.
2. Use the licenseAdd command to add the 10G license.
3. Use the licenseShow command to check the results of automatic license assignment. If the results are not what you intended,
use the licenseSlotCfg command to reassign the license to the desired FX8-24 blade.
4. Use the licenseShow command to verify the license.
5. Use the bladeCfgGeMode --set command to configure GbE port mode for the FX8-24 blade.
To enable the 10-GbE ports, set the mode to one of the following:
• 10g —Enables both 10-GbE ports and disables all ten 1-GbE ports.
• dual —Enables the xge0 port (but not xge1) and also enables all ten 1-GbE ports.
The following example assigns a license to slot 7 on a Brocade DCX 8510-4 Backbone and enables both 10-GbE ports on
the FX8-24 blade in that slot. In this example, the license was first automatically assigned to slot 1.
1. Connect to the switch, and log in using an account with admin permissions.
2. Enter the licenseShow command to display the active licenses.
3. Remove the license key using the licenseRemove command.
The license key is case-sensitive and must be entered exactly as given. The quotation marks are optional. After removing a
license key, the licensed feature is disabled when the switch is rebooted or when it is disabled and enabled.
switch:admin> licenseshow
bQebzbRdScRfc0iK:
Enterprise ICL license
SybbzQQ9edTzcc0X:
Full Fabric license
switch:admin> licenseremove "bQebzbRdScRfc0iK"
removing license key "bQebzbRdScRfc0iK"
Entering the licenseShow command after the licenseRemove command displays the remaining licenses.
switch:admin> licenseshow
SybbzQQ9edTzcc0X:
Full Fabric license
1. Connect to the switch, and log in using an account with admin permissions or an account with OM permissions in the license
class of RBAC commands.
2. Deconfigure the application that uses the licensed feature on the blade slot.
3. Enter the licenseSlotCfg --remove command to remove the license from the slot.
1. Connect to the switch, and log in using an account with admin permissions.
2. Enter the reboot command for the expiration to take effect.
1. Connect to the switch, and log in using an account with admin permissions.
switch:admin> licenseshow
Scz9y9QQSdTf0AzV:
FICON_CUP license
Scz9y9QQSdTt4Azn:
Full Ports on Demand license - additional 24 port upgrade license
Sbccb9QzbRTcddcP:
Full Fabric license
Extended Fabric license
BTPMBmMNSTmEN7PSYYJ3WtHCWTQfHRPYBAHNL:
Trunking license
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 them.
Some licenses may display with the text “Obsolete license” or "Unknown license." This happens because of changes in the
licensing requirements of some features that no longer require a license key, yet are still installed on a switch.
1. Connect to the switch, and log in using an account with admin permissions.
2. Enter the licenseIdShow command.
switch:admin> licenseidshow
[Link]
1. Connect to the switch using a web browser; Web Tools opens automatically.
2. Log in as admin, and enter your switch password. The license ID value is shown in the Switch Information tab for the switch.
1. Connect to the switch, and log in using an account with admin permissions.
2. Enter the licenseShow command to determine if the appropriate licenses are installed on the local switch and any connecting
switches.
A list of the currently installed licenses on the switch is displayed. If the license is not listed, install the license using the
licenseAdd command.
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
license, do not take effect until the switch is restarted.
NOTE
You can enable slot-based licenses only on the 10 Gigabit Ethernet (FTR_10G), Advanced Extension (FTR_AE), and
Advanced FICON Acceleration (FTR_AFA) features.
1. Click Configure > Switch Admin to open the Switch Administration window.
2. Select the License tab.
3. Select the license key for which you want to assign slots from the License Administration table.
4. Click Assign Slot(s).
The Assign Slots window displays.
5. Select the slots that you want to assign.
6. Click OK.
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.
2. Select the License tab.
3. Select the license key that you want to remove.
4. Click Remove.
Brocade G610 Can be purchased with 8, 16, or 24 licensed ports. A maximum of 24 ports is allowed.
Brocade G620 Can be purchased with 24, 36, or 48 licensed SFP ports. A maximum of 48 SFP ports is allowed.
The Q-Flex Ports on Demand license provides 4 QSFP ports, providing a total of 16 individual links.
Brocade G630 Can be purchased with a base allowance of 48 licensed SFP ports and two license step upgrades of 24 ports each. A
maximum of 96 SFP ports is allowed. The Q-Flex Ports on Demand license provides 8 QSFP ports, providing a total of
32 individual links.
Brocade M6505 Can be purchased with 12 or 24 licensed ports. A maximum of 24 ports is allowed.
Brocade 6505 Can be purchased with 12 or 24 licensed ports. A maximum of 24 ports is allowed.
Brocade 6510 Can be purchased with 24, 36, or 48 licensed ports. A maximum of 48 ports is allowed.
Brocade 6520 Can be purchased with 48, 72, or 96 licensed ports. A maximum of 96 ports is allowed.
Brocade 6547 Can be purchased with 12, 24, or 48 licensed ports. A maximum of 48 ports is allowed.
Brocade 6548 Can be purchased with 16, 22, or 28 licensed ports. A maximum of 28 ports is allowed.
ATTENTION
Licenses are not interchangeable between units. For example, if you bought a POD license for a Brocade 6505, you cannot
use that license on a Brocade 6510 or Brocade G620. The licenses are based on the switch license IDs and are not
interchangeable.
The following table 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.
NOTE
A Ports on Demand license adds SFP ports to the standard 24 SFP ports in 12-port increments. Therefore, the possible SFP
port configurations are 24 SFP ports, 36 SFP ports, 48 SFP ports, and 96 SFP ports. With any of the SFP port
configurations, the Q-Flex license adds up to 32 QSFP ports (four ports on each QSFP).
Ports on Demand is ready to be unlocked in the switch firmware. Its license key may be part of the licensed paperpack supplied with the
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 the Generating a license on page 10 task for instructions on generating a license
key.
Each Ports on Demand license activates the next group of ports in numerical order in either 4-, 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, refer to the switch’s hardware reference manual.
With Dynamic Ports on Demand mode on fixed-port switches, the order in which the ports are enabled does not matter; any ports can
be used so long as the total number of ports does not exceed the licensed capacity.
1. Connect to the switch, and log in using an account with admin permissions.
2. Verify the current states of the ports using the portShow command.
In the portShow output, the Licensed field indicates whether the port is licensed.
3. Install the Brocade Ports on Demand license.
For instructions on how to install a license, refer to Adding a licensed feature on page 26.
4. Use the portEnable command to enable the ports.
Alternatively, you can disable and re-enable the switch to activate ports.
5. Use the portShow command to check the newly activated ports.
3. Enter the license key in the License Key field to add the additional ports.
4. Click Add License.
1. Install the Brocade Ports on Demand licensed product. For instructions, refer to Activating a license on a switch on page 34.
2. Enable the port by performing the following steps.
a) Click the port in the Switch View to open the Port Admin tab.
b) Select the FC Ports or GigE Ports tab.
c) From the tree on the left, select the switch or slot that contains the port that you want to enable.
d) From the table, select one or more ports.
NOTE
Use Shift + click and Ctrl + click to select multiple ports from the table. You cannot select multiple ports from the
tree.
1. Connect to the switch, and log in using an account with admin permissions.
2. Enter the licenseshow command.
switch:admin> licenseshow
RSrMDB39KRYrBfFM4QSRQQGXSf3ttKHaQL97fWHASL4B:
WAN Rate Upgrade 1 (FTR_UPG1) license
Capacity 4
Consumed 3
Configured Blade Slots 1,2,3
PMJmKQXTmHt9QDNACgT3MMT4AR4NgRgKBAPZR:
WAN Rate Upgrade 2 (FTR_UPG2) license
Capacity 4
Consumed 2
Configured Blade Slots 1,3
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 be disabled
the next time the platform reboots or when the next port is deactivated.
For the blade server SAN I/O modules, Dynamic POD detects and assigns ports to a POD license only if the server blade is installed
with an HBA. 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.
Dynamic POD assigns 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 come online at different times. This means
that the port assignment order is not guaranteed.
If the switch detects more active links than allowed by the current POD licenses, some ports will not be assigned a POD license. Ports
that do not receive a POD assignment have a state of "No Sync" or "On 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.
1. Connect to the switch, and log in using an account with admin permissions.
Reserving a license for a port assigns a POD license to that port whether the port is online or offline. That license will not be available to
other ports that come online before the specified port.
To allocate licenses to a specific port instead of automatically assigning them as the ports come online, reserve a license for the port. The
port receives a POD assignment if any are available.
1. Connect to the switch, and log in using an account with admin permissions.
2. Enter the licensePort --show command to verify that port reservations are available.
3. Take the following action based on whether port reservations are available:
• If a port reservation is available, enter the licensePort --reserve command to reserve a license for a port or range of ports.
• 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 on page 43 to release a port from its POD assignment. Once the port is released, you can reserve it.
After a port is assigned to the POD set, the port is licensed until it is manually removed from the POD port set. When a port is released
from its POD port set (base, single, or double), a vacancy is created in that port set.
1. Connect to the switch, and log in using an account with admin permissions.
2. Enter the portDisable command to take the switch offline.
switch:admin> portdisable 0
3. Enter the portShow command to verify that the switch state is offline.
4. Enter the licensePort --release command to remove a port or range of ports from the POD license.
5. Enter the licensePort --show command to verify that the port is no longer assigned to a POD set.
NOTE
Capacity-based feature licenses (IR Ports on Demand, Ports on Demand, Q-Flex Ports on Demand, ICL, Enterprise ICL) are
not allowed to be created as combination licenses with any other features in the same license (that is only the capacity-based
feature and its capacity are allowed in the license). Capacity in a capacity feature license cannot be zero or "not specified." Any
licenses that are already installed (before Fabric OS 8.2.0) will be flagged in licenseshow output as having capacity incorrectly
specified.
NOTE
Either or both POD1 and POD2 features cannot be included in a single combination license with any other features.
NOTE
Trial licenses are supported only for a single feature—so combination trial licenses are not supported.
NOTE
The configUpload and
configDownload commands are
provided automatically with Fabric
OS on the switch.
NOTE
The firmwareDownload command
is provided automatically with Fabric
OS on the switch.
Full fabric connectivity No license required. Local switch. May be required on attached
switches.
Inband management No license required. N/A
In-flight encryption and compression No license required. N/A
Ingress rate limiting No license required. N/A for local switches running Fabric OS 7.2.0
or later.
An Adaptive Networking with QoS license is
required for switches running Fabric OS versions License required on local switches running
earlier than 7.2.0. Fabric OS versions earlier than 7.2.0.
NOTE
A license is needed on both sides of
the connection.
Monitoring and Alerting Policy Suite (MAPS) Fabric Vision Local switch.
NOTE
If you have both the Advanced
Performance Monitoring and the
Fabric Watch licenses installed, you
do not need the Fabric Vision
license.
NOTE
MAPS basic monitoring (system
resources, SFP, Fabric Performance
Impact) does not require a license.
NOTE
Port-based or exchanged-based
routing, static routes, frame-order
delivery, and dynamic routes all
included.
NOTE
DCC, SCC, FCS, IP Filter, and
authentication policies are all
included.
Slow Drain Device Quarantine Fabric Vision Local and attached switches.
SNMP No license required. N/A