Bug 1512997

Summary: [Docs][Metrics] Document how to install OpenShift with Common Logging for RHV
Product: Red Hat Enterprise Virtualization Manager Reporter: Emma Heftman <eheftman>
Component: DocumentationAssignee: Emma Heftman <eheftman>
Status: CLOSED CURRENTRELEASE QA Contact: Avital Pinnick <apinnick>
Severity: unspecified Docs Contact:
Priority: high    
Version: 4.2.0CC: eheftman, lbopf, lsurette, pbrilla, rbalakri, rmeggins, sradco, srevivo, ykaul
Target Milestone: ovirt-4.2.0Keywords: Reopened, Triaged
Target Release: ---Flags: rmeggins: needinfo+
rmeggins: needinfo+
Hardware: Unspecified   
OS: Unspecified   
Whiteboard: docs-accepted
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2018-02-15 08:32:52 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: 1510988    
Bug Blocks: 1451625, 1513015    

Description Emma Heftman 2017-11-14 15:00:13 UTC
Review current documentation and create RHV installation document based on this:

https://github.com/ViaQ/Main/blob/master/README-install.md

Comment 2 Lucy Bopf 2017-11-17 01:50:33 UTC
Tentatively accepting into beta program (pending the availability of QE-tested instructions for installation downstream), and assigning to Emma for review.

Comment 3 Emma Heftman 2017-11-23 15:55:34 UTC
Draft has been sent to Yaniv, Rich, Shirly and Pavel for review.

Comment 5 Rich Megginson 2017-11-27 18:30:17 UTC
Yes, the outline looks good.

Comment 16 Emma Heftman 2018-02-11 13:13:42 UTC
Moving this bug back to modified as Pavol has now provided the following feedback:

 

​1.7. Configuring Persistent Storage for Elasticsearch

Step 3.
​chmod -R 0660 /var/lib/elasticsearch

need to be:
chmod g+wx /var/lib/elasticsearch

​1.10 Customizing vars.yaml

At the end of step 3, preceding # at example need to be removed:
openshift_logging_mux_namespaces:
- ovirt-metrics-test-engine
- ovirt-logs-test-engine​

Appendix A. vars.yaml.template

Few lines were joined so severak variables are missing:

1st row: ansible_ssh_user: root  should be already on new line

#openshift_logging_mux_namespaces:
#- this-is-a-namespace
#- another-namespace
​
should be replaced ​with
openshift_logging_mux_namespaces:
- ovirt-metrics-ovirt_env_name
- ovirt-logs-ovirt_env_name​
​so we are consistent with exaple in chapter above​
​

​Private IP looks like 2 lines in docs, but in reality in is only one, row need to be broken like this:
​# the private IP address, if your machine has a different public and private IP  
address openshift_ip: "{{ ansible_default_ipv4.address }}"​


​Appendix B. ansible-inventory-ocp-36-aio File

​Has too many empty lines, breaking readability. proposal keep empty lines only between last item and [new group] like this:

[OSEv3:children]          
nodes                     
masters                   
                          
[OSEv3:vars]              
ansible_connection=local  
openshift_release=v3.6    
...