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ôleContenu
Systèmeservices systemd, conteneurs Docker et leur ancienneté, mémoire et swap, espace disque, charge, pare-feu
Journauxerreurs, avertissements et messages critiques de chaque service dans journalctl
Base de donnéesnombre de nœuds, propriétés et aspects, utilisateurs internes et externes (SSO/LDAP), groupes, sites, taille des tables
Configurationrevue de alfresco-global.properties et des env-config.json des applications Pristy, paramètres manquants
Solrnœ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, parmi md, html et zip (par défaut les trois) ;
  • --since, -s : période analysée dans les journaux, par exemple 24h, 7d (par défaut) ou 30d.
sudo pristy-support audit --output-dir /tmp/audit --formats html,zip --since 30d

Lancer un seul contrôle

CommandeContrôle
pristy-support system-checksystème, services et conteneurs
pristy-support logs-check --since 7djournaux des services
pristy-support access-logs-checkjournaux d’accès du proxy : volume de requêtes, pics, navigateurs, adresses IP et sites les plus actifs
pristy-support database-checkstatistiques de la base de données
pristy-support solr-checkcœurs alfresco et archive de Solr, et rapport de synchronisation avec la base
pristy-support config-checkfichiers de configuration

Interroger la base de données

La commande database-query regroupe des requêtes de diagnostic sur la base Alfresco :

CommandeRésultat
list-modulesmodules 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-tablesapplications d’audit, nombre d’entrées, taille et état du vacuum des tables alf_audit_* et alf_prop_*
table-sizestables les plus volumineuses
locked-nodesnœuds verrouillés (extraction, session d’édition)
trash-and-orphansnœuds en corbeille et contenus orphelins en attente de nettoyage
largest-documentsfichiers les plus volumineux
db-activityrequê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
Appel à l’action

Essayer Pristy

Vous pouvez essayer la démo de Pristy en vous inscrivant au lien ci-dessous.

Demander une démo