import 15.2.5

[ceph.git] / ceph / doc / cephadm / operations.rst

diff --git a/ceph/doc/cephadm/operations.rst b/ceph/doc/cephadm/operations.rst
index 7768b1ff4a6a3ab9c612982e0a3a64916f934242..198286a3a3046c70b3d95be1e5c982cf731fbbaf 100644 (file)
--- a/ceph/doc/cephadm/operations.rst
+++ b/ceph/doc/cephadm/operations.rst
@@ -141,6 +141,21 @@ You will then need to restart the mgr daemon to reload the configuration with::
 
   ceph mgr fail
 
+Configuring a different SSH user
+----------------------------------
+
+Cephadm must be able to log into all the Ceph cluster nodes as an user
+that has enough privileges to download container images, start containers
+and execute commands without prompting for a password. If you do not want
+to use the "root" user (default option in cephadm), you must provide
+cephadm the name of the user that is going to be used to perform all the
+cephadm operations. Use the command::
+
+  ceph cephadm set-user <user>
+
+Prior to running this the cluster ssh key needs to be added to this users
+authorized_keys file and non-root users must have passwordless sudo access.
+
 
 Customizing the SSH configuration
 ---------------------------------
@@ -193,6 +208,8 @@ Resume cephadm work with::
 
   ceph orch resume
 
+.. _cephadm-stray-host:
+
 CEPHADM_STRAY_HOST
 ------------------
 
@@ -216,6 +233,9 @@ You can also disable this warning entirely with::
 
   ceph config set mgr mgr/cephadm/warn_on_stray_hosts false
 
+See :ref:`cephadm-fqdn` for more information about host names and
+domain names.
+
 CEPHADM_STRAY_DAEMON
 --------------------