Skip to content

Commit 46dcd64

Browse files
committed
docs: address maintainer feedback on v7 migration guide
1 parent e03381d commit 46dcd64

1 file changed

Lines changed: 12 additions & 9 deletions

File tree

docs/IntelOwl/installation.md

Lines changed: 12 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -358,6 +358,8 @@ Below you can find the additional process required to upgrade from each major ve
358358

359359
#### Updating to >=7.0.0 from a 6.x.x version
360360

361+
*Note: Version 7.0.0 is not yet officially released; this guide is provided for the upcoming major update.*
362+
361363
IntelOwl v7.0.0 updated the base PostgreSQL image from version 16 to version 18. This change is a breaking change for the database data. You have two choices:
362364

363365
- **Choice 1: Start from scratch**: Remove your actual database volumes and start from scratch with a new one.
@@ -398,28 +400,29 @@ The database migration procedure is as follows:
398400
docker container stop intelowl_postgres_16
399401
docker container rm intelowl_postgres_16
400402
```
401-
7. (Optional) Remove the old PostgreSQL volume:
402-
```bash
403-
docker volume rm <OLD_POSTGRES_VOLUME>
404-
```
405-
8. Start a temporary PostgreSQL 18 container using the new volume name:
403+
7. Start a temporary PostgreSQL 18 container using the new volume name:
406404
```bash
407405
docker run -d --name intelowl_postgres_18 -v intelowl_postgres_data_v18:/var/lib/postgresql/data/ --env-file env_file_postgres library/postgres:18-alpine
408406
```
409-
9. Restore the data:
407+
8. Restore the data:
410408
```bash
411409
cat /tmp/intelowl_v6_dump.sql | docker exec -i intelowl_postgres_18 psql -U <POSTGRES_USER> -d <POSTGRES_DB>
412410
```
413-
10. Stop and remove the temporary container:
411+
9. Stop and remove the temporary container:
414412
```bash
415413
docker container stop intelowl_postgres_18
416414
docker container rm intelowl_postgres_18
417415
```
418-
11. Update your IntelOwl repository to the latest version (v7.0.0).
419-
12. Bring the application back up:
416+
10. Update your IntelOwl repository to the latest version (v7.0.0).
417+
11. Bring the application back up:
420418
```bash
421419
./start prod up
422420
```
421+
12. (Optional) Once you have verified that everything works properly, you can remove the old PostgreSQL volume.
422+
**Warning**: This will permanently delete your original data/backup.
423+
```bash
424+
docker volume rm <OLD_POSTGRES_VOLUME>
425+
```
423426

424427
#### Updating to >=6.0.0 from a 5.x.x version
425428

0 commit comments

Comments
 (0)