Bug 1276121

Summary:	[Docs][Install][3.5] Wrong syntax for automated VLAN assignment on Red Hat Enterprise Virtualization Hypervisor
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Chris Reynolds <creynold>
Component:	Documentation	Assignee:	Julie <juwu>
Status:	CLOSED CURRENTRELEASE	QA Contact:	rhev-docs <rhev-docs>
Severity:	medium	Docs Contact:
Priority:	unspecified
Version:	3.5.0	CC:	adahms, ecohen, eedri, gklein, juwu, lsurette, rbalakri, yeylon, ylavi
Target Milestone:	ovirt-3.5.6
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:	docs
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2015-12-23 01:19:01 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:

Description Chris Reynolds 2015-10-28 18:57:34 UTC

Description of problem:
The docs at https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.5/html/Installation_Guide/sect-Automated_Installation.html use the wrong vlan syntax.

Current docs
----
vlan
    The vlan parameter sets the VLAN identifier for the network connected to the Red Hat Enterprise Virtualization Manager. This parameter should be set where VLANs are in use.

Example =>  vlan=vlan-id
----

However this fails with the same error seen in this solution https://access.redhat.com/solutions/500843

Error Seen
----
dracut: FATAL: vlan= requires two parameters
dracut: Refusing to continue
-----

Our doc should show the correct syntax as seen in this solution above
----
vlan=<vlanid>:<interface>
(eg: vlan=eth0.36:eth0)

Version-Release number of selected component (if applicable):
3.5

How reproducible:
easy

Steps to Reproduce:
1. follow documentation
2.
3.

Actual results:
dracut: FATAL: vlan= requires two parameters
dracut: Refusing to continue

Expected results:
no error

Additional info:

Comment 1 Julie 2015-11-18 01:54:29 UTC

Hi Chris,
  Thanks for filing this bug. The issue you reported has been fixed in:
https://bugzilla.redhat.com/show_bug.cgi?id=1281399
and will be published shortly with the 3.6 Beta release. 
I will make sure the change is backported to the 3.5 Install Guide as well. 

Please let me know if you have further feedback.

Cheers,
Julie

Comment 3 Chris Reynolds 2015-11-24 17:29:04 UTC

Awesome! Thanks Julie!

Comment 4 Eyal Edri 2015-11-29 12:23:15 UTC

should this be targeted to 3.5.6 rather than 3.5.7?
since 3.5.6 is due to be released this week.

Comment 5 Andrew Dahms 2015-11-29 23:27:39 UTC

Hi Eyal,

Thank you for asking after this bug.

This content will indeed be released with the updates to the documentation that are planned for RHEV 3.5.6, and we will move it to CLOSED - CURRENT RELEASE after the content has been published.

Let us know at any time if you have any further questions or concerns.

Kind regards,

Andrew

Comment 6 Julie 2015-12-23 01:19:01 UTC

Content available at:
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.5/html/Installation_Guide/sect-Automated_Installation.html#Networking_Parameters