Browse files

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

… Python

lock file.

Addresses documentation need raised in bug 897155

Change-Id: Idc95c12f939948bbbefd84a79b3785e3c2fd752c
  • Loading branch information...
Duncan McGreggor
Duncan McGreggor committed Dec 2, 2011
1 parent 3d46b46 commit 5f72723b4137ec59b4c6b376ddf6e7cb42df26b5
Showing with 17 additions and 0 deletions.
  1. +1 −0 Authors
  2. +16 −0 doc/source/devref/unit_tests.rst
@@ -40,6 +40,7 @@ Derek Higgins <>
Devendra Modium <>
Devin Carlen <>
Donal Lafferty <>
+Duncan McGreggor <>
Ed Leafe <>
Edouard Thuleau <>
Eldar Nugaev <>
@@ -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
idea to recreate the test database.
+**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
+ 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
@@ -141,3 +155,5 @@ idea to recreate the test database.
.. [#f3] There is an effort underway to use a fake DB implementation for the
unit tests. See
+.. [#f4] See Vish's comment in this bug report:

0 comments on commit 5f72723

Please sign in to comment.