Appel du fichier de l'utilitaire pour configurer les adaptateurs de recherche

Intégration de plusieurs moteurs de recherches à l'aide de la recherche fédérée › Configuration de la recherche fédérée › Génération des fichiers de configuration XML pour la recherche fédérée › Appel du fichier de l'utilitaire pour configurer les adaptateurs de recherche

Appel du fichier de l'utilitaire pour configurer les adaptateurs de recherche

Un moteur de recherche nécessite des adaptateurs de plug-in spécialement codés. Un plug-in Adaptateur de recherche traduit les demandes de recherche génériques au format propriétaire d'un moteur de recherche, appelle ce moteur et renvoie des demandes de recherche.

Remarque : Si CA SDM est configuré pour l'hébergement multiclient, le client hébergé est transmis au moteur de recherche. La recherche fédérée inclut une prise en charge intégrée pour l'hébergement multiclient. Vous pouvez l'utiliser pour isoler les données par client hébergé dans une mise en oeuvre SharePoint unique.

Important : Les espaces et les esperluettes ne sont pas admis dans les valeurs du fichier de propriétés adapters.properties.

Chiffrez des mots de passe pour les adaptateurs de recherche à l'aide de l'utilitaire de chiffrement de mots de passe. Pour ce faire, accédez au répertoire CA SDM suivant :
```
$NXROOT\bin
```
Pour générer des mots de passe chiffrés, exécutez la commande suivante :
```
encrypt_pwd [-e] <mot_passe_moteur_recherche>
```
L'option par défaut est -e.
Ouvrez le fichier adapters.properties qui se trouve dans le répertoire CA SDM suivant :
```
$NX_ROOT\samples\cafedsearch
```
Modifiez le fichier adapters.properties. Définissez les paramètres des adaptateurs à configurer.
Pour SharePoint, mettez à jour les valeurs suivantes dans le fichier adapters.properties :

sharepoint_username=

Entrez le nom d'utilisateur pour l'accès SharePoint.

sharepoint_password=

Entrez le mot de passe chiffré pour l'accès SharePoint comme indiqué à l'étape 1.

sharepoint_hostname=

Entrez le nom d'hôte.

sharepoint_domainName=

Entrez le nom de domaine.

sharepoint_protocol=

Entrez le protocole de communication (http ou https).

sharepoint_portNumber=

Entrez le numéro de port. La valeur par défaut est 80.
Pour Google, mettez à jour les valeurs suivantes dans le fichier adapters.properties :

google_googleCx=

Entrez la valeur de clé unique dont se sert Google pour choisir le compte de recherche personnalisée Google à utiliser.

google_googleApiKey=

Entrez la valeur de clé unique dont se sert Google pour déterminer l'identité d'une application. Pour récupérer la clé dans la console des API, activez l'API de recherche personnalisée JSON/Atom. Cette API fournit une nouvelle clé d'API pour l'accès aux API simples.
Pour CA Open Space, mettez à jour les valeurs suivantes dans le fichier adapters.properties :

openspace_protocol=

Entrez le protocole de communication (http ou https).

openspace_portNumber=

Entrez le numéro de port de CA Open Space. La valeur par défaut est 8686.

openspace_default_tenant_userName=

Si l'hébergement multiclient n'est pas configuré pour CA SDM, entrez un nom d'utilisateur pour effectuer une recherche dans CA Open Space.

openspace_default_tenant_password=

Entrez le mot de passe chiffré de CA Open Space. Pour de plus amples renseignements, reportez-vous à l'étape 1.

openspace_default_tenant_companyHost=

Entrez les détails de l'hôte de l'entreprise du client hébergé.
1. En cas d'hébergement multiclient CA SDM, ajoutez une entrée pour chaque client hébergé dans le fichier openspace-tmpl.xml :
  Par exemple, si CA SDM contient le nom de client hébergé Client_hébergé1, vous devez indiquer les valeurs suivantes dans le fichier openspace-tmpl.xml :
