Recherche à distance d'instructions du groupe de correctifs pour HCL Digital Experience

Lisez les instructions relatives à l'installation pour apprendre comment appliquer un groupe de correctifs combinés à une installation de recherche à distance de portail ou revenir au groupe de correctifs combinés précédent.

A propos des groupes de correctifs combinés version 8.5

Ce groupe de correctifs ne peut être appliqué qu'à une version fonctionnelle existante du serveur de conversion de documents (DCS) ou du serveur de recherche distant d'HCL Portal version 8.5 à laquelle un groupe de correctifs antérieur a été appliqué.

Présentation Si vous avez configuré un serveur de recherche distant ou un serveur de conversion de documents à utiliser avec Portal version 8.5, alors chaque fois que vous appliquez un groupe de correctifs sur le serveur du portail, vous devez également appliquer le groupe de correctifs correspondant sur le serveur distant. (De même, lorsque vous rétrogradez un correctif à partir du serveur Portal, vous devez rétrograder le correctif correspondant sur le serveur distant). Vous pouvez procéder de deux manières différentes, selon la façon dont vous avez installé le serveur à l'origine.
  • Si vous aviez installé manuellement le service distant, vous devez le mettre à niveau manuellement. Mettez à jour l'application sur le serveur de recherche à distance en copiant les fichiers mis à jour du serveur Portal principal et en les redéployant. Reportez-vous à la section Mise à jour manuelle de la recherche à distance de la documentation produit HCL pour obtenir plus de détails sur la configuration de l'application.

Nouveautés Pour obtenir la liste des correctifs de chaque groupe de correctifs, consultez la section Stratégie de groupes correctifs pour plus d'informations.

Avant de commencer

Espace requis Assurez-vous que vous disposez de suffisamment d'espace disque dans les répertoires suivants :
  • Toutes les plateformes : 250 Mo dans le répertoire de téléchargement pour télécharger le groupe de correctifs, 1 Mo dans le répertoire d'installation et 75 Mo dans l'espace de données partagé, qui est le répertoire où Installation Manager stocke temporairement les fichiers téléchargés pour les utiliser pendant la mise à jour.

Meilleures pratiques Accédez à la page Support logiciel HCL pour prendre connaissance des bonnes pratique concernant la mise à niveau de Portal.

Sauvegarde des données d'Installation Manager Sauvegardez le contenu du répertoire des données d'IBM Installation Manager sur le serveur que vous mettez à niveau au cas où vous perdriez la connexion au cours de la mise à niveau, au risque de corrompre le répertoire des données.

Les emplacements par défaut de ces répertoires sont :
  • Windows : C:\ProgramData\IBM\InstallationManager
  • Utilisateurs root Linux/UNIX : /var/ibm/InstallationManager
  • Utilisateurs non root Linux/UNIX : /home/(user id)/var/ibm/InstallationManager
  • IBM i : Emplacement d'installation : /QIBM/ProdData/InstallationManager
  • IBM i : Emplacement des données d'agent : /QIBM/UserData/InstallationManager

Problèmes connus Consultez la page Problèmes connus liés au groupe de correctifs pour prendre connaissance des problèmes rencontrés pour les différentes versions de groupes de correctifs HCL Portal version 8.5.

Consultez la configuration matérielle et logicielle requise Pour Portal version 8.5 CF08 ou version ultérieure, le niveau minimum requis pour WebSphere Application Server est WAS 8.5.5.6 avec le niveau JDK correspondant appliqué.

Consultez (lien externe vers la configuration matérielle et logicielle requise prise en charge) pour ce groupe de correctifs. Si nécessaire, procédez à la mise à niveau de tous les matériels et logiciels avant d'appliquer ce groupe de correctifs, y compris les correctifs intermédiaires requis pour WebSphere Application Server.

Vérifiez les correctifs installés sur votre système Tous les correctifs temporaires ou intermédiaires sur votre système doivent être supprimés avant d'installer ce groupe de correctifs. Vérifiez également si les correctifs installés sur votre système sont inclus dans la liste des correctifs fournie dans ce groupe de correctifs. Si vous disposez de correctifs temporaires ou intermédiaires sur votre système qui ne sont pas inclus dans ce groupe de correctifs, contactez le Support logiciel HCL pour obtenir une version mise à jour de ces correctifs ou pour obtenir plus d'informations.

