Bug 1477265

Summary: [Doc] Revise the RHEL and Ubuntu installation guides to promote ansible as the primary install method
Product: [Red Hat Storage] Red Hat Ceph Storage Reporter: Anjana Suparna Sriram <asriram>
Component: DocumentationAssignee: Erin Donnelly <edonnell>
Status: CLOSED CURRENTRELEASE QA Contact: Vasishta <vashastr>
Severity: unspecified Docs Contact:
Priority: high    
Version: 3.0CC: anharris, edonnell, flucifre, hnallurv, kdreyer, khartsoe
Target Milestone: rcKeywords: Documentation, FutureFeature
Target Release: 3.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: 2017-12-26 03:40:53 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: 1477276    
Bug Blocks:    

Description Anjana Suparna Sriram 2017-08-01 15:13:42 UTC
Additional info:

RHCS 3.0 Content Plan:
https://docs.google.com/document/d/1fp1j6iPr9UPHCMWqqS8QG3SXiSQ3n9Y9a1YogivhtzA/edit

Comment 2 khartsoe@redhat.com 2017-08-03 14:30:26 UTC
Per feedback in https://docs.google.com/document/d/14c6cx2PY6xe2XC0N9sFY8Jc-VobAy_LjpTxJsrOL_q8/edit

I have opened the following BZs to request Eng changes to default values in  all.yml.sample file:

https://bugzilla.redhat.com/show_bug.cgi?id=1478071
https://bugzilla.redhat.com/show_bug.cgi?id=1478075
https://bugzilla.redhat.com/show_bug.cgi?id=1478073

As a result, please make the following all.yml.sample file modifications to the "3.2.2. Configuring Ceph Global Settings" section in the RHEL Install Guide (and Ubuntu Install Guide when ansible content is added to it in 3.0):

https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/2/html-single/installation_guide_for_red_hat_enterprise_linux/#configuring_ceph_global_settings

(1) Remove Step 5 (ceph_rhcs)
(2) Remove Step 7 and Note (generate_fsid)
(3) Remove Step 8

Also, please remove Step 11 (journal_size): we will use the default value of 5GB.

Note more similar changes might be forthcoming.

Comment 3 khartsoe@redhat.com 2017-08-03 15:11:33 UTC
Please add following at end of install procedure:

- Verification step: run rados put / get with example of output showing success.

- Add information about using ceph-medic to identify/resolve potential install-related problems. Provide link to “main” ceph-medic content (perhaps in Appx A Troubleshooting? TBD)

Comment 10 Federico Lucifredi 2017-11-02 23:56:33 UTC
We do not need to remove the manual procedures. We document these because advanced customers see value in having a detailed explanation of what is going on behind the scenes.

The current draft looks ok.

Thanks. --F

Comment 11 Federico Lucifredi 2017-11-02 23:57:18 UTC
We do not want to remove the manual procedures. We document these because advanced customers see value in having a detailed explanation of what is going on behind the scenes.

The current draft looks ok.

Thanks. --F

Comment 12 Vasishta 2017-11-03 13:05:47 UTC
Looks good to me, Moving to VERIFIED state.