Suivi de l’indexation Solr

Page réservée aux super administrateurs.

Rôle de la page

Solr est le moteur d’indexation et de recherche utilisé par Alfresco. L’indexation peut prendre du retard sur le contenu du référentiel, notamment après un import massif de documents, ou s’arrêter. Cette page suit l’état de chaque cœur (core) Solr, compare l’index à la base de données, inspecte un nœud et lance des réindexations ou des sauvegardes.

Elle fonctionne avec Solr 9 et le service d’indexation Pristy (Pristy Indexing Trackers) : le sous-système d’indexation solr9 doit être activé sur le dépôt.

Accéder à la page

Menu Pristy Portail : Portail Administrateur > SOLR Tracking. L’entrée n’apparaît que pour les super administrateurs.

Pages indisponibles

L’entrée reste visible même lorsque le suivi n’est pas disponible. La page indique alors la cause :

  • « Supervision indisponible : ce Pristy Core est trop ancien. Mettez-le à jour pour activer cette page. » : Pristy Core doit être mis à jour,
  • « Supervision indisponible : le sous-système d’indexation solr9 est requis, la recherche utilise actuellement … » : le dépôt utilise un autre sous-système d’indexation (nommé dans le message), et sa configuration doit être modifiée (-Dindex.subsystem.name=solr9).

État des cœurs

Une carte est affichée pour chaque cœur Solr. Elle présente :

  • un verdict, sous forme d’étiquette :
VerdictSignification
À jourle retard d’indexation est inférieur à 1 minute
En retardle retard d’indexation est compris entre 1 et 10 minutes
Décrochéle retard d’indexation dépasse 10 minutes
Arrêtéaucun des trois trackers (métadonnées, ACL, contenu) n’est actif, quel que soit le retard affiché
  • l’état de chaque tracker (« actif » ou « inactif ») et le dernier retard mesuré,
  • les Documents, la Taille de l’index, les Transactions en attente, les Textes en attente d’extraction et les documents supprimés en attente de purge,
  • un avertissement lorsque des erreurs de modèle de contenu bloquent l’indexation du cœur.

Le bouton Rafraîchir recharge les cartes. L’interrupteur Actualisation auto les recharge à intervalle régulier (5, 10, 30 ou 60 secondes), uniquement lorsque l’onglet du navigateur est affiché. Si un rafraîchissement échoue, les dernières valeurs restent affichées avec leur heure de mise à jour.

Diagnostic

Le diagnostic compare l’index à la base de données du dépôt et liste les nœuds dont l’indexation a échoué. Il interroge la base : il n’est pas rafraîchi automatiquement et se lance avec le bouton Lancer le diagnostic.

Sur un dépôt récent (Pristy Core 5.0 ou ultérieur), le diagnostic s’exécute sur le serveur : fermer l’onglet ne l’interrompt pas, tous les administrateurs voient le même diagnostic en cours, et le dernier résultat reste affiché à la réouverture de la page. La progression s’affiche étape par étape (cœur et phase), avec l’utilisateur qui l’a lancé. Le bouton Annuler arrête le diagnostic à la fin du lot en cours ; le résultat précédent est conservé.

Le résultat comporte deux parties :

  • Cohérence de l’index : transactions présentes en base mais absentes de l’index, transactions dupliquées, transactions indexées qui n’existent plus en base, documents en erreur ou non indexés. Seules les anomalies sont affichées par défaut, regroupées par section (« Transactions », « ACL », « Documents ») ; le bouton « Afficher les … indicateurs » affiche le tableau complet. Sans anomalie, la page affiche « Aucune anomalie : l’index est cohérent avec la base de données. ».
  • Nœuds en erreur : les nœuds que le service d’indexation a enregistrés comme ayant échoué, avec les « Nœuds en attente de réparation » et les « Réparations récentes ».

Le bouton Relancer les nœuds en erreur planifie une nouvelle tentative pour ces nœuds, puis relance le diagnostic.

Inspecteur de nœud

L’Inspecteur de nœud indique si un nœud est indexé. Saisissez son DBID, son UUID ou son noderef complet, puis cliquez sur Inspecter. Le verdict est accompagné du cœur qui a répondu et de l’état du nœud en base :

VerdictSignification
Indexéle nœud est indexé à jour
Obsolète dans l’indexla modification la plus récente du nœud n’est pas encore indexée
En erreur d’indexationle nœud a échoué à l’indexation, le service de réparation le retente
Orphelin dans l’indexl’index détient un document pour un nœud supprimé ou inconnu en base
Non vérifiablela comparaison entre l’index et la base n’a pas pu être faite
Volontairement non indexéle service d’indexation a choisi de ne pas indexer le nœud, généralement parce que son type n’appartient à aucun modèle de contenu chargé
Absent de l’indexle nœud existe, mais aucun cœur ne détient de document pour lui
Nœud introuvableaucun nœud ne correspond à la référence saisie

Sauf pour un nœud indexé ou introuvable, le bouton Réindexer ce nœud planifie sa réindexation.

Réindexation

Le bouton Réindexer… ouvre une fenêtre qui planifie une action sur un cœur :

  • Action : « Réindexation » (suppression puis reconstruction) ou « Indexation » (mise en file des nœuds manquants uniquement),
  • Cible : un DBID de nœud, un identifiant de transaction, un identifiant de changeset ACL, un identifiant ACL ou une requête AFTS.

Pour une requête AFTS, cliquez d’abord sur Vérifier le nombre de correspondances. Le nombre affiché (« Au moins … nœud(s) ») est un minimum : les nœuds absents de l’index ne peuvent pas être comptés. Au-delà de 10 000 correspondances, ou si le comptage n’a pas pu être lu, il faut saisir le nom du cœur pour confirmer.

L’action s’exécute en arrière-plan, par lots.

Sauvegarde

Le menu de chaque carte propose Déclencher une sauvegarde de l’index du cœur, après confirmation. Solr écrit un instantané sur le volume de sauvegarde : vérifiez l’espace disponible avant de continuer. La page signale le lancement de la sauvegarde, pas sa fin : le résultat se lit dans les journaux du service d’indexation.


Dernière modification - 5 novembre 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