openstack/nova
Code Issues Proposed changes

Add missing documentation for shared folder issue with unit tests and Python

Browse Source 
lock file.

Addresses documentation need raised in bug 897155

Change-Id: Idc95c12f939948bbbefd84a79b3785e3c2fd752c
This commit is contained in:
Duncan McGreggor
2011-12-02 09:48:15 -08:00
parent 3d46b46a3a
commit 5f72723b41
2 changed files with 17 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
Authors
View File

@@ -40,6 +40,7 @@ Derek Higgins <higginsd@gmail.com>
Devendra Modium <dmodium@isi.edu> Devendra Modium <dmodium@isi.edu>
Devin Carlen <devin.carlen@gmail.com> Devin Carlen <devin.carlen@gmail.com>
Donal Lafferty <donal.lafferty@citrix.com> Donal Lafferty <donal.lafferty@citrix.com>
Duncan McGreggor <duncan@dreamhost.com>
Ed Leafe <ed@leafe.com> Ed Leafe <ed@leafe.com>
Edouard Thuleau <edouard1.thuleau@orange.com> Edouard Thuleau <edouard1.thuleau@orange.com>
Eldar Nugaev <reldan@oscloud.ru> Eldar Nugaev <reldan@oscloud.ru>

16
doc/source/devref/unit_tests.rst
View File

@@ -131,6 +131,20 @@ Reusing an existing database may cause tests to fail if the schema has
changed. If any files in the ``nova/db/sqlalchemy`` have changed, it's a good changed. If any files in the ``nova/db/sqlalchemy`` have changed, it's a good
idea to recreate the test database. idea to recreate the test database.
Gotchas
-------
**Running Tests from Shared Folders**
If you are running the unit tests from a shared folder, you may see tests start
to fail or stop completely as a result of Python lockfile issues [#f4]_. You
can get around this by manually setting or updating the following line in
``nova/tests/fake_flags.py``::
FLAGS['lock_path'].SetDefault('/tmp')
Note that you may use any location (not just ``/tmp``!) as long as it is not
a shared folder.
.. rubric:: Footnotes .. rubric:: Footnotes
@@ -141,3 +155,5 @@ idea to recreate the test database.
.. [#f3] There is an effort underway to use a fake DB implementation for the .. [#f3] There is an effort underway to use a fake DB implementation for the
unit tests. See https://lists.launchpad.net/openstack/msg05604.html unit tests. See https://lists.launchpad.net/openstack/msg05604.html
.. [#f4] See Vish's comment in this bug report: https://bugs.launchpad.net/nova/+bug/882933