ceph/doc/rados/operations/operating.rst

   1 =====================
   2  Operating a Cluster
   3 =====================
   4
   5 .. index:: systemd; operating a cluster
   6
   7
   8 Running Ceph with systemd
   9 ==========================
  10
  11 For all distributions that support systemd (CentOS 7, Fedora, Debian
  12 Jessie 8 and later, SUSE), ceph daemons are now managed using native
  13 systemd files instead of the legacy sysvinit scripts.  For example::
  14
  15         sudo systemctl start ceph.target       # start all daemons
  16         sudo systemctl status ceph-osd@12      # check status of osd.12
  17
  18 To list the Ceph systemd units on a node, execute::
  19
  20         sudo systemctl status ceph\*.service ceph\*.target
  21
  22 Starting all Daemons
  23 --------------------
  24
  25 To start all daemons on a Ceph Node (irrespective of type), execute the
  26 following::
  27
  28         sudo systemctl start ceph.target
  29
  30
  31 Stopping all Daemons
  32 --------------------
  33
  34 To stop all daemons on a Ceph Node (irrespective of type), execute the
  35 following::
  36
  37         sudo systemctl stop ceph\*.service ceph\*.target
  38
  39
  40 Starting all Daemons by Type
  41 ----------------------------
  42
  43 To start all daemons of a particular type on a Ceph Node, execute one of the
  44 following::
  45
  46         sudo systemctl start ceph-osd.target
  47         sudo systemctl start ceph-mon.target
  48         sudo systemctl start ceph-mds.target
  49
  50
  51 Stopping all Daemons by Type
  52 ----------------------------
  53
  54 To stop all daemons of a particular type on a Ceph Node, execute one of the
  55 following::
  56
  57         sudo systemctl stop ceph-mon\*.service ceph-mon.target
  58         sudo systemctl stop ceph-osd\*.service ceph-osd.target
  59         sudo systemctl stop ceph-mds\*.service ceph-mds.target
  60
  61
  62 Starting a Daemon
  63 -----------------
  64
  65 To start a specific daemon instance on a Ceph Node, execute one of the
  66 following::
  67
  68         sudo systemctl start ceph-osd@{id}
  69         sudo systemctl start ceph-mon@{hostname}
  70         sudo systemctl start ceph-mds@{hostname}
  71
  72 For example::
  73
  74         sudo systemctl start ceph-osd@1
  75         sudo systemctl start ceph-mon@ceph-server
  76         sudo systemctl start ceph-mds@ceph-server
  77
  78
  79 Stopping a Daemon
  80 -----------------
  81
  82 To stop a specific daemon instance on a Ceph Node, execute one of the
  83 following::
  84
  85         sudo systemctl stop ceph-osd@{id}
  86         sudo systemctl stop ceph-mon@{hostname}
  87         sudo systemctl stop ceph-mds@{hostname}
  88
  89 For example::
  90
  91         sudo systemctl stop ceph-osd@1
  92         sudo systemctl stop ceph-mon@ceph-server
  93         sudo systemctl stop ceph-mds@ceph-server
  94
  95
  96 .. index:: Ceph service; Upstart; operating a cluster
  97
  98
  99
 100 Starting all Daemons
 101 --------------------
 102
 103 To start all daemons on a Ceph Node (irrespective of type), execute the
 104 following::
 105
 106         sudo start ceph-all
 107
 108
 109 Stopping all Daemons
 110 --------------------
 111
 112 To stop all daemons on a Ceph Node (irrespective of type), execute the
 113 following::
 114
 115         sudo stop ceph-all
 116
 117
 118 Starting all Daemons by Type
 119 ----------------------------
 120
 121 To start all daemons of a particular type on a Ceph Node, execute one of the
 122 following::
 123
 124         sudo start ceph-osd-all
 125         sudo start ceph-mon-all
 126         sudo start ceph-mds-all
 127
 128
 129 Stopping all Daemons by Type
 130 ----------------------------
 131
 132 To stop all daemons of a particular type on a Ceph Node, execute one of the
 133 following::
 134
 135         sudo stop ceph-osd-all
 136         sudo stop ceph-mon-all
 137         sudo stop ceph-mds-all
 138
 139
 140 Starting a Daemon
 141 -----------------
 142
 143 To start a specific daemon instance on a Ceph Node, execute one of the
 144 following::
 145
 146         sudo start ceph-osd id={id}
 147         sudo start ceph-mon id={hostname}
 148         sudo start ceph-mds id={hostname}
 149
 150 For example::
 151
 152         sudo start ceph-osd id=1
 153         sudo start ceph-mon id=ceph-server
 154         sudo start ceph-mds id=ceph-server
 155
 156
 157 Stopping a Daemon
 158 -----------------
 159
 160 To stop a specific daemon instance on a Ceph Node, execute one of the
 161 following::
 162
 163         sudo stop ceph-osd id={id}
 164         sudo stop ceph-mon id={hostname}
 165         sudo stop ceph-mds id={hostname}
 166
 167 For example::
 168
 169         sudo stop ceph-osd id=1
 170         sudo start ceph-mon id=ceph-server
 171         sudo start ceph-mds id=ceph-server
 172
 173
 174 .. index:: Ceph service; sysvinit; operating a cluster
 175
 176
 177 Running Ceph
 178 ============
 179
 180 Each time you to **start**, **restart**, and  **stop** Ceph daemons (or your
 181 entire cluster) you must specify at least one option and one command. You may
 182 also specify a daemon type or a daemon instance. ::
 183
 184         {commandline} [options] [commands] [daemons]
 185
 186
 187 The ``ceph`` options include:
 188
 189 +-----------------+----------+-------------------------------------------------+
 190 | Option          | Shortcut | Description                                     |
 191 +=================+==========+=================================================+
 192 | ``--verbose``   |  ``-v``  | Use verbose logging.                            |
 193 +-----------------+----------+-------------------------------------------------+
 194 | ``--valgrind``  | ``N/A``  | (Dev and QA only) Use `Valgrind`_ debugging.    |
 195 +-----------------+----------+-------------------------------------------------+
 196 | ``--allhosts``  |  ``-a``  | Execute on all nodes in ``ceph.conf.``          |
 197 |                 |          | Otherwise, it only executes on ``localhost``.   |
 198 +-----------------+----------+-------------------------------------------------+
 199 | ``--restart``   | ``N/A``  | Automatically restart daemon if it core dumps.  |
 200 +-----------------+----------+-------------------------------------------------+
 201 | ``--norestart`` | ``N/A``  | Don't restart a daemon if it core dumps.        |
 202 +-----------------+----------+-------------------------------------------------+
 203 | ``--conf``      |  ``-c``  | Use an alternate configuration file.            |
 204 +-----------------+----------+-------------------------------------------------+
 205
 206 The ``ceph`` commands include:
 207
 208 +------------------+------------------------------------------------------------+
 209 | Command          | Description                                                |
 210 +==================+============================================================+
 211 |    ``start``     | Start the daemon(s).                                       |
 212 +------------------+------------------------------------------------------------+
 213 |    ``stop``      | Stop the daemon(s).                                        |
 214 +------------------+------------------------------------------------------------+
 215 |  ``forcestop``   | Force the daemon(s) to stop. Same as ``kill -9``           |
 216 +------------------+------------------------------------------------------------+
 217 |   ``killall``    | Kill all daemons of a particular type.                     |
 218 +------------------+------------------------------------------------------------+
 219 |  ``cleanlogs``   | Cleans out the log directory.                              |
 220 +------------------+------------------------------------------------------------+
 221 | ``cleanalllogs`` | Cleans out **everything** in the log directory.            |
 222 +------------------+------------------------------------------------------------+
 223
 224 For subsystem operations, the ``ceph`` service can target specific daemon types
 225 by adding a particular daemon type for the ``[daemons]`` option. Daemon types
 226 include:
 227
 228 - ``mon``
 229 - ``osd``
 230 - ``mds``
 231
 232
 233
 234 .. _Valgrind: http://www.valgrind.org/
 235 .. _initctl: http://manpages.ubuntu.com/manpages/raring/en/man8/initctl.8.html