Bug 1318637 - [GSS][Doc-bug]Contradictory statements regarding 'sudo' in RHCS1.3 installation guide
Summary: [GSS][Doc-bug]Contradictory statements regarding 'sudo' in RHCS1.3 installati...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Ceph Storage
Classification: Red Hat
Component: Documentation
Version: 1.3.2
Hardware: x86_64
OS: Linux
medium
medium
Target Milestone: rc
: 1.3.3
Assignee: John Wilkins
QA Contact: Vasishta
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-03-17 12:18 UTC by Vimal Kumar
Modified: 2020-02-14 17:42 UTC (History)
6 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-09-30 17:19:16 UTC
Target Upstream Version:


Attachments (Terms of Use)

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


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