Bug 1318637

Summary: [GSS][Doc-bug]Contradictory statements regarding 'sudo' in RHCS1.3 installation guide
Product: Red Hat Ceph Storage Reporter: Vimal Kumar <vikumar>
Component: DocumentationAssignee: John Wilkins <jowilkin>
Status: CLOSED CURRENTRELEASE QA Contact: Vasishta <vashastr>
Severity: medium Docs Contact:
Priority: medium    
Version: 1.3.2CC: asriram, flucifre, hnallurv, jowilkin, kdreyer, ngoswami
Target Milestone: rc   
Target Release: 1.3.3   
Hardware: x86_64   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-09-30 17:19:16 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:

Description Vimal Kumar 2016-03-17 12:18:49 UTC 
1) Description of problem

Section "1.1.9. Create a Ceph Deploy User" of the RHCS1.3 installation documentation talks about setting sudo access for the ceph user across all the cluster nodes, so that ceph-deploy can access every node in the cluster via ssh and root permissions, and execute commands on them.

But section "2.1. Executing ceph-deploy" of the same document says [in the 'Important' section]:

"The ceph-deploy utility does not issue sudo commands needed on the remote host."

It seems that we may need to remove the above said line from "2.1. Executing ceph-deploy", since it contradicts with what was said in "1.1.9. Create a Ceph Deploy User".
Comment 2 John Wilkins 2016-03-18 15:47:29 UTC 
It's not a bug. If you execute ceph-deploy with sudo, it will fail. Yet, you need sudo permissions to install software. So we add the ceph-deploy user to sudoers.d so that the user automatically has sudo/root permissions WITHOUT specifying sudo when executing ceph-deploy (which would have the effect of executing as root instead of as the ceph-deploy user). It may be a bit confusing, but people are tempted to execute ceph-deploy as root, when the should not do this.
Comment 5 John Wilkins 2016-09-13 22:13:04 UTC 
I removed the first sentence in section 2.1. It seems that sentence is what caused the confusion.

https://access.qa.redhat.com/documentation/en/red-hat-ceph-storage/1.3/single/installation-guide-for-red-hat-enterprise-linux#executing_literal_ceph_deploy_literal