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 en utilisant1 :
docker compose logs becpg-mail
1. La commande ci-dessus affichera les logs du conteneur becpg-mail. ↩
Pour en savoir plus sur les logs, allez sur la documentation officiel
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 virtuels.
Puis utilisez les commandes2 :
sudo reboot
sudo resize2fs /dev/sdb (ou sdb est la partition à redimensionner )
2. fdisk -l permet de lister les partitions ↩
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 indexs
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. > 24h!