Console d'administration Power search (xSearchConsole)

SOMMAIRE

Généralités

La console Search contient toutes les informations sur l'état du mécanisme d'indexation Power Search de votre environnement.

Vous obtiendrez des statistiques détaillées sur les opérations en cours ainsi que le niveau d'indexation de chaque élément.
Si vous souhaitez agir sur l'indexation, le menu « Actions » offre la possibilité d'indexer un dictionnaire particulier ou encore de tout indexer après avoir réinitialisé la base.

Connexion à la console du serveur Search(xSearchConsole)

En mode Saas, la console est directement accessible depuis le menu Administration / Paramètres / Cloud / Console search

image-20240906-084708.png

En mode OnPremise, ou en Saas, la console peut être appelée depuis la fenêtre de connexion en indiquant le programme à exécuter : xsearchconsole.dhop

En mode OnPremise, la console peut aussi être appelée depuis Harmony / Administration / Console search

Console d'administration du serveur Search

La console permet d'administrer un serveur Search, elle se connecte en mode client/serveur au serveur Search.
Elle permet notamment d'indexer l'ensemble des documents existants après l'installation d'un nouveau serveur.
Le menu "Action" est contextuel. Les choix de ce menu dépendent du choix "Affichage" en cours.

La file d'attente des actions
Les actions d'indexation ne sont pas directement exécutées par la console elle-même, mais sont mises dans une file d'attente du serveur. Elles sont ensuite exécutées au fil de l'eau par le moteur Search. Ceci permet de « lancer » plusieurs actions à la suite sans être obligé d'attendre qu'elles soient effectivement réalisées. Le choix « indexations » affiche la file d'attente des actions en cours.

Choix du serveur
Le bouton "Serveur" de la toolbar permet de choisir le serveur que l'on souhaite administrer.

Relire les paramètres
Le serveur Search garde les paramètres du fichier Search_Param.xml ainsi que les RecordSQL associés aux documents en cache. Toute modification des paramètres ou recompilation d'un dictionnaire de RecordSQL du Search nécessitent obligatoirement la relecture des paramètres d'indexation pour être prises en compte.
Cette action est placée en tête dans la file d'attente, mais s'il y a, par exemple, une indexation en cours celle-ci ne sera pas affectée par les modifications de paramètres.
Les paramètres <User> et <UsersPath> ne sont pas pris en compte. En cas de changement de l'un de ces paramètres, il convient de redémarrer le service DhsSearchServer.

Journaux

Les boutons ”Journalisation”, ”Effacer le journal”, ”Journal” et ”Stats Serveur” permettent d’inter-agir avec le système de journalisation. La modification du niveau de journalisation par l’intermédiaire du bouton ”Journalisation” n’est pas permanente. En cas de redémarrage ou de relecture des paramètres, celui-ci sera repositionné au niveau indiqué dans les paramètres.

Indexations périodiques
Voir l'explication détaillée des indexations périodiques.

Privilèges liés à la console Search

L'utilisation de la console est soumise à des privilèges utilisateur. Il existe 3 niveaux de privilèges :

  • La consultation seule ne nécessite pas de droits particuliers.

  • L'indexation des documents et la gestion des connexions au serveur nécessitent le droit HS1.

  • La suppression des index (en particulier l'effacement de tous les index pour une ré-indexation totale) nécessite le droit HS2 ou HCO.

  • La modification du niveau de journalisation, la suppression des journaux et la consultation des journaux nécessitent le droit HCO.

Ces droits sont attribués au niveau des codes confidentialité de l’utilisateur

Affichage

Le choix "Affichage" du menu propose

  • Afficher l'état général du serveur

  • Afficher les connexions en cours

  • Afficher la liste des documents

  • Afficher les indexations en cours

  • Afficher les traitements périodiques à venir

  • Tester les différents analyseurs. Voir dans le chapitre Installation Power Search

Gestion des connexions


La gestion des connexion peut être mise en oeuvre lors d'opérations de maintenance du serveur Search.
Le menu "Actions" des choix d'affichage du "Serveur" ou des "Connexions" propose les choix suivants :
Fermer toutes les connexions.
Ce choix provoque la déconnexion de toutes les connexions des postes client du Search (sauf celle de la console à partir de laquelle la demande a été effectuée)
Fermer la connexion.
L'affichage des connexions affiche toutes les connexions en cours vers le serveur Search dans un tableau. Le choix "fermer les connexions" déconnecte toutes les connexions sélectionnées dans le tableau (par défaut la ligne courante).
Interdire les connexions.
Les client ne peuvent plus se connecter au serveur Search. Par exemple si l'on indexe un document et que l'on ne souhaite pas que les utilisateurs n'aient accès qu'à un résultat partiel lors d'une recherche.
Autoriser les connexions.
Les client peuvent à nouveau se connecter au serveur Search.

Indexations

Le menu "Action" du choix d'affichage des serveurs propose les choix suivants :
Suspendre les indexations
Permet de suspendre temporairement les indexations. L'indexation en cours d'exécution n'est pas suspendue.
Reprendre les indexations
Reprend les indexations en attente dans la file d'attente.
Relire le fichiers paramètre d'indexation
Afin qu'une modification du fichier paramètre ou une nouvelle version d'un dictionnaire RecordSQL soit prise en compte par Divalto Power Search, il convient de relire le fichier paramètres.
Attention : Le changement du code utilisateur <User> ou le chemin du fichier des utilisateurs <UsersPath> n'est pas pris en compte par ce choix. Pour la prise en compte d'une modification d'un de ces deux paramètres, il convient de redémarrer le service DhSearchServer.
Suspendre les indexations périodiques
Permet de suspendre temporairement les indexations périodiques.
Reprendre les indexations périodiques
Permet de reprendre les indexations périodiques.
Relire de fichiers paramètre des indexations périodiques
Indexer tout
Indexe l'ensemble des documents. Ce choix n'efface pas les documents existants, il applique la stratégie d'indexation définie dans les paramètres généraux ou ceux liés à chaque document.
L'indexation de documents est également accessible à partir de l'affichage des documents.
Effacer tout et indexer
Supprime l'ensemble des index, puis indexe tous les documents. Ce choix est soumis au privilège le plus élevé. En effet cette opération peut durer un certain temps.
Remettre à zéro les compteurs
Met à zéro les compteurs statistiques.
Limiter le nombre de documents à indexer
Ce choix est particulièrement intéressant en phase de paramétrage d'un nouveau document ou de modification de paramètres de documents existants. En effet si la base ERP contient du volume, l'indexation complète d'un document peut durer un certain temps. Limiter le nombre de document à indexer permet de vérifier que le paramétrage est correct sur un échantillon avant de lancer l'indexation complète de tous les documents.
Ce choix peut également permettre par extrapolation une estimation du temps nécessaire à l'indexation d'un document.

Gestion des documents

Le choix "Documents" du menu "Affichage" affiche le liste des documents de la base Search.
Le nombre de document du tableau correspond au nombre effectif de documents indexés dans la base Search pour chaque document.
Les boutons de la toolbar ou bien les choix du popup menu affichés après un clic-droit sur une des lignes du tableau permettent de :

  • Indexer un document

  • Indexer tous les documents d'un dictionnaire

  • Supprimer les index d'un document