Red Hat Bugzilla – Bug 1302782
Adjust CRUSH Tunables section needs "sudo"
Last modified: 2016-09-30 13:21:53 EDT
Description of problem:
The "Adjust CRUSH Tunables" section of quick-ceph-deploy.adoc has the following command:
ceph osd crush tunables optimal
This command requires the cephx admin keyring. If that keyring was set up by ceph-deploy (as our docs describe with "ceph-deploy admin <calamarinode>), then the "ceph" command will not work if it's run by an unprivileged user on the Calamari admin node. The user must run all cephx-authenticated ceph commands with "sudo".
Version-Release number of selected component (if applicable):
Latest quick-ceph-deploy.adoc for both RHEL and Ubuntu.
Steps to Reproduce:
1. Set up a cluster, following the documentation.
2. As described in the installation guide, run `ceph-deploy admin <calamarinode>` to install the admin keyring to the calamari admin node.
3. Run `ceph osd crush tunables optimal` as described in the guide.
The command successfully sets crush tunables
Maybe we want to add "sudo" into the "Storage Strategies" document as well? https://access.redhat.com/documentation/en/red-hat-ceph-storage/1.3/storage-strategies/chapter-9-crush-tunables What do you think?
Added "as root" commentary to make it consistent with platform docs.
Please provide stage area link to verify this bug. Gitlab access not available.
As per the bug "ceph osd crush tunables optimal" command need to be run as "root" user or the command should be prefixed with "sudo".
In Document "2.10. Adjust CRUSH Tunables" Section is not updated accordingly.
Suggesting to add "sudo" prefix to the command (sudo ceph osd crush tunables optimal) or add a note saying that "run this command as root user".
You can say that the command needs to be executed with root privilege and leave it to the admin to know to use sudo on Ubuntu.
Added "as root" phraseology per Federico:
Verified the document for ubuntu and RHEL.