Téléchargez le groupe de correctifs Si vous installez le groupe de collectifs en utilisant un référentiel en direct, vous ne devez pas télécharger le groupe de correctifs sur votre serveur. Si vous devez télécharger le groupe correctifs, procédez comme suit.
  1. Téléchargez le dernier fichier zip qui correspond à l'installation sur votre système. Accédez à la page Support logiciel HCL et téléchargez le fichier du groupe de correctifs HCL Portal Remote Search 8.5-WP-RemoteSearch-CFPInnnnn-CFnn.zip.
  2. Créez un répertoire pour extraire le fichier zip téléchargé dans ce répertoire. Dans le fichier zip se trouvent un fichier readme, des fichiers d'exemples de réponses et le groupe de correctifs actuel. Le fichier du groupe de correctifs est nommé comme suit, où nn représente le numéro du groupe de correctifs associé : WP8500CFnn_Remote.zip .
  3. Créez un sous-répertoire pour extraire le fichier WP8500CFnn_Remote.zip dans ce répertoire. The extraction results in a repository.config file that is used by IBM Installation Manager during the update.

Etapes pour l'installation du groupe de correctifs

Il existe plusieurs méthodes différentes pour installer le groupe correctif cumulatif, et elles le sont :
  • Utilisation de li'nterface graphique
  • Utilisation d'un référentiel en direct via l'interface utilisateur graphique
  • Utilisation de la ligne de commande
  • Utilisation de l'installation en mode silencieux
  • Utilisation de l'installation en mode silencieux

Choisissez une méthode parmi celles disponibles pour votre système et suivez les étapes détaillées pour cette option.

Use a Graphical User Interface (available on Windows, Linux, and Unix operating systems)
  1. Si vous exécutez un serveur Web externe, comme IBM HTTP Server, arrêtez-le.
  2. Stop any active application servers by using the stopServer command. Pour voir si les serveurs d'applications sont actifs, utilisez la commande serverStatus depuis le répertoire (prs_profile)/bin :
    • UNIX/Linux : 
      ./serverStatus.sh -all
    • Windows : 
      serverStatus.bat -all
  3. Lancez l'IBM Installation Manager qui a été utilisé pour installer HCL Portal Remote Search Version 8.5.
  4. Using Installation Manager, click File > Preferences.
  5. Accédez au panneau Référentiels, cliquez sur « Ajouter un référentiel ».
  6. Navigate to the repository.config file mentioned earlier and select it.
  7. Sélectionnez Mettre à jour et suivez les invites pour mettre à jour HCL Portal Remote Search.
  8. Si vous exécutez un serveur Web externe, redémarrez-le maintenant.
Utilisez le référentiel en direct via l'interface graphique utilisateur (disponible sous les systèmes d'exploitation Windows, Linux et Unix)
  1. Si vous exécutez un serveur Web externe, comme IBM HTTP Server, arrêtez-le.
  2. Stop any active application servers by using the stopServer command. Pour voir si les serveurs d'applications sont actifs, utilisez la commande serverStatus depuis le répertoire (prs_profile)/bin :
    • UNIX/Linux : 
      ./serverStatus.sh -all
    • Windows : 
      serverStatus.bat -all
  3. Lancez l'IBM Installation Manager qui a été utilisé pour installer HCL Portal Remote Search Version 8.5.
  4. Using Installation Manager, click File > Preferences.
  5. Go to the Repositories panel and click Search service repositories during installation and updates. Cliquez sur Appliquer.
  6. Select Update and follow the prompts to update HCL Portal Remote Search.
  7. Si vous exécutez un serveur Web externe, redémarrez-le maintenant.
