Installation du service de recherche à distance à l'aide d'étapes manuelles

Vous pouvez installer un service de recherche distant à l'aide d'étapes manuelles plutôt qu'avec IBM Installation Manager.

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 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.
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. Accédez à la console WebSphere® Integrated Server Console sur le serveur de recherche du portail.
  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 le nom d'hôte de serveur du service de recherche distant, son port HTTPS et un alias.
  4. Cliquez sur OK.

Procédure

Copiez PseLibs.zip et en fonction des besoins spécifiques à votre environnement, copiez l'un des deux fichiers suivants : WebScannerSoap.ear ou WebScannerEjbEar.ear dans le répertoire AppServer_root/installableApps.
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/prereq/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 deux applications suivantes : WebScannerEJbEar.ear ou WebScannerSoap.ear sur un serveur distant.
Par exemple, le serveur distant peut être server1. Procédez comme suit :
1. Accédez à la console 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.
2. Démarrez la console WebSphere® Integrated Solutions Console et sélectionnez Environnement > Bibliothèques partagées. Créez une nouvelle bibliothèque partagée appelée PSE, avec le chemin de classes suivant :
```
$(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
$(APP_INSTALL_ROOT)/cell_name/dcs_war.ear/dcs.war/WEB-INF/lib/commons-fileupload.jar
```
  , où cell_name est le nom de cellule WebSphere® Application Server où le DCS est installé.
3. Pour enregistrer vos modifications, cliquez sur Appliquer > Sauvegarder > Sauvegarder.
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 dans le répertoire installableApps.
2. Localisez le fichier PseLibs.zip dans le répertoire installableApps et procédez à l'extraction de son contenu dans le répertoire extract que vous avez créé à l'étape précédente.
3. Ouvrez la console 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 la case Utilisez un chargeur de classe isolé pour cette bibliothèque partagée.
6. Ajoutez les bibliothèques extract/lib au chemin d'accès aux classes en ajoutant à celui-ci une ligne qui indique le chemin d'accès complet : 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. Cliquez sur Appliquer > Sauvegarder pour enregistrer les modifications de la configuration.
En fonction des besoins spécifiques de votre environnement, ajoutez une référence provenant de l'application WebScannerEJbEar.ear ou WebScannerSoap.ear à l'application partagée. Pour ajouter une référence, procédez comme suit :
1. Accédez à la console WebSphere® Integrated Server Console sur le serveur distant.
2. Accédez à Applications d'entreprise WebSphere.
3. Pour Enterprise JavaBeans : Cliquez sur l'application PSEStandalone > Shared library references. Pour 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. Pour 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. Cliquez sur la flèche appropriée de sorte que PSE s'affiche dans la liste Sélectionné.
7. Cliquez sur OK > OK.
8. Enregistrez la configuration.
9. Pour Enterprise JavaBeans : Redémarrez l'application PSEStandalone. Pour 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 serveur > 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 s'exécute. En d'autres termes, le transport HTTP sur lequel le serveur distant est configuré pour s'exécuter. Déterminez le numéro de port correct depuis Serveurs d'applications > serveur1 > Ports > WC_defaulthost. La valeur de WC_defaulthost est 10014. 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 est le répertoire de profil de votre installation WebSphere® Application Server. 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. La valeur par défaut de WC_defaulthost est 10014.

Dans la console WebSphere® Integrated Solutions Console, sous Resources > Beans asynchrones > Gestionnaires de travaux, créez un nouveau gestionnaire de travaux avec le nom PSEWorkManager et les attributs suivants :


   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

Cliquez sur Appliquer > Sauvegarder pour enregistrer les modifications de la configuration.
Démarrez l'application :
1. Ouvrez la console WebSphere® Integrated Solutions Console.
2. Cliquez sur Applications > Types d'application > Applications d'entreprise WebSphere.
3. Faites défiler jusqu'à PSEStandalone ou WebScannerEar. Utilisez la fonction de filtre pour rechercher ces noms.
4. Cochez la case et cliquez sur Démarrer.
  Un message confirme que l'application a démarré.
Cette étape n'est requise que si vous travaillez avec EJB sur un serveur sécurisé : Définition de l'ID utilisateur de recherche.
Redémarrez 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. Accédez à la console WebSphere® Integrated Server Console sur le serveur du portail.
  2. Accédez à Sécurité > Sécurité générale > RMI/IIOP security > CSIv2 outbound communications.
  3. Cochez 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. Accédez à la console WebSphere® Integrated Server Console sur le serveur distant.
  2. Accédez à Sécurité > Sécurité globale > RMI/IIOP security > CSIv2 inbound communications.
  3. Cochez Use identity assertion.
  4. Dans Trusted identities, entrez un astérisque (*) ou l'identité du serveur de portail.
  5. Une fois terminé, redémarrez le serveur distant.
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.