Bug 1683075 - [DOC] Clarity on increasing the size of /var/log in RHHI4Virt deployment document.
Summary: [DOC] Clarity on increasing the size of /var/log in RHHI4Virt deployment doc...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat Storage
Component: doc-Deploying_RHHI
Version: rhhiv-1.6
Hardware: x86_64
OS: Linux
unspecified
high
Target Milestone: ---
: ---
Assignee: Laura Bailey
QA Contact: Mugdha Soni
URL:
Whiteboard:
Depends On:
Blocks: RHHI-V-1-6-Documentation-InFlight-BZs
TreeView+ depends on / blocked
 
Reported: 2019-02-26 08:27 UTC by Mugdha Soni
Modified: 2019-05-20 04:18 UTC (History)
8 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2019-05-20 04:18:50 UTC
Embargoed:


Attachments (Terms of Use)

Description Mugdha Soni 2019-02-26 08:27:13 UTC
Description of problem:
-------------------------
In chapter 4 of deployment document of rhhi4V states that " Increase the size of /var/log to 15GB to provide sufficient space for the additional logging requirements of Red Hat Gluster Storage. "

We need to refine this  statement as " Increase the size of the available var/log to 15GB to provide sufficient space for additional logging requirements of Red Hat Gluster Storage.

Also we need to add the steps/commands to increase the size of the var/log.The commands are mentioned below :

1. device=`ls /dev/mapper | grep var_log$`
2. lvextend --size <required size> /dev/mapper/$device
3. resize2fs /dev/mapper/$device 


Additional info:
-----------------
The document used is " https://access.qa.redhat.com/documentation/en-us/red_hat_hyperconverged_infrastructure_for_virtualization/1.6/html-single/deploying_red_hat_hyperconverged_infrastructure_for_virtualization/ "

Comment 1 SATHEESARAN 2019-03-08 08:45:06 UTC
This changes comes as part of deployment enhancement and attaching this doc bug to the associated doc RFE tracker

@Anjana, could you provide devel_ack on this one ?
Already we have warning on minimum requirement of 15 GB for /var/log

Now we need to emphasize, the available space of /var/log should be 15GB as requirement,
else the validation during deployment will fail

Comment 2 SATHEESARAN 2019-03-08 08:47:03 UTC
This is a inflight bug and doesn't qualify to be RFE, though the parent change came in from deployment enhancement RFE

Comment 3 Rejy M Cyriac 2019-03-08 09:08:29 UTC
(In reply to SATHEESARAN from comment #1)
> This changes comes as part of deployment enhancement and attaching this doc
> bug to the associated doc RFE tracker
> 
> @Anjana, could you provide devel_ack on this one ?
> Already we have warning on minimum requirement of 15 GB for /var/log
> 
> Now we need to emphasize, the available space of /var/log should be 15GB as
> requirement,
> else the validation during deployment will fail

Emphasis on available space to be at least 15 GB is good.

But I am not sure we should add the steps to increase the size as provided in Comment 0

Comment 6 SATHEESARAN 2019-03-14 08:57:06 UTC
(In reply to Rejy M Cyriac from comment #3)
> 
> Emphasis on available space to be at least 15 GB is good.
> 
> But I am not sure we should add the steps to increase the size as provided
> in Comment 0

This is for ease of use purpose, the commands will be helpful for customers to
directly increase the size of the /var/log/ LV

@Rejy, Do you expect that these commands should be already known for the admin/customer ?

Comment 7 SATHEESARAN 2019-03-14 09:03:21 UTC
(In reply to Laura Bailey from comment #4)
> Is this done as part of the ansible installation script, or is it something
> users need to do manually?

User have to do it manually.
They have to resize the /var/log/ LV such a way, the available space is 15GB

> What is the distinction between ensuring that /var/log is at least 15GB on
> install, and ensuring that it has 15GB available on install? I'm not sure
> what the difference is here.
> 
> Mugdha, can you clarify?

By default /var/log is the mounted filesytem with a LV for it. The
default size of /var/log comes around 7GB. We have a not to increase it to 15GB.

Take for example, size of /var/log is 15GB
But now, we are not sure, all that 15GB is available or consumed by some other logs say ovirt logs.
Say, by the time the user goes for RHHI-V deployment, /var/log/ is 11GB full,
which means only 4GB is available. This adds the risk. So the newly added deployment validation,
always checks for available space of 15GB and that needs to be emphasized in the document

Comment 8 Rejy M Cyriac 2019-03-15 02:46:45 UTC
(In reply to SATHEESARAN from comment #6)
> (In reply to Rejy M Cyriac from comment #3)
> > 
> > Emphasis on available space to be at least 15 GB is good.
> > 
> > But I am not sure we should add the steps to increase the size as provided
> > in Comment 0
> 
> This is for ease of use purpose, the commands will be helpful for customers
> to
> directly increase the size of the /var/log/ LV
> 
> @Rejy, Do you expect that these commands should be already known for the
> admin/customer ?

I would expect that only the steps specific to RHHI-V be documented in the RHHI-V guide. If the steps are generic and related to components at RHEL, such as LVM, the ideal way would be to point the admin to the relevant section of the RHEL guide.


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