Préparation du service de recherche distant

Obtenez une vue d'ensemble de la préparation du système de portail pour un service de recherche distant. Vous pouvez fournir ce service à l'aide d'EJB ou de SOAP.

Avant de commencer

Pour SOAP : Si vous utilisez SOAP, tenez compte des points suivantes sur la sécurité et les performances :
1. Sécurité des applications : si vous utilisez SOAP sur un serveur sécurisé, le service SOAP lui-même n'est pas sécurisé.
2. Sécurité Java 2 : si vous utilisez SOAP, vous devez désactiver la sécurité Java 2.
Remarque : La prise en charge de SOAP pour les services de recherche à distance a été dépréciée avec HCL DX Portal version 8.0. EJB est toujours pris en charge.
Pour Enterprise JavaBeans : Si vous utilisez EJB, exécutez les tâches d'administration de la sécurité suivantes :
1. Préparez la sécurité pour un service de recherche distant dans un domaine à connexion unique (SSO).
2. Ajoutez la certification de signataire du serveur de service de recherche distant dans le serveur de recherche de portail. Pour ce faire, procédez comme suit :
  1. Access the WebSphere® Integrated Solutions Console of the portal search server.
  2. Cliquez sur Sécurité > Certificat SSL et gestion des clés > Magasins de clés et certificats > NodeDefaultTrustStore > Certificats de signataire > Extraire d'un port.
    Cluster note : Dans un environnement en cluster, cliquez sur Sécurité > Certificat SSL et gestion des clés > Magasins de clés et certificats > CellDefaultTrustStore > Certificats de signataire > Extraire d'un port.
  3. Entrez l'hôte du serveur du service de recherche distant, son port SOAP et un alias.
  4. Cliquez sur OK.

Procédure

Copiez les fichiers WebScannerSoap.ear, WebScannerEjbEar.ear et PseLibs.zip dans le répertoire AppServer_root/installableApps sur l'ordinateur où vous avez installé le service de recherche distant.
Ces fichiers se trouvent dans les emplacements suivants de votre installation de portail :
- Les fichiers WebScannerSoap.ear et WebScannerEjbEar.ear se trouvent dans le répertoire PortalServer_root/search/prereq.webscanner/installableApps
- Le fichier PseLibs.zip se trouve dans le répertoire PortalServer_root/search/wp.search.libs/installableApps
Selon les besoins de votre environnement, installez l'une des applications WebScannerEJbEar.ear ou WebScannerSoap.ear sur un serveur éloigné. Par exemple, il peut s'agir de server1.
Procédez comme suit :
1. Access the WebSphere® Integrated Solutions Console.
2. Cliquez sur Applications > Applications d'entreprise WebSphere.
3. Cliquez sur Installer.
4. Recherchez et sélectionnez WebScannerEjbEar.ear ou WebScannerSoap.ear, selon que vous utilisez un service EJB ou Web via SOAP.
5. Cliquez sur Suivant.
6. Sur les panneaux suivants, acceptez les paramètres par défaut.
7. Un message confirme que la réussite de l'installation de l'application PSEStandalone (pour EJB) ou de l'application WebScannerEar (pour SOAP).
8. Cliquez sur Sauvegarde dans la configuration maîtresse.
9. Cliquez sur Sauvegarder.
Obligatoire : Cette étape est requise si vous utilisez les services de conversion de documents.
1. Installez les services de conversion de documents distants sur le serveur distant. Vous n'avez pas besoin de déléguer toutes les tâches de conversion d'HCL DX Portal au serveur distant. Il vous suffit d'installer les services de conversion distants.
  Pour plus d'informations, reportez-vous à la rubrique Activation de la conversion de documents distants.
2. Start the WebSphere® Integrated Solutions Console and select Environment > Shared Libraries. Create a new shared library that is named PSE with a class path as follows:
```
     $(APP_INSTALL_ROOT)/cell_name/dcs_war.ear/dcs.war/WEB-INF/lib/convertors.jar
     $(APP_INSTALL_ROOT)/cell_name/dcs_war.ear/dcs.war/WEB-INF/lib/Export.jar
```
  où cell_name est le nom de cellule IBM WebSphere® Application Server où le DCS est installé.
