€•9Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ/translations/zh_CN/scsi/bnx2fc”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/zh_TW/scsi/bnx2fc”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/it_IT/scsi/bnx2fc”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/ja_JP/scsi/bnx2fc”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/ko_KR/scsi/bnx2fc”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/sp_SP/scsi/bnx2fc”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1h”hhhžhhŸŒ9/var/lib/git/docbuild/linux/Documentation/scsi/bnx2fc.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒOperating FCoE using bnx2fc”h]”hŒOperating FCoE using bnx2fc”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h KubhŒ paragraph”“”)”}”(hX^Broadcom FCoE offload through bnx2fc is full stateful hardware offload that cooperates with all interfaces provided by the Linux ecosystem for FC/FCoE and SCSI controllers. As such, FCoE functionality, once enabled is largely transparent. Devices discovered on the SAN will be registered and unregistered automatically with the upper storage layers.”h]”hX^Broadcom FCoE offload through bnx2fc is full stateful hardware offload that cooperates with all interfaces provided by the Linux ecosystem for FC/FCoE and SCSI controllers. As such, FCoE functionality, once enabled is largely transparent. Devices discovered on the SAN will be registered and unregistered automatically with the upper storage layers.”…””}”(hhĖhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhŹ)”}”(hXTDespite the fact that the Broadcom's FCoE offload is fully offloaded, it does depend on the state of the network interfaces to operate. As such, the network interface (e.g. eth0) associated with the FCoE offload initiator must be 'up'. It is recommended that the network interfaces be configured to be brought up automatically at boot time.”h]”hXZDespite the fact that the Broadcom’s FCoE offload is fully offloaded, it does depend on the state of the network interfaces to operate. As such, the network interface (e.g. eth0) associated with the FCoE offload initiator must be ā€˜up’. It is recommended that the network interfaces be configured to be brought up automatically at boot time.”…””}”(hhŁhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K hh¶hžhubhŹ)”}”(hŒšFurthermore, the Broadcom FCoE offload solution creates VLAN interfaces to support the VLANs that have been discovered for FCoE operation (e.g. eth0.1001-fcoe). Do not delete or disable these interfaces or FCoE operation will be disrupted.”h]”hŒšFurthermore, the Broadcom FCoE offload solution creates VLAN interfaces to support the VLANs that have been discovered for FCoE operation (e.g. eth0.1001-fcoe). Do not delete or disable these interfaces or FCoE operation will be disrupted.”…””}”(hhēhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhµ)”}”(hhh]”(hŗ)”}”(hŒDriver Usage Model:”h]”hŒDriver Usage Model:”…””}”(hhųhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hhõhžhhŸh³h KubhŒenumerated_list”“”)”}”(hhh]”hŒ list_item”“”)”}”(hŒ-Ensure that fcoe-utils package is installed. ”h]”hŹ)”}”(hŒ,Ensure that fcoe-utils package is installed.”h]”hŒ,Ensure that fcoe-utils package is installed.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjhžhhŸh³h Nubah}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ.”uh1jhhõhžhhŸh³h KubhŹ)”}”(hŒf2. Configure the interfaces on which bnx2fc driver has to operate on. Here are the steps to configure:”h]”hŒf2. Configure the interfaces on which bnx2fc driver has to operate on. Here are the steps to configure:”…””}”(hj0hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhhõhžhubhŒ block_quote”“”)”}”(hX0a. cd /etc/fcoe b. copy cfg-ethx to cfg-eth5 if FCoE has to be enabled on eth5. c. Repeat this for all the interfaces where FCoE has to be enabled. d. Edit all the cfg-eth files to set "no" for DCB_REQUIRED** field, and "yes" for AUTO_VLAN. e. Other configuration parameters should be left as default ”h]”j)”}”(hhh]”(j )”}”(hŒ cd /etc/fcoe”h]”hŹ)”}”(hjIh]”hŒ cd /etc/fcoe”…””}”(hjKhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhjGubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjDubj )”}”(hŒhŸh³h Khhõhžhubj)”}”(hhh]”j )”}”(hŒGEnsure that "bnx2fc" is in SUPPORTED_DRIVERS list in /etc/fcoe/config. ”h]”hŹ)”}”(hŒFEnsure that "bnx2fc" is in SUPPORTED_DRIVERS list in /etc/fcoe/config.”h]”hŒJEnsure that ā€œbnx2fcā€ is in SUPPORTED_DRIVERS list in /etc/fcoe/config.”…””}”(hjŠhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K&hjĢubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjÉhžhhŸh³h Nubah}”(h]”h ]”h"]”h$]”h&]”j+j,j-hj.j/Œstart”Kuh1jhhõhžhhŸh³h K&ubhŹ)”}”(hŒĆ4. Start fcoe service. (service fcoe start). If Broadcom devices are present in the system, bnx2fc driver would automatically claim the interfaces, starts vlan discovery and log into the targets.”h]”hŒĆ4. Start fcoe service. (service fcoe start). If Broadcom devices are present in the system, bnx2fc driver would automatically claim the interfaces, starts vlan discovery and log into the targets.”…””}”(hjėhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K(hhõhžhubhŹ)”}”(hŒ\5. "Symbolic Name" in 'fcoeadm -i' output would display if bnx2fc has claimed the interface.”h]”hŒd5. ā€œSymbolic Nameā€ in ā€˜fcoeadm -i’ output would display if bnx2fc has claimed the interface.”…””}”(hjłhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K,hhõhžhubhŹ)”}”(hŒEg::”h]”hŒEg:”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K/hhõhžhubhŒ literal_block”“”)”}”(hX{[root@bh2 ~]# fcoeadm -i Description: NetXtreme II BCM57712 10 Gigabit Ethernet Revision: 01 Manufacturer: Broadcom Corporation Serial Number: 0010186FD558 Driver: bnx2x 1.70.00-0 Number of Ports: 2 Symbolic Name: bnx2fc v1.0.5 over eth5.4 OS Device Name: host11 Node Name: 0x10000010186FD559 Port Name: 0x20000010186FD559 FabricName: 0x2001000DECB3B681 Speed: 10 Gbit Supported Speed: 10 Gbit MaxFrameSize: 2048 FC-ID (Port ID): 0x0F0377 State: Online”h]”hX{[root@bh2 ~]# fcoeadm -i Description: NetXtreme II BCM57712 10 Gigabit Ethernet Revision: 01 Manufacturer: Broadcom Corporation Serial Number: 0010186FD558 Driver: bnx2x 1.70.00-0 Number of Ports: 2 Symbolic Name: bnx2fc v1.0.5 over eth5.4 OS Device Name: host11 Node Name: 0x10000010186FD559 Port Name: 0x20000010186FD559 FabricName: 0x2001000DECB3B681 Speed: 10 Gbit Supported Speed: 10 Gbit MaxFrameSize: 2048 FC-ID (Port ID): 0x0F0377 State: Online”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jhŸh³h K1hhõhžhubj)”}”(hhh]”j )”}”(hŒ„Verify the vlan discovery is performed by running ifconfig and notice .-fcoe interfaces are automatically created. ”h]”hŹ)”}”(hŒƒVerify the vlan discovery is performed by running ifconfig and notice .-fcoe interfaces are automatically created.”h]”hŒƒVerify the vlan discovery is performed by running ifconfig and notice .-fcoe interfaces are automatically created.”…””}”(hj,hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KDhj(ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj%hžhhŸh³h Nubah}”(h]”h ]”h"]”h$]”h&]”j+j,j-hj.j/jźKuh1jhhõhžhhŸh³h KDubhŹ)”}”(hŒ†Refer to fcoeadm manpage for more information on fcoeadm operations to create/destroy interfaces or to display lun/target information.”h]”hŒ†Refer to fcoeadm manpage for more information on fcoeadm operations to create/destroy interfaces or to display lun/target information.”…””}”(hjFhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KGhhõhžhubeh}”(h]”Œdriver-usage-model”ah ]”h"]”Œdriver usage model:”ah$]”h&]”uh1h“hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hŗ)”}”(hŒNOTE”h]”hŒNOTE”…””}”(hj_hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj\hžhhŸh³h KKubhŹ)”}”(hX** Broadcom FCoE capable devices implement a DCBX/LLDP client on-chip. Only one LLDP client is allowed per interface. For proper operation all host software based DCBX/LLDP clients (e.g. lldpad) must be disabled. To disable lldpad on a given interface, run the following command::”h]”hX** Broadcom FCoE capable devices implement a DCBX/LLDP client on-chip. Only one LLDP client is allowed per interface. For proper operation all host software based DCBX/LLDP clients (e.g. lldpad) must be disabled. To disable lldpad on a given interface, run the following command:”…””}”(hjmhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KLhj\hžhubj)”}”(hŒ:lldptool set-lldp -i adminStatus=disabled”h]”hŒ:lldptool set-lldp -i adminStatus=disabled”…””}”hj{sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jhŸh³h KQhj\hžhubeh}”(h]”Œnote”ah ]”h"]”Œnote”ah$]”h&]”uh1h“hh¶hžhhŸh³h KKubeh}”(h]”Œoperating-fcoe-using-bnx2fc”ah ]”h"]”Œoperating fcoe using bnx2fc”ah$]”h&]”uh1h“hhhžhhŸh³h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒ current_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¹NŒ generator”NŒ datestamp”NŒ source_link”NŒ source_url”NŒ toc_backlinks”Œentry”Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒ report_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j¼Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ _destination”NŒ _config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒ raw_enabled”KŒline_length_limit”M'Œpep_references”NŒ pep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒ rfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œ smart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œ image_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(j–j“jYjVjŽj‹uŒ nametypes”}”(j–‰jY‰jމuh}”(j“h¶jVhõj‹j\uŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œ collections”ŒCounter”“”}”…”R”Œparse_messages”]”(hŒsystem_message”“”)”}”(hhh]”hŹ)”}”(hŒ:Enumerated list start value not ordinal-1: "3" (ordinal 3)”h]”hŒ>Enumerated list start value not ordinal-1: ā€œ3ā€ (ordinal 3)”…””}”(hj#hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhj ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”h³Œline”Kuh1jhhõhžhhŸh³h K&ubj)”}”(hhh]”hŹ)”}”(hŒ:Enumerated list start value not ordinal-1: "6" (ordinal 6)”h]”hŒ>Enumerated list start value not ordinal-1: ā€œ6ā€ (ordinal 6)”…””}”(hj?hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhj<ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”j9Œsource”h³Œline”Kuh1jhhõhžhhŸh³h KDubeŒtransform_messages”]”Œ transformer”NŒ include_log”]”Œ decoration”Nhžhub.