Bug 1420938

Summary: correction needed for 24.4. Configuring a Fibre Channel over Ethernet Interface
Product: Red Hat Enterprise Linux 7 Reporter: Mason Loring Bliss <mbliss>
Component: doc-Storage_Administration_GuideAssignee: Milan Navratil <mnavrati>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: unspecified Docs Contact:
Priority: medium    
Version: 7.3CC: mbliss, rhel-docs
Target Milestone: rcKeywords: Documentation, EasyFix
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-05-24 22:20:22 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Mason Loring Bliss 2017-02-09 22:58:05 UTC
Document URL:

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Storage_Administration_Guide/fcoe-config.html

Section Number and Name:

24.4. Configuring a Fibre Channel over Ethernet Interface

Describe the issue:

Step 1 gives as an example:

    # cp /etc/fcoe/cfg-eth0  /etc/fcoe/cfg-ethX

However, in a default install, there is no /etc/fcoe/cfg-eth0. Instead, there is a file named "cfg-ethx".

Suggestions for improvement:

Step 1 should give as an example:

    # cp /etc/fcoe/cfg-ethx /etc/fcoe/cfg-ethX

Additional information:

While this is unfortunately confusing, it's correct. Just today I had a customer stumble on this, noting that there is no file "cfg-eth1".

Comment 3 Mason Loring Bliss 2017-05-19 19:19:33 UTC
Just noticed that the page seems to have been updated incorrectly.

We want:

# cp /etc/fcoe/cfg-ethx /etc/fcoe/cfg-ethX

Comment 5 Milan Navratil 2017-05-24 22:20:22 UTC
The fix is now available on the Red Hat Customer Portal:

http://jenkinscat.gsslab.pnq.redhat.com:8080/job/doc-Red_Hat_Enterprise_Linux-7-Storage_Administration_Guide%20(html-single)/lastStableBuild/artifact/tmp/en-US/html-single/index.html#fcoe-config

~~~
 To configure a new VLAN, make a copy of an existing network script, for example /etc/fcoe/cfg-eth0, and change the name to the Ethernet device that supports FCoE. This provides you with a default file to configure. Given that the FCoE device is ethX, run:

# cp /etc/fcoe/cfg-ethx  /etc/fcoe/cfg-ethX

Modify the contents of cfg-ethX as needed. Notably, set DCB_REQUIRED to no for networking interfaces that implement a hardware Data Center Bridging Exchange (DCBX) protocol client. 
~~~

Comment 7 Milan Navratil 2017-05-24 22:28:33 UTC
I shared an internal link in comment 5 by accident. This is the correct link to the updated version of the Storage Administration Guide on the Red Hat Customer Portal: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Storage_Administration_Guide/fcoe-config.html