linux/Documentation/scsi/bnx2fc.txt
<<
>>
Prefs
   1Operating FCoE using bnx2fc
   2===========================
   3Broadcom FCoE offload through bnx2fc is full stateful hardware offload that
   4cooperates with all interfaces provided by the Linux ecosystem for FC/FCoE and
   5SCSI controllers.  As such, FCoE functionality, once enabled is largely
   6transparent. Devices discovered on the SAN will be registered and unregistered
   7automatically with the upper storage layers.
   8
   9Despite the fact that the Broadcom's FCoE offload is fully offloaded, it does
  10depend on the state of the network interfaces to operate. As such, the network
  11interface (e.g. eth0) associated with the FCoE offload initiator must be 'up'.
  12It is recommended that the network interfaces be configured to be brought up
  13automatically at boot time.
  14
  15Furthermore, the Broadcom FCoE offload solution creates VLAN interfaces to
  16support the VLANs that have been discovered for FCoE operation (e.g.
  17eth0.1001-fcoe).  Do not delete or disable these interfaces or FCoE operation
  18will be disrupted.
  19
  20Driver Usage Model:
  21===================
  22
  231. Ensure that fcoe-utils package is installed.
  24
  252. Configure the interfaces on which bnx2fc driver has to operate on.
  26Here are the steps to configure:
  27        a. cd /etc/fcoe
  28        b. copy cfg-ethx to cfg-eth5 if FCoE has to be enabled on eth5.
  29        c. Repeat this for all the interfaces where FCoE has to be enabled.
  30        d. Edit all the cfg-eth files to set "no" for DCB_REQUIRED** field, and
  31           "yes" for AUTO_VLAN.
  32        e. Other configuration parameters should be left as default
  33
  343. Ensure that "bnx2fc" is in SUPPORTED_DRIVERS list in /etc/fcoe/config.
  35
  364. Start fcoe service. (service fcoe start). If Broadcom devices are present in
  37the system, bnx2fc driver would automatically claim the interfaces, starts vlan
  38discovery and log into the targets.
  39
  405. "Symbolic Name" in 'fcoeadm -i' output would display if bnx2fc has claimed
  41the interface.
  42Eg:
  43[root@bh2 ~]# fcoeadm -i
  44    Description:      NetXtreme II BCM57712 10 Gigabit Ethernet
  45    Revision:         01
  46    Manufacturer:     Broadcom Corporation
  47    Serial Number:    0010186FD558
  48    Driver:           bnx2x 1.70.00-0
  49    Number of Ports:  2
  50
  51        Symbolic Name:     bnx2fc v1.0.5 over eth5.4
  52        OS Device Name:    host11
  53        Node Name:         0x10000010186FD559
  54        Port Name:         0x20000010186FD559
  55        FabricName:        0x2001000DECB3B681
  56        Speed:             10 Gbit
  57        Supported Speed:   10 Gbit
  58        MaxFrameSize:      2048
  59        FC-ID (Port ID):   0x0F0377
  60        State:             Online
  61
  626. Verify the vlan discovery is performed by running ifconfig and notice
  63<INTERFACE>.<VLAN>-fcoe interfaces are automatically created.
  64
  65Refer to fcoeadm manpage for more information on fcoeadm operations to
  66create/destroy interfaces or to display lun/target information.
  67
  68NOTE:
  69====
  70** Broadcom FCoE capable devices implement a DCBX/LLDP client on-chip. Only one
  71LLDP client is allowed per interface. For proper operation all host software
  72based DCBX/LLDP clients (e.g. lldpad) must be disabled. To disable lldpad on a
  73given interface, run the following command:
  74
  75lldptool set-lldp -i <interface_name> adminStatus=disabled
  76
lxr.linux.no kindly hosted by Redpill Linpro AS, provider of Linux consulting and operations services since 1995.