Bug 1584737
| Summary: | [Doc RFE] - Document how to deploy RHGSWA by using tendrl-ansible | ||
|---|---|---|---|
| Product: | [Red Hat Storage] Red Hat Gluster Storage | Reporter: | khartsoe <khartsoe> |
| Component: | doc-RHGS_Web_Administration | Assignee: | Rakesh <rghatvis> |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | Elena Bondarenko <ebondare> |
| Severity: | unspecified | Docs Contact: | |
| Priority: | unspecified | ||
| Version: | rhgs-3.4 | CC: | apaladug, asriram, ebondare, fbalak, mbukatov, nthomas, rghatvis, rhs-bugs, sankarshan |
| Target Milestone: | --- | Keywords: | FutureFeature |
| Target Release: | RHGS 3.4.0 | ||
| 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-09-10 15:28:11 UTC | Type: | Bug |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
| Embargoed: | |||
| Bug Depends On: | |||
| Bug Blocks: | 1503140 | ||
|
Description
khartsoe@redhat.com
2018-05-31 14:08:46 UTC
Adding missing qe ack. I have rechecked the text again, see my feedback below. 1) The text states (3.2. Installation Workflow, Ansible Groups) > The sample site.yml playbook from tendrl-ansible package expects ... but should be: > The site.yml playbook from tendrl-ansible package expects ... Because the site.yml playbook is no longer just an example. 2) Text states (3.3. Web Administration Installation, Procedure. Installing Web Administration, step 4): > Enable or disable features by specifying values to the variables such > as etcd-tls client authentication This etcd-tls client authentication is described in a separate chapter (Chapter 5. TLS Encryption Configuration), it would be nice to point this out and link it (so that customer will connect the dots). 3) Text states (3.3. Web Administration Installation, Procedure. Installing Web Administration, step 5): > For detailed inventory file configuration, see the README.md file > provided with the installation > # less /usr/share/doc/tendrl-ansible-1.6.3/README.md I feel that this step would be better converted into note of previous step. Would it make sense? 4) Text states (3.3. Web Administration Installation, Procedure. Installing Web Administration, step 6): > If you use tendrl-ansible from the rpm package, copy the site.yml playbook > into the ... Should be: > Copy the site.yml playbook into the ... As we support tendrl-ansible from rpm package only. 5) Text states (3.3. Web Administration Installation, Procedure. Installing Web Administration, step 9): > To check if Web Administration minimal requirements and setup are > satisfied, run the prechecks playbook To make purpose of this prechecks playbook absolutely clear, I would suggest to add the following note here: ``` Any problem with the pre checks will make the playbook run fail immediately, pointing you to a particular requirement or problem with configuration before the installation itself (preventing you to spend time with unnecessary debugging after installation). ``` I think that this can be verified after Martin's notes are incorporated. |