Bug 1400127

Summary: [Docs][SHE] Add a warning describing what happens if the self-hosted engine storage domain is the last active data storage domain in a data center
Product: Red Hat Enterprise Virtualization Manager Reporter: Nikolai Sednev <nsednev>
Component: DocumentationAssignee: Avital Pinnick <apinnick>
Status: CLOSED CURRENTRELEASE QA Contact: Byron Gravenorst <bgraveno>
Severity: high Docs Contact:
Priority: high    
Version: 4.0.5CC: adahms, lbopf, lsurette, nsednev, ratamir, rbalakri, srevivo, ykaul, ylavi
Target Milestone: ovirt-4.1.3   
Target Release: ---   
Hardware: x86_64   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-07-31 08:02:46 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: 1315074, 1354200, 1397189    
Bug Blocks:    

Description Nikolai Sednev 2016-11-30 13:50:48 UTC 
Description of problem:
Fort to these tree bugs, I would like to have this documented in RH official documentation:
1)https://bugzilla.redhat.com/show_bug.cgi?id=1315074
2)https://bugzilla.redhat.com/show_bug.cgi?id=1354200
3)https://bugzilla.redhat.com/show_bug.cgi?id=1397189

Version-Release number of selected component (if applicable):
Engine:
rhevm-setup-plugins-4.0.0.3-1.el7ev.noarch
rhevm-4.0.6.1-0.1.el7ev.noarch
rhevm-spice-client-x86-msi-4.0-3.el7ev.noarch
rhev-release-4.0.6-3-001.noarch
rhevm-dependencies-4.0.0-1.el7ev.noarch
rhev-guest-tools-iso-4.0-6.el7ev.noarch
rhevm-spice-client-x64-msi-4.0-3.el7ev.noarch
rhevm-branding-rhev-4.0.0-5.el7ev.noarch
rhevm-guest-agent-common-1.0.12-3.el7ev.noarch
rhevm-doc-4.0.6-1.el7ev.noarch
Linux version 3.10.0-514.el7.x86_64 (mockbuild.eng.bos.redhat.com) (gcc version 4.8.5 20150623 (Red Hat 4.8.5-11) (GCC) ) #1 SMP Wed Oct 19 11:24:13 EDT 2016
Linux 3.10.0-514.el7.x86_64 #1 SMP Wed Oct 19 11:24:13 EDT 2016 x86_64 x86_64 x86_64 GNU/Linux
Red Hat Enterprise Linux Server release 7.3 (Maipo)

Hosts:
libvirt-client-2.0.0-10.el7.x86_64
qemu-kvm-rhev-2.6.0-27.el7.x86_64
ovirt-hosted-engine-ha-2.0.4-1.el7ev.noarch
ovirt-setup-lib-1.0.2-1.el7ev.noarch
ovirt-imageio-daemon-0.4.0-0.el7ev.noarch
ovirt-vmconsole-1.0.4-1.el7ev.noarch
mom-0.5.8-1.el7ev.noarch
vdsm-4.18.15.3-1.el7ev.x86_64
ovirt-hosted-engine-setup-2.0.3-2.el7ev.noarch
sanlock-3.4.0-1.el7.x86_64
ovirt-host-deploy-1.5.3-1.el7ev.noarch
ovirt-engine-sdk-python-3.6.9.1-1.el7ev.noarch
ovirt-imageio-common-0.3.0-0.el7ev.noarch
ovirt-vmconsole-host-1.0.4-1.el7ev.noarch
Linux version 3.10.0-514.el7.x86_64 (mockbuild.eng.bos.redhat.com) (gcc version 4.8.5 20150623 (Red Hat 4.8.5-11) (GCC) ) #1 SMP Wed Oct 19 11:24:13 EDT 2016
Linux 3.10.0-514.el7.x86_64 #1 SMP Wed Oct 19 11:24:13 EDT 2016 x86_64 x86_64 x86_64 GNU/Linux
Red Hat Enterprise Linux Server release 7.3 (Maipo)


How reproducible:
100%

Steps to Reproduce:
1.Get HE environment deployed on pair of hosts with single data storage domain.
2.Set single data storage domain in to maintenance.
3.

Actual results:
Scenario with single data storage domain not covered in current RH documentation.

Expected results:
We should cover single data storage domain scenario in official RH documentation with proper warnings for customers.

Additional info:
Comment 1 Yaniv Lavi 2016-12-05 08:58:23 UTC 
Can you please add description of what happen if HE storage is the last storage in the DC? 
And what else you want documented about this?
Comment 4 Yaniv Lavi 2016-12-14 16:25:35 UTC 
This bug had requires_doc_text flag, yet no documentation text was provided. Please add the documentation text and only then set this flag.
Comment 5 Lucy Bopf 2017-06-29 07:08:09 UTC 
Assigning to Avital for review.

Avital, we need to add a warning to the Self-Hosted Engine Guide that recommends that users always have additional active data storage domains in the same data center as their self-hosted engine environment, and the potential consequences of not following this advice, as explained in comment 2.

Please add this note to the 4.0 and 4.1 documentation.
Comment 14 Byron Gravenorst 2017-07-28 05:39:03 UTC 
Reviewed and verified.
Comment 15 Avital Pinnick 2017-07-30 06:31:11 UTC 
Updated Self-Hosted Engine Guide 4.0:
https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.0/html-single/self-hosted_engine_guide/

4.1 awaiting merge.
Comment 16 Avital Pinnick 2017-07-31 08:02:46 UTC 
Updated Self-Hosted Engine Guide 4.1:
https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html-single/self-hosted_engine_guide