Bugzilla will be upgraded to version 5.0. The upgrade date is tentatively scheduled for 2 December 2018, pending final testing and feedback.
Bug 1075511 - [Docs] [Technical] Need to fix predictable vNIC order procedure to include reference to sealing process in templates.
[Docs] [Technical] Need to fix predictable vNIC order procedure to include re...
Status: CLOSED CURRENTRELEASE
Product: Red Hat Enterprise Virtualization Manager
Classification: Red Hat
Component: Documentation (Show other bugs)
3.4.0
Unspecified Unspecified
high Severity unspecified
: ovirt-3.6.1
: 3.6.0
Assigned To: Andrew Dahms
ecs-bugs
docs
:
Depends On:
Blocks:
  Show dependency treegraph
 
Reported: 2014-03-12 06:10 EDT by Zac Dover
Modified: 2016-02-10 13:57 EST (History)
8 users (show)

See Also:
Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Environment:
Last Closed: 2015-11-11 23:16:56 EST
Type: Bug
Regression: ---
Mount Type: ---
Documentation: ---
CRM:
Verified Versions:
Category: ---
oVirt Team: Docs
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---


Attachments (Terms of Use)

  None (edit)
Description Zac Dover 2014-03-12 06:10:52 EDT
Predictable vNIC Order resolves the usual mess in MAC address and PCI address mapping when adding a virtual NIC to an oVirt guest by making in-guest order of NICs predictable, depending their visual order. 
  -- http://www.ovirt.org/OVirt_3.4_Release_Notes

http://www.ovirt.org/Feature/Predictable_vNIC_Order
Comment 1 Zac Dover 2014-03-13 02:06:16 EDT
The PRD bug relevant to this issue is here:

https://bugzilla.redhat.com/show_bug.cgi?id=1057988
Comment 2 Zac Dover 2014-03-13 04:20:29 EDT
See also this bug, which does not require documentation but does provide more information about why a predictable vNIC order is desirable:

https://bugzilla.redhat.com/show_bug.cgi?id=737564

(Spoiler: the old way, RHEV often tried to boot from the wrong NIC, and it had to timeout before booting commenced from the correct NIC.)
Comment 3 Andrew Dahms 2014-04-08 23:31:18 EDT
Fixed in 8942.
Comment 4 Andrew Dahms 2014-04-29 00:25:02 EDT
Documentation Link
------------------------------
http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.4/html-single/Technical_Guide/index.html#Virtual_Network_Interface_Controller_VNIC

What Changed
------------------------------
The following topic was revised to re-write the first three paragraphs to include a description of how network interface card order is regulated in a Red Hat Enterprise Virtualization environment.

Virtual Network Interface Cards [8942-628365]

Updated revision history: [30107-628366]

NVR
------------------------------
Red_Hat_Enterprise_Virtualization-Technical_Guide-3.4-en-US-3.4-7

Moving to ON_QA.
Comment 5 Tomas Dosek 2014-04-30 06:07:17 EDT
Andrew I think "ifconfig" command is actually deprecated in favor of "ip" command. This at least is valid for RHEL 7 where ip command is default way of getting NIC configuration. Don't we want to mention this in: 

http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.4/html-single/Technical_Guide/index.html#Virtual_Network_Interface_Controller_VNIC

Given the fact we're supposed to support RHEL 7 in 3.4 we should make sure we use the preferred commands for given OS family, aren't we?
Comment 6 Andrew Dahms 2014-05-01 04:17:13 EDT
Hi Tomas,

Thank you for your input.

You raise a very good point - I will update the command to use the 'ip' command and will look through the other guides to see if there are any other instances.
I will also investigate other RHEL7-based changes that might be required.

In regards to what we should replace 'ifconfig' with, do you think the standard 'ip addr show' command will do, or is there another, preferred command that I can use?

Kind regards,

Andrew
Comment 7 Martin Pavlik 2014-05-19 08:47:51 EDT
changing state to assigned as comment 6 suggests docs is not ready for QA
Comment 8 Andrew Dahms 2014-06-30 20:26:04 EDT
Revised in 8942.
Comment 9 Andrew Dahms 2014-07-24 04:12:32 EDT
Documentation Link
------------------------------
https://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.5-Beta/html-single/Technical_Guide/index.html#Virtual_Network_Interface_Controller_VNIC

What Changed
------------------------------
The following topic was revised in accordance with the advice in comment #5.
This involved editing the mention of the 'ifconfig' command and updating the STDOUT to reflect that when running 'ip addr show'.

Virtual Network Interface Cards [8942-668837]

Updated revision history: [34616-651639]

NVR
------------------------------
Red_Hat_Enterprise_Virtualization-Technical_Guide-3.5-Beta-en-US-3.5-3

Moving to ON_QA.
Comment 10 Michael Burman 2014-07-29 05:54:46 EDT
There should be link or reference to Sealing linux vm- http://www.ovirt.org/Sealing_Linux_VM
on the-http://www.ovirt.org/Feature/Predictable_vNIC_Order
For creating vm from template.
Comment 11 Andrew Dahms 2014-07-29 21:55:04 EDT
Hi Michael,

Thank you for your comment.

What kind of content are you seeking? The above topic is a conceptual overview of how predictable vNIC order operates, and also touches upon the interaction with templates.

Is there a need to include a link to the sealing procedure? I am just unsure as to how the two would come together.

Kind regards,

Andrew
Comment 12 Michael Burman 2014-07-30 01:41:10 EDT
Hi andrew, 

Because i was testing this feature, i can tell that it's an important information, when you want to import vm from template. 
If you make a vm template without the sealing procedure, you will lose the predictable vNIC order, and it's why i think, that in some way it's a part of the Predictable vNIC order feature. 

If the above topic also touches upon the interaction with templates, so information(link or reference) about sealing procedure should be included.
This is my opinion.

Kind regards,

Michael
Comment 13 Sandro Bonazzola 2015-10-26 08:44:46 EDT
this is an automated message. oVirt 3.6.0 RC3 has been released and GA is targeted to next week, Nov 4th 2015.
Please review this bug and if not a blocker, please postpone to a later release.
All bugs not postponed on GA release will be automatically re-targeted to

- 3.6.1 if severity >= high
- 4.0 if severity < high
Comment 14 Andrew Dahms 2015-11-11 23:16:56 EST
Cancelling needinfo request.

The content for this bug is now included in the Red Hat Enterprise Virtualization 3.5 documentation on the Customer Portal.

Separate bugs shall be raised to address any further requests with regards to this topic.

Closing.

Note You need to log in before you can comment on or make changes to this bug.