53-1003091-02 19 February 2014 FastIron Ethernet Switch Software Licensing Guide Supporting FastIron Software Release 08.0.
© 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....................................
Overview of licensing for Ports on Demand.................................................. 31 Configuring PoD on an interface...................................................................32 Configuring the upper PoD ports in a stack for ICX 6610 devices only........ 32 Displaying license configuration for PoD ports after a license upgrade........ 33 Displaying license configuration for PoD ports for ICX 6610 devices ......................................................................................
Preface ● Document conventions......................................................................................................3 ● Brocade resources............................................................................................................ 5 ● Getting technical help........................................................................................................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. • • Adapter documentation is available on the Downloads and Documentation for Brocade Adapters page. Select your platform and scroll down to the Documentation section.
Document feedback Document feedback To send feedback and report errors in the documentation you can use the feedback form posted with the document or you can e-mail the documentation team. 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.
Software Licensing Overview ● Software licensing overview..............................................................................................7 ● How software licensing works........................................................................................... 7 ● Seamless transition for legacy devices............................................................................. 8 ● License types....................................................................................................
Seamless transition for legacy devices customer’s PC, where the file can then be transferred to a TFTP or SCP server, and then uploaded to the Brocade device. Once a license is installed on the Brocade device, it has the following effects: • • For FCX and ICX devices, the license unlocks the licensed feature and it becomes available immediately. There is no need to reload the software.
Licensing rules • • • • with the license ID (LID) of the Brocade device to generate and download a software license from the Brocade software portal. License file - The file produced by the Brocade software portal when the license is generated. The file is uploaded to the Brocade device and controls access to a licensed feature or feature set. License ID (LID) - The identification number that uniquely identifies the Brocade device.
Licensing rules for FSX 800 and FSX 1600 devices NOTE For FCX and ICX 6610 devices, the behavior for running software licensing with different licenses (Premium, Advance, or Upgrade licenses) is the same. One license allows multiple protocols to run in a stack. All units must have a separate license to run the same licensed feature in a stack. If all units do not have the same license, the Active controller cannot enable the licensed feature on the stack.
Viewing software license information from the Brocade software portal management module. To enable the standby management module, you must install a separate license. For example, if the active management module has the SX-FIL3U-SW license, the standby management module must also have this license. Viewing software license information from the Brocade software portal This section describes other software licensing tasks supported from the Brocade software portal.
Obtaining a license The following License Query Results window appears. FIGURE 2 License Query Results window In this example, 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.
Software Licensing Overview The following figure shows the Brocade Software Portal Login window. FIGURE 3 Brocade Software Portal Login window 4. From the License Management menu, select Brocade IP/ADP > License Generation with Transaction key. The IP/ADP License Generation dialog window displays.
Software Licensing Overview FIGURE 4 License Management Welcome window 14 FastIron Ethernet Switch Software Licensing Guide 53-1003091-02
Software Licensing Overview The following figure shows the IP/ADP License Generation window for generating a license using a transaction key and LID. FIGURE 5 IP/ADP License Generation window 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.
Software Licensing Overview 7. Click the Generate button to generate the license. The following figure shows the results window, which 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.
Software Licensing Tasks ● Software licensing configuration tasks ........................................................................... 17 ● Installing a license file..................................................................................................... 18 ● Deleting a license file...................................................................................................... 19 ● Using a trial license.................................................................................
Installing a license file Installing a license file Once you obtain a license file, place it on a TFTP or SCP server to which the Brocade device has access, and then use TFTP or SCP to copy the file to the license database of the Brocade device. Using TFTP to copy a license file on FSX 800 and FSX 1600 devices To copy a license file from a TFTP server to the license database of the Brocade device, enter a command such as the following at the privileged EXEC level of the CLI. device# copy tftp license 10.
Verifying the license file installation The scp license_file_on_host user @ IP_address :license command is supported on FSX 800 and FSX 1600 devices. To copy a license file from an SCP-enabled client to the license database of the Brocade device, enter a command such as the following on the SCP-enabled client. scp c:\license\license101 terry@10.1.1.
Deleting a license on FCX and ICX devices The index_number variable is a valid license index number. The license index number can be retrieved from the show license command output. For more information, refer to Viewing information about software licenses on page 23. NOTE When removing a license on an FSX device running a release 08.0.01 image, Brocade recommends an immediate reboot.
Console, syslog, and trap messages for trial license expiration licensed feature will no longer be available from the CLI. The licensed feature will continue to run as configured until the system is reloaded, at which time the feature will be disabled and removed from the system. NOTE Trial licenses are not cumulative. The new license replaces the current license. To extend the license, you must contact your Brocade representative.
Syslog messages and trap information For Brocade legacy devices in need of replacement (by way of a Return Merchandise Agreement [RMA]), the following actions must be taken: • • If the replacement device will be upgraded to a software release that supports software licensing, registration of the replacement device is required after the software is upgraded.
Viewing information about software licenses Explanation The license package has been added. Message Level Informational Message License: Package package_name with LID LID_number is removed Explanation The license package has been deleted. Message Level Informational Message License: Package package_name with LID LID_number expires in number days Explanation The trial license is about to expire.
Software Licensing Tasks Use the show version command to display the serial number, software and hardware license package name, and LID of all units in the device. The following example is sample output from an FCX unit with the FCX_ADV_ROUTER_SOFT_PACKAGE package installed on units 1, 3, and 5. device#show version Copyright (c) 1996-2011 Brocade Communications Systems, Inc. UNIT 5: compiled on Jun 24 2011 at 14:20:38 labeled as FCXR07203a (6674957 bytes) from Primary FCXR07203a.
Viewing the license database Unlimited Stack unit 1 Unlimited Stack unit 1 Unlimited 4: FCX-ADV-LIC-SW 5: FCX-ADV-LIC-SW 1 1 1 dexHHIIgFFd Normal Active writcfgMFMH Normal Active Viewing the license database NOTE The show license command can be used to display software license information for the FSX 800 and FSX 1600, FCX, ICX 6610, ICX 6450, and ICX 6650 devices. To display general information about all software licenses for all units in a device, use the show license command.
Software Licensing Tasks The output from the show license command is the same for an FSX 800 or FSX 1600 device. device#show license Index Package Name Period 1 FCX624-EL3U Lid License Type Status License cpFNJHFFGO normal active unlimited To display specific software license information installed on a FSX 800 or FSX 1600 device, enter the following command.
Software Licensing Tasks TABLE 3 Output from the show license unit command (Continued) Field Description Status Indicates the status of the license: • Valid - A license is valid if the LID matches the license ID of the device for which the license was purchased, and the package name is recognized by the system. • Invalid - The LID does not match the license ID of the device for which the license was purchased. • Active - The license is valid and in effect on the device.
Viewing software packages installed in the device TABLE 4 Output from the show license unit command (Continued) Field Description +status Indicates the status of the license: • Valid - A license is valid if the LID embedded in the license matches the license ID of the device for which the license was purchased, and the package name is recognized by the system. • Invalid - The LID does not match the license ID of the device for which the license was purchased.
Software Licensing Tasks =============== UNIT 1: SL 3: FCX-2XG 2-port 10G Module (2-XFP) ========================================================================== UNIT 2: SL 1: FCX-48GS POE 48-port Management Module Serial #: upgrade7072 License: FCX_FULL_ROUTER_SOFT_PACKAGE (LID: ZU0W478MFMH) P-ENGINE 0: type DB90, rev 01 P-ENGINE 1: type DB90, rev 01 ========================================================================== UNIT 2: SL 2: FCX-2XGC 2-port 16G Module (2-CX4) ===============================
Viewing software packages installed in the device 30 FastIron Ethernet Switch Software Licensing Guide 53-1003091-02
Licensing for Ports on Demand ● Overview of licensing for Ports on Demand.................................................................... 31 ● Configuring PoD on an interface..................................................................................... 32 ● Configuring the upper PoD ports in a stack for ICX 6610 devices only.......................... 32 ● Displaying license configuration for PoD ports after a license upgrade..........................
Configuring PoD on an interface ports 2 and 4 to 10 Gbps port speed, refer to Configuration considerations when configuring PoD for ICX 6450 devices only on page 38. The PoD feature is not applicable to ICX 6430 devices because there are no 10 Gbps ports on the device. The PoD feature for ICX 6650 is explained in detail in the Ports on Demand Licensing on the ICX 6650 section.
Displaying license configuration for PoD ports after a license upgrade NOTE If you purchased a second ICX6610-10G-LIC-POD license, you do not need to perform the following steps. The flexible-10g-ports upper command is used to configure the upper four PoD ports to 10 Gbps port speed using a single ICX6610-10G-LIC-POD license. The command can only be used on the upper four PoD ports. 1. Enter the flexible-10g-ports upper command at the stack unit configuration level.
Displaying license configuration for PoD ports for ICX 6610 devices Displaying license configuration for PoD ports for ICX 6610 devices To display a license configuration for all PoD ports for all units in a stack, enter the following command at the CLI level.
Displaying license configuration for PoD ports for ICX 6650 devices If ports 2 and 4 are configured to 1 Gbps port speed, the license state changes to the default. The following output from the show pod command displays port 2 and 4 in the default state. Brocade#show pod Unit-Id: 1 PoD-ports Lic-Available Lic-Used 1/2/2 No No 1/2/4 No No Syntax: show pod [unit id] The unit id parameter specifies the unit ID number of the PoD you want to display.
Upgrading or downgrading configuration considerations for PoD TABLE 7 Output from the show pod command Field Description Unit-Id The unit ID number of the PoD. PoD license capacity The port capacity of the PoD license (10 GbE or 40 GbE license) that is purchased. The PoD 10 GbE license consists of an 8-, 16-, or 24-port capacity license. The PoD 40 GbE license consists of a 2-, 4-, or 6-port capacity license.
Configuration considerations when configuring PoD on an interface Configuration considerations when configuring PoD on an interface Consider the following when configuring PoD on an interface or a range of interfaces on ICX 6610 or ICX 6450 devices: • The speed-duplex 10g-full command is rejected when there is no license or an insufficient license in the unit.
Configuration considerations when configuring PoD for ICX 6450 devices only STP configured to ON, priority is level0, mac-learning is enabled Flow Control is enabled Mirror disabled, Monitor disabled Not member of any active trunks Not member of any configured trunks No port name Configuration considerations when configuring PoD for ICX 6450 devices only Consider the following when configuring PoD for ICX 6450 devices only: • • • • By default, without a license at bootup, ports 2 and 4 come up in 10 G
Licensing for Ports on Demand • • • You can add an ICX6650-2P40G-POD license to any configuration. For example, you can add an ICX6650-2P40G-POD license to a base 32-port configuration. In a trunk formation, if there is no license upon bootup or hot swap of a unit, a port is disabled. This does not affect the trunk formation.
Ports on Demand licensing on the ICX 6650 STP configured to ON, priority is level0, mac-learning is enabled Flow Control is enabled Mirror disabled, Monitor disabled Member of active trunk ports 1/2/1,1/2/2,1/2/3,1/2/4, primary port Member of configured trunk ports 1/2/1,1/2/2,1/2/3,1/2/4, primary port No port name Ports on Demand licensing on the ICX 6650 . The Brocade ICX 6650 device features Ports on Demand licensing.
Enabling ports on the front panel • • 2 pairs of 40 ports that are error-disabled by default. 2 ports that can be converted to eight ports using a breakout cable. The ports are error disabled by default. The ports on the rear panel are categorized into groups. Each group requires a Flexible PoD (FPoD) license to enable the ports. For more information about using the FPoD license with a group of ports, refer to Disabling the FPoD ports on the rear panel section. • • • Group 1 = Ports 1/2/1 - 1/2/2.
Deleting an ICX6650-10G-LIC-POD license SSH and Secure Copy (SCP) must be enabled on the Brocade device before the procedures in this section can be performed. To copy the file from an SCP-enabled client to the license database of a specific unit, enter the following command. In the example, the license is copied to unit 1. scp license.xml terry@10.20.91.
Enabling ports on the rear panel 3. Reload the device for the 8-port ICX6650-10G-LIC-POD license file to take effect. 4. Use the show pod command to display configuration information for the 8-port ICX6650-10G-LICPOD license.
Disabling the FPoD ports on the rear panel SSH and Secure Copy (SCP) must be enabled on the Brocade device before the procedures in this section can be performed. To copy the file from an SCP-enabled client to the license database of a specific unit, enter the following command. In the example, the license is copied to unit 1. scp license.xml terry@10.20.91.
Licensing for Ports on Demand a) Disable ports in group 1 or 2. Brocade(config)# no fpod-40g-enable group 2 b) Enable ports in group 3. c) Use the show pod command to display configuration information for the groups enabled as shown in the following example output.
Disabling the FPoD ports on the rear panel 46 FastIron Ethernet Switch Software Licensing Guide 53-1003091-02
Appendix A: FastIron Licensed Features and Part Numbers This appendix lists the supported licensed features, associated image filenames, and related part numbers. There are no changes to the part numbers for products with pre-installed (factory-installed) licenses. These part numbers are listed for reference in the last column.
Appendix A: FastIron Licensed Features and Part Numbers TABLE 8 Licensed features and part numbers (Continued) Product Licensed feature or feature set Image filename Part numbers for software license only Part numbers for hardware with preinstalled software license Advance Layer 3: N/A1 ICX6610-ADV-LICSW Sold separately. To purchase the ICX 6610 Advance license, contact your Brocade representative. N/A1 ICX6610-ADV-UPGLIC-SW Sold separately.
Appendix A: FastIron Licensed Features and Part Numbers TABLE 8 Licensed features and part numbers (Continued) Product Licensed feature or feature set Image filename Part numbers for software license only Part numbers for hardware with preinstalled software license ICX 6450 Premium Layer 3: N/A1 ICX6450-PREM-LIC N/A ICX 6450C • • • • • • • N/A1 ICX6450-2X10G-LIC- Sold separately. To POD purchase the Ports on Demand license, contact your Brocade representative.
Appendix A: FastIron Licensed Features and Part Numbers TABLE 8 Licensed features and part numbers (Continued) Product Licensed feature or feature set Image filename Part numbers for software license only Part numbers for hardware with preinstalled software license ICX 6650 ICX 6650 - Ports on Demand license for 10Gbps N/A1 ICX6650-10G-LICPOD Enables ports 1/1/331/1/56 in blocks of eight in sequential order. You need three ICX6650-8P10GPOD licenses to enable all front panel ports.
Appendix A: FastIron Licensed Features and Part Numbers TABLE 8 Licensed features and part numbers (Continued) Product Licensed feature or feature set Image filename Part numbers for software license only Part numbers for hardware with preinstalled software license ICX 6650 - Ports on Demand license for 40Gbps N/A1 ICX6650-40G-LICPOD Enables the rear panel ports by port groups. You need three ICX6650-2P40GPOD licenses to enable all rear panel ports.
Appendix A: FastIron Licensed Features and Part Numbers TABLE 8 Licensed features and part numbers (Continued) Product Licensed feature or feature set FSX 800 and FSX 1600 IPv4 and IPv6 PREM SXLRxxxxx.
Appendix A: FastIron Licensed Features and Part Numbers TABLE 8 Licensed features and part numbers (Continued) Product Licensed feature or feature set • • Image filename Part numbers for software license only Part numbers for hardware with preinstalled software license IPv4 over GRE Multi-VRF 1 Basic Layer 3 functionality is available in an FSX router image that does not require a license. 2 Third generation only The following table lists the supported software packages.
Appendix A: FastIron Licensed Features and Part Numbers 54 FastIron Ethernet Switch Software Licensing Guide 53-1003091-02
Appendix B: FastIron Non-Licensed features This appendix lists the FastIron software images that do not require a license to run on the device. TABLE 10 Software image files that do not require a license Product Image filename FSX 800 SXLRxxxxx.bin FSX 1600 SXLSxxxxx.bin FCX FCXSxxxxx.bin (Layer 2) FCXRxxxxx.bin (Layer 3) ICX 6610 ICX 6430 ICX64Sxxxxx.bin (Layer 2) ICX 6450 ICX64Rxxxxx.bin (Layer 3) ICX 6650 ICXSxxxxx.bin ICXRxxxxx.
Appendix B: FastIron Non-Licensed features 56 FastIron Ethernet Switch Software Licensing Guide 53-1003091-02