From: Sarah Hoffmann Date: Wed, 10 Feb 2021 10:15:21 +0000 (+0100) Subject: add 'make install' to installation instructions X-Git-Tag: v3.7.0~38^2~5 X-Git-Url: https://git.openstreetmap.org./nominatim.git/commitdiff_plain/85589cf7dcb61c860d88177a986a49beb4bf57d4?ds=sidebyside add 'make install' to installation instructions --- diff --git a/README.md b/README.md index d4bb0936..6fd0cd45 100644 --- a/README.md +++ b/README.md @@ -41,12 +41,13 @@ A quick summary of the necessary steps: cd build cmake .. make + sudo make install 2. Create a project directory, get OSM data and import: mkdir nominatim-project cd nominatim-project - ~/build/nominatim import --osm-file + nominatim import --osm-file 3. Point your webserver to the nominatim-project/website directory. diff --git a/docs/admin/Advanced-Installations.md b/docs/admin/Advanced-Installations.md index 4f59900d..d5e6e889 100644 --- a/docs/admin/Advanced-Installations.md +++ b/docs/admin/Advanced-Installations.md @@ -155,7 +155,7 @@ Make sure that the PostgreSQL server package is installed on the machine the PostgreSQL server itself. Download and compile Nominatim as per standard instructions. Once done, you find -the nomrmalization library in `build/module/nominatim.so`. Copy the file to +the normalization library in `build/module/nominatim.so`. Copy the file to the database server at a location where it is readable and executable by the PostgreSQL server process. diff --git a/docs/admin/Import.md b/docs/admin/Import.md index 280231b6..b810c37e 100644 --- a/docs/admin/Import.md +++ b/docs/admin/Import.md @@ -2,7 +2,8 @@ The following instructions explain how to create a Nominatim database from an OSM planet file. It is assumed that you have already successfully -installed the Nominatim software itself. If this is not the case, return to the +installed the Nominatim software itself and the `nominatim` tool can be found +in your `PATH`. If this is not the case, return to the [installation page](Installation.md). ## Creating the project directory @@ -10,10 +11,11 @@ installed the Nominatim software itself. If this is not the case, return to the Before you start the import, you should create a project directory for your new database installation. This directory receives all data that is related to a single Nominatim setup: configuration, extra data, etc. Create a project -directory apart from the Nominatim software: +directory apart from the Nominatim software and change into the directory: ``` mkdir ~/nominatim-planet +cd ~/nominatim-planet ``` In the following, we refer to the project directory as `$PROJECT_DIR`. To be @@ -25,18 +27,8 @@ export PROJECT_DIR=~/nominatim-planet The Nominatim tool assumes per default that the current working directory is the project directory but you may explicitly state a different directory using -the `--project-dir` parameter. The following instructions assume that you have -added the Nominatim build directory to your PATH and run all directories from -the project directory. If you haven't done yet, add the build directory to your -path and change to the new project directory: - -``` -export PATH=~/Nominatim/build:$PATH -cd $PROJECT_DIR -``` - -Of course, you have to replace the path above with the location of your build -directory. +the `--project-dir` parameter. The following instructions assume that you run +all commands from the project directory. !!! tip "Migration Tip" diff --git a/docs/admin/Installation.md b/docs/admin/Installation.md index d8c98ef5..0013e993 100644 --- a/docs/admin/Installation.md +++ b/docs/admin/Installation.md @@ -40,14 +40,15 @@ For running Nominatim: * [PostGIS](https://postgis.net) (2.2+) * [Python 3](https://www.python.org/) (3.5+) * [Psycopg2](https://www.psycopg.org) + * [Python Dotenv](https://github.com/theskumar/python-dotenv) * [PHP](https://php.net) (7.0 or later) * PHP-pgsql * PHP-intl (bundled with PHP) - * [Python Dotenv](https://github.com/theskumar/python-dotenv) + ( PHP-cgi (for running queries from the command line) For running continuous updates: - * [pyosmium](https://osmcode.org/pyosmium/) (with Python 3) + * [pyosmium](https://osmcode.org/pyosmium/) For dependencies for running tests and building documentation, see the [Development section](../develop/Development-Environment.md). @@ -143,6 +144,16 @@ build at the same level as the Nominatim source directory run: ``` cmake ../Nominatim make +sudo make install +``` + +Nominatim installs itself into `/usr/local` per default. To choose a different +installation directory add `-DCMAKE_INSTALL_PREFIX=` to the +cmake command. Make sure that the `bin` directory is available in your path +in that case, e.g. + +``` +export PATH=/bin:$PATH ``` Now continue with [importing the database](Import.md).