0001 .. SPDX-License-Identifier: GPL-2.0
0002
0003 ===========================
0004 Operating FCoE using bnx2fc
0005 ===========================
0006 Broadcom FCoE offload through bnx2fc is full stateful hardware offload that
0007 cooperates with all interfaces provided by the Linux ecosystem for FC/FCoE and
0008 SCSI controllers. As such, FCoE functionality, once enabled is largely
0009 transparent. Devices discovered on the SAN will be registered and unregistered
0010 automatically with the upper storage layers.
0011
0012 Despite the fact that the Broadcom's FCoE offload is fully offloaded, it does
0013 depend on the state of the network interfaces to operate. As such, the network
0014 interface (e.g. eth0) associated with the FCoE offload initiator must be 'up'.
0015 It is recommended that the network interfaces be configured to be brought up
0016 automatically at boot time.
0017
0018 Furthermore, the Broadcom FCoE offload solution creates VLAN interfaces to
0019 support the VLANs that have been discovered for FCoE operation (e.g.
0020 eth0.1001-fcoe). Do not delete or disable these interfaces or FCoE operation
0021 will be disrupted.
0022
0023 Driver Usage Model:
0024 ===================
0025
0026 1. Ensure that fcoe-utils package is installed.
0027
0028 2. Configure the interfaces on which bnx2fc driver has to operate on.
0029 Here are the steps to configure:
0030
0031 a. cd /etc/fcoe
0032 b. copy cfg-ethx to cfg-eth5 if FCoE has to be enabled on eth5.
0033 c. Repeat this for all the interfaces where FCoE has to be enabled.
0034 d. Edit all the cfg-eth files to set "no" for DCB_REQUIRED** field, and
0035 "yes" for AUTO_VLAN.
0036 e. Other configuration parameters should be left as default
0037
0038 3. Ensure that "bnx2fc" is in SUPPORTED_DRIVERS list in /etc/fcoe/config.
0039
0040 4. Start fcoe service. (service fcoe start). If Broadcom devices are present in
0041 the system, bnx2fc driver would automatically claim the interfaces, starts vlan
0042 discovery and log into the targets.
0043
0044 5. "Symbolic Name" in 'fcoeadm -i' output would display if bnx2fc has claimed
0045 the interface.
0046
0047 Eg::
0048
0049 [root@bh2 ~]# fcoeadm -i
0050 Description: NetXtreme II BCM57712 10 Gigabit Ethernet
0051 Revision: 01
0052 Manufacturer: Broadcom Corporation
0053 Serial Number: 0010186FD558
0054 Driver: bnx2x 1.70.00-0
0055 Number of Ports: 2
0056
0057 Symbolic Name: bnx2fc v1.0.5 over eth5.4
0058 OS Device Name: host11
0059 Node Name: 0x10000010186FD559
0060 Port Name: 0x20000010186FD559
0061 FabricName: 0x2001000DECB3B681
0062 Speed: 10 Gbit
0063 Supported Speed: 10 Gbit
0064 MaxFrameSize: 2048
0065 FC-ID (Port ID): 0x0F0377
0066 State: Online
0067
0068 6. Verify the vlan discovery is performed by running ifconfig and notice
0069 <INTERFACE>.<VLAN>-fcoe interfaces are automatically created.
0070
0071 Refer to fcoeadm manpage for more information on fcoeadm operations to
0072 create/destroy interfaces or to display lun/target information.
0073
0074 NOTE
0075 ====
0076 ** Broadcom FCoE capable devices implement a DCBX/LLDP client on-chip. Only one
0077 LLDP client is allowed per interface. For proper operation all host software
0078 based DCBX/LLDP clients (e.g. lldpad) must be disabled. To disable lldpad on a
0079 given interface, run the following command::
0080
0081 lldptool set-lldp -i <interface_name> adminStatus=disabled
