| Info |
|---|
Dans un offre Saas/Cloud, le Power Search est déjà installé et opérationnel |
SOMMAIRE
| Sommaire | ||
|---|---|---|
|
Préambule à l'installation du Power Search
...
Si le serveur de base de données est déjà fortement sollicité ou si la recherche et la production de nouveaux documents constituent une activité importante de l'entreprise, on privilégiera un serveur indépendant pour la base Search.
Plusieurs serveurs Search peuvent être hébergés sur un même serveur Windows, par exemple si l'on souhaite physiquement séparer les bases pour un serveur en mode ASP ou pour une application sensible comme la paie.
L'installation d'un service Search peut s'effectuer à l'aide d'un assistant présent dans le programme 'Harmony.dhop'
Avant d'exécuter ce programme, vous devez avoir sélectionné l'environnement (soit en utilisant l'icone Divalto depuis la traybar soit en exécutant l'utilitaire 'xDivaltoSelectEnv.exe')
L'environnement déterminera automatiquement un certain nombre de paramètres
L'assistant est disponible sur le menu « Administration » : 'Installation Power Search Serveur'
...
Installation du Power Search - composant SERVEUR
Le programme xSearchInstall.dhop, également accessible à partir du choix « Administration » du menu Harmony permet d'installer un serveur Search.
Il crée :
...
L'installateur pose les questions suivantes (les réponses sont pré-garnies avec des valeurs standard) :
Répertoire source :
Emplacement (Windows) du dossier objets\search livré en standard avec chaque version de l'ERP Infinity
Paramètres éditeur
Il s'agit du chemin d'un répertoire source contenant un modèle du fichier de paramétrage du serveur (Search_param.xml), ainsi que les dictionnaires décrivant les documents. Divalto fournit ces fichiers dans le répertoire /divalto/objets/Search (après l'installation de l'ERP sur un serveur). Remarque : L'environnement dans lequel s'effectue l'installation du produit est pris en compte, en particulier pour positionner le paramètre <UsersPath> (qui détermine la base de données ERP qui servira à alimenter la base de données Search) du fichier paramètre search_param.xml. Le mot clé ##cheminxlog## du fichier modèle est remplacé par le chemin du serveur xlog de l'environnement courant.
...
Il s'agit du répertoire de destination où sont stockés tous les fichiers paramètres du serveur Search (fichiers XML). Le chemin de ce répertoire est passé en paramètre au service DhsSearchServer. S'il y a plusieurs services Divalto Power Search hébergés sur le même serveur, chacun aura son propre répertoire de paramètres.
...
Pour créer les documents dans la base Search, Divalto Power Search accède aux tables de l'ERP au travers de RecordSQL. Des dictionnaires de RecordSQL spécifiques au Search sont fournis par Divalto avec les objets standards de l'ERP.
Si vous êtes amenés à personnaliser ces dictionnaires afin d'ajouter des informations complémentaires dans les documents existants, il faudra indiquer le répertoire des dictionnaires de surcharge. Si vous avez vos propres dictionnaires, vous pouvez également les stocker dans le répertoire de surcharge.
Chemin des objets :
* Base : Dossier qui contient les objets standards de l'ERP
* Surcharge : Dossier qui contient les surcharges de l'ERP
Suffixe du nom du service DhsSearchServer
...
Chemin des paramètres :
Les chemins sont conservés dans le fichier Search_Param.xml situé dans le répertoire des paramètres du serveur. Il s'agit de chemins Windows qui doivent être accessibles depuis le serveur Search par le service DhsSearchServer. On s'assurera que ce service puisse accéder et possède les droits d'accès à ces répertoires, en particulier lorsque le serveur Search est dédié.
Paramètres éditeur :
/divalto/objets/Search/Search_param.xml
Lorsque le processus d'installation est terminé, le service sera automatiquement démarré
Vous pouvez ajuster les paramètres du service si nécessaire
L'identité du compte de service doit avoir accès en lecture aux fichiers joints ainsi qu'à la base de données SQL
Le service Search doit être déclaré dans la table des serveurs
Cette opération doit s'effectuer sur les serveurs d'applications pour permettre aux utilisateurs d'accéder au service
Le port utilisé lors de l'installation devra correspondre à celui indiqué dans la table
<NAME>search_testing<ADDRESS>10.127.13.35<SQLPATH><COMMENT>testing<TYPE>SEARCH<OS>WINDOWS<PORT>58174
Le service doit être défini dans les paramètres de l'environnement puis diffusé aux utilisateurs
Le nom du service tel que défini dans la table des serveurs devra correspondre au nom qui sera utilisé comme paramètre d'environnement
On s'assurera aussi que le serveur Search ait accès aux répertoires des pièces jointes.
Fichier Search_Param.xml
| Info |
|---|
Le schéma des fichiers XML est visible dans les fichiers XSD présents sur le master dans le dossier Harmony\Search\xsd |
Ce fichier, situé dans le répertoire des paramètres du serveur, contient :
...
des balises principales et complémentaires
Balises principales | Usage | Détails |
|---|---|---|
<Directory> | Répertoire de la base search | indique le dossier windows de la base Search |
...
<IndexExistingDocument> |
...
Stratégie générale de ré-indexation des documents existants dans la base Search |
...
...
Chaque document est identifié par un code unique. Ce code fait le lien avec la base de données de l'ERP. Lors de l'indexation d'un document qui existe déjà dans la base Search, quatre stratégies sont possibles :
Cette stratégie générale peut être adaptée pour chaque document particulier. |
...
<Dictionary> | Liste des dictionnaires de documents |
...
Les balises Dictionnary permettent d'indiquer la liste des dictionnaires de documents gérés par le serveur. Les dictionnaires eux-mêmes doivent être dans le répertoire des paramètres du serveur. Les dictionnaires spécifiques peuvent être ajouté en plus des dictionnaires standard fournis par Divalto. |
...
Exemple
...
<RecordSQLPath> <RecordSQLOverwritePath> | Le chemin des RecordSQL |
...
...
Pour créer les documents dans la base Search, Divalto Power Search accède aux tables de l'ERP au travers de RecordSQL. Des dictionnaires de RecordSQL spécifiques au Search sont fournis par Divalto avec les objets standards de l'ERP. |
<User> |
...
Code utilisateur utilisé pour indexation de la base ERP | Pour indexer un document, le serveur Search accède à la base de données de l'ERP (par la lecture des RecordSQL provenant de la description des documents). Le code utilisateur indiqué ici détermine :
|
...
L'option de journalisation des actions du serveur.
Logging
Lorsque cette option est active, le serveur Search journalise toutes les opérations d'indexation qu'il effectue. La journalisation est intéressante en phase de démarrage ou d'ajout de nouveaux documents. Elle permet également de « surveiller » l'indexation en mode « presque temps réel ».
Le journal peut être lu par la console d'administration d'Harmony (Xconsole.dhop). Il se trouve dans le répertoire du fichier des paramètres du serveur Search. Le journal permet également de connaître le temps nécessaire à l'indexation des documents
Balise <UsersPath> du fichier Search_param.xml
...
| ||
UsersPath | Serveur ou chemin du fichier utilisateurs | Cette balise permet d'indiquer un serveur ou un chemin du fichier des utilisateurs Xlogf (des utilisateurs et donc des implicitesSQL.xml) Attention : L'utilisateur déclaré par la balise <User> doit |
...
toujours être déclaré sur le serveur Search lui-même dans /divalto/sys/xlogf.dhfi. |
Balise <User> du fichier Search_param.xml
User indique le code utilisateur qu'utilise le moteur d'indexation pour accéder à la base ERP.
Ce sont les chemins implicites de cet utilisateur qui déterminent la base de données ERP à laquelle le moteur d'indexation accède.
Balise <Logging> du fichier Search_param.xml
...
<Logging> | Option de journalisation | Lorsque cette option est active, le serveur Search journalise toutes les opérations d'indexation |
...
qu'il effectue. La journalisation est intéressante en phase de démarrage ou d'ajout de nouveaux documents. |
...
Elle permet également de |
...
« surveiller » l'indexation en mode |
...
« presque temps |
...
réel ». |
...
Le journal permet également de connaître le temps nécessaire à l'indexation des documents. Plusieurs niveaux de journalisation existent : None (false), Critical, Error, Information (true), Debug, Trace. |
Balises complémentaires
Exclure un document dans un dictionnaire
<Excluded>
Pour chaque dictionnaire, des documents ou des familles de documents peuvent être exclus.
Exemple
| Bloc de code |
|---|
<Dictionary Name="Dico_Document_DAV" >
<Excluded Document="avoir_client" />
</Dictionary>
<Dictionary Name="Dico_Document_DRT" /> |
Service DhsSearchServer
L'installateur crée puis démarre le service Windows Divalto DhsSearchServer.
...
Dans cet exemple, il faut exécuter la commande :
sc delete DhsSearchServer_aaaa.
Désinstallation du serveur Search
Le choix Paramétrage : Désinstallation Power Search Serveur du menu Harmony permet de désinstaller une instance d'un serveur Search (utilitaire xSearchUninstall.dhop).
La désinstallation consiste à supprimer le service DhsSearchServer et les informations qui le concernent dans la base de registre.
Choix de l'analyseur LUCENE
...
Exemple :
<Analyzer Dll="Lucene.Net.dll" AnalyzerName="StandardAnalyzer" NameSpace="Lucene.Net.Analysis.Standard" Version="LUCENE_CURRENT" />
Remarque :
Si vous changez d'analyseur, il faut impérativement refaire l'indexation de toute la base. Le même analyseur est utilisé pour le découpage des mots lors de l'indexation et lors de la recherche.
Désinstallation du serveur Search
Le choix Paramétrage : Désinstallation Power Search Serveur du menu Harmony permet de désinstaller une instance d'un serveur Search (utilitaire xSearchUninstall.dhop).
La désinstallation consiste à supprimer le service DhsSearchServer et les informations qui le concernent dans la base de registre.
Installation Search - composant CLIENT
Deux paramétrages sont nécessaires sur le poste client pour pouvoir accéder au serveur Search :
La déclaration du serveur Search dans la table des serveurs
L'ajout du nom du serveur Search dans l'environnement de l'utilisateur
Ces opérations sont également nécessaires sur le serveur afin de pouvoir utiliser la console d'administration Search sur le serveur lui-même.
Remarque : Le serveur Search est créé dans la table des serveurs par l'installation de l'ERP Divalto.
Table des serveurs Search
Harmony / Paramétrage / Serveurs
...
Si le nom du serveur correspond à son nom Netbios, l'adresse IP est facultative.
Si un serveur héberge plusieurs serveurs Search, il faut créer autant d'entrées dans la table qu'il y a de serveurs (chacun avec son numéro de port dédié). Dans ce cas, il faudra indiquer l'adresse IP du serveur car chaque serveur doit porter un nom différent dans la table.
Environnement utilisateur
Harmony / Paramétrage / gestion des Environnements
Le nom du serveur Search est un paramètre de l'environnement de l'utilisateur.
...
Le paramètre « Serveur Search » de l'environnement de l'utilisateur indique le nom du serveur Search à utiliser. Lorsque ce paramètre est présent dans l'environnement, le menu Divalto et la toolbar des Zooms offrent l'accès à la recherche.
Les boutons « Propager » et « Exporter dans un fichier » permettent de diffuser les environnements vers tous les postes clients.