Merge pull request #2252 from codalab/doc-1.24

Add upgrade instructions for 1.24 in documentation

Author: ObadaS

documentation/docs/Developers_and_Administrators/Upgrading_Codabench/Postgres-18.md

@@ -0,0 +1,66 @@
+!!! note "After upgrading from Codabench <1.24.0, you will need to perform important manual interventions."
+
+## Rabbit
+We also need to log into the RabbitMQ interface and enable the flags it wants us to enable after upgrading.
+
+RabbitMQ port, username and password to access the interface are defined in the `.env` file.
+
+![Rabbit-screenshot](../_attachments/554725936-6659efd8-e953-42dd-b885-629c41beb1c7.png)
+
+More information about feature flags [here](https://www.rabbitmq.com/docs/feature-flags)
+
+
+## Database (Postgres 12 -> 18)
+### 1. Maintenance mode on to avoid update on the database during the upgrade:
+
+```sh
+touch maintenance_mode/maintenance.on
+git pull
+```
+
+### 2. Create the new `postgres.conf` file from the sample:
+
+```sh
+cp my-postgres_sample.conf my-postgres.conf
+```
+
+### 3. Rebuild docker containers to take into account the new images:
+
+```sh
+docker compose build --no-cache
+```
+
+### 4. Dump the database, remove it and reload it on the new configuration:
+
+```sh
+# Dump database
+docker compose exec db bash -lc 'PGPASSWORD="$DB_PASSWORD" pg_dump -Fc -U "$DB_USERNAME" -d "$DB_NAME" -f /app/backups/upgrade-1.24.dump'
+```
+
+```sh
+# Check that dump file is not empty
+docker compose exec db bash -lc 'ls -lh /app/backups/upgrade-1.24.dump && pg_restore -l /app/backups/upgrade-1.24.dump | head'
+```
+
+**/!\ Dangerous operation here: confirm that your dump worked before removing the database!**
+
+```sh
+# Remove database
+sudo rm -rf var/postgres
+```
+
+```sh
+# Launch the new containers (containing the updated databse image and Restore from backup)
+docker compose up -d db
+docker compose exec db bash -lc 'PGPASSWORD="$DB_PASSWORD" pg_restore --verbose --clean --no-acl --no-owner -h $DB_HOST -U "$DB_USERNAME" -d "$DB_NAME" /app/backups/upgrade-1.24.dump'
+```
+
+_See [this](https://www.postgresql.org/docs/18/upgrading.html) for more details._
+
+### 5 Restart the rest of the services and disable maintenance mode:
+
+```sh
+docker compose up -d
+rm maintenance_mode/maintenance.on
+```
+

documentation/docs/Developers_and_Administrators/_attachments/554725936-6659efd8-e953-42dd-b885-629c41beb1c7.png

@@ -166,6 +166,7 @@ nav:
           - Minio Image Upgrade (version < 1.21.0): Developers_and_Administrators/Upgrading_Codabench/Minio-image.md
           - Docker-Py (version < 1.22.0): Developers_and_Administrators/Upgrading_Codabench/Docker-py.md
           - Django 4 Upgrades (version < 1.23.0): Developers_and_Administrators/Upgrading_Codabench/Django-4.md
+          - Postgres 18 upgrade (version < 1.24.0): Developers_and_Administrators/Upgrading_Codabench/Postgres-18.md
   - Newsletters Archive:
       - 2024: Newsletters_Archive/CodaLab-in-2024.md
       - 2025: Newsletters_Archive/CodaLab-in-2025.md