Bug 1369874

Summary:	[Docs][Install] Update the disk requirements for RHVH
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Fabian Deutsch <fdeutsch>
Component:	Documentation	Assignee:	Emma Heftman <eheftman>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Byron Gravenorst <bgraveno>
Severity:	medium	Docs Contact:
Priority:	high
Version:	4.0.0	CC:	bgraveno, bugs, dougsland, eheftman, guillaume.pavese, lbopf, lsurette, mgoldboi, rbalakri, rbarry, sbonazzo, srevivo, ycui, ylavi
Target Milestone:	ovirt-4.1.1-1	Flags:	eheftman: needinfo- guillaume.pavese: needinfo?
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:	2017-05-03 11:09: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 Fabian Deutsch 2016-08-24 15:06:15 UTC

Node 4 is using a LVM thinpool.

Thus we can differentiate between the minimum requirements which are derived from teh space we need to write down the images, and the maximum requirements which are derived from the maximum filesystems sizes of all filesystems in the pool.

Comment 1 Douglas Schilling Landgraf 2017-01-17 21:18:22 UTC

Currently the RHVH disk requirements are:

    Partitions required:
        - /     - As LVM Thin Provisioning
        - /var  - As LVM Thin Provisioning
        - /boot - Standard partition

    Size of partitions:
        - /     - At least 6G
        - /var  - At least 15G
        - /boot - At least 1G

    Filesystem type:
        - /     - xfs or ext4
        - /var  - xfs or ext4
        - /boot - xfs or ext4

Comment 2 Douglas Schilling Landgraf 2017-01-17 21:23:49 UTC

Example of manual installation:
=========================
 - Boot RHVH 4.X CD
   - Select Install RHVH 4.X
     - Select and Set Language
     - Select and Set Date & Time
     - Select and Set Keyboard
     - Select and Set Installation Destination 
       - Select the HardDisk
       - Select <I will configure partitioning>
       - Click Done

    Now create the partitions as you desire, the minimum required are: 
       / 6G - Device Type: LVM Thin Provisioning FileSystem: xfs or ext4
       /var 15G - Device Type: LVM Thin Provisioning FileSystem: xfs or ext4
       /boot 1G - Device type: Standard Partition FileSystem: xfs or ext4


Example of kickstart:
=========================
<snip>
clearpart --all
part /boot --fstype xfs --size=1000 --ondisk=sda
part pv.01 --size=42000 --grow
volgroup HostVG pv.01
logvol swap --vgname=HostVG --name=swap --fstype=swap --recommended
logvol none --vgname=HostVG --name=HostPool --thinpool --size=40000 --grow
logvol / --vgname=HostVG --name=root --thin --fstype=ext4 --poolname=HostPool --fsoptions="defaults,discard" --size=6000
logvol /var --vgname=HostVG --name=var --thin --fstype=ext4 --poolname=HostPool --fsoptions="defaults,discard" --size=15000
<snip>

Comment 3 Douglas Schilling Landgraf 2017-01-17 21:37:53 UTC

Fabian/Ryan, 

Could you please review?

Thanks!

Comment 4 Ryan Barry 2017-01-18 23:56:21 UTC

Looks OK to me, except I believe the root partition grows with our installclass, so we should keep that the same

Comment 5 Douglas Schilling Landgraf 2017-01-23 17:50:40 UTC

