doc: describe libvirt client logging

Describe how to configure logging and the admin socket for debugging RBD
libvirt clients.

Thanks to Jason Dillman <jdillama@redhat.com> on ceph-devel for this
information.

Signed-off-by: Ken Dreyer <kdreyer@redhat.com>
This commit is contained in:
Ken Dreyer 2016-08-02 09:30:10 -06:00
parent 367cb8407b
commit 8e8d55b797

View File

@ -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