git clone --recursive https://github.com/openstreetmap/Nominatim.git
- If forgot `--recursive`, you can later load the submodules using
+ If you forgot `--recursive`, it you can later load the submodules using
git submodule init
git submodule update
restart any software: just refresh your browser window.
Note that the webserver uses files from the /build directory. If you change
-files in Nominatim/lib for example you first need to copy them into the
-/build directory.
+files in Nominatim/website or Nominatim/utils for example you first need to
+copy them into the /build directory by running the `cmake` step from the
+installation.
PHP errors are written to `/var/log/apache2/error.log`.
## Running functional tests
-Tests in `/features/db` and `/features/osm2pgsql` have to pass 100%. Other
+Tests in `test/bdd/db` and `test/bdd/osm2pgsql` have to pass 100%. Other
tests might require full planet-wide data. Sadly even if you have your own
planet-wide data there will be enough differences to the openstreetmap.org
installation to cause false positives in the other tests (see FAQ).
To run a single file
- behave -DBUILDDIR=/home/vagrant/build/ features/api/reverse.feature
+ behave -DBUILDDIR=/home/vagrant/build/ api/lookup/simple.feature
+
+Or a single test by line number
+
+ behave -DBUILDDIR=/home/vagrant/build/ api/lookup/simple.feature:34
-To run specific tests you can add tags just before the `Scenario line`, e.g.
+To run specific groups of tests you can add tags just before the `Scenario line`, e.g.
@bug-34
Scenario: address lookup for non-existing or invalid node, way, relation