From 959689e30d71e4f10493bc2c62f6e90c8875b961 Mon Sep 17 00:00:00 2001 From: Jacek Tomasiak Date: Wed, 10 Feb 2016 22:28:36 +0100 Subject: [PATCH] Document possible access problems with custom IRONIC_VM_LOG_DIR path Example local.conf from Ironic docs uses $HOME/ironic-bm-logs as VM log dir. On some systems (e.g. Fedora) user's home is accessible only to the owner by default which causes "permission denied" errors when starting VMs because QEMU domains are running as non-root user ("qemu" in Fedora). Extend the documentation with note about possible problems with custom log directory set using IRONIC_VM_LOG_DIR. Change-Id: Ia1d7688fd71c4853538621ec32b2d4a024f52a76 Closes-Bug: #1532184 --- doc/source/dev/dev-quickstart.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/doc/source/dev/dev-quickstart.rst b/doc/source/dev/dev-quickstart.rst index 86581a02e6..c327decd70 100644 --- a/doc/source/dev/dev-quickstart.rst +++ b/doc/source/dev/dev-quickstart.rst @@ -444,6 +444,16 @@ and uses the ``pxe_ssh`` driver by default:: END +.. note:: + When running QEMU as non-root user (e.g. ``qemu`` on Fedora or ``libvirt-qemu`` on Ubuntu), + make sure ``IRONIC_VM_LOG_DIR`` points to a directory where QEMU will be able to write. + You can verify this with, for example:: + + # on Fedora + sudo -u qemu touch $HOME/ironic-bm-logs/test.log + # on Ubuntu + sudo -u libvirt-qemu touch $HOME/ironic-bm-logs/test.log + Run stack.sh:: ./stack.sh