docs/admin/Advanced-Installations.md

   1 # Advanced installations
   2
   3 This page contains instructions for setting up multiple countries in
   4 your Nominatim database. It is assumed that you have already successfully
   5 installed the Nominatim software itself, if not return to the
   6 [installation page](Installation.md).
   7
   8 ## Importing multiple regions
   9
  10 To import multiple regions in your database, you need to configure and run `utils/import_multiple_regions.sh` file. This script will set up the update directory which has the following structure:
  11
  12 ```bash
  13 update
  14     ├── europe
  15     │   ├── andorra
  16     │   │   └── sequence.state
  17     │   └── monaco
  18     │       └── sequence.state
  19     └── tmp
  20         ├── combined.osm.pbf
  21         └── europe
  22                 ├── andorra-latest.osm.pbf
  23                 └── monaco-latest.osm.pbf
  24
  25
  26 ```
  27
  28 The `sequence.state` files will contain the sequence ID, which will be used be pyosmium to get updates. The tmp folder is used for import dump.
  29
  30 ### Configuring multiple regions
  31
  32 The file `import_multiple_regions.sh` needs to be edited as per your requirement:
  33
  34 1. List of countries. eg:
  35
  36         COUNTRIES="europe/monaco europe/andorra"
  37
  38 2. Path to Build directory. eg:
  39
  40         NOMINATIMBUILD="/srv/nominatim/build"
  41
  42 3. Path to Update directory. eg:
  43
  44         UPDATEDIR="/srv/nominatim/update"
  45
  46 4. Replication URL. eg:
  47
  48         BASEURL="https://download.geofabrik.de"
  49         DOWNCOUNTRYPOSTFIX="-latest.osm.pbf"
  50
  51 !!! tip
  52     If your database already exists and you want to add more countries, replace the setting up part
  53     `${SETUPFILE} --osm-file ${UPDATEDIR}/tmp/combined.osm.pbf --all 2>&1`
  54     with `${UPDATEFILE} --import-file ${UPDATEDIR}/tmp/combined.osm.pbf 2>&1`.
  55
  56 ### Setting up multiple regions
  57
  58 Run the following command from your Nominatim directory after configuring the file.
  59
  60     bash ./utils/import_multiple_regions.sh
  61
  62 ## Updating multiple regions
  63
  64 To import multiple regions in your database, you need to configure and run ```utils/update_database.sh```.
  65 This uses the update directory set up while setting up the DB.
  66
  67 ### Configuring multiple regions
  68
  69 The file `update_database.sh` needs to be edited as per your requirement:
  70
  71 1. List of countries. eg:
  72
  73         COUNTRIES="europe/monaco europe/andorra"
  74
  75 2. Path to Build directory. eg:
  76
  77         NOMINATIMBUILD="/srv/nominatim/build"
  78
  79 3. Path to Update directory. eg:
  80
  81         UPDATEDIR="/srv/nominatim/update"
  82
  83 4. Replication URL. eg:
  84
  85         BASEURL="https://download.geofabrik.de"
  86         DOWNCOUNTRYPOSTFIX="-updates"
  87
  88 5. Followup can be set according to your installation. eg: For Photon,
  89
  90         FOLLOWUP="curl http://localhost:2322/nominatim-update"
  91
  92     will handle the indexing.
  93
  94 ### Updating the database
  95
  96 Run the following command from your Nominatim directory after configuring the file.
  97
  98     bash ./utils/update_database.sh
  99
 100 This will get diffs from the replication server, import diffs and index the database. The default replication server in the script([Geofabric](https://download.geofabrik.de)) provides daily updates.
 101
 102 ## Verification and further setup
 103
 104 Instructions for import verification and other details like importing Wikidata can be found in [import and update page](Import-and-Update.md)
 105