openstack/ironic
Code Issues Proposed changes

Document possible access problems with custom IRONIC_VM_LOG_DIR path

Browse Source 
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
This commit is contained in:
Jacek Tomasiak 2016-02-10 22:28:36 +01:00
parent 37a3486919
commit 959689e30d
1 changed files with 10 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
doc/source/dev/dev-quickstart.rst
View File

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