Pristy Support
pristy-support s’exécute sur le serveur qui héberge Pristy, et non depuis Pristy Portail. Il demande Python 3.9 ou plus, un système Linux avec systemd, et Docker pour les contrôles des conteneurs et l’accès à PostgreSQL.
pristy-support est un outil en ligne de commande qui audite une installation Pristy : état du système et des services, erreurs dans les journaux, statistiques de la base de données, revue des fichiers de configuration et état de l’index Solr. Il produit un rapport Markdown, HTML et une archive ZIP, à joindre à une demande de support.
Le code source est publié sur gitlab.com/pristy-oss/pristy-support.
Installation
L’outil est publié sur PyPI :
pip install pristy-support
L’outil adapte ses contrôles aux droits disponibles. Lancé en root ou avec sudo, il accède à tous les contrôles ; membre du groupe docker, il accède aux conteneurs ; avec un compte standard, certaines informations système manquent.
Lancer un audit complet
sudo pristy-support audit
L’audit enchaîne les contrôles suivants :
| Contrôle | Contenu |
|---|---|
| Système | services systemd, conteneurs Docker et leur ancienneté, mémoire et swap, espace disque, charge, pare-feu |
| Journaux | erreurs, avertissements et messages critiques de chaque service dans journalctl |
| Base de données | nombre de nœuds, propriétés et aspects, utilisateurs internes et externes (SSO/LDAP), groupes, sites, taille des tables |
| Configuration | revue de alfresco-global.properties et des env-config.json des applications Pristy, paramètres manquants |
| Solr | nœuds et transactions indexés, retard d’indexation, nœuds en erreur, état des trackers |
Il écrit dans le répertoire courant pristy_audit_report.md, pristy_audit_report.html et pristy_audit.zip. Les options principales :
--output-dir,-o: répertoire des rapports ;--formats,-f: formats produits, parmimd,htmletzip(par défaut les trois) ;--since,-s: période analysée dans les journaux, par exemple24h,7d(par défaut) ou30d.
sudo pristy-support audit --output-dir /tmp/audit --formats html,zip --since 30d
Lancer un seul contrôle
| Commande | Contrôle |
|---|---|
pristy-support system-check | système, services et conteneurs |
pristy-support logs-check --since 7d | journaux des services |
pristy-support access-logs-check | journaux d’accès du proxy : volume de requêtes, pics, navigateurs, adresses IP et sites les plus actifs |
pristy-support database-check | statistiques de la base de données |
pristy-support solr-check | cœurs alfresco et archive de Solr, et rapport de synchronisation avec la base |
pristy-support config-check | fichiers de configuration |
Interroger la base de données
La commande database-query regroupe des requêtes de diagnostic sur la base Alfresco :
| Commande | Résultat |
|---|---|
list-modules | modules Alfresco installés et leur version |
node-info <uuid|nodeRef|id> | type, store, dates, chemin, aspects et propriétés d’un nœud, par exemple un nœud cité dans une erreur Solr |
audit-tables | applications d’audit, nombre d’entrées, taille et état du vacuum des tables alf_audit_* et alf_prop_* |
table-sizes | tables les plus volumineuses |
locked-nodes | nœuds verrouillés (extraction, session d’édition) |
trash-and-orphans | nœuds en corbeille et contenus orphelins en attente de nettoyage |
largest-documents | fichiers les plus volumineux |
db-activity | requêtes PostgreSQL en cours ou bloquées |
pristy-support database-query node-info workspace://SpacesStore/0d3b2c8e-1f5a-4e2b-9a7c-6b1d2e3f4a5b
Ces requêtes sont en lecture seule, à l’exception de drop-module, qui supprime de la base l’enregistrement d’un module Alfresco après confirmation.
drop-module modifie la base de données. Faites une sauvegarde de la base avant de l’utiliser.
Configuration
Les valeurs par défaut correspondent à une installation Pristy standard (/opt/alfresco/tomcat/shared/classes/alfresco-global.properties, /opt/pristy-*/public/env-config.json, base dans le conteneur postgres). Pour les adapter, générez un fichier de configuration :
pristy-support init-config
Le fichier pristy-support.yml est cherché, dans l’ordre, dans le répertoire courant, dans ~/.pristy-support.yml, dans ~/.config/pristy-support/config.yml puis dans /etc/pristy/pristy-support.yml. L’option --config désigne un autre fichier :
pristy-support --config /etc/pristy/pristy-support.yml audit
Il permet notamment de régler les services et conteneurs surveillés, les seuils de mémoire et de disque, la connexion à la base, les chemins des fichiers de configuration et la source des journaux d’accès. La section web_publish publie en plus chaque rapport HTML dans un répertoire servi par le serveur web (/var/www/html/pristy-support par défaut), en conservant les dix derniers.
Mode debug
L’option --debug affiche chaque commande lancée par l’outil (systemctl, journalctl, docker, requêtes SQL) et son résultat :
sudo pristy-support --debug audit
Dernière modification - 20 octobre 2026