X-Git-Url: https://git.openstreetmap.org./nominatim.git/blobdiff_plain/f56bac350b70e1d68733411faaf6a71e36dd05aa..185ff683cfc2c6d65ec55a7c05d4cbbf35c077ff:/docs/admin/Faq.md diff --git a/docs/admin/Faq.md b/docs/admin/Faq.md index 2bf0e6be..b8b900d0 100644 --- a/docs/admin/Faq.md +++ b/docs/admin/Faq.md @@ -16,7 +16,7 @@ was killed. If it looks like this: then you can resume with the following command: ```sh -./utils/setup.php --index --create-search-indices --create-country-names +nominatim import --continue indexing ``` If the reported rank is 26 or higher, you can also safely add `--index-noanalyse`. @@ -31,7 +31,7 @@ list for hints. If it happened during index creation you can try rerunning the step with ```sh -./utils/setup.php --create-search-indices --ignore-errors +nominatim import --continue indexing ``` Otherwise it's best to start the full setup from the beginning. @@ -53,7 +53,7 @@ by adding ";" at the beginning of the line. Don't forget to enable this setting again once you are done with the PHP command line operations. -### PHP timzeone warnings +### PHP timezeone warnings The Apache log may contain lots of PHP warnings like this: `PHP Warning: date_default_timezone_set() function.` @@ -93,7 +93,7 @@ on a non-managed machine. ### I see the error: "function transliteration(text) does not exist" -Reinstall the nominatim functions with `setup.php --create--functions` +Reinstall the nominatim functions with `nominatim refresh --functions` and check for any errors, e.g. a missing `nominatim.so` file. ### I see the error: "ERROR: mmap (remap) failed" @@ -113,7 +113,8 @@ Double-check clang is installed. Instead of `make` try running `make CLANG=true` ### nominatim UPDATE failed: ERROR: buffer 179261 is not owned by resource owner Portal -Several users [reported this](https://github.com/openstreetmap/Nominatim/issues/1168) during the initial import of the database. It's +Several users [reported this](https://github.com/openstreetmap/Nominatim/issues/1168) +during the initial import of the database. It's something PostgreSQL internal Nominatim doesn't control. And PostgreSQL forums suggest it's threading related but definitely some kind of crash of a process. Users reported either rebooting the server, different hardware or just trying @@ -171,7 +172,8 @@ Example error message The PostgreSQL database, i.e. user `postgres`, needs to have access to that file. -The permission need to be read & executable by everybody, e.g. +The permission need to be read & executable by everybody, but not writeable +by everybody, e.g. ``` -rwxr-xr-x 1 nominatim nominatim 297984 build/module/nominatim.so @@ -182,6 +184,16 @@ Try `chmod a+r nominatim.so; chmod a+x nominatim.so`. When running SELinux, make sure that the [context is set up correctly](../appendix/Install-on-Centos-7/#adding-selinux-security-settings). +When you recently updated your operating system, updated PostgreSQL to +a new version or moved files (e.g. the build directory) you should +recreate `nominatim.so`. Try + +``` + cd build + rm -r module/ + cmake $main_Nominatim_path && make +``` + ### Setup.php fails with "DB Error: extension not found" Make sure you have the PostgreSQL extensions "hstore" and "postgis" installed. @@ -191,7 +203,7 @@ See the installation instructions for a full list of required packages. ### I forgot to delete the flatnodes file before starting an import. That's fine. For each import the flatnodes file get overwritten. -See [https://help.openstreetmap.org/questions/52419/nominatim-flatnode-storage]() +See [https://help.openstreetmap.org/questions/52419/nominatim-flatnode-storage](https://help.openstreetmap.org/questions/52419/nominatim-flatnode-storage) for more information. @@ -200,11 +212,3 @@ for more information. ### Can I import negative OSM ids into Nominatim? See [this question of Stackoverflow](https://help.openstreetmap.org/questions/64662/nominatim-flatnode-with-negative-id). - -### Missing XML or text declaration - -The website might show: `XML Parsing Error: XML or text declaration not at start of entity Location.` - -Make sure there are no spaces at the beginning of your `settings/local.php` file. - -