Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

This project is now read‑only. Starting Monday, February 2, please use https://ibm-ceph.atlassian.net/ for all bug tracking management.

Bug 1514396

Summary:	[DOCS]: Need changes in Installation guide for RHEL and Ubuntu
Product:	[Red Hat Storage] Red Hat Ceph Storage	Reporter:	Sidhant Agrawal <sagrawal>
Component:	Documentation	Assignee:	Erin Donnelly <edonnell>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Vasishta <vashastr>
Severity:	high	Docs Contact:
Priority:	high
Version:	3.0	CC:	asriram, edonnell, hnallurv, kdreyer, vashastr
Target Milestone:	rc
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:05 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:	1496210

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