From eeabe7d9260da976a103f941047efb8eee6ec408 Mon Sep 17 00:00:00 2001 From: Sage Weil Date: Thu, 19 Mar 2020 15:51:08 -0500 Subject: [PATCH] doc/cephadm: some troubleshooting tips Signed-off-by: Sage Weil --- doc/cephadm/operations.rst | 2 ++ doc/cephadm/troubleshooting.rst | 33 +++++++++++++++++++++++++++++++++ 2 files changed, 35 insertions(+) diff --git a/doc/cephadm/operations.rst b/doc/cephadm/operations.rst index 2e25874aabdf8..59e2f2965f327 100644 --- a/doc/cephadm/operations.rst +++ b/doc/cephadm/operations.rst @@ -26,6 +26,8 @@ These events are also logged to the ``ceph.cephadm.log`` file on monitor hosts and to the monitor daemons' stderr. +.. _cephadm-logs: + Ceph daemon logs ================ diff --git a/doc/cephadm/troubleshooting.rst b/doc/cephadm/troubleshooting.rst index 375420ad18282..c8208cef5ffd9 100644 --- a/doc/cephadm/troubleshooting.rst +++ b/doc/cephadm/troubleshooting.rst @@ -8,6 +8,39 @@ a specific service no longer runs properly. As cephadm deploys daemons as containers, troubleshooting daemons is slightly different. Here are a few tools and commands to help investigating issues. +Pausing or disabling cephadm +---------------------------- + +If thigns go wrong and cephadm is doing something you don't like, you can +pause most background activity with:: + + ceph orch pause + +This will stop any changes, but cephadm will still periodically check hosts to +refresh its inventory of daemons and devices. You can disable cephadm +completely with:: + + ceph orch set backend '' + ceph mgr module disable cephadm + +This will disable all of the ``ceph orch ...`` CLI commands but the previously +deployed daemon containers will still continue to exist and start as they +did before. + +Checking cephadm logs +--------------------- + +You can monitor the cephadm log in realtime with:: + + ceph -W cephadm + +You can see the last few messages with:: + + ceph log last cephadm + +If you have enabled logging to files, you can see a cephadm log file called +``ceph.cephadm.log`` on monitor hosts (see :ref:`cephadm-logs`). + Gathering log files ------------------- -- 2.39.5