Bug 1370030

Summary:	[Docs][Admin][RFE] Document FCoE hook
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Lucy Bopf <lbopf>
Component:	Documentation	Assignee:	Tahlia Richardson <trichard>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Byron Gravenorst <bgraveno>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	4.0.0	CC:	danken, ebenahar, gklein, lsurette, mkalinin, rbalakri, srevivo, ykaul, ylavi
Target Milestone:	ovirt-3.6.9	Keywords:	FutureFeature
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:	2016-10-11 06:07:34 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	Docs	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:	1334748
Bug Blocks:

Description Lucy Bopf 2016-08-25 06:22:23 UTC

From 4.1, RHV can consume FCoE block storage. An 'fcoe' hook is available on hosts (confirm whether it is available by default or must be installed). This hook and its functionality must be documented.

Depending on the FCoE card on the hosts, special configuration may be needed as described in https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Storage_Administration_Guide/fcoe-config.html. To enable FCoE on a NIC, attach a network to it, and set the "fcoe" network custom property to enable=yes[,dcb=yes][,auto_vlan=yes] in the Administration Portal.

Comment 1 Lucy Bopf 2016-08-31 01:01:00 UTC

Assigning to Tahlia for review.

Comment 4 Dan Kenigsberg 2016-09-26 13:30:54 UTC

It is not: the user should run

 engine-config -s UserDefinedNetworkCustomProperties='fcoe=^((enable|dcb|auto_vlan)=(yes|no),?)*$'

to allow the right values.

I suggest users to start with `engine-config -g UserDefinedNetworkCustomProperties` which checks whether there's a previously defined user custom property, so they don't blindly override it with the new value.

Also, we should document that on RHEL-H hosts, users are responsible to install vdsm-hook-fcoe on each host, as it is not deployed by default.

Elad, have I missed something?

Comment 5 Elad 2016-09-27 13:59:08 UTC

(In reply to Dan Kenigsberg from comment #4)

> Elad, have I missed something?
No, neither the documentation. The described procedure is correct for both RHVM FCoE configuration and fcoe custom property in networks setup

Comment 8 Tahlia Richardson 2016-10-11 06:07:34 UTC

Now published at https://access.redhat.com/documentation/en/red-hat-virtualization/4.0/single/administration-guide/#How_to_Set_Up_RHVM_to_Use_FCoE