From 8e8d55b7970db9cd6945a61ba8bf55c71df19b07 Mon Sep 17 00:00:00 2001 From: Ken Dreyer Date: Tue, 2 Aug 2016 09:30:10 -0600 Subject: [PATCH] doc: describe libvirt client logging Describe how to configure logging and the admin socket for debugging RBD libvirt clients. Thanks to Jason Dillman on ceph-devel for this information. Signed-off-by: Ken Dreyer --- doc/rbd/libvirt.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/doc/rbd/libvirt.rst b/doc/rbd/libvirt.rst index 9a8ad5784112..b0a3dbda3c7b 100644 --- a/doc/rbd/libvirt.rst +++ b/doc/rbd/libvirt.rst @@ -95,6 +95,18 @@ To configure Ceph for use with ``libvirt``, perform the following steps: **NOTE:** You can also use `rbd create`_ to create an image, but we recommend ensuring that QEMU is working properly. +.. tip:: Optionally, if you wish to enable debug logs and the admin socket for + this client, you can add the following section to ``/etc/ceph/ceph.conf``:: + + [client.libvirt] + log file = /var/log/ceph/qemu-guest-$pid.log + admin socket = /var/run/ceph/$cluster-$type.$id.$pid.$cctid.asok + + The ``client.libvirt`` section name should match the cephx user you created + above. If SELinux or AppArmor is enabled, note that this could prevent the + client process (qemu via libvirt) from writing the logs or admin socket to + the destination locations (``/var/log/ceph`` or ``/var/run/ceph``). + Preparing the VM Manager -- 2.47.3