diff options
| author | Duncan McGreggor <duncan@dreamhost.com> | 2011-12-02 09:48:15 -0800 |
|---|---|---|
| committer | Duncan McGreggor <duncan@dreamhost.com> | 2011-12-05 09:54:31 -0800 |
| commit | 5f72723b4137ec59b4c6b376ddf6e7cb42df26b5 (patch) | |
| tree | 910e86f0faa132c38d8a5d50fbe0d9de226e79bf /doc | |
| parent | 3d46b46a3a57b07f8d260083f548664b7472c612 (diff) | |
| download | nova-5f72723b4137ec59b4c6b376ddf6e7cb42df26b5.tar.gz | |
Add missing documentation for shared folder issue with unit tests and Python
lock file.
Addresses documentation need raised in bug 897155
Change-Id: Idc95c12f939948bbbefd84a79b3785e3c2fd752c
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/source/devref/unit_tests.rst | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/doc/source/devref/unit_tests.rst b/doc/source/devref/unit_tests.rst index f8ce7e7555..8033406f0b 100644 --- a/doc/source/devref/unit_tests.rst +++ b/doc/source/devref/unit_tests.rst @@ -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. +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 @@ -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 https://lists.launchpad.net/openstack/msg05604.html + +.. [#f4] See Vish's comment in this bug report: https://bugs.launchpad.net/nova/+bug/882933 |