(In reply to Ryan Barry from comment #4)
> Looks OK to me, except I believe the root partition grows with our
> installclass, so we should keep that the same

Sure, updated the example to include --grow in /. Any additional comment?

Example of kickstart:
=========================
<snip>
clearpart --all
part /boot --fstype xfs --size=1000 --ondisk=sda
part pv.01 --size=42000 --grow
volgroup HostVG pv.01
logvol swap --vgname=HostVG --name=swap --fstype=swap --recommended
logvol none --vgname=HostVG --name=HostPool --thinpool --size=40000 --grow
logvol / --vgname=HostVG --name=root --thin --fstype=ext4 --poolname=HostPool --fsoptions="defaults,discard" --size=6000 --grow
logvol /var --vgname=HostVG --name=var --thin --fstype=ext4 --poolname=HostPool --fsoptions="defaults,discard" --size=15000
<snip>

Comment 6 Ryan Barry 2017-01-23 18:19:32 UTC

Looks OK to me

Comment 7 Douglas Schilling Landgraf 2017-01-23 18:23:03 UTC

Hi Emma,

Could you please review this report as well? Looks like a good candidate to include in our documentation.

Thanks!

Comment 8 Emma Heftman 2017-01-24 13:00:38 UTC

Hi Lucy
Pls. see comment 7. This is not a bug that was assigned to me.

Comment 9 Lucy Bopf 2017-01-24 13:23:38 UTC

(In reply to Douglas Schilling Landgraf from comment #7)
> Hi Emma,
> 
> Could you please review this report as well? Looks like a good candidate to
> include in our documentation.
> 
> Thanks!

Hi Douglas,

Thanks for notifying Emma of the potential docs impact here. To confirm: Is this a change for RHV 4.1? Is this simply an update to the minimum disk requirements for RHVH? I'm not sure if the information about the kickstart is to be included as well.

Let me know, and I can raise a separate bug against the downstream documentation.

Comment 10 Ryan Barry 2017-01-24 13:25:10 UTC

This is not a change for 4.1 -- just clarifying the requirements which have existed since 4.0.

This should definitely be part of the documentation.

Comment 11 Sandro Bonazzola 2017-01-31 09:20:15 UTC

Moving to docs team

Comment 12 Sandro Bonazzola 2017-02-01 16:02:25 UTC

oVirt 4.1.0 GA has been released, re-targeting to 4.1.1.
Please check if this issue is correctly targeted or already included in 4.1.0.

Comment 13 Douglas Schilling Landgraf 2017-02-01 18:46:56 UTC

(In reply to Sandro Bonazzola from comment #12)
> oVirt 4.1.0 GA has been released, re-targeting to 4.1.1.
> Please check if this issue is correctly targeted or already included in
> 4.1.0.

Seems correct re-targeted, removing needinfo.

Comment 14 Yaniv Lavi 2017-02-07 09:07:30 UTC

Can you please provide the exact action items to be documented?

Comment 15 Douglas Schilling Landgraf 2017-02-07 21:18:46 UTC

(In reply to Yaniv Dary from comment #14)
> Can you please provide the exact action items to be documented?

#1) I would suggest update this document:
https://access.redhat.com/documentation/en/red-hat-virtualization/4.0/single/installation-guide/#Advanced_RHVH_Install according with comment#1:

Currently the RHVH disk requirements are:

    Partitions required:
        - /     - As LVM Thin Provisioning
        - /var  - As LVM Thin Provisioning
        - /boot - Standard partition

    Size of partitions:
        - /     - At least 6G
        - /var  - At least 15G
        - /boot - At least 1G

    Filesystem type:
        - /     - xfs or ext4
        - /var  - xfs or ext4
        - /boot - xfs or ext4


#2) Add if possible example of manual partitioning/installation (#comment2):

Example of manual installation:
=========================
 - Boot RHVH 4.X CD
   - Select Install RHVH 4.X
     - Select and Set Language
     - Select and Set Date & Time
     - Select and Set Keyboard
     - Select and Set Installation Destination 
       - Select the HardDisk
       - Select <I will configure partitioning>     
       - Click Done

    Now create the partitions as you desire, the minimum required are: 
       / 6G - Device Type: LVM Thin Provisioning FileSystem: xfs or ext4
       /var 15G - Device Type: LVM Thin Provisioning FileSystem: xfs or ext4
       /boot 1G - Device type: Standard Partition FileSystem: xfs or ext4


#3) Finally, I would show in the advanced topics an example of kickstart:

Example of kickstart: (comment#5)
=========================
<snip>
clearpart --all
part /boot --fstype xfs --size=1000 --ondisk=sda
part pv.01 --size=42000 --grow
volgroup HostVG pv.01
logvol swap --vgname=HostVG --name=swap --fstype=swap --recommended
logvol none --vgname=HostVG --name=HostPool --thinpool --size=40000 --grow
logvol / --vgname=HostVG --name=root --thin --fstype=ext4 --poolname=HostPool --fsoptions="defaults,discard" --size=6000 --grow
logvol /var --vgname=HostVG --name=var --thin --fstype=ext4 --poolname=HostPool --fsoptions="defaults,discard" --size=15000
<snip>

Comment 16 Douglas Schilling Landgraf 2017-02-07 21:25:05 UTC

Internal note:

Looks like we are going to change again very soon according with:
https://bugzilla.redhat.com/show_bug.cgi?id=1420068

Comment 17 Yaniv Lavi 2017-02-14 07:33:59 UTC

(In reply to Douglas Schilling Landgraf from comment #16)
> Internal note:
> 
> Looks like we are going to change again very soon according with:
> https://bugzilla.redhat.com/show_bug.cgi?id=1420068

I see in the bug that you plan the changes in 4.1.
Can you provide the new info for 4.1?

Comment 18 Douglas Schilling Landgraf 2017-03-08 05:29:11 UTC

(In reply to Yaniv Dary from comment #17)
> (In reply to Douglas Schilling Landgraf from comment #16)
> > Internal note:
> > 
> > Looks like we are going to change again very soon according with:
> > https://bugzilla.redhat.com/show_bug.cgi?id=1420068
> 
> I see in the bug that you plan the changes in 4.1.
> Can you provide the new info for 4.1?

* Currently the RHVH disk requirements are:

    Partitions required:
        - /              - As LVM Thin Provisioning
        - /home          - As LVM Thin Provisioning
        - /tmp           - As LVM Thin Provisioning 
        - /var           - As LVM Thin Provisioning
        - /var/log       - As LVM Thin Provisioning
        - /var/log/audit - As LVM Thin Provisioning
        - /boot - Standard partition

    Size of partitions:
        - /               - At least 6G
        - /home           - At least 1G
        - /tmp            - At least 1G
        - /var            - At least 15G
        - /var/log        - At least 8G
        - /var/log/audit  - At least 2G
        - /boot           - At least 1G

   Filesystem type:
        - xfs or ext4


* Add if possible example of manual partitioning/installation:

Example of manual installation:
=========================
 - Boot RHVH 4.X CD
   - Select Install RHVH 4.X
     - Select and Set Language
     - Select and Set Date & Time
     - Select and Set Keyboard
     - Select and Set Installation Destination 
       - Select the HardDisk
       - Select <I will configure partitioning>     
       - Click Done

    Now create the partitions as you desire, the minimum required are: 
       / 6G - Device Type: LVM Thin Provisioning FileSystem: xfs or ext4
       /home 1G - Device Type: LVM Thin Provisioning FileSystem: xfs or ext4
       /tmp 1G - Device Type: LVM Thin Provisioning FileSystem: xfs or ext4
       /var 15G - Device Type: LVM Thin Provisioning FileSystem: xfs or ext4
       /var/log 8G - Device Type: LVM Thin Provisioning FileSystem: xfs or ext4
       /var/log/audit 2G - Device Type: LVM Thin Provisioning FileSystem: xfs or ext4
       /boot 1G - Device type: Standard Partition FileSystem: xfs or ext4


* I would show in the advanced topics an example of kickstart:

Example of kickstart:
=========================
<snip>
clearpart --all
part /boot --fstype xfs --size=1000 --ondisk=sda
part pv.01 --size=42000 --grow
volgroup HostVG pv.01
logvol swap --vgname=HostVG --name=swap --fstype=swap --recommended
logvol none --vgname=HostVG --name=HostPool --thinpool --size=40000 --grow
logvol / --vgname=HostVG --name=root --thin --fstype=ext4 --poolname=HostPool --fsoptions="defaults,discard" --size=6000 --grow
logvol /var --vgname=HostVG --name=var --thin --fstype=ext4 --poolname=HostPool --fsoptions="defaults,discard" --size=15000
logvol /var/log --vgname=HostVG --name=var_log --thin --fstype=ext4 --poolname=HostPool --fsoptions="defaults,discard" --size=8000
logvol /var/log/audit --vgname=HostVG --name=var_audit --thin --fstype=ext4 --poolname=HostPool --fsoptions="defaults,discard" --size=2000
logvol /home --vgname=HostVG --name=home --thin --fstype=ext4 --poolname=HostPool --fsoptions="defaults,discard" --size=1000
logvol /tmp --vgname=HostVG --name=tmp --thin --fstype=ext4 --poolname=HostPool --fsoptions="defaults,discard" --size=1000
<snip>

Comment 20 Lucy Bopf 2017-04-13 01:18:30 UTC

Assigning to Emma for review.

Comment 25 Emma Heftman 2017-05-03 11:09:01 UTC

The updated documentation is available on the customer portal:

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html-single/installation_guide/#Advanced_RHVH_Install

Comment 26 Guillaume Pavese 2018-07-30 08:05:03 UTC

There is a bug in this kickstart exemple that has been copied on to the official documentation as visible here : https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.2/html-single/installation_guide/#Advanced_RHVH_Install


The bug is the use of "--grow" on the creation of "logvol /" :

logvol / --vgname=HostVG --name=root --thin --fstype=ext4 --poolname=HostPool --fsoptions="defaults,discard" --size=6000 --grow

Either --grow should not be used, or the creation of "logvol /" shoul be last.

If copied as is, this exemple fails to work as intended

I think the doc should be changed but I do not know the proper channel for asking that