Administration du serveur

Ce chapitre décrit les tâches d'administration courantes réalisables par l'exploitant de la machine virtuelle. La configuration de l'application, la gestion des comptes de service et les mises à jour de sécurité applicatives restent à la charge de beCPG.

Démarrer et arrêter le service beCPG

Utilisez les commandes :

cd /opt/becpg-srv-instances/inst1
docker compose stop
docker compose up -d

ou :

cd /opt/becpg-srv-instances/inst1
docker compose restart

Si les modules optionnels OLAP ou AI sont installés, utilisez de préférence ./tools/instance.sh restart, qui prend en compte l'ensemble des composants déployés.

Vérifier l'état des services

cd /opt/becpg-srv-instances/inst1
docker compose ps

La colonne STATUS doit indiquer healthy pour les composants qui déclarent un contrôle de santé. Un composant durablement en erreur doit être signalé au support.

Journaux applicatifs serveur

Utilisez les commandes :

cd /opt/becpg-srv-instances/inst1
./tools/instance.sh logs

ou :

cd /opt/becpg-srv-instances/inst1
docker compose logs -f -t --tail="100"

ou affichez les logs d’un conteneur, ici le conteneur becpg-mail :

docker compose logs becpg-mail

Pour en savoir plus sur les logs, allez sur la documentation officielle.

Des logs additionnels sont disponibles dans chaque conteneur dans /var/lib/docker/volumes/*_logs/.

Afficher la consommation mémoire

cd /opt/becpg-srv-instances/inst1
./tools/instance.sh stats

Diagnostiquer l'instance

En cas de lenteur ou de comportement anormal, un diagnostic complet (conteneurs, mémoire, disque, index) peut être produit et transmis au support :

cd /opt/becpg-srv-instances/inst1
./tools/instance.sh diagnose

Afficher l’espace disponible sur le système

df -h
du -ms /var/lib/docker/volumes

Augmenter la partition données

Augmentez le disque dans votre hyperviseur de machines virtuelles.

Puis utilisez les commandes suivantes (fdisk -l liste les partitions) :

sudo reboot
# Remplacez sdb par la partition à redimensionner
sudo resize2fs /dev/sdb

Corriger l'indexation en cas de crash

cd /opt/becpg-srv-instances/inst1
./tools/solr.sh fix

Réindexer en cas de crash du serveur et corruption des index

Faire la réindexation si le fix ne corrige pas le problème.

cd /opt/becpg-srv-instances/inst1
./tools/solr.sh reindex

Attention : la réindexation peut prendre beaucoup de temps (plus de 24 h) !