3. Click Apply > Save > Save to save your changes.
Extrayez les bibliothèques de recherche dans le portail sur le serveur éloigné et ajoutez-les dans le chemin de classes sur le serveur éloigné. Pour ce faire, procédez comme suit :
1. Créez un répertoire que vous nommez extract sous le répertoire installableApps.
2. Localisez le fichier PseLibs.zip dans le répertoire installableApps et procédez à l'extraction de sont contenu dans le répertoire extract que vous avez créé à l'étape précédente.
3. Open the WebSphere® Integrated Solutions Console.
4. Cliquez sur Environnement > Bibliothèques partagées.
5. Créez ou modifiez les noms de bibliothèques partagées PSE.
  Lorsque vous créez la bibliothèque, cochez l'option Utilisez un chargeur de classe isolé pour cette bibliothèque partagée.
6. Add the libraries extract/lib to the class path by adding a line to the class path and giving the full path: AppServer_root/installableApps/extract/lib.
  AppServer_root est le répertoire de profil de votre installation WebSphere® Application Server. Par exemple, ce chemin peut être :
```
      /usr/WebSphere/AppServer/profiles/profile_name
```
  Pour z/OS®, ce chemin peut être :
```
     /WebSphere/VR1M0/AppServer/profiles/default
```
7. Click Apply > Save to save your changes to the configuration.
Ajoutez une référence provenant de l'application WebScannerEJbEar.ear à la bibliothèque partagée. Pour ajouter une référence, procédez comme suit :
1. Access the WebSphere® Integrated Solutions Console of the remote server.
2. Accédez à Applications d'entreprise WebSphere.
3. Pour Enterprise JavaBeans : Cliquez sur l'application PSEStandalone > Shared library references. For SOAP: cliquez sur l'application WebScannerEar > Shared library references.
4. Pour Enterprise JavaBeans : Dans la fenêtre qui s'affiche, cochez la case PSEStandalone, puis cliquez sur Reference shared library. For SOAP: Dans la fenêtre qui s'affiche, cochez la case WebScannerEar, puis cliquez sur Reference shared library.
5. Dans la liste Disponible, sélectionnez PSE.
6. Click the appropriate arrow so that PSE displays in the Selected list.
7. Cliquez sur OK > OK.
8. Enregistrez la configuration.
9. Pour Enterprise JavaBeans : Redémarrez l'application PSEStandalone. For SOAP: Redémarrez l'application WebScannerEar.
Sur la console WebSphere® Integrated Solutions Console, déterminez les valeurs requises pour configurer les paramètres de portlet, selon que vous utilisez le service EJB ou Web via SOAP :
- Pour Enterprise JavaBeans : déterminez la valeur du port sous Serveurs > Types de serveurs > Serveurs d'applications WebSphere > YourAppServer1 > Communications > Ports > BOOTSTRAP_ADDRESS.
- Pour SOAP : Déterminez la valeur du numéro de port pour le paramètre d'URL SOAP. Le numéro de port approprié pour le paramètre d'URL SOAP est le port sur lequel le serveur d'application est exécuté, en d'autres termes, le transport HTTP sur lequel le serveur distant est configuré pour fonctionner. Déterminez le numéro de port correct depuis Serveurs d'applications > serveur1 > Ports > WC_defaulthost. La valeur WC_defaulthost est 10014. Par conséquent, si vous n'avez pas modifié la valeur par défaut, vous pouvez utiliser cette valeur. Veillez à ce que le numéro de port défini dans le fichier suivant corresponde à ce port :
```
AppServer_root/installedApps/cell/WebScannerEar.ear/WebScannerSoap.war/
     wsdl/com/ibm/hrl/portlets/WsPSE/WebScannerLiteServerSOAPService.wsdl
```
  Remplacez les variables comme suit :
  - AppServer_root is the profile directory of your WebSphere® Application Server installation. Par exemple, ce répertoire peut être :
```
      /usr/WebSphere/AppServer/profiles/profile_name
```
    Pour z/OS® ce répertoire peut être :
```
     /WebSphere/VR1M0/AppServer/profiles/default
```
  - cell est le nom de cellule de votre poste de recherche à distance.
  - WebScannerEar.ear est le nom que vous avez donné à l'application d'entreprise lorsque vous avez installé le fichier WebScannerSoap.war.
  Modifiez le fichier et cherchez le port indiqué dans la valeur de l'emplacement de l'adresse SOAP. Exemple :
```
  <soap: address location="http://localhost:your_port_no/WebScannerSOAP/servlet/rpcrouter"/> .
```
  Dans l'exemple, le port est your_port_no. The default value for the WC_defaulthost is 10014.