```
<entry key="Tenant1"> 
```
```
 <bean class="com.ca.ServicePlus.cafedsearch.adapters.openspace.OpenSpaceCompanyDetail">
```
```
  <property name="nom_utilisateur" value="$(openspace_tenant1_userName)"/>
```
```
   <property name="mot_passe" value="$(openspace_tenant1_password)"/>
```
```
  <property name="hôte_entreprise" value="$(openspace_tenant1_companyHost)"/>
```
```
  </bean>
```
```
</entry>
```
2. Ajoutez les entrées suivantes pour Client_hébergé1 dans le fichier adapters.properties :
```
openspace_tenant1_userName=
```
```
openspace_tenant1_password=
```
```
openspace_tenant1_companyHost=
```
  Répétez les étapes a et b pour tous les clients hébergés requis dans le fichier openspace-tmpl.xml.
Appelez fs_adapters_cli une fois pour chaque adaptateur à configurer.
- Pour configurer un adaptateur CA Open Space, utilisez la valeur de bean pour OpenSpaceSearchAdapter et le modèle pour le fichier openspace-tmpl.xml, comme l'illustre l'exemple suivant :
```
fs_adapters_cli -i -k OpenSpace -b OpenSpaceSearchAdapter -t "openspace-tmpl.xml" -o "openspace.xml"
```
- Pour configurer un adaptateur Google, indiquez la valeur de bean pour GoogleSearchAdapter et le modèle pour google-tmpl.xml, comme l'illustre l'exemple suivant :
```
fs_adapters_cli -i -k Google -b GoogleSearchAdapter -t "google-tmpl.xml" -o "google.xml"
```
- Pour configurer un adaptateur SharePoint, utilisez la valeur de bean pour SharePointSearchAdapter et le modèle pour le fichier sharepoint-tmpl.xml, comme l'illustre l'exemple suivant :
```
fs_adapters_cli -i -k SharePoint -b SharePointSearchAdapter -t "sharepoint-tmpl.xml" -o "sharepoint.xml"
```
Remplacez les valeurs d'attribut -k et -o par le nom de votre choix. Pour de plus amples renseignements sur le fichier de l'utilitaire de recherche fédérée et sur ses attributs, reportez-vous à la rubrique Fichiers de l'utilitaire de recherche fédérée.
En cas d'erreurs au terme de l'installation, vérifiez le fichier journal dans le répertoire CA SDM :
```
$NXROOT\log\jfedsearch.log
```
Vous pouvez également créer votre propre fichier XML d'enregistrement. Toutes les entrées de l'adaptateur sont enregistrées dans le fichier adapters-config.xml qui se trouve dans le répertoire suivant :
```
$NX_ROOT\samples\cafedsearch
```
Pour créer votre propre fichier XML d'enregistrement, vous pouvez également faire une copie du fichier adapters-config.xml existant (étape facultative). Attribuez un nom au fichier adapters-config.xml modifié. Vous pouvez, par exemple, le nomme xyz.xml.
Utilisez l'option -c avec le fichier XML modifié (xyz.xml) pour enregistrer les adaptateurs.
Modifiez la valeur de la ressource dans bean.xml <import resource="adapters-config.xml"/>.
Copiez le fichier adapters-config.xml ou le fichier modifié xyz.xml (étape 11) et tous les fichiers XML associés propres à l'adaptateur pour Google (google.xml), CA Open Space (openspace.xml), SharePoint (sharepoint.xml) dans le répertoire CA SDM suivant :
```
$NX_ROOT/bopcfg/www/CATALINA_BASE_FS/webapps/cafedsearch/WEB-INF/
```
Redémarrez l'instance de serveur Tomcat de recherche fédérée :
```
pdm_tomcat_nxd -c STOP -t FS
```
```
pdm_tomcat_nxd -c START -t FS
```
Les adaptateurs de recherche fédérée sont configurés.
Vérifiez les fichiers d'erreurs situés dans le répertoire CA SDM :
```
$NX_ROOT\log\jrest.log
```