Use a command line (available on Windows, Linux, and Unix operating systems)
  1. Si vous exécutez un serveur Web externe, comme IBM HTTP Server, arrêtez-le.
  2. Stop any active application servers by using the stopServer command. Pour voir si les serveurs d'applications sont actifs, utilisez la commande serverStatus depuis le répertoire (prs_profile)/bin :
    • UNIX/Linux : 
      ./serverStatus.sh -all
    • Windows : 
      serverStatus.bat -all
  3. Ouvrez une fenêtre de commande et passez dans le sous-répertoire eclipse/tools d'Installation Manager. Par défaut, il s'agit de :
    • UNIX/Linux : 
      /opt/IBM/InstallationManager/eclipse/tools
    • Windows : 
      C:\Program Files\IBM\Installation Manager\eclipse\tools
  4. Exécutez la commande suivante pour lancer le programme d'installation d'IBM Installation Manager. REMARQUE : La commande est présentée ici sur plusieurs lignes pour plus de clarté, mais la commande entière doit être saisie sur une seule ligne. Mettez des guillemets autour des chemins d'accès aux fichiers qui comprennent des espaces. Pour Unix/Linux : 
    ./imcl install com.ibm.websphere.PORTAL.REMOTESEARCH.v85 
	-repositories <fullpath/to/repository.config> 
	-installationDirectory <portal_remotesearch_root> 
	-acceptLicense
    Pour Windows : 
    imcl.exe install com.ibm.websphere.PORTAL.REMOTESEARCH.v85 
-repositories <fullpath/to/repository.config> 
-installationDirectory <portal_remotesearch_root> -acceptLicense
  5. Si vous exécutez un serveur Web externe, redémarrez-le maintenant.
Use silent mode installation (available on Windows, Linux, Unix, and IBM i operating systems)
  1. Si vous exécutez un serveur Web externe, comme IBM HTTP Server, arrêtez-le.
  2. Stop any active application servers by using the stopServer command. Pour voir si les serveurs d'applications sont actifs, utilisez la commande serverStatus depuis le répertoire (prs_profile)/bin :
    • UNIX/Linux : 
      ./serverStatus.sh -all
    • Windows : 
      serverStatus.bat -all
  3. Pour IBM i only, exécutez la commande suivante depuis qshell : 
    chown QEJBSVR
/QIBM/UserData/WebSphere/AppServer/V85/ND/profiles/prs_profile/ConfigEngine/properties/wkplc.properties
  4. Ouvrez une fenêtre de commande et passez dans le sous-répertoire eclipse/tools d'Installation Manager. Par défaut, il s'agit de :
    • UNIX/Linux : /opt/IBM/InstallationManager/eclipse/tools
    • Windows : C:\Program Files\IBM\Installation Manager\eclipse\tools
    • IBM i : /QIBM/ProdData/InstallationManager/eclipse/tools
  5. Mettez à jour le fichier d'exemples de réponses fourni avec votre niveau de groupe de correctifs en fonction des commentaires figurant dans le fichier. Vous pouvez également enregistrer un fichier de réponses à utiliser pour installer le correctif en mode silencieux. Accédez à la page Support logiciel HCL pour obtenir des instructions détaillées sur l'enregistrement d'un fichier de réponses IBM Installation Manager. Remarque : Le jeu de fonctions repris dans votre fichier de réponses doit correspondre au jeu de fonctions que vous avez installé. Vous ne pouvez pas ajouter ou supprimer des fonctions au cours de la mise à jour du groupe de correctifs. Le jeu de fonctions repris dans le fichier d'exemples de réponses est : 
    features='main.ce,main.rs.install,main.dcs.install,main.rs.deploy,main.dcs.deploy'
    Si le serveur auquel vous appliquez le correctif est configuré uniquement comme un serveur de recherche distant, vous devez alors supprimer main.dcs.deploy de cette liste.
    • Exemple (serveur de recherche distant uniquement) : 
      features='main.ce,main.rs.install,main.dcs.install,main.rs.deploy'
    • Exemple (serveur de conversion de documents uniquement) : 
      features='main.ce,main.rs.install,main.dcs.install,main.dcs.deploy'
  6. Exécutez la commande suivante en mode silencieux : 
    imcl -acceptLicense -input
<Full_path_to_your_response_file> -log <Full_Path_to_a_log_file> -showProgress
  7. Si vous exécutez un serveur Web externe, redémarrez-le maintenant.
