82 lines · plain
1.. SPDX-License-Identifier: GPL-2.02 3===========================4Operating FCoE using bnx2fc5===========================6Broadcom FCoE offload through bnx2fc is full stateful hardware offload that7cooperates with all interfaces provided by the Linux ecosystem for FC/FCoE and8SCSI controllers. As such, FCoE functionality, once enabled is largely9transparent. Devices discovered on the SAN will be registered and unregistered10automatically with the upper storage layers.11 12Despite the fact that the Broadcom's FCoE offload is fully offloaded, it does13depend on the state of the network interfaces to operate. As such, the network14interface (e.g. eth0) associated with the FCoE offload initiator must be 'up'.15It is recommended that the network interfaces be configured to be brought up16automatically at boot time.17 18Furthermore, the Broadcom FCoE offload solution creates VLAN interfaces to19support the VLANs that have been discovered for FCoE operation (e.g.20eth0.1001-fcoe). Do not delete or disable these interfaces or FCoE operation21will be disrupted.22 23Driver Usage Model:24===================25 261. Ensure that fcoe-utils package is installed.27 282. Configure the interfaces on which bnx2fc driver has to operate on.29Here are the steps to configure:30 31 a. cd /etc/fcoe32 b. copy cfg-ethx to cfg-eth5 if FCoE has to be enabled on eth5.33 c. Repeat this for all the interfaces where FCoE has to be enabled.34 d. Edit all the cfg-eth files to set "no" for DCB_REQUIRED** field, and35 "yes" for AUTO_VLAN.36 e. Other configuration parameters should be left as default37 383. Ensure that "bnx2fc" is in SUPPORTED_DRIVERS list in /etc/fcoe/config.39 404. Start fcoe service. (service fcoe start). If Broadcom devices are present in41the system, bnx2fc driver would automatically claim the interfaces, starts vlan42discovery and log into the targets.43 445. "Symbolic Name" in 'fcoeadm -i' output would display if bnx2fc has claimed45the interface.46 47Eg::48 49 [root@bh2 ~]# fcoeadm -i50 Description: NetXtreme II BCM57712 10 Gigabit Ethernet51 Revision: 0152 Manufacturer: Broadcom Corporation53 Serial Number: 0010186FD55854 Driver: bnx2x 1.70.00-055 Number of Ports: 256 57 Symbolic Name: bnx2fc v1.0.5 over eth5.458 OS Device Name: host1159 Node Name: 0x10000010186FD55960 Port Name: 0x20000010186FD55961 FabricName: 0x2001000DECB3B68162 Speed: 10 Gbit63 Supported Speed: 10 Gbit64 MaxFrameSize: 204865 FC-ID (Port ID): 0x0F037766 State: Online67 686. Verify the vlan discovery is performed by running ifconfig and notice69 <INTERFACE>.<VLAN>-fcoe interfaces are automatically created.70 71Refer to fcoeadm manpage for more information on fcoeadm operations to72create/destroy interfaces or to display lun/target information.73 74NOTE75====76** Broadcom FCoE capable devices implement a DCBX/LLDP client on-chip. Only one77LLDP client is allowed per interface. For proper operation all host software78based DCBX/LLDP clients (e.g. lldpad) must be disabled. To disable lldpad on a79given interface, run the following command::80 81 lldptool set-lldp -i <interface_name> adminStatus=disabled82