Bug 1565155

Summary:	documentation for red hat hyperconverged infrastructure should stress to add more space to /var/log
Product:	[Red Hat Storage] Red Hat Gluster Storage	Reporter:	Marian Jankular <mjankula>
Component:	doc-Deploying_RHHI	Assignee:	Laura Bailey <lbailey>
Status:	CLOSED CURRENTRELEASE	QA Contact:	SATHEESARAN <sasundar>
Severity:	medium	Docs Contact:
Priority:	unspecified
Version:	rhgs-3.2	CC:	asriram, bkunal, bshetty, dfediuck, jcall, lsurette, rbarry, rdlugyhe, rhs-bugs, sabose, sankarshan, sarora, srevivo, ykaul
Target Milestone:	---
Target Release:	RHHI-V 1.5
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-12-17 09:32:10 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:
Bug Blocks:	1534399

Description Marian Jankular 2018-04-09 13:53:39 UTC

Description of problem:
documentation for red hat hyperconverged infrastructure should stress to add more space to /var/log

Version-Release number of selected component (if applicable):
4.1.9

RHHI documentation host prerequisites points to "normal RHVH" installation recomendation. I think this is not correct as gluster logs consume lots of space
I think we should advise to use at least 15gb for /var/log not just 8gb

RHHI documentation
https://access.redhat.com/documentation/en-us/red_hat_hyperconverged_infrastructure/1.0/html/deploying_red_hat_hyperconverged_infrastructure/install-host-physical-machines


RHV documentation:
https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html/planning_and_prerequisites_guide/requirements#host-requirements

Comment 1 Ryan Barry 2018-04-09 13:58:03 UTC

This requires modification to the custom partitioning from RHVH. That's ok, but it's definitely a docs bug, not a RHVH bug.

I would suggest that the RHHI docs should recommend storing the logs in a central location with rsyslog, logstash, journald log shipping, or another solution rather than having them per-host.

Comment 2 Lucy Bopf 2018-04-26 00:41:01 UTC

Moving to the Gluster team, who handle the RHHI documentation.

Comment 4 Sahina Bose 2018-07-05 05:35:38 UTC

(In reply to Ryan Barry from comment #1)
> This requires modification to the custom partitioning from RHVH. That's ok,
> but it's definitely a docs bug, not a RHVH bug.

Can this (custom partitioning) be done during install? Or should we change the default size alloted to /var/log in RHVH to accomodate the RHHI use case

> 
> I would suggest that the RHHI docs should recommend storing the logs in a
> central location with rsyslog, logstash, journald log shipping, or another
> solution rather than having them per-host.

Comment 5 Laura Bailey 2018-07-05 05:37:43 UTC

As an FYI, the RHGS Installation Guide has the following recommendation:

It is recommended to create a separate /var partition that is large enough (50GB - 100GB) for log files, geo-replication related miscellaneous files, and other files.

Comment 6 Laura Bailey 2018-07-05 05:47:51 UTC

Custom partitioning is available according to the RHV docs:
https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.2/html/installation_guide/advanced_rhvh_install#Custom_Partitioning

However, doing this is not recommended according to the docs.

From the customer perspective, it would probably be better to have the RHV auto-partition process take RHHI deployments into account.


Ryan is out this week, Sahina to follow this up when he's back.

Comment 9 Sahina Bose 2018-07-10 15:51:38 UTC

Logged bug 1599808 to change the default logrotate settings for gluster. 

Please update the documentation with requirements of 15GB for /var/log in case of RHHI deployments

Comment 15 bipin 2018-07-18 09:09:54 UTC

Verified the comments documented in the documentation to increase /var/log space. Looks good. Moving to verfied

Comment 17 John Call 2019-04-22 14:18:48 UTC

I see that the 4.3 beta also automatically creates a /var/crash partition, which is not documented.  This will impact the size of the installation disk required for the customer (e.g. if they are using small SD-card type installation targets)  Changing the size of the required disk can be problematic, as seen in C7 of this same bug, here https://bugzilla.redhat.com/show_bug.cgi?id=1565155#c7

Comment 18 Rolfe Dlugy-Hegwer 2019-04-26 10:51:49 UTC

(In reply to John Call from comment #17)
> I see that the 4.3 beta also automatically creates a /var/crash partition,
> which is not documented.  This will impact the size of the installation disk
> required for the customer (e.g. if they are using small SD-card type
> installation targets)  Changing the size of the required disk can be
> problematic, as seen in C7 of this same bug, here
> https://bugzilla.redhat.com/show_bug.cgi?id=1565155#c7

John: Thanks for creating https://bugzilla.redhat.com/show_bug.cgi?id=1701385. I've added /var/crash to the RHV 4.3 GA documentation. 

As agreed, that bug task does not include changes to reflect the differing requirements for RHHI. 

My recommendation is to add notes to the RHV Planning and Prerequisites guide and Installation guides directing RHHI customers to see the RHHI documentation for different requirements.