53-1003139-01 27 June 2014 Fabric OS Software Licensing Guide Supporting Fabric OS 7.3.
© 2014, Brocade Communications Systems, Inc. All Rights Reserved. Brocade, the B-wing symbol, Brocade Assurance, ADX, AnyIO, DCX, Fabric OS, FastIron, HyperEdge, ICX, MLX, MyBrocade, NetIron, OpenScript, VCS, VDX, and Vyatta are registered trademarks, and The Effortless Network and the On-Demand Data Center are trademarks of Brocade Communications Systems, Inc., in the United States and in other countries. Other brands and product names mentioned may be trademarks of others.
Contents Preface..................................................................................................................................... 3 Document conventions......................................................................................3 Text formatting conventions.................................................................. 3 Command syntax conventions.............................................................. 3 Notes, cautions, and warnings....................................
Adding a licensed feature............................................................................. 28 Activating a slot-based licensed feature....................................................... 29 Assigning a license to a slot..........................................................................29 Assigning 10G licenses.................................................................................29 Enabling 10 Gbps operation on an FC port......................................
Preface ● Document conventions......................................................................................................3 ● Brocade resources............................................................................................................ 5 ● Contacting Brocade Technical Support.............................................................................5 ● Document feedback..........................................................................................................
Notes, cautions, and warnings Convention Description 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. Default responses to system prompts are enclosed in square brackets. {x|y|z} A choice of required parameters is enclosed in curly brackets separated by vertical bars. You must select one of the options.
Brocade resources Brocade resources Visit the Brocade website to locate related documentation for your product and additional Brocade resources. You can download additional publications supporting your product at www.brocade.com. Select the Brocade Products tab to locate your product, then click the Brocade product name or image to open the individual product page. The user manuals are available in the resources module at the bottom of the page under the Documentation category.
Document feedback • • • • OEM/Solution Providers are trained and certified by Brocade to support Brocade® products. Brocade provides backline support for issues that cannot be resolved by the OEM/Solution Provider. Brocade Supplemental Support augments your existing OEM support contract, providing direct access to Brocade expertise. For more information, contact Brocade or your OEM. For questions regarding service levels and response times, contact your OEM/Solution Provider.
About This Document ● Supported hardware and software.................................................................................... 7 ● What’s new in this document............................................................................................ 8 Supported hardware and software In those instances in which procedures or parts of procedures documented here apply to some switches but not to others, this guide identifies exactly which switches are supported and which are not.
What’s new in this document ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ FC8-32E port blade FC8-48E port blade FC8-64 port blade FC16-32 port blade FC16-48 port blade FC16-64 port blade FCOE10-24 blade (not supported on Brocade DCX 8510-4) FS8-18 Encryption Blade FX8-24 DCX Extension Blade What’s new in this document This document supports Fabric OS 7.3.0; and the new licenses in this release include: • • WAN Rate Upgrade 1 WAN Rate Upgrade 2 For complete information, refer to the Release Notes.
Software Licensing Overview ● Licensing overview............................................................................................................9 ● How software licensing works........................................................................................... 9 ● License types.................................................................................................................. 10 ● Software licensing terminology.................................................................
License types 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.
Software Licensing Overview 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.
Software Licensing Overview The Brocade FOS License Generation window displays as shown below. FIGURE 2 Brocade FOS License Generation window 5. Enter the requested information in the required fields. An asterisk (*) next to a field indicates that the information is required. 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.
Viewing software license information from the Brocade licensing portal Viewing software license information from the Brocade licensing portal This section describes other software licensing tasks supported from the Brocade software licensing portal. You can use the Unit License Query option to view software license information for a particular unit, transaction key, or both. You can export the report to Excel for sharing or archiving purposes.
Viewing software license information from the Brocade licensing portal 14 Fabric OS Software Licensing Guide 53-1003139-01
Fabric OS Licenses ● Available Fabric OS licenses.......................................................................................... 15 ● Brocade 7800 Upgrade license.......................................................................................20 ● ICL licensing....................................................................................................................20 ● 8G licensing.....................................................................................................
Fabric OS Licenses TABLE 1 Available Brocade licenses (Continued) License Description 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.
Fabric OS Licenses TABLE 1 Available Brocade licenses (Continued) License Description Brocade ISL Trunking • • Brocade Ports on Demand 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. Allows you to instantly scale the fabric by provisioning additional ports using license key upgrades.
Fabric OS Licenses TABLE 1 Available Brocade licenses (Continued) License Description Enterprise ICL Allows you to connect four or more chassis to a Brocade DCX 8510 chassis using ICLs. For each Brocade DCX 8510 chassis, you can connect up to three Brocade DCX 8510 Backbones via ICLs without this license. This license is required only on the Brocade DCX 8510 chassis that is connected to four or more Brocade DCX 8510 chassis.
Fabric OS Licenses TABLE 1 Available Brocade licenses (Continued) License Description ICL 16-Link Activates all 16 links on ICL ports on a Brocade DCX chassis. Each chassis must have the ICL 16-Link license installed in order to enable the full 16-link ICL connections. Available on the Brocade DCX only.
Brocade 7800 Upgrade license TABLE 1 Available Brocade licenses (Continued) License Description WAN Rate Upgrade 2 Provides unlimited WAN transmission throughput (other than the physical port limit) and enables two 40 GbE ports on Brocade 7840 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.
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 The EICL license is required in addition to the ICL POD license. The following requirements apply: • • • • • Connection of three or fewer DCX 8510 Backbones with ICLs does not require the EICL license. However, EICL license is required on a Brocade DCX 8510 chassis when that chassis is connected to four or more DCX 8510 Backbones via ICLs. With the EICL license installed, a maximum of 10 chassis are allowed to be connected together via ICLs.
10G licensing • 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 prelicensed state maximum speed of 4 Gbps.
Slot-based licensing 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, FC16-48, and FC16-64). Slot-based licensing is used for the WAN Rate Upgrade 1 and WAN Rate Upgrade 2 features on the Brocade 7840. Brocade 7840 has only a single slot that can be licensed. License capacity is equal to the number of slots.
Restrictions on upgrading temporary slot-based licenses 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.
Configupload and download considerations 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. Configupload and download considerations The configDownload and configUpload commands download the legacy, enhanced, consumed capacities, and temporary licenses.
Licensing Tasks ● Software licensing configuration tasks............................................................................ 27 ● Licensing commands...................................................................................................... 28 ● Adding a licensed feature................................................................................................28 ● Activating a slot-based licensed feature..........................................................................
Licensing commands Licensing commands The following table 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. TABLE 4 Fabric OS commands related to licensing Command Description 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.
Activating a slot-based licensed feature 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.
Enabling 10 Gbps operation on an FC port Enabling 10 Gbps operation on an FC port Use the following procedure to enable 10 Gbps operation on an FC port on a Brocade 6510 or 6520 switch or an FC16-32 or FC16-48 blade: 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.
Removing software licenses 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 blades. 4. Use the licenseShow command to verify the license. 5. Use the bladeCfgGeMode --set command to configure the GbE port mode for the FX8-24 blade.
Removing a license from a slot 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 a switch disable and enable is performed. 4. Enter the licenseShow command to verify the license is disabled.
Viewing the license ID using a Telnet session 1. Connect to the switch and log in using an account with admin permissions. 2. Enter the licenseShow command. switch:admin> licenseshow bQebzbRdScRfc0iK: Entry Fabric license Fabric Watch license SybbzQQ9edTzcc0X: Fabric license gFEfTam4YHDLGXZBZ7RHHMBGmrrS3aNWgANKggEAGAJB: WAN Rate Upgrade 1 license ARSNJE4GC9aJ4Y7FrBgYaEWWBfKK3EMRFHSBHtHAEERB: WAN Rate Upgrade 2 license Save the output to a text file in a secure location.
Troubleshooting licensing issues Troubleshooting licensing issues Some features require licenses in order to work properly. To view a list of features and their associated licenses, refer to License Requirements for Features on page 47. Licenses are created using a switch license identifier (LID), so you cannot apply one license to different switches. Before calling your switch support provider, verify that you have the correct licenses installed by using the licenseShow command. 1.
Licensing Tasks The Switch Administration window displays. FIGURE 5 Switch Administration window 2. Select the License tab and click Add. The Add License dialog box displays. FIGURE 6 Add License dialog box 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.
Assigning slots for a license key Assigning slots for a license key This feature allows you to increase the capacity without disrupting the slots that already have licensed features running. 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. Use the following procedure to assign slots for a license key. 1. Click Configure > Switch Admin to open the Switch Administration window. 2.
Ports on Demand Licensing ● Ports on Demand overview............................................................................................. 37 ● Activating Ports on Demand using a Telnet session.......................................................39 ● Activating Ports on Demand using EZSwitchSetup........................................................ 39 ● Activating Ports on Demand using Web Tools................................................................40 ● Displaying installed licenses....
Ports on Demand Licensing TABLE 5 List of available user ports when implementing PODs Platform Available user ports, Available user ports, Available user ports, No POD license POD1 or POD2 present Both POD licenses present Brocade 300 0-7 0-15 0-23 Brocade 5100 0-23 0-31 0-39 Brocade 5300 0-47 0-63 0-79 Brocade 5410 0-11 N/A N/A Brocade M5424 1-8 and 17-20 POD1: 0, 9-16, and 21-23 0-23 Brocade 5450 1-10 and 19-22 POD1: 0, 11-18, and 23-25 0-25 Brocade 5480 1-8 and 17-20 POD1
Activating Ports on Demand using a Telnet session Activating Ports on Demand using a Telnet session Use the following procedure to activate Ports on Demand. 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.
Activating Ports on Demand using Web Tools The Add Port License dialog box is displayed. FIGURE 8 Add Port License dialog box 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 Use the Advanced Management tool.
Displaying installed licenses Displaying installed licenses If a single license is installed that enables all Ports on Demand, the license will display as "Full Ports on Demand license - additional X port upgrade license.
Displaying the port license assignments 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.
Enabling Dynamic Ports on Demand 3. Enter the reboot command to restart the switch. switch:admin> reboot 4. Enter the licensePort --show command to verify the switch started the Dynamic POD feature.
Disabling Dynamic Ports on Demand 3. Enter the reboot command to restart the switch. 4. Enter the licensePort --show command to verify the switch changed to static POD.
Releasing a port from a POD set None Ports not assigned to a license: 0, 7, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 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. • If all port reservations are assigned, select a port to release its POD license.
Releasing a port from a POD set 46 Fabric OS Software Licensing Guide 53-1003139-01
License Requirements for Features The following table 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. TABLE 6 License requirements and location name by feature Feature License Where license should be installed Adaptive Rate Limiting Advanced Extension Local switch. Administrative Domains No license required. N/A Bottleneck Detection No license required.
License Requirements for Features TABLE 6 License requirements and location name by feature (Continued) Feature License FCIP High Performance Extension over FCIP/FC Where license should be installed NOTE Local and attached switches. License is needed on both sides of tunnel. FCIP Trunking Advanced Extension Local and attached switches. Fibre Channel Routing/ EX_Ports Integrated Routing Local switch. FICON No license required. N/A FICON-CUP FICON Management Server Local switch.
License Requirements for Features TABLE 6 License requirements and location name by feature (Continued) Feature License Where license should be installed In-flight encryption and compression No license required. N/A Inband Management No license required. N/A Ingress rate limiting No license required. N/A for local switches running Fabric OS 7.2.0 or later. Adaptive Networking with QoS license is required for switches running Fabric OS versions earlier than 7.2.0.
License Requirements for Features TABLE 6 License requirements and location name by feature (Continued) Feature License Where license should be installed OpenSSH public key No license required. N/A Performance monitoring Advanced Performance Monitoring or Fabric Vision license for advanced features. No license required for basic features. Local switch. Port fencing Fabric Watch Local switch. Ports • Local switch.
License Requirements for Features TABLE 6 License requirements and location name by feature (Continued) Feature License Where license should be installed Speed 8 Gbps license needed to support 8 Gbps on the Brocade 300, 5100, 5300, and VA-40FC switches and embedded switches only. Local switch NOTE The 8 Gbps license is installed by default, and you should not remove it.
License Requirements for Features 52 Fabric OS Software Licensing Guide 53-1003139-01
Index 10 Gbps operation on an FC port, enabling 30 10G license 23, 30 16-link ICL license 21 1st POD ICL license 21 2nd POD ICL license 21 8G license 22 8-link ICL license 21 A activate slot-based license 29 activating ports on demand 37 activating POD using EZSwitchSetup 39 adding licensed features 28 assigning license to slot 29 Available licenses 15 bladeCfgGeMode 30 configDownload 26 configUpload 26 licenseAdd 28, 30, 34 licensePort 42–45 licenseRemove 31 licenseShow 26, 28, 30–34 licenseSlotCfg 23,
G generating license 27 I ICL 16-link license 21 1st POD license 21 2nd POD license 21 8-link license 21 enterprise license 21 licensing 20, 21 install license 27 L license 10G 23, 30 8G 22 adding features 28 Brocade 7800 upgrade 20 date change restriction 25 enterprise ICL 21 expired 26 ICL 20, 21 ICL 16-link 21 ICL 1st POD 21 ICL 2nd POD 21 ICL 8-link 21 removing expired 32 removing features 31 reserving for POD 44 slot-based 24, 32 temporary 24, 26 time-based 24 time-based temporary licenses 26 troub
activating POD 39 disabling dynamic POD 43 displaying license assignments 42 dynamic POD 41 enabling dynamic POD 42 releasing from a POD set 45 reserving a POD license 44 portCfgOctetSpeedCombo command 23 portCfgSpeed command 23 portEnable 9 portEnable command 39 portShow command 39 ports on demand activating 39 available ports 37 disabling dynamic 43 displaying installed licenses 41 dynamic 41 enabling dynamic 42 licence restrictions 37 See also\ POD.
56 Fabric OS Software Licensing Guide 53-1003139-01