Bug 1658661 - [Docs] Hosts with mismatch IP-stack at the same cluster is not allowed
Summary: [Docs] Hosts with mismatch IP-stack at the same cluster is not allowed
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Virtualization Manager
Classification: Red Hat
Component: Documentation
Version: 4.3.0
Hardware: x86_64
OS: Linux
high
low
Target Milestone: ovirt-4.3.0
: ---
Assignee: Rolfe Dlugy-Hegwer
QA Contact: rhev-docs@redhat.com
Rolfe Dlugy-Hegwer
URL:
Whiteboard:
Depends On: 1658638
Blocks:
TreeView+ depends on / blocked
 
Reported: 2018-12-12 15:57 UTC by Roni
Modified: 2019-05-07 12:44 UTC (History)
12 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2019-01-15 16:51:06 UTC
oVirt Team: Network
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)
PDF rendering of /docs-Red_Hat_Enterprise_Virtualization/doc-Technical_Reference/topics/Host_Networking_Configurations.adoc (2.45 MB, application/pdf)
2019-01-09 21:13 UTC, Rolfe Dlugy-Hegwer
no flags Details
PDF rendering of /docs-Red_Hat_Enterprise_Virtualization/doc-Administration_Guide/topics/Editing_host_network_interfaces.adoc (3.24 MB, application/pdf)
2019-01-09 21:19 UTC, Rolfe Dlugy-Hegwer
no flags Details

Description Roni 2018-12-12 15:57:07 UTC
Description of problem:
It is recommended not to mix hosts with different IP-stack (IPv4, IPv6, or both) at the same cluster.
Currently, the system is not alerting or blocking the user from such a configuration

Version-Release number of selected component (if applicable):
4.3.0-0.6.alpha2.el7

How reproducible:
100%

Steps to Reproduce:
1. Engine: go to Compute | Hosts | Network Interfaces | Setup Host Networks
2. Edit 'ovirtmgmt' attached to NIC
3. Enable/Disable IPv6/IPv4

Actual results:
User can set one host as IPv4 only and second as IPv6 & IPv4

Expected results:
All hosts should have the same settings, only IPv4, only IPv6, or both IPv4 & IPv6

Additional info:
https://bugzilla.redhat.com/show_bug.cgi?id=1658639

Comment 4 Rolfe Dlugy-Hegwer 2019-01-03 19:19:37 UTC
Hi Roni,

Where do you think would be the best place to present this information?
Here's a list of the most likely topics: https://access.redhat.com/search/#/?q=ovirtmgmt&p=1&sort=relevant&scoped=false&documentKind=Documentation

Comment 5 Rolfe Dlugy-Hegwer 2019-01-07 20:30:13 UTC
Hi Roni. Aside from not mixing protocols, could you please confirm that IPv6 is supported? I ask because I found this note, which might be outdated: "The IPv6 tab should not be used as it is currently not supported." in the following doc topic: https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.2/html-single/administration_guide/#Editing_host_network_interfaces

In any case, that note in the doc is the same place where I plan to document place the following proposed text:

"All of the hosts must have the same setting: IPv4, IPv6, or IPv4 & IPv6
For example, when configuring Host Network Interfaces using Setup Host Networks and ovirtmgmt, set all of the hosts to use only one of the following: IPv4, IPv6, or IPv4 & IPv6. If the hosts use different settings, they will not be able to connect."

Please review and approve.

Thanks,

Rolfe

Comment 6 Roni 2019-01-08 07:30:29 UTC
Hi Rolfe

Regarding comment 4 above, I think that the best place to present this information would be:
3.16. HOST NETWORKING CONFIGURATIONS

Regarding Comment 5:
IPv6 should be supported from v4.3

I would change the proposed text as following:
1. "All of the hosts at the same cluster must have....."
   I add the text: "at the same cluster"

2. "...they will not be able to connect..." should be changed to 
   "...they will not be able to communicate one with each other..."


Thanks
Roni

Comment 7 Rolfe Dlugy-Hegwer 2019-01-08 20:37:45 UTC
I've added the following text to /home/rdlugyhe/docs-Red_Hat_Enterprise_Virtualization/doc-Technical_Reference/topics/Host_Networking_Configurations.adoc

[IMPORTANT]
====
Set all of the hosts in the same cluster to use the same option: *IPv4*, *IPv6*, or *IPv4 & IPv6*. For example, when configuring the ovirtmgmt network, set all of the host network interfaces in the *Setup Host Networks* window to use only one of the following options: *IPv4*, *IPv6*, or *IPv4 & IPv6*. If the hosts use different options, they cannot communicate with each other.
====

Roni is tech reviewing the rendered doc. Here's a Google doc with a screenshot and text:

https://docs.google.com/document/d/16Suo4tf_-gROSB4B4NGZWJG0F80FjCK6_sUxqOBM0EY/edit?usp=sharing

Comment 8 Rolfe Dlugy-Hegwer 2019-01-08 21:32:01 UTC
Roni. I've created this WIP merge request: https://gitlab.cee.redhat.com/rhci-documentation/docs-Red_Hat_Enterprise_Virtualization/merge_requests/1205
When you've reviewed and approved the text, I'll resolve the WIP status.

Comment 9 Rolfe Dlugy-Hegwer 2019-01-09 21:13:49 UTC
Created attachment 1519587 [details]
PDF rendering of  /docs-Red_Hat_Enterprise_Virtualization/doc-Technical_Reference/topics/Host_Networking_Configurations.adoc

Comment 10 Rolfe Dlugy-Hegwer 2019-01-09 21:19:07 UTC
Created attachment 1519588 [details]
PDF rendering of /docs-Red_Hat_Enterprise_Virtualization/doc-Administration_Guide/topics/Editing_host_network_interfaces.adoc

To find the added text, Ctrl+F "Set all of the hosts in the same cluster to "

Comment 11 Rolfe Dlugy-Hegwer 2019-01-09 21:19:25 UTC
Comment on attachment 1519587 [details]
PDF rendering of  /docs-Red_Hat_Enterprise_Virtualization/doc-Technical_Reference/topics/Host_Networking_Configurations.adoc

To find the added text, Ctrl+F "Set all of the hosts in the same cluster to "

Comment 12 Rolfe Dlugy-Hegwer 2019-01-09 21:28:53 UTC
Hi Chris, Would you peer review the two PDFs? To find the added text, Ctrl+F "Set all of the hosts in the same cluster to "

Here's the associated WIP merge request https://gitlab.cee.redhat.com/rhci-documentation/docs-Red_Hat_Enterprise_Virtualization/merge_requests/1209

Comment 14 Rolfe Dlugy-Hegwer 2019-01-15 16:51:06 UTC
The documentation has been updated to fix this issue. See: https://gitlab.cee.redhat.com/rhci-documentation/docs-Red_Hat_Enterprise_Virtualization/merge_requests/1210
The changes were both tech reviewed and doc reviewed.


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