Use Console Mode Interface (available on Windows, Linux, Unix and IBM i operating systems)
  1. Si vous exécutez un serveur Web externe, comme IBM HTTP Server, arrêtez-le.
  2. Stop any active application servers by using the stopServer command. Pour voir si les serveurs d'applications sont actifs, utilisez la commande serverStatus depuis le répertoire (prs_profile)/bin :
    • UNIX/Linux : 
      ./serverStatus.sh -all
    • Windows : 
      serverStatus.bat -all
  3. Pour IBM i only, exécutez la commande suivante depuis qshell : 
    chown QEJBSVR
/QIBM/UserData/WebSphere/AppServer/V85/ND/profiles/prs_profile/ConfigEngine/properties/wkplc.properties
  4. Ouvrez une fenêtre de commande et passez dans le sous-répertoire eclipse/tools d'Installation Manager. Par défaut, il s'agit de :
    • UNIX/Linux : 
      /opt/IBM/InstallationManager/eclipse/tools
    • Windows : 
      C:\Program
Files\IBM\Installation Manager\eclipse\tools
    • IBM i : 
      /QIBM/ProdData/InstallationManager/eclipse/tools
  5. Exécutez la commande pour lancer l'IBM Installation Manager en mode console. Pour Unix/Linux : 
    ./imcl -c
    Windows : 
    imcl.exe -c
    IBM i : 
    ./imcl -c
  6. Pour ajouter les référentiels, procédez comme suit :
    • Entrez P pour accéder au menu Préférences.
    • Entrez 1 pour accéder au menu Référentiels.
    • Entrez D pour ajouter des référentiels.
    • Entrez le chemin d'accès à votre fichier de référentiel HCL Portal Remote Search version 8.5 CF.
    • Entrez A pour appliquer vos référentiels et revenir au menu Préférences.
    • Entrez R pour revenir au menu Principal.
  7. SélectionnezMettre à jour et suivez les invites pour mettre à jour HCL Portal.
  8. Si vous exécutez un serveur Web externe, redémarrez-le maintenant.

Rappel : Problèmes connusConsultez section relative aux problèmes connus pour prendre connaissance des problèmes rencontrés pour les différentes versions de groupes de correctifs HCL Portal.

Etapes pour la rétrogradation du groupe de correctifs

REMARQUE : Les étapes décrites dans ces sections relatives à la rétrogradation du groupe de correctifs décrivent comment revenir à un niveau précédent à partir d'une mise à jour réussie. Cependant, la rétrogradation à partir d'une mise à jour qui a échoué ne garantit pas le retour à un état diablef Lorsqu'une mise à jour échoue, il est conseillé de corriger la cause de l'échec et d'essayer à nouveau pour une mise à jour réussie ; pour revenir à un niveau précédent, vous devez dépendre d'une sauvegarde et d'une restauration du système et de la base de données.

Il existe plusieurs méthodes différentes pour rétrograder le groupe correctifs, notamment :
  • Utilisation de l'interface utilisateur graphique pour la rétrogradation
  • Utilisation de la rétrogradation par ligne de commande
  • Utilisation de la rétrogradation en mode silencieux
  • Utilisation de la rétrogradation en mode console

Choisissez une méthode disponible pour votre système. Suivez les étapes détaillées pour cette option, puis passez aux étapes post-rétrogradation.

Use a Graphical User Interface to roll back (available on Windows, Linux, and Unix operating systems)
  1. Si vous exécutez un serveur Web externe, comme IBM HTTP Server, arrêtez-le.
  2. Stop any active application servers by using the stopServer command. Pour voir si les serveurs d'applications sont actifs, utilisez la commande serverStatus depuis le répertoire (prs_profile)/bin :
    • UNIX/Linux : 
      ./serverStatus.sh -all
    • Windows : 
      serverStatus.bat -all
  3. Ouvrez une fenêtre de commande et passez dans le sous-répertoire eclipse/tools d'Installation Manager. Pour Unix/Linux : 
    
