Bug 1404549

Summary: [Docs][Admin] Clarify important box and procedure for preparing local storage for RHVH
Product: Red Hat Enterprise Virtualization Manager Reporter: Lucy Bopf <lbopf>
Component: DocumentationAssignee: Billy Burmester <bburmest>
Status: CLOSED CURRENTRELEASE QA Contact: Tahlia Richardson <trichard>
Severity: medium Docs Contact:
Priority: medium    
Version: 4.0.0CC: lsurette, melewis, rabraham, rbalakri, srevivo, ykaul, ylavi
Target Milestone: ovirt-4.1.6Keywords: Triaged
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: 2018-02-28 01:53:31 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:

Description Lucy Bopf 2016-12-14 05:18:55 UTC 
The important box and procedure in the following section were reported by Ribu Abraham (Technical Support Engineer) as unclear:

https://access.redhat.com/documentation/en/red-hat-virtualization/4.0/paged/administration-guide/83-preparing-and-adding-local-storage

The important box notes that the path for local storage in RHVH must be within the /var directory, but the procedure below uses /data. It may be unclear to users that the same procedure, with /var prepended to each command, will work for RHVH. The procedure should be updated to include RHVH-specific substeps.

Based on an initial SME comment in https://bugzilla.redhat.com/show_bug.cgi?id=1352435#c9 the important box may require some further context:

"From RHVH 4.0 on a local storage domain must be within /var or in any subpath or the local storage domain must be put on a mount point which is backed by another volume or device"
Comment 2 Lucy Bopf 2018-01-08 04:33:39 UTC 
Moving to 'NEW' and to the default assignee to be re-triaged as resources allow.
Comment 3 Lucy Bopf 2018-02-13 04:31:30 UTC 
Assigning to Billy for review.
Comment 6 Billy Burmester 2018-02-28 01:53:31 UTC 
Now published.

[4.0] https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.0/html-single/administration_guide/

[4.1] https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html-single/administration_guide/

[4.2b] https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.2-beta/html-single/administration_guide/