Mise à jour de Parsec Server

Cette section décrit les étapes générales à suivre pour mettre à jour Parsec Server.

Cette section part du principe que vous avez déployé Parsec en suivant les instructions de la section Déploiement du serveur. Si vous avez déployé Parsec d’une autre manière, vous devrez peut-être adapter cette section à votre déploiement personnalisé.

Suivez les étapes ci-dessous en fonction de la méthode utilisée pour installer Parsec Server :

• Mise à jour avec Docker, si vous avez installé Parsec Server avec Docker.

• Mise à niveau sous Linux, si vous avez installé Parsec Server directement sous Linux.

Mise à jour avec Docker

Important

Avant de procéder à la mise à jour, assurez-vous de sauvegarder la base de données comme expliqué dans la section Sauvegarde et restauration au cas où vous auriez besoin de revenir sur la mise à jour.

Les étapes suivantes expliquent comment mettre à niveau le service parsec-server de la version v3.0.0 à la version v3.1.0.

1. Mettre à jour le tag de l’image Docker de parsec-server dans parsec-server.docker.yaml, de ceci :

   services:
     # ...
     parsec-server:
       image: ghcr.io/scille/parsec-cloud/parsec-server:v3.0.0
       # ...
   

   À cela :

   services:
     # ...
     parsec-server:
       image: ghcr.io/scille/parsec-cloud/parsec-server:v3.1.0
       # ...
   

2. Lister les migrations à appliquer :

   docker compose -f parsec-server.docker.yaml run parsec-server migrate --dry-run
   

   Le résultat devrait ressembler à ceci :

   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

   Ce résultat est fourni à titre d’exemple. Ne vous attendez pas à ce qu’il corresponde au vôtre.

   Les lignes se terminant par already applied sont des migrations déjà présentes dans la base de données tandis que celles se terminant par ✔ sont des migrations à appliquer.

3. Appliquer les migrations de la base de données :

   docker compose -f parsec-server.docker.yaml run parsec-server migrate
   

1. Redémarrer le conteneur parsec-server :

   docker compose -f parsec-server.docker.yaml restart parsec-server
   

Mise à jour sous Linux

Important

Avant de procéder à la mise à jour, assurez-vous de sauvegarder la base de données comme expliqué dans la section Sauvegarde et restauration au cas où vous auriez besoin de revenir sur la mise à jour.

Important

Certaines personnalisations de Parsec nécessitent de modifier les fichiers source à l’intérieur du répertoire d’installation. Ces fichiers étant écrasés lors de la mise à jour, vous devez en faire une copie avant de commencer, puis les restaurer après la mise à jour.

Depuis la version 3.5 de Parsec, les modèles d’e-mails et les pages serveur peuvent être chargés à partir d’un répertoire de modèles situé en dehors du répertoire d’installation. Pour ce faire, il suffit d’utiliser l’option --template-dir lors du lancement de Parsec Server.

Les étapes suivantes expliquent comment mettre à jour Parsec Server directement sous Linux.

1. Arrêtez le serveur Parsec en cours d’exécution

   Cette étape dépendra de la manière dont vous exécutez Parsec Server.

   Par exemple, si vous utilisiez la commande systemctl, vous exécuteriez quelque chose comme :

   systemctl stop parsec.service
   

2. Installez Parsec Server et appliquez les migrations de la base de données

   Suivez les étapes décrites dans Déploiement sous Linux.

3. Vérifiez que la bonne version est installée

   python -m parsec --version
   

4. Redémarrez Parsec Server

   Cette étape dépendra de la manière dont vous exécutez Parsec Server.

   Par exemple, si vous utilisiez la commande systemctl, vous exécuteriez quelque chose comme :

   systemctl restart parsec.service
   

5. Vérifiez que Parsec Server est opérationnel.

   Ouvrez un navigateur Web et rendez-vous à l’adresse où vous avez déployé Parsec Server.

   Si l’application web est activée : vous devriez être redirigé vers la page d’accueil.

   Si l’application web n’est pas activée : vous devriez voir la page du serveur qui tourne correctement.