Server Maintenance
This section covers how to maintain the Parsec server up to date.
Note
We consider that you are using the same infrastructure configuration as in the Parsec Server installation guide. Adapt this guide to your own situation.
Upgrade Parsec Server
Warning
Before updating to a newer version, make sure to back up the database, in case you need to roll back the update.
In this guide, we will migrate parsec-server
from version v3.0.0
to v3.1.0
.
Update the
parsec-server
’s docker image tag of in docker-compose file (parsec-server.docker.yaml
):
1services: 2 # ... 3 4 parsec-server: 5 image: ghcr.io/scille/parsec-cloud/parsec-server:v3.0.0 6 # ...You need to change the used tag (at line 5) to
v3.1.0
.
List the pending migrations to be applied:
docker compose -f parsec-server.docker.yaml run parsec-server migrate --dry-runThe output should look like this:
0001_initial.sql (already applied) 0002_add_migration_table.sql (already applied) 0003_human_handle.sql (already applied) 0004_invite.sql (already applied) 0005_redacted_certificates.sql (already applied) 0006_outsider_enabled.sql (already applied) 0007_users_limit.sql (already applied) 0008_apiv1_removal.sql (already applied) 0009_add_realm_user_change_table.sql (already applied) 0010_add_pki_certificate_table.sql (already applied) 0011_add_sequester_tables.sql (already applied) 0012_add_sequester_webhook.sql (already applied) 0013_add_shamir_recovery.sql ✔ 0014_add_realm_archiving.sql ✔Note
This output is provided as an example. Don’t expect it to match your output.
The lines ending with
already applied
are migrations already present on the database whereas the one ending with✔
are migrations to be applied.
Apply the database migration:
docker compose -f parsec-server.docker.yaml run parsec-server migrate
Restart the
parsec-server
container:
docker compose -f parsec-server.docker.yaml restart parsec-server
Downgrade Parsec Server
Warning
Rollback is currently limited in Parsec. The only possible way to rollback is to use the previous database backup. So you will lose the delta of backup vs current database.
To roll back to a previous version, let’s say we want to downgrade parsec-server
from version v3.1.0
to v3.0.0
.
Downgrade the
parsec-server
’s docker image tag in the docker-compose file (parsec-server.docker.yaml
). Like in Update the parsec-server tag change the tagv3.1.0
tov3.0.0
.Replace the current database with the backup on the Postgres database.