/opt/IBM/InstallationManager/eclipse/tools
    Windows : 
    C:\Program Files\IBM\Installation Manager\eclipse\tools
  4. Exécutez la commande suivante pour lancer le programme d'installation d'Installation Manager : REMARQUE : La commande est présentée ici sur plusieurs lignes pour plus de clarté, mais la commande entière doit être saisie sur une seule ligne. Mettez des guillemets autour des chemins d'accès aux fichiers qui comprennent des espaces. Pour Unix/Linux : 
    ./imcl rollback com.ibm.websphere.PORTAL.REMOTESEARCH.v85 -installationDirectory
<portal_remotesearch_root>
    Windows : 
    imcl.exe rollback com.ibm.websphere.PORTAL.REMOTESEARCH.v85
-installationDirectory <portal_remotesearch_root>
  5. Si vous exécutez un serveur Web externe, redémarrez-le maintenant.
Use silent mode to roll back (available on Windows, Linux, Unix, and IBM i operating systems)
  1. Si vous exécutez un serveur Web externe, comme IBM HTTP Server, arrêtez-le.
  2. Stop any active application servers by using the stopServer command. Pour voir si les serveurs d'applications sont actifs, utilisez la commande serverStatus depuis le répertoire (prs_profile)/bin :
    • UNIX/Linux : 
      ./serverStatus.sh -all
    • Windows : 
      serverStatus.bat -all
    • IBM i : 
      serverStatus -all
  3. Pour IBM i only, exécutez la commande suivante depuis qshell : 
    chown QEJBSVR
/QIBM/UserData/WebSphere/AppServer/V85/ND/profiles/prs_profile/ConfigEngine/properties/wkplc.properties
  4. Ouvrez une fenêtre de commande et passez dans le sous-répertoire eclipse/tools d'Installation Manager. Par défaut, il s'agit de :
    • UNIX/Linux : 
      /opt/IBM/InstallationManager/eclipse/tools
    • Windows : 
      C:\Program
Files\IBM\Installation Manager\eclipse\tools
    • IBM i : 
      /QIBM/ProdData/InstallationManager/eclipse/tools
  5. Mettez à jour le fichier d'exemples de réponses fourni avec votre niveau de groupe de correctifs en fonction des commentaires figurant dans le fichier.
  6. Exécutez la commande suivante pour rétrograder en mode silencieux :
     imcl -input
(Full_path_to_your_response_file) -log (Full_Path_to_a_log_file) -showProgress
  7. Si vous exécutez un serveur Web externe, redémarrez-le maintenant.
Use Console Mode Interface (available on Windows, Linux, Unix and IBM i operating systems)
  1. Si vous exécutez un serveur Web externe, comme IBM HTTP Server, arrêtez-le.
  2. Stop any active application servers by using the stopServer command. Pour voir si les serveurs d'applications sont actifs, utilisez la commande serverStatus depuis le répertoire (prs_profile)/bin :
    • UNIX/Linux : 
      ./serverStatus.sh -all
    • Windows : 
      serverStatus.bat -all
    • IBM i : 
      serverStatus -all
  3. Pour IBM i only, exécutez la commande suivante depuis qshell : 
    chown QEJBSVR
/QIBM/UserData/WebSphere/AppServer/V85/ND/profiles/prs_profile/ConfigEngine/properties/wkplc.properties
  4. Ouvrez une fenêtre de commande et passez dans le sous-répertoire eclipse/tools d'Installation Manager. Par défaut, il s'agit de :
    • UNIX/Linux : 
      /opt/IBM/InstallationManager/eclipse/tools
    • Windows : 
      C:\Program
Files\IBM\Installation Manager\eclipse\tools
    • IBM i : 
      /QIBM/ProdData/InstallationManager/eclipse/tools
  5. Exécutez la commande pour lancer l'IBM Installation Manager en mode console :
    • UNIX/Linux : 
      ./imcl -c
    • Windows : 
      imcl.exe -c
    • IBM i : 
      ./imcl -c
  6. Sélectionnez Rétrograder et suivez les invites pour rétrograder HCL Portal Remote Search.
  7. Si vous exécutez un serveur Web externe, redémarrez-le maintenant.