diff options
author | Jacek Tomasiak <jacek.tomasiak@gmail.com> | 2016-02-10 22:28:36 +0100 |
---|---|---|
committer | Jacek Tomasiak <jacek.tomasiak@gmail.com> | 2016-02-11 15:03:39 +0100 |
commit | 959689e30d71e4f10493bc2c62f6e90c8875b961 (patch) | |
tree | b495d9dcffdafbf8f4affb93519538fae323b205 /doc | |
parent | 37a34869195fc493daf791718f1338501d49fba9 (diff) | |
download | ironic-959689e30d71e4f10493bc2c62f6e90c8875b961.tar.gz |
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
Diffstat (limited to 'doc')
-rw-r--r-- | doc/source/dev/dev-quickstart.rst | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/doc/source/dev/dev-quickstart.rst b/doc/source/dev/dev-quickstart.rst index 86581a02e..c327decd7 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 |