From: Ken Dreyer Date: Tue, 2 Aug 2016 15:30:10 +0000 (-0600) Subject: doc: describe libvirt client logging X-Git-Tag: ses5-milestone5~213^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F10542%2Fhead;p=ceph.git 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 --- 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