Bug 1514396 - [DOCS]: Need changes in Installation guide for RHEL and Ubuntu
Summary: [DOCS]: Need changes in Installation guide for RHEL and Ubuntu
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
high
Target Milestone: rc
: 3.0
Assignee: Erin Donnelly
QA Contact: Vasishta
URL:
Whiteboard:
Depends On:
Blocks: 1496210
TreeView+ depends on / blocked
 
Reported: 2017-11-17 09:59 UTC by Sidhant Agrawal
Modified: 2017-12-26 03:40 UTC (History)
5 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:05 UTC
Embargoed:


Attachments (Terms of Use)

Description Sidhant Agrawal 2017-11-17 09:59:44 UTC
Description of problem:

The document for installation needs changes under the section 3.4 Installing the Ceph Client Role.

The clients.yml.sample file is not present in the path: /usr/share/ceph-ansible

It is present in /usr/share/ceph-ansible/group_vars

The third step should be modified from 
# cp clients.yml.sample clients.yml 

to the following
 
# cp group_vars/clients.yml.sample group_vars/clients.yml

Version-Release number of selected component (if applicable):


How reproducible:


Steps to Reproduce:
1.
2.
3.

Actual results:


Expected results:


Additional info:

Comment 4 Sidhant Agrawal 2017-11-29 10:57:34 UTC
Hi,

Following changes are needed specific to Ubuntu Installation:

1) In the section 2.5. Enabling the Red Hat Ceph Storage Repositories:
   only the 3rd point ,i.e, On Ansible administration node, enable the Red Hat Ceph Storage 3 Tools repository is needed,
   Other steps are redundant because from ceph 3.0 onwards Ansible will act as primary installer and will automatically enable the required repositories (BZ  1434175). Please remove them

2) In the section 3.2. Installing a Red Hat Ceph Storage Cluster, under the 5th point:
   when editing the all.yml file, the parameter "ceph_rhcs_cdn_debian_repo" in that file needs to be modified and user have to provide credentials to access  
   online ubuntu ceph repos.
   Example:
    ceph_rhcs_cdn_debian_repo: https://username:password@rhcs.download.redhat.com
     

3) In the section 3.5. Installing the Ceph Object Gateway under the Additional Resources the second link ,i.e., link for The Object Gateway Guide for Ubuntu
   is not working.

Comment 7 Vasishta 2017-11-30 09:00:05 UTC
Hi Erin,

It would be appropriate if its added as a step with description saying that this step is for those who are upgrading from 2.x.

Regards,
Vasishta

Comment 13 Vasishta 2017-12-01 14:56:31 UTC
Hi Erin,

Can you please make below small changes in step 9 of section 3.4 ?

1) Change "[root@admin ~]#" to "[root@mon1]" -

 "[root@admin ~]#" will work only when a mon is collocated with admin node.


2) It would be apt if the example command "docker exec ceph-mon0 ceph -s" can be changed as "docker exec ceph-mon-mon1 ceph -s"

(Mentioned "mon1" just for example purpose)

Moving BZ back to ASSIGNED.


Regards,
Vasishta


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