Merge remote-tracking branch 'upstream/master'

[nominatim.git] / docs / Installation.md

diff --git a/docs/Installation.md b/docs/Installation.md
index ddd0fc7b6dbaf802b75ce426fc00d4148344c47d..1cdd9d109014b039cbaaf40965ecec74620fb12e 100644 (file)
--- a/docs/Installation.md
+++ b/docs/Installation.md
@@ -1,12 +1,12 @@
-Nominatim Installation
+Nominatim installation

 ======================
 
 This page contains generic installation instructions for Nominatim and its
 prerequisites. There are also step-by-step instructions available for
 the following operating systems:
 
 ======================
 
 This page contains generic installation instructions for Nominatim and its
 prerequisites. There are also step-by-step instructions available for
 the following operating systems:
 

-  * [Ubuntu 16.04](install-on-ubuntu-16.md)
-  * [CentOS 7.2](install-on-centos-7.md)
+  * [Ubuntu 16.04](Install-on-Ubuntu-16.md)
+  * [CentOS 7.2](Install-on-Centos-7.md)

 
 These OS-specific instructions can also be found in executable form
 in the `vagrant/` directory.
 
 These OS-specific instructions can also be found in executable form
 in the `vagrant/` directory.


@@ -28,8 +28,7 @@ required for compiling osm2pgsql.
 
 For running tests:
 
 
 For running tests:
 

-  * [lettuce](http://lettuce.it)
-  * [Shapely](http://toblerity.org/shapely/index.html)
+  * [behave](http://pythonhosted.org/behave/)

   * [Psycopg2](http://initd.org/psycopg)
   * [nose](https://nose.readthedocs.io)
   * [phpunit](https://phpunit.de)
   * [Psycopg2](http://initd.org/psycopg)
   * [nose](https://nose.readthedocs.io)
   * [phpunit](https://phpunit.de)


@@ -38,14 +37,15 @@ For running Nominatim:
 
   * [PostgreSQL](http://www.postgresql.org) (9.1 or later)
   * [PostGIS](http://postgis.refractions.net) (2.0 or later)
 
   * [PostgreSQL](http://www.postgresql.org) (9.1 or later)
   * [PostGIS](http://postgis.refractions.net) (2.0 or later)

-  * [PHP](http://php.net)
+  * [PHP](http://php.net) (5.4 or later)

   * PHP-pgsql
   * PHP-pgsql

+  * PHP-intl (bundled with PHP)

   * [PEAR::DB](http://pear.php.net/package/DB)
   * a webserver (apache or nginx are recommended)
 
 For running continuous updates:
 
   * [PEAR::DB](http://pear.php.net/package/DB)
   * a webserver (apache or nginx are recommended)
 
 For running continuous updates:
 

-  * [osmosis](http://wiki.openstreetmap.org/wiki/Osmosis)
+  * [pyosmium](http://osmcode.org/pyosmium/)

 
 ### Hardware
 
 
 ### Hardware
 


@@ -60,10 +60,10 @@ On a 6-core machine with 32GB RAM and SSDs the import of a full planet takes
 a bit more than 2 days. Without SSDs 7-8 days are more realistic.
 
 
 a bit more than 2 days. Without SSDs 7-8 days are more realistic.
 
 

-Setup of the Server
+Setup of the server

 -------------------
 
 -------------------
 

-### PostgreSQL Tuning
+### PostgreSQL tuning

 
 You might want to tune your PostgreSQL installation so that the later steps
 make best use of your hardware. You should tune the following parameters in
 
 You might want to tune your PostgreSQL installation so that the later steps
 make best use of your hardware. You should tune the following parameters in


@@ -74,7 +74,7 @@ your `postgresql.conf` file.
     work_mem (50MB)
     effective_cache_size (24GB)
     synchronous_commit = off
     work_mem (50MB)
     effective_cache_size (24GB)
     synchronous_commit = off

-    checkpoint_segments = 100
+    checkpoint_segments = 100 # only for postgresql <= 9.4

     checkpoint_timeout = 10min
     checkpoint_completion_target = 0.9
 
     checkpoint_timeout = 10min
     checkpoint_completion_target = 0.9
 


@@ -103,7 +103,8 @@ directory and create an alias:
 
     <Directory "/srv/nominatim/build/website">
       Options FollowSymLinks MultiViews
 
     <Directory "/srv/nominatim/build/website">
       Options FollowSymLinks MultiViews

-      AddTpe text/html   .php
+      AddType text/html   .php
+      DirectoryIndex search.php

       Require all granted
     </Directory>
     Alias /nominatim /srv/nominatim/build/website
       Require all granted
     </Directory>
     Alias /nominatim /srv/nominatim/build/website


@@ -134,13 +135,15 @@ follows:
 Tell nginx that php files are special and to fastcgi_pass to the php-fpm
 unix socket by adding the location definition to the default configuration.
 
 Tell nginx that php files are special and to fastcgi_pass to the php-fpm
 unix socket by adding the location definition to the default configuration.
 

+    root /srv/nominatim/build/website;
+    index search.php index.html;

     location ~ [^/]\.php(/|$) {
         fastcgi_split_path_info ^(.+?\.php)(/.*)$;
         if (!-f $document_root$fastcgi_script_name) {
             return 404;
         }
         fastcgi_pass unix:/var/run/php5-fpm.sock;
     location ~ [^/]\.php(/|$) {
         fastcgi_split_path_info ^(.+?\.php)(/.*)$;
         if (!-f $document_root$fastcgi_script_name) {
             return 404;
         }
         fastcgi_pass unix:/var/run/php5-fpm.sock;

-        fastcgi_index index.php;
+        fastcgi_index search.php;

         include fastcgi.conf;
     }
 
         include fastcgi.conf;
     }
 


@@ -148,4 +151,4 @@ Restart the nginx and php5-fpm services and the website should now be available
 on http://localhost/.
 
 
 on http://localhost/.
 
 

-Now continue with [importing the database](Import_and_update.md).
+Now continue with [importing the database](Import-and-Update.md).