X-Git-Url: https://git.openstreetmap.org./nominatim.git/blobdiff_plain/799a4c9ab63996d2ef3977baf774316c03fc9fde..445a6428a64d950ebc4ace2784a247fe6ab4970c:/docs/admin/Import.md diff --git a/docs/admin/Import.md b/docs/admin/Import.md index 3701df92..88d3ba5b 100644 --- a/docs/admin/Import.md +++ b/docs/admin/Import.md @@ -40,7 +40,7 @@ all commands from the project directory. ### Configuration setup in `.env` -The Nominatim server can be customized via an `.env` configuration file in the +The Nominatim server can be customized via an `.env` configuration file in the project directory. This is a file in [dotenv](https://github.com/theskumar/python-dotenv) format which looks the same as variable settings in a standard shell environment. You can also set the same configuration via environment variables. All @@ -48,7 +48,7 @@ settings have a `NOMINATIM_` prefix to avoid conflicts with other environment variables. There are lots of configuration settings you can tweak. Have a look -at `settings/env.default` for a full list. Most should have a sensible default. +at `Nominatim/settings/env.default` for a full list. Most should have a sensible default. #### Flatnode files @@ -137,6 +137,14 @@ Note that you still need to provide for sufficient disk space for the initial import. So this option is particularly interesting if you plan to transfer the database or reuse the space later. +!!! warning + The datastructure for updates are also required when adding additional data + after the import, for example [TIGER housenumber data](Customization#installing-tiger-housenumber-data-for-the-us). + If you plan to use those, you must not use the `--no-updates` parameter. + Do a normal import, add the external data and once you are done with + everything run `nominatim freeze`. + + ### Reverse-only Imports If you only want to use the Nominatim database for reverse lookups or @@ -193,12 +201,15 @@ can be found in the development section. [Geofabrik](https://download.geofabrik.de). Download the data to import. Then issue the following command -from the **build directory** to start the import: +from the **project directory** to start the import: ```sh nominatim import --osm-file 2>&1 | tee setup.log ``` +The **project directory** is the one that you have set up at the beginning. +See [creating the project directory](Import#creating-the-project-directory). + ### Notes on full planet imports Even on a perfectly configured machine @@ -235,7 +246,8 @@ reduce the cache size or even consider using a flatnode file. ### Testing the installation -Run this script to verify all required tables and indices got created successfully. +Run this script to verify that all required tables and indices got created +successfully. ```sh nominatim admin --check-database