Dans WebSphere® Integrated Solutions Console, rendez-vous sous Ressources > Beans asynchrones > Gestionnaires de travaux, créez un gestionnaire de travaux nommé PSEWorkManager et doté des attributs suivants :
WebSphere Application Server V9 : Si vous avez mis à niveau vers IBM® WebSphere® Application Server version 9.0, le chemin d'accès WebSphere® Integrated Solutions Console est Ressources > Concurrence > Gestionnaires de travaux.
```
   Name:                       PSEWorkManager
   JNDI Name:                  wps/searchIndexWM
   Minimum Number of Threads:  20
   Maximum number of Threads:  60
   Growable =                  True (Ensure that the Growable check box is selected.) 
   Service Names:              Application Profiling Service, WorkArea, Security, Internationalization
```
Click Apply > Save to save your changes to the configuration.
Démarrez l'application :
1. Open the WebSphere® Integrated Solutions Console.
2. Cliquez sur Applications > Types d'application > Applications d'entreprise WebSphere.
3. Scroll to PSEStandalone or WebScannerEar. Vous pouvez utiliser la fonction de filtre pour rechercher ces noms.
4. Click the check box and click Start.
  Un message confirme que l'application a démarré.
Obligatoire : Cette étape n'est requise que si vous travaillez avec EJB sur un serveur sécurisé : Setting the search user ID.
Obligatoire : Cette étape n'est requise que si vous avez désactivé la sécurité ou défini l'ID de l'utilisateur de la recherche, en effectuant l'une des étapes facultatives précédentes : Restart the WebSphere® Application Server.
Sur le serveur de portail, activez la vérification d'identité CSIv2. Pour ce faire, procédez comme suit :
Cluster note : Dans un environnement en cluster, exécutez ces étapes sur la console WebSphere® Integrated Solutions Console du gestionnaire de déploiement.
1. Activez la vérification d'identité CSIv2 dans la connexion sortante :
  1. Access the WebSphere® Integrated Solutions Console of the portal server.
  2. Accédez à Sécurité > Sécurité générale > RMI/IIOP security > CSIv2 outbound communications.
  3. Check Use identity assertion.
  4. Une fois terminé, redémarrez le serveur de portail.
2. Activez la vérification d'identité CSIv2 dans la connexion entrante :
  1. Access the WebSphere® Integrated Solutions Console of the remote server.
  2. Accédez à Sécurité > Sécurité générale > RMI/IIOP security > CSIv2 inbound communications.
  3. Check Use identity assertion.
  4. Sous Identités sécurisées, entrez un astérisque (*) ou l'identité du serveur de portail.
  5. Une fois terminé, redémarrez le serveur distant.
  Pour plus d'informations, reportez-vous au centre de documentation WebSphere® Application Server.
Sur le serveur de portail, configurez HTTPs pour le portlet Seedlist.
Le servlet Seedlist requiert HTTPs par défaut. Ainsi, lorsque vous accédez au servlet via HTTP, WebSphere® Application Server vous redirige vers HTTPs. Procédez comme suit :
1. Ouvrez le fichier suivant dans un éditeur :
  PortalServer_root/search/wp.search.servlets/seedlist/servletEAR/installableApps/wp.search.seedlist.ear/wp.search.servlets.seedlist.war/WEB-INF/web.xml
  Cluster note : Dans un environnement en cluster, exécutez cette étape sur le noeud principal et tous les noeuds secondaires.
2. Mettez à jour le code suivant :
  Cluster note : Dans un environnement en cluster, exécutez cette étape sur le noeud principal et tous les noeuds secondaires.
```
<user-data-constraint>     
     <transport-guarantee>CONFIDENTIAL</transport-guarantee>
</user-data-constraint>
```
  Remplacez-le par le code suivant :
```
<user-data-constraint>     
     <transport-guarantee>NONE</transport-guarantee>
</user-data-constraint>
```
3. Enregistrez le fichier.
  Cluster note : Dans un environnement en cluster, exécutez cette étape sur le noeud principal et tous les noeuds secondaires.
4. Exécutez le script ConfigEngine suivant du portail :
  Cluster note : Dans un environnement en cluster, effectuez cette étape uniquement sur le noeud principal.
```
./ConfigEngine.sh action-update-ear-wp.search.servlets/seedlist/servletEAR
```
5. Redémarrez tous les serveurs de la configuration pour que vos mises à jour soient appliquées.
Sur le portail, configurez Recherche de portail pour le service de recherche distant.
Cluster note : Dans un environnement en cluster, effectuez cette étape uniquement sur le noeud principal.