X-Git-Url: https://git.openstreetmap.org./nominatim.git/blobdiff_plain/aefca48e78252b374fa2137433f0fe2f3166bde2..3905dd68dd5b261449df7df243c594b25995d8bd:/docs/admin/Faq.md?ds=sidebyside diff --git a/docs/admin/Faq.md b/docs/admin/Faq.md index d933a84d..efcd5741 100644 --- a/docs/admin/Faq.md +++ b/docs/admin/Faq.md @@ -37,40 +37,6 @@ nominatim import --continue indexing Otherwise it's best to start the full setup from the beginning. -### PHP "open_basedir restriction in effect" warnings - - PHP Warning: file_get_contents(): open_basedir restriction in effect. - -You need to adjust the -[open_basedir](https://www.php.net/manual/en/ini.core.php#ini.open-basedir) -setting in your PHP configuration (`php.ini` file). By default this setting may -look like this: - - open_basedir = /srv/http/:/home/:/tmp/:/usr/share/pear/ - -Either add reported directories to the list or disable this setting temporarily -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 timezeone warnings - -The Apache log may contain lots of PHP warnings like this: - `PHP Warning: date_default_timezone_set() function.` - -You should set the default time zone as instructed in the warning in -your `php.ini` file. Find the entry about timezone and set it to -something like this: - - ; Defines the default timezone used by the date functions - ; https://php.net/date.timezone - date.timezone = 'America/Denver' - -Or - -``` -echo "date.timezone = 'America/Denver'" > /etc/php.d/timezone.ini -``` ### nominatim.so version mismatch @@ -79,7 +45,7 @@ When running the import you may get a version mismatch: pg_config seems to use bad includes sometimes when multiple versions of PostgreSQL are available in the system. Make sure you remove the -server development libraries (`postgresql-server-dev-9.5` on Ubuntu) +server development libraries (`postgresql-server-dev-13` on Ubuntu) and recompile (`cmake .. && make`). @@ -160,9 +126,6 @@ by everybody, e.g. 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-8.md#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 @@ -173,12 +136,31 @@ recreate `nominatim.so`. Try cmake $main_Nominatim_path && make ``` -### Setup.php fails with "DB Error: extension not found" +### Setup fails with "DB Error: extension not found" Make sure you have the PostgreSQL extensions "hstore" and "postgis" installed. See the installation instructions for a full list of required packages. +### UnicodeEncodeError: 'ascii' codec can't encode character + +Make sure that the operating system's locale is UTF-8. With some prebuilt +images (e.g. LXC containers from Proxmox, see +[discussion](https://github.com/osm-search/Nominatim/discussions/2343)) or +images that optimize for size it might be missing. + +On Ubuntu you can check the locale is installed: + +``` + grep UTF-8 /etc/default/locale +``` + +And install it using + +``` + dpkg-reconfigure locales +``` + ### I forgot to delete the flatnodes file before starting an import. That's fine. For each import the flatnodes file get overwritten.