Bug 1477265 - [Doc] Revise the RHEL and Ubuntu installation guides to promote ansible as the primary install method
Summary: [Doc] Revise the RHEL and Ubuntu installation guides to promote ansible as th...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Ceph Storage
Classification: Red Hat Storage
Component: Documentation
Version: 3.0
Hardware: Unspecified
OS: Unspecified
high
unspecified
Target Milestone: rc
: 3.0
Assignee: Erin Donnelly
QA Contact: Vasishta
URL:
Whiteboard:
Depends On: 1477276
Blocks:
TreeView+ depends on / blocked
 
Reported: 2017-08-01 15:13 UTC by Anjana Suparna Sriram
Modified: 2017-12-26 03:40 UTC (History)
6 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-12-26 03:40:53 UTC
Embargoed:


Attachments (Terms of Use)

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.


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