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

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

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

Un moteur de recherche requiert des adaptateurs de module d'extension spécialement codés. Un adaptateur de recherche de module d'extension convertit des demandes de recherche générique au format propriétaire du moteur de recherche, appelle le moteur de recherche et renvoie les demandes de recherche.

Remarque : Si CA SDM est configuré pour l'hébergement multiclient, le client hébergé sera transmis au moteur de recherche. La recherche fédérée dispose de la prise en charge intégrée pour l'hébergement multiclient. Vous pouvez l'utiliser pour isoler des données d'un client hébergé dans une implémentation SharePoint unique.

Important : N'utilisez pas d'esperluettes ni d'espaces dans les valeurs du fichier adapters.properties.

Procédez comme suit:

Chiffrez des mots de passe pour les adaptateurs de recherche à l'aide de l'utilitaire de chiffrement de mots de passe. Pour chiffrer des mots de passe, 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 disponible dans le répertoire CA SDM suivant :
```
$NX_ROOT\samples\cafedsearch
```
Modifiez le fichier adapters.properties. Spécifiez les paramètres appropriés pour les adaptateurs que vous voulez 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=

Saisissez le nom du domaine.

sharepoint_protocol=

Entrez le protocole de communication (http ou https).

sharepoint_portNumber=

Indiquez 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=

Saisissez une clé unique que Google utilise pour sélectionner le compte de recherche personnalisée de Google à utiliser.

google_googleApiKey=

Entrez la valeur de clé unique qui permet à Google de déterminer l'identité d'une application. Pour récupérer la clé dans la console d'API, activez l'API de recherche personnalisée JSON/Atom. Cette API fournit une nouvelle clé d'API pour l'accès à l'API simple.
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 pour CA Open Space. La valeur par défaut est 8686.

openspace_default_tenant_userName=

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

openspace_default_tenant_password=

Saisissez le mot de passe chiffré de CA Open Space. Pour plus d'informations, reportez-vous à Step1.

openspace_default_tenant_companyHost=

Saisissez les détails de l'hôte de la société de 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é comme client hébergé 1, vous devez fournir les valeurs suivantes dans le fichier openspace-tmpl.xml :
```
<entry key="Tenant1"> 
```
```
 <bean class="com.ca.ServicePlus.cafedsearch.adapters.openspace.OpenSpaceCompanyDetail">
```
```
  <property name="userName" value="$(openspace_tenant1_userName)"/>
```
```
   <property name="password" value="$(openspace_tenant1_password)"/>
```
```
  <property name="companyHost" value="$(openspace_tenant1_companyHost)"/>
```
```
  </bean>
```
```
</entry>
```
2. Ajoutez les entrées suivantes pour le 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 que vous voulez configurer.
- Si vous voulez configurer un adaptateur CA Open Space, utilisez la valeur OpenSpaceSearchAdapter pour le bean et openspace-tmpl.xml pour le modèle comme illustré dans 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 GoogleSearchAdapter pour le bean et google-tmpl.xml pour le modèle comme illustré dans l'exemple suivant :
```
fs_adapters_cli -i -k Google -b GoogleSearchAdapter -t "google-tmpl.xml" -o "google.xml"
```
- Si vous voulez configurer un adaptateur SharePoint, utilisez la valeur SharePointSearchAdapter pour le bean et sharepoint-tmpl.xml pour le modèle comme illustré dans 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 nom de votre choix. Pour plus d'informations sur le fichier d'utilitaire pour la recherche fédérée et les attributs, reportez-vous à la section Fichiers d'utilitaire pour la recherche fédérée.
A l'issue de l'installation, en cas d'erreurs, consultez le fichier journal figurant dans le répertoire CA SDM :
```
$NXROOT\log\jfedsearch.log
```
Vous pouvez également créer votre propre fichier XML pour l'enregistrement. Toutes les entrées d'adaptateur sont enregistrées dans le fichier adapters-config.xml situé dans le répertoire suivant :
```
$NX_ROOT\samples\cafedsearch
```
Pour créer votre fichier XML pour l'enregistrement, vous pouvez également effectuer une copie du nom du fichier adapters-config.xml existant (étape facultative). Attribuez un nom au fichier adapters-config.xml modifié. Par exemple : fichier xyz.xml.
Utilisez l'option -c avec le fichier XML modifié (xyz.xml) pour enregistrer des adaptateurs.
Changez la valeur resource dans bean.xml <import resource="adapters-config.xml"/>.
Copiez adapters-config.xml ou le fichier xyz.xml modifié (étape 11) et tout fichier XML associé spécifique à 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 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 journaux d'erreurs dans le répertoire CA SDM :
```
$NX_ROOT\log\jfedsearch.log
```