Skip to content

Commit 8d61235

Browse files
authored
Merge pull request #604 from MerginMaps/anchors-for-migration-guides
anchors for server migration guides
2 parents 03ac461 + bd4c037 commit 8d61235

File tree

1 file changed

+10
-11
lines changed

1 file changed

+10
-11
lines changed

src/server/upgrade/index.md

+10-11
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Make sure to always back up your database data before doing a migration.
1111
[[toc]]
1212

1313

14-
## Migration guide from 2025.2.x to 2025.3.x
14+
## From 2025.2.x to 2025.3.x {#migration-guide-from-2025-2-x-to-2025-3-x}
1515

1616
<MigrationType type="EE" />
1717

@@ -69,7 +69,7 @@ Your webmaps won’t display the default background map unless we enable them on
6969
Alternatively, you can set up your own background map using [environment variables](../environment/index.md#webmaps).
7070
:::
7171

72-
## Migration guide from 2024.2.x to 2025.2.x (CE)
72+
## From 2024.2.x to 2025.2.x (CE) {#migration-guide-from-2024-2-x-to-2025-2-x-ce}
7373

7474
::: tip Before you upgrade!
7575
Release 2025.2.x brings significant changes on <MainPlatformName /> docker compose orchestration infrastructure.
@@ -127,9 +127,7 @@ Perform the migration:
127127
$ docker exec merginmaps-server flask db upgrade heads
128128
```
129129

130-
131-
132-
## Migration guide from 2024.4.x to 2025.2.x
130+
## From 2024.4.x to 2025.2.x {#migration-guide-from-2024-4-x-to-2025-2-x}
133131

134132
::: tip Before you upgrade!
135133
Release 2025.2.x brings significant changes on <MainPlatformName /> docker compose orchestration infrastructure.
@@ -189,7 +187,7 @@ Perform the migration:
189187
```
190188

191189

192-
## Migration guide from 2024.3.x to 2024.4.x
190+
## From 2024.3.x to 2024.4.x {#migration-guide-from-2024-3-x-to-2024-4-x}
193191

194192
Get the latest <GitHubRepo id="MerginMaps/server/blob/master/deployment/enterprise/docker-compose.yml" desc="docker-compose file" /> or update docker images manually to version `2024.4.0`.
195193
Perform the migration:
@@ -221,7 +219,7 @@ Perform the migration:
221219
$ docker exec merginmaps-server flask db upgrade enterprise@df5b4efdae7b
222220
```
223221

224-
## Migration guide from 2024.2.x to 2024.3.x
222+
## From 2024.2.x to 2024.3.x {#migration-guide-from-2024-2-x-to-2024-3-x}
225223

226224
Get the latest <GitHubRepo id="MerginMaps/server/blob/master/deployment/enterprise/docker-compose.yml" desc="docker-compose file" /> or update docker images manually to version `2024.3.0`.
227225
Perform the migration:
@@ -252,7 +250,7 @@ Perform the migration:
252250
$ docker exec merginmaps-server flask db upgrade community@0e3fc92aeaaa
253251
```
254252

255-
## Migration guide from 2023.6.1 to 2024.2.x (CE)
253+
## From 2023.6.1 to 2024.2.x (CE) {#migration-guide-from-2023-6-1-to-2024-2-x-ce}
256254

257255
Get the latest <GitHubRepo id="MerginMaps/server/blob/master/deployment/community/docker-compose.yml" desc="docker-compose file" /> or update docker images manually.
258256

@@ -313,7 +311,7 @@ Update image to `2024.2.1` and perform the migration:
313311
$ docker exec merginmaps-server flask db upgrade enterprise@head
314312
```
315313

316-
## Migration guide from 2023.2.0+ to 2023.6.1
314+
## From 2023.2.0+ to 2023.6.1 {#migration-guide-from-2023-2-0-to-2023-6-1}
317315

318316
⚠️ If you are on a server version lower than `2023.2.0`, it is important to first [upgrade to `2023.2.0`](#migration-guide-from-any-previous-version-to-2023-2-0) before continuing with this migration.
319317

@@ -373,7 +371,7 @@ Perform the migration:
373371
$ docker exec merginmaps-server flask db upgrade community@3a77058a2fd7
374372
```
375373

376-
## Migration guide from any previous version to 2023.2.0
374+
## Any previous version to 2023.2.0 {#migration-guide-from-any-previous-version-to-2023-2-0}
377375

378376
Besides various fixes, enhancements and performance improvements the most notable change recently introduced is the concept of workspaces. For Community Edition it means there is a **common shared workspace (global workspace)** for all users where all projects are stored, instead of having a personal or organisational namespace for projects.
379377

@@ -460,9 +458,10 @@ root@merginmaps-db$ pg_restore -U postgres -Fc -d postgres < /tmp/pg_backup.dump
460458
If your PostgreSQL settings were custom, you might need to follow official instructions for upgrading the PostgreSQL cluster.
461459
:::
462460

463-
**Database migration**
461+
### Database migration
464462

465463
<MigrationType type="CE" />
464+
466465
In this step we will select a global workspace (e.g. my-company) where all your projects will be merged. Your projects are migrated as follows: former namespace is prepended to project name and whole project is moved to new global workspace, for example:
467466

468467
john.doe/survey -> my-company/john.doe_survey

0 commit comments

Comments
 (0)