VM — Maintenance du backend

VM : pourquoi effectuer des opérations de maintenance

Cette application est conçue pour être hautement résiliente et ne nécessite pas beaucoup d'opérations de maintenance. Cependant, dans certaines situations, vous devrez peut-être redémarrer Docker pour mettre à jour la version de votre application et bénéficier des derniers correctifs.

Dans certains cas, par exemple si une erreur survient pendant le traitement des données, certains fichiers créés pour l'opération peuvent ne pas être supprimés. Ils peuvent s'accumuler et remplir le volume alloué. Ce problème peut généralement être résolu en arrêtant puis en redémarrant l'application.

Quand intervenir

Échec des processus de données

Le premier signe indiquant que votre application peut nécessiter une maintenance est lorsque certains processus de données lancés depuis Salesforce se terminent avec le statut Failed. Avant de vérifier votre VM, assurez-vous que la description de l'erreur n'indique pas un problème ailleurs. Par exemple, si vous avez créé vos propres règles de dédoublonnage, certaines erreurs peuvent survenir et arrêter le processus.

Par exemple, si vous consultez votre application Salesforce Lightning DQE One, ouvrez l'onglet Runs, et trouvez une exécution en échec comme illustré ci-dessous, vous devrez peut-être redémarrer votre VM.

Processus de données en attente

Parfois, la file d'attente des tâches peut rester bloquée sur le même message et empêcher le traitement des données. Dans cette situation, videz le volume Docker RabbitMQ et rechargez l'application. Cela devrait résoudre le problème dans la plupart des cas.

1. Connectez-vous à votre VM en tant qu'administrateur.

sudo bash

2. Accédez au dépôt où se trouve le fichier docker-compose.yml de DQE et arrêtez Docker Compose.

docker-compose down

3. Trouvez le nom du volume de la file d'attente des messages.

docker volume ls

4. Le nom du volume doit contenir rabbitmq et data, par exemple dqe_rabbitmq_data. Supprimez-le.

docker volume rm <name of the volume>

5. Démarrez Docker Compose.

docker-compose up

Mise à jour du moteur du serveur backend

Vérifiez la version de l'image définie dans le fichier docker-compose.yml.

Si nécessaire, mettez-la à jour. Ensuite :

1. Connectez-vous à votre VM en tant qu'administrateur.

sudo bash

2. Accédez au dépôt où se trouve le fichier docker-compose.yml de DQE et arrêtez Docker Compose.

docker-compose down

3. Exécutez la commande pull suivante.

docker-compose pull

4. Si vos identifiants sont toujours valides, vous recevrez automatiquement le nouveau package. Si ce n'est pas le cas, veuillez créer un ticket de support en envoyant un e-mail à support_dqe@dqe-software.com et demander de nouveaux identifiants. Une fois que vous les avez reçus, exécutez les commandes ci-dessous :

$ sudo docker login **************
Username: <Login provided by DQE>
Password: <Pwd provided by DQE>

5. Démarrez Docker Compose.

docker-compose up