Bug 1593399

Summary: Ceph-mgr installation missing from manual instructions in the admin guide.
Product: [Red Hat Storage] Red Hat Ceph Storage Reporter: Warren <wusui>
Component: DocumentationAssignee: Jennifer Patton <jpatton>
Status: CLOSED CURRENTRELEASE QA Contact: Yogesh Mane <ymane>
Severity: unspecified Docs Contact: Aron Gunn <agunn>
Priority: unspecified    
Version: 3.0CC: asriram, jbrier, jpatton, kdreyer, tchandra, wusui, ymane
Target Milestone: z2   
Target Release: 3.2   
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: 2019-03-12 14:56:39 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: 1668330    

Description Warren 2018-06-20 18:01:18 UTC
Description of problem:

https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/3/html-single/administration_guide

The administration guide, in the manual installation using the CLI portion of section 6, is missing steps to install ceph-mgr.

I think that after the mon is installed, the following information should be added:

https://access.redhat.com/solutions/3078301

Comment 3 Jennifer Patton 2019-02-15 21:21:48 UTC
Hi Warren,

Can you please clarify whether this is for the administration guide or the installation guide?  Also 
https://access.redhat.com/solutions/3078301 is related to DNS entries in the resolv.conf. Perhaps there is a different solution to which you meant to point?
Please advise
Regards,
Jennifer Patton

Comment 4 Warren 2019-02-15 21:43:22 UTC
This is in the administration guide.

The link to https://access.redhat.com/solutions/307830 is incorrect.

Also I think that section 6 is the wrong location for this.  I believe that something should be added to sections 2.4 and 2.5 for ceph-mgr nodes.

Many ceph installations requires ceph-mgr to be collocated with ceph-mon so I think that adding ceph-mgr text to sections 2.4 and 2.5 would be useful.

Comment 5 Warren 2019-02-15 21:59:31 UTC
Add the following Procedures to section 2.4 (format should be identical to the Ceph Monitor node instructions)

On Ceph Manager nodes:

Starting

[root@mon ~]# systemctl start ceph-mgr.target

Stopping

[root@mon ~]# systemctl stop ceph-mgr.target

Restarting

[root@mon ~]# systemctl restart ceph-mgr.target





Add the following Procedures to section 2.5 (format should be identical to the Ceph Monitor node instructions)

On a Ceph Manager node:

Starting

[root@mon ~]# systemctl start ceph-mgr@$MANAGER_HOST_NAME

Stopping

[root@mon ~]# systemctl stop ceph-mgr@$MANAGER_HOST_NAME

Restarting

[root@mon ~]# systemctl restart ceph-mgr@$MANAGER_HOST_NAME

Replace $MANAGER_HOST_NAME with the name of the Ceph Manager node.

Comment 6 Jennifer Patton 2019-02-19 18:17:00 UTC
Ready for peer review

Comment 14 Jennifer Patton 2019-03-12 14:56:39 UTC
This change made it into the most recent release.  I have changed this status accordingly.