From 529cff2b6b76b7f600078bf4ffd85e8d47a3181a Mon Sep 17 00:00:00 2001
From: Justine Fricou <justine.fricou@gmail.com>
Date: Thu, 28 Nov 2024 17:10:20 +0100
Subject: [PATCH] Update installation and upgrade docs for pgrouting use

---
 docs/install/installation.rst |  4 ++--
 docs/install/upgrade.rst      | 16 +++++++++++++++-
 2 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/docs/install/installation.rst b/docs/install/installation.rst
index 69b31f5fbc..7fdd719542 100644
--- a/docs/install/installation.rst
+++ b/docs/install/installation.rst
@@ -79,8 +79,8 @@ If you are not confident with the ``install.sh`` script, or if you are having tr
 1. Add ``deb https://packages.geotrek.fr/ubuntu bionic main`` to APT sources list.
 2. Add https://packages.geotrek.fr/geotrek.gpg.key to apt keyring.
 3. Run ``apt-get update``
-4. If you want to use a local database, install PostGIS package (before installing Geotrek-admin, not at the same time).
-   If not, you must create database and enable PostGIS extension before.
+4. If you want to use a local database, install the pgRouting package by running ``sudo apt install -y postgresql-pgrouting wget software-properties-common`` (before installing Geotrek-admin, not at the same time).
+   If not, you must create database and enable PostGIS and pgRouting extensions before.
 5. Install the Geotrek-admin package (``sudo apt install geotrek-admin``).
 
 .. note ::
diff --git a/docs/install/upgrade.rst b/docs/install/upgrade.rst
index eb515a4ee9..7d5b9dc427 100644
--- a/docs/install/upgrade.rst
+++ b/docs/install/upgrade.rst
@@ -89,6 +89,19 @@ Make sure to run the following command **BEFORE** upgrading:
 ``su postgres -c "psql -q -d $POSTGRES_DB -c 'CREATE EXTENSION pgcrypto;'"``
 
 
+From Geotrek-admin <= 2.110.0
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**WARNING!**
+
+Starting from version 2.111.0, Geotrek now requires pgRouting. Before upgrading:
+
+1. Install the pgRouting package by running ``sudo apt install -y postgresql-pgrouting wget software-properties-common``
+
+2. Run the following command: ``su postgres -c "psql -q -d $POSTGRES_DB -c 'CREATE EXTENSION pgrouting;'"``
+
+
+
 Server migration
 ~~~~~~~~~~~~~~~~
 
@@ -180,7 +193,7 @@ Now, install newest version of PostgreSQL and PostGIS:
 
 ::
 
-    sudo apt install postgresql-14-postgis-3
+    sudo apt install postgresql-14-pgrouting
 
 
 
@@ -206,6 +219,7 @@ Recreate user and database:
     CREATE EXTENSION postgis;
     CREATE EXTENSION postgis_raster;
     CREATE EXTENSION pgcrypto;
+    CREATE EXTENSION pgrouting;
     \q
 
 .. warning::