Merge pull request #3530 from lonvia/clean-use-of-os-environ

[nominatim.git] / docs / admin / Migration.md

diff --git a/docs/admin/Migration.md b/docs/admin/Migration.md
index 59702e7bbc8def65eb049fed62ce8a3b82afdf9d..75f891412e8cf48f8644adab9e1c39d78377aae4 100644 (file)
--- a/docs/admin/Migration.md
+++ b/docs/admin/Migration.md
@@ -1,12 +1,17 @@
 # Database Migrations
 
 # Database Migrations
 

-Since version 3.7.0 Nominatim offers automatic migrations. Please follow
+Nominatim offers automatic migrations since version 3.7. Please follow

 the following steps:
 
 the following steps:
 

-* stop any updates that are potentially running
-* update Nominatim to the newer version
-* go to your project directory and run `nominatim admin --migrate`
-* (optionally) restart updates
+* Stop any updates that are potentially running
+* Update the backend: `pip install -U nominatim-db`
+* Go to your project directory and run `nominatim admin --migrate`
+* Update the frontend: `pip install -U nominatim-api`
+* (optionally) Restart updates
+
+If you are still using CMake for the installation of Nominatim, then you
+need to update the software in one step before migrating the database.
+It is not recommended to do this while the machine is serving requests.

 
 Below you find additional migrations and hints about other structural and
 breaking changes. **Please read them before running the migration.**
 
 Below you find additional migrations and hints about other structural and
 breaking changes. **Please read them before running the migration.**


@@ -19,7 +24,7 @@ breaking changes. **Please read them before running the migration.**
 
 ### New structure for Python packages
 
 
 ### New structure for Python packages
 

-The nominatim Python package has been split into nominatim-db and nominatim-api.
+The nominatim Python package has been split into `nominatim-db` and `nominatim-api`.

 Any imports need to be adapted accordingly.
 
 If you are running the Python frontend, change the server module from
 Any imports need to be adapted accordingly.
 
 If you are running the Python frontend, change the server module from