When these daemons are started, they will know their own address, but
not their peers. They can learn those addresses via the admin socket::
- ceph --admin-daemon /var/run/ceph/mon.<id>.asok add_bootstrap_peer_hint <peer ip>
+ ceph mon.<id> add_bootstrap_peer_hint <peer ip>
Once they learn enough of their peers from the initial member set,
they will be able to create the cluster.
Once the daemon starts, you can give it one or more peer addresses to join with::
- ceph --admin-daemon /var/run/ceph/mon.<id>.asok add_bootstrap_peer_hint <peer ip>
+ ceph daemon mon.<id> add_bootstrap_peer_hint <peer ip>
This monitor will never participate in cluster creation; it can only join an existing
cluster.
The perf counter data is accessed via the admin socket. For example::
- ceph --admin-daemon /var/run/ceph/ceph-osd.0.asok perf schema
- ceph --admin-daemon /var/run/ceph/ceph-osd.0.asok perf dump
+ ceph daemon osd.0 perf schema
+ ceph daemon osd.0 perf dump
Collections
Name of the Ceph cluster.
-.. option:: --admin-daemon ADMIN_SOCKET
+.. option:: daemon ADMIN_SOCKET, daemon DAEMON_NAME, --admin-socket ADMIN_SOCKET, --admin-socket DAEMON_NAME
- Submit admin-socket commands.
+ Submit admin-socket commands via admin sockets in /var/run/ceph.
.. option:: --admin-socket ADMIN_SOCKET_NOPE
via the admin socket, login to the host running the daemon and use the
following command::
- ceph --admin-daemon /var/run/ceph/{socket-name}
+ ceph daemon {daemon-name}
+ ceph daemon {path-to-socket-file}
+
+For example, the following are equivalent::
+
+ ceph daemon osd.0 foo
+ ceph daemon /var/run/ceph/ceph-osd.0.asok foo
To view the available admin socket commands, execute the following command::
- ceph --admin-daemon /var/run/ceph/{socket-name} help
+ ceph daemon {daemon-name} help
The admin socket command enables you to show and set your configuration at
runtime. See `Viewing a Configuration at Runtime`_ for details.
If you would like to see the configuration settings at runtime, you must log
in to a host with a running daemon and execute the following::
- ceph --admin-daemon {/path/to/admin/socket} config show | less
- ceph --admin-daemon /var/run/ceph/ceph-osd.0.asok config show | less
+ ceph daemon {daemon-name} config show | less
+
+For example,::
+
+ ceph daemon osd.0 config show | less
To activate Ceph's debugging output (*i.e.*, ``dout()``) at runtime, use the
``ceph tell`` command to inject arguments into the runtime configuration::
The ``ceph tell`` command goes through the monitors. If you cannot bind to the
monitor, you can still make the change by logging into the host of the daemon
-whose configuration you'd like to change using ``ceph --admin-daemon``.
+whose configuration you'd like to change using ``ceph daemon``.
For example::
- sudo ceph --admin-daemon /var/run/ceph/ceph-osd.0.asok config set debug_osd 0/5
+ sudo ceph daemon osd.0 config set debug_osd 0/5
See `Subsystem, Log and Debug Settings`_ for details on available settings.
Accessing the admin socket is as simple as telling the ``ceph`` tool to use
the ``asok`` file. In pre-Dumpling Ceph, this can be achieved by::
- ceph --admin-daemon /var/run/ceph/ceph-mon.ID.asok <command>
+ ceph --admin-daemon /var/run/ceph/ceph-mon.<id>.asok <command>
while in Dumpling and beyond you can use the alternate (and recommended)
format::
- ceph daemon mon.ID <command>
+ ceph daemon mon.<id> <command>
Using ``help`` as the command to the ``ceph`` tool will show you the
supported commands available through the admin socket. Please take a look
ls /var/run/ceph
-Then, execute the following, replacing ``{socket-name}`` with an actual
-socket name to show the list of available options::
+Then, execute the following, replacing ``{daemon-name}`` with an actual
+daemon (e.g., ``osd.0``)::
+
+ ceph daemon osd.0 help
+
+Alternatively, you can specify a ``{socket-file}`` (e.g., something in ``/var/run/ceph``)::
+
+ ceph daemon {socket-file} help
- ceph --admin-daemon /var/run/ceph/{socket-name} help
The admin socket, among other things, allows you to:
its admin socket. By default, there will be a socket configured to
reside in ``/var/run/ceph``, and the daemon can be queried with::
- ceph --admin-daemon /var/run/ceph/client.rgw help
+ ceph daemon /var/run/ceph/client.rgw help
help list available commands
objecter_requests show in-progress osd requests
Of particular interest::
- ceph --admin-daemon /var/run/ceph/client.rgw objecter_requests
+ ceph daemon /var/run/ceph/client.rgw objecter_requests
...
will dump information about current in-progress requests with the
This tells us to look at ``osd.1``, the primary copy for this PG::
- ceph --admin-daemon /var/run/ceph/osd.1.asok
+ ceph daemon osd.1 ops
{ "num_ops": 651,
"ops": [
{ "description": "osd_op(client.4124.0:1858 fatty_25647_object1857 [write 0~4096] 2.d2041a48)",