Instructions sur le groupe de correctif : Autonome | HCL Digital Experience

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

Avant de commencer

REMARQUE : A moins que vous ne migriez à partir d'une version précédente ou que vous ne prévoyiez d'ajouter ce nœud à un cluster existant, vous devez créer votre profil Portal avant d'appliquer le groupe de correctifs. Si vous ne l'avez pas fait lors de l'installation initiale, vous pouvez utiliser l'assistant de configuration pour le faire maintenant. Portal Version 8.5 CF12 ou les versions ultérieures prennent en charge JDK8. However, if you plan to use JDK 8 with your profile, you must first create the profile using JDK 7 and then upgrade to JDK 8 after applying the cumulative fix.

REMARQUE : Dans Portal version 8.5 CF12 ou les versions ultérieures, les paramètres de liste noire sont devenus plus restricitifs. For inquiries, go to HCL Software Support page.

Espace requis : Assurez-vous que vous disposez de suffisamment d'espace disque dans les répertoires suivants :
  • Pour toutes les plateformes : 2 Go dans le répertoire de téléchargement pour télécharger le groupe de correctifs, 1,5 Go dans Portal_Install_Root, 1 Go d'espace disque temporaire dans (wp_profile_root) et 1.66 Go 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.
  • Sous Solaris : Il est recommandé d'allouer un espace de permutation égal à au moins deux fois votre mémoire RAM physique pour éviter les erreurs de mémoire lors de la configuration de ce groupe de correctifs.

Best Practices

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

Information sur le Syndicateur/Abonné

Il est recommandé que les serveurs utilisant la syndication aient des syndicateurs associés et des abonnés désactivés avant d'installer le groupe de correctifs.

Sinon, les mises à jour de la syndication qui sont exécutées pendant l'insallation peuvent entrer en conflit avec les modifications de l'installation et provoquer l'échec de la mise à niveau du groupe de correctifs.

Les syndicateurs et les abonnés peuvent être désactivés en les modifiant dans le portlet d'administration de la syndication. Pour plus d'informations, accédez aux rubriques Syndicateurs et Abonnés dans la documentation produit d'HCL Digital Experience version 8.5. La syndication doit ensuite être réactivée une fois la mise à niveau terminée.

Par ailleurs, les tâches ConfigEngine suivantes ont également été intégrées dans le groupe de correctifs CF09 ou versions ultérieures pour désactiver et activer globalement la syndication (Ces tâches peuvent être utilisées à la place des mises à jour manuelles mentionnées ci-dessus) :
  • (wp_profile root)/ConfigEngine/ConfigEngine.sh|.bat disable-syndication-auto-scheduler
  • (wp_profile root)/ConfigEngine/ConfigEngine.sh|.bat enable-syndication-auto-scheduler

Informations sur le moteur de balayage de recherche

Il est recommandé de désactiver tout moteur de balayage de recherche avant d'applique un groupe de correctifs. Si un groupe de correctifs est appliqué en même temps que le moteur de balayage de recherche, ceci pourrait corromptre la collection de recherche. Le moteur de balayage de recherche doit être redémarré une fois la mise à jour du groupe de correctifs terminée.

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 combinés 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, les exigences minimales requises sont WebSphere Application Server level is at least WAS 8.5.5.6 with the corresponding JDK level applied.

Consultez la section Configuration matérielle et logicielle 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.

Remarque : Assurez-vous que la fonction facultative « Outil EJBDeploy pour les modules antérieurs à EJB 3.0 » de WebSphere Application Server est installée.

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. If you have temporary or interim fixes on your system that are not included in this cumulative fix then contact HCL Software Support for an updated version of those fixes or for more information.

Ensure wkplc.properties files are correct

La mise à niveau d'HCL Portal exécute plusieurs scripts ConfigEngin. Ces scripts dépendent de la mise à jour et de la précision des wkplc.properties, particulièrement des propriétés du mot de passe. Si vous utilisez plusieurs profils, vérifiez que les informations de chaque profil sont correctes.

  1. Modifiez le fichier (wp_profile root)/ConfigEngine/properties/wkplc.properties et assurez-vous que les valeurs suivantes sont correctement définies :
    • WasRemoteHostName=(the hostname of your WAS instance)
    • WasSoapPort=(the soap port of your WAS instance)
    • WasUserid=(your WAS admin user)
    • WasPassword=(your WAS admin pwd)
    • PortalAdminId=(your Portal Admin ID)
    • PortalAdminPwd=(your Portal Admin password)
    • WpsHostName=(Your Portal hostname)
    • WpsHostPort=(The port you use to access Portal)
    • WpsContextRoot=(your Portal context root)
  2. Edit the (wp_profile root)/ConfigEngine/properties/wkplc_dbdomain.properties file and ensure the following values are set correctly:
    • release.DbPassword=(your database user password)
    • community.DbPassword=(your database user password)
    • customization.DbPassword=(your database user password)
    • jcr.DbPassword=(your database user password)
    • likeminds.DbPassword=(your database user password)
    • feedback.DbPassword=(your database user password)
  3. Edit the (wp_profile root)/ConfigEngine/properties/wkplc_comp.properties file and ensure the following values are set correctly: XmlAccessHost=(your Portal hostname) XmlAccessPort=(the port you use to access Portal)

Remarque : Si votre serveur est configuré avec des utilisateurs d'exécution de la base de données, par exemple, feedback.DbRuntimeUser=(your feedback database runtime user), assurez-vous de définir correctement les valeurs de leur mot de passe, par exemple, dans feedback.DbRuntimePassword=(your feedback database runtime user password).

Unix, Linux, Windows et IBM i :

Le processus de mise à jour supprime les mots de passe en texte clair des fichiers wkplc*.properties. Pour conserver ces mots de passe dans les fichiers de propriétés, insérez la ligne suivante dans le fichier wkplc.properties : PWordDelete=false

Considérations liées aux profils multiples

Vérifiez que tous vos profils sont au même niveau avant de lancer la mise à niveau ou l'annulation de la mise à niveau. Tous les profils qui partagent le même répertoire d'installation Portal (option à profils multiples) doivent être mis à niveau manuellement une fois la mise à jour d'IBM Installation Manager terminée. Voir la section « Procédures de configuration complémentaire » pour plus de détails.

Considérations conernant les utilisateurs non root

Dans des environnements Unix/Linux, vous devez installer le groupe de correctifs en tant qu'utilisateur identique à celui que vous avez utilisé pour installer HCL Portal à l'origine. Il peut s'agir d'un utilisateur root ou non-root. Si vous devez utiliser un utilisateur non-root, vérifiez que les conditions suivantes sont remplises :
  • Si vous effectuez une installation en tant qu'utilisateur non-root sous Unix ou Linux, le paramètre umask de votre session de connexion doit être réglé sur 0022 ou plus élevé. (umask est un paramètre qui contrôle les autorisations de fichiers pour les fichiers et répertoires nouvellement créés). Une valeur de 0022 correspond aux paramètres de permission de (rwxr-xr-x). Si l'umask n'est pas défini correctement par défaut, vous devez le définir lorsque vous démarrez Installation Manager ou lorsque vous ouvrez un utilitaire de ligne de commande pour exécuter les commandes d'Installation Manager.
  • L'utilisateur non-root a un paramètre « ulimit - n » d'au moins 18192. La valeur doit être un nombre et pas « illimité ».
  • L'utilisateur non-root est propriétaire des répertoires des profils AppServer, PortalServer, ConfigEngine et Portal et dispose de l'accès en lecture/écriture sur tous les fichiers de ces répertoires. Des paramètres de permission de 755 (rwxr-xr-x) suffisent.
  • N'utilisez pas « sudo » et « su » pour installer le groupe de correctifs. Utilisez plutôt root de manière explicite ou utilisez un utilisateur non-root qui répond aux conditions ci-dessus.
Pour ouvrir l'utilitaire de ligne de commande pour exécuter les commandes d'Installation Manager :
  1. Ouvrez une fenêtre de ligne de commande.
  2. Exécutez cette commande pour vérifier votre paramètre unmask actuel :
    umask
  3. Si nécessaire, exécutez cette commande pour définir le paramètre unmask :
    umask 0022

Considérations concernant l'anti-virus et l'indexation des fichiers (Windows uniquement)

Dans le cadre du processus de mise à niveau du groupe de correctifs, de nouveaux fichiers seront créés dans le répertoire d'installation de WebSphere, ainsi que dans le répertoire temporaire de l'utilisateur. Les anti-virus et les logiciels d'indexation de fichiers (comme Google Desktop) sont connus pour verrouiller les fichiers nouvellement créés lors de leur analyse, ce qui peut interférer avec le processus de mise à jour. Nous recommandons d'exclure le répertoire d'installation de WebSphere et le répertoire temporaire de l'utilisateur de l'analyse par ce logiciel pendant la mise à niveau. Vous pouvez également arrêter/désactiver ces outils pendant la mise à niveau et les réactiver une fois la mise à niveau terminée.

Remarques spéciales pour les clients qui utilisent WAS 8.5.5.14

La prise en charge de WebSphere Application Server v8.5.5.14 sera ajoutée au groupe de correctifs Portal CF16. Si vous devez appliquer le groupe de correctifs Portal CF15 ou une version antérieure à une installation de WAS v8.5.5.14, vous devrez effectuer une étape manuelle supplémentaire au cours de la mise à niveau.

Après avoir lancé le gestionnaire d'installation pour installer le nouveau code de Portal, mais avant d'exécuter la commande applyCF.sh ou applyCF.bat ou pour mettre à jour le profil de Portal, procédez comme suit :
  1. Ouvrez une fenêtre de commande et accédez au répertoire de base de ConfigEngine : Par défaut, il s'agit de :
    • Unix/Linux: /opt/IBM/WebSphere/ConfigEngine
    • Windows: C:\IBM\WebSphere\ConfigEngine
    • IBM i: /QIBM/ProdData/WebSphere/ConfigEngine
  2. Effectuez une copie de sauvegarde du script ConfigEngine. Ce fichier est intitulé
    ConfigEngine.bat
    pour Windows et
    ConfigEngine.sh
    pour toutes les plateformes.
  3. Assurez-vous que vous disposez des droits en écriture pour le fichier de script et ouvrez-le dans un éditeur de texte.
  4. Recherchez le texte EJBDEPLOY_JAVA_HOME dans le script.
  5. Si vous ne le trouvez pas, aucune action supplémentaire n'est nécessaire et vous pouvez poursuivre l'installation. Si vous le trouvez, supprimez chaque ligne qui contient le texte EJBDEPLOY_JAVA_HOME dans la ligne. (Il doit y avoir 3 lignes de ce type dans le script .sh et 2 lignes dans le script .bat)
  6. Enregistrez le fichier.

Vous pouvez maintenant poursuivre l'installation du groupe de correctifs (CF) de Portal.

Téléchargez le groupe de correctifs

Si vous installez le groupe de collectifs en utilisant un référentiel en direct (uniquement possible avec les groupes de correctifs antérieurs à CF17), 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. Accédez à la page du Support logiciel HCL et téléchargez le dernier fichier zip qui correspond à l'installation sur votre système.
  2. Créez un répertoire pour extraire les fichiers dans ce répertoire. Dans le fichier zip se trouvent un fichier readme, des fichiers d'exemples de réponses (Server et Express uniquement) et le groupe de correctifs actuel.
  3. Créez un sous-répertoire pour extraire le fichier zip approprié 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 correctifs. Choisissez une méthode disponible pour votre système. Suivez les étapes détaillées pour cette option, puis passez à la section Etapes de configuration supplémentaires.

Use a Graphical User Interface (available on Windows, Linux, and Unix operating systems)
  1. Si vous exécutez un serveur Web externe, arrêtez-le.
  2. Stop any active application servers by using the stopServer command. To see which application servers are active, use the serverStatus command from the (wp_profile)/bin directory and again from the (cw_profile)/bin directory:
    • Unix/Linux: ./serverStatus.sh -all
    • Windows: serverStatus.bat -all
  3. Lancez l'IBM Installation Manager qui a été utilisé pour installer HCL Portal version 8.5.
  4. Using Installation Manager, click File then Preferences.
  5. Go to the Repositories panel and click "Add Repository".
  6. Naviguez vers le fichier repository.config mentionné plus haut et sélectionnez-le.
  7. SélectionnezMettre à jour et suivez les invites pour mettre à jour HCL Portal.
  8. Une fois l'installation terminée, procédez aux « Etapes de configuration supplémentaires ».
Use a live repository via the Graphical User Interface (available on Windows, Linux, and Unix operating systems)
  1. Si vous exécutez un serveur Web externe, arrêtez-le.
  2. Stop any active application servers by using the stopServer command. To see which application servers are active, use the serverStatus command from the ( wp_profile)/bin directory and again from the (cw_profile)/bin directory:
    • Unix/Linux: ./serverStatus.sh -all
    • Windows: serverStatus.bat -all
  3. Lancez l'IBM Installation Manager qui a été utilisé pour installer HCL Portal version 8.5.
  4. Using Installation Manager, click File then Preferences.
  5. Go to the Repositories panel and click Search service repositories during installation and updates. Cliquez sur Appliquer.
  6. SélectionnezMettre à jour et suivez les invites pour mettre à jour HCL Portal.
  7. Une fois l'installation terminée, procédez aux « Etapes de configuration supplémentaires ».
Use a command line (available on Windows, Linux, and Unix operating systems)
  1. Si vous exécutez un serveur Web externe, arrêtez-le.
  2. Stop any active application servers by using the stopServer command. To see which application servers are active, use the serverStatus command from the ( wp_profile)/bin directory and again from the (cw_profile)/bin directory:
    • 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. Si vous désinstallez le groupe de correctifs sur HCL Portal Express, passez à l'étape 5. Sinon, exécutez la commande suivante pour lancer le programme d'installation sur d'IBM Installation Manager. Notez que les commandes sont présentées 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.SERVER.v85 
    	-repositories (fullpath/to/repository.config) -installationDirectory (portal_server_root)
    	-installationDirectory(portal_server_root) 
        -acceptLicense
    Pour Windows :
    imcl.exe install com.hcl.websphere.PORTAL.SERVER.v85 
    	-repositories (fullpath/to/repository.config) 
    	-installationDirectory (portal_server_root) 
    	-acceptLicense
  5. Pour Portal HCL Express uniquement (IBM i doit utiliser la méthode mode silencieux ou console) : exécutez la commande suivante pour lancer le programme d'installation depuis sous-répertoire eclipse/tools d'Installation Manager. Notez que les commandes sont présentées 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 Linux :
    ./imcl install com.hcl.websphere.PORTAL.EXPRESS.v85
    	-repositories (fullpath/to/repository.config) 
    	-installationDirectory (portal_server_root) 
    	-acceptLicense
    Pour Windows :
    imcl.exe install com.ibm.websphere.PORTAL.EXPRESS.v85 
    	-repositories (fullpath/to/repository.config) 
    	-installationDirectory (portal_server_root) 
    	-acceptLicense
  6. Une fois l'installation terminée, procédez aux « Etapes de configuration supplémentaires ».
Use silent mode installation (available on Windows, Linux, Unix, and IBM i operating systems)
  1. Si vous exécutez un serveur Web externe, arrêtez-le.
  2. Stop any active application servers by using the stopServer command. To see which application servers are active, use the serverStatus command from the ( wp_profile)/bin directory and again from the (cw_profile)/bin directory:
    • 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/cw_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'une réponse IBM Installation Manager. Notez que 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='ce.install,portal.binary,portal.profile'
    Si vous n'avez aucun profil sur ce nœud (parce que vous êtes en train de migrer depuis une version précédente d'HCL Portal, ou de créer plusieurs profils, ou parce que vous avez initialement installé HCL Portal en tant qu'installation binaire), alors vous devez supprimer la fonction 'portal.profile' de la liste :
    features='ce.install,portal.binary'
    .
  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. Une fois l'installation terminée, procédez aux « Etapes de configuration supplémentaires ».
Use Console Mode Interface (available on Windows, Linux, Unix and IBM i operating systems)
  1. Si vous exécutez un serveur Web externe, arrêtez-le.
  2. Stop any active application servers by using the stopServer command. To see which application servers are active, use the serverStatus command from the ( wp_profile)/bin directory and again from the (cw_profile)/bin directory:
    • 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/cw_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
    Pour Windows :
    imcl.exe -c
    Pour IBM i :
    ./imcl  -c
  6. Pour ajouter les référentiels, procédez comme suit :
  7. Select Update and follow the prompts to update HCL Portal.
  8. Une fois l'installation terminée, procédez aux « Etapes de configuration supplémentaires ».
Pour ajouter les référentiels pour l'étape 6 :
  1. Entrez P pour accéder au menu Préférences.
  2. Entrez 1 pour accéder au menu Référentiels.
  3. Entrez D pour ajouter des référentiels.
  4. Entrez le chemin d'accès à votre fichier de référentiel HCL Portal version 8.5 CF.
  5. Entrez A pour appliquer vos référentiels et revenir au menu Préférences.
  6. Entrez R pour revenir au menu Principal.

Procédures de configuration complémentaire

Si vous avez un profil, les étapes de configuration suivantes sont obligatoires.

Si vous n'avez pas de profil à ce stade (parce que vous êtes en cours de migration depuis une version précédente d'HCL Portal ou que vous prévoyez d'ajouter ce nœud à un cluster existant), aucune étape de configuration supplémentaire n'est nécessaire et vous pouvez poursuivre avec les étapes de postinstallation. Si vous êtes en cours de migration, vous devrez suivre ces étapes de configuration supplémentaires après avoir exécuté upgrade-profile pour votre environnement migré.

Remarque : Les étapes de configuration suivantes doivent être effectuées par l'utilisateur qui administre normalement le serveur Portal, qui peut être ou non le même utilisateur que celui qui exécute le programme d'installation.

Linux, Unix, Windows ou IBM i Utilisez les commandes suivantes pour mettre à jour tous les profils. Ces étapes doivent être répétées pour chaque profil, si plusieurs profils existent. Tous les profils qui partagent le même répertoire d'installation Portal (option à profils multiples) doivent être au même niveau pour que les futures mises à niveau puissent être appliquées.

Notes :
  • Si un serveur de recherche distante est utilisé dans cet environnement, il doit être démarré avant d'exécuter les commandes suivantes.
  • De plus, si une mise à jour WAS a eu lieu avant l'exécution de la mise à jour du groupe de correctifs, il est recommandé d'exécuter la tâche suivante :
    (profile_root)/bin/osgiCfgInit.sh|bat
Remarque facultativePour passer la régénération du modèle de profil, ajoutez l'indicateur suivant à la commande de mise à jour du groupe de correctifs :
ex. applyCF.sh -Dskip.profile.template.update=true
Si un modèle mis à jour est nécessaire ultérieurement, cette commande peut être exécutée pour le faire à tout moment :
ex. ConfigEngine.sh cf-create-profile-templates

Appliquez le groupe de correctifs

  1. Assurez-vous que le serveur WebSphere_Portal est arrêté sur le profil que vous souhaitez mettre à niveau.
  2. Exécutez la commande suivante depuis le chemin du profil à configurer : Si vous installez le groupe de correctifs sur un portail vide, consultez la section Considérations spéciales ci-dessous avant d'exécuter applyCF. Si la commande applyCF échoue pour l'une ou l'autre raison, consultez les journaux des erreurs avant de l'exécuter à nouveau.
    • UNIX/Linux :(profile_root)/PortalServer/bin/applyCF.sh -DPortalAdminPwd=(password) -DWasPassword=(password)
    • Windows :(profile_root)\PortalServer\bin\applyCF.bat -DPortalAdminPwd=(password) -DWasPassword=(password)
    • IBM i : (profile_root)/PortalServer/bin/applyCF.sh -DPortalAdminPwd=(password) -DWasPassword=(password)
Special Consideration for empty portals If you are installing the CF on an empty portal then extra steps are required to avoid upgrade errors.
  1. Si vous avez créé un contenu personnalisé au-dessus du portail vide, vous devez d'abord utiliser xmlaccess pour exporter le contenu Portal. A partir du répertoire wp_profile_root/PortalServer/bin, exécutez :
    xmlaccess.bat/sh -user Portal_admin_user -password Portal_admin_password -url http://(myhost):(port)/wps/config -in (Portal home)/doc/xml-samples/Export.xml -out result.xml
  2. Mettez à niveau le profil Portal vers le nouveau niveau de groupe de correctifs. Comme un grand nombre des artefacts attendus n'existeront pas dans un portail vide, vous devez définir la propriété "isEmptyPortal" lors de cette étape : Si la commande applyCF échoue pour l'une ou l'autre raison, consultez les journaux des erreurs avant de poursuivre.
    • UNIX/Linux :(profile_root)/PortalServer/bin/applyCF.sh -DisEmptyPortal=true -DPortalAdminPwd=(password) -DWasPassword=(password)
    • Windows :(profile_root)\PortalServer\bin\applyCF.bat -DisEmptyPortal=true -DPortalAdminPwd=(password) -DWasPassword=(password)
    • IBM i :(profile_root)/PortalServer/bin/applyCF.sh -DisEmptyPortal=true -DPortalAdminPwd=(password) -DWasPassword=(password)
  3. Après une exécution réussie du script applyCF, relancez la tâche empty-portal pour supprimer les artefacts POrtal qui ont été réintroduits avec le groupe de correctifs, car ils peuvent provoquer des erreurs d'exécution.
    • UNIX/Linux :(profile_root)/ConfigEngine/ ./ConfigEngine.sh empty-portal -DWasPassword=password -DPortalAdminPwd=password
    • Windows :(profile_root)/ConfigEngine/ ConfigEngine.bat empty-portal -DWasPassword=password -DPortalAdminPwd=password
    • IBM i :(profile_root)/ConfigEngine/ ConfigEngine.sh empty-portal -DWasPassword=password -DPortalAdminPwd=password
  4. Si vous avez exporté du contenu personnalisé à l'étape 1 ci-dessus, vous pouvez désormais utiliser xmlaccess pour réimporter ce contenu. From the wp_profile_root/PortalServer/bin directory run:
     xmlaccess.bat/sh -user (Portal_admin_user) -password (Portal_admin_password) -url http://(myhost):(port)/wps/config -in result.xml -out importResults.xml

Etapes de post-l'installation

  1. Si vous exécutez un serveur Web externe et que vous utilisez la génération automatique de WebSphere Application Server et la propagation du plug-in, redémarrez alors le serveur Web. Si vous n'utilisez pas la génération automatique et la propagation automatique, régénérez simplement le plug-in du serveur Web, copiez le fichier plugin-cfg.xml dans le répertoire plugin et redémarrez le serveur Web.
  2. S'il existe un thème personnalisé qui contient un fichier WAR de contenu statique et que les paramètres de contexte com.ibm.portal.resource.blacklist and com.ibm.portal.resource.whitelist n'ont pas encore été ajoutés au fichier web.xml, accédez à la page Support logiciel HCL pour régler les vulnérabilités de sécurité. Les modifications associées à ceci peuvent faire en sorte que les thèmes personnalisés produisent beaucoup de messages d'avertissement dans les journaux, ce qui entrave fortement la performance. Le thème personnalisé doit être redéployé avant que les modifications prennent effet.
  3. Si nécessaire, redéployez tous les éléments personnalisés, y compris les JSP, sur les portlets WCM (si vous utilisez Web Content Manager), sur tout autre portlet ou toute autre application d'entreprise Portal, si vous les avez personnalisés, avant d'installer le groupe de correctifs.
  4. Connectez-vous sur la page Support logiciel HCL afin de voir si les changements et options de configuration introduits dans les groupes de correctifs combinés d'HCL Web Content Manager version 8.5 s'appliquent à votre environnement.
  5. Si vous avez modifié les droits dans l'arborescence du répertoire principal PortalServer pour installer le groupe de correctifs combinés en tant que non-root, restaurez les droits d'origine.
  6. Si vous utilisez HCL Web Content Manager et que vous avez installé des extensions officielles (telles que la solution multilingue WCM ou le diffuseur de médias sociaux pour WCM), exécutez la tâche suivante pour les mettre à jour.
    • UNIX/Linux :(profile_root)/ConfigEngine/ConfigEngine.sh action-update-wcm-extensions -DWasPassword=(password) -DPortalAdminPwd=(password)
    • Windows :(profile_root)\ConfigEngine\ConfigEngine.bat action-update-wcm-extensions -DWasPassword=(password) -DPortalAdminPwd=(password)
    • IBM i :(profile_root)/ConfigEngine/ConfigEngine.sh action-update-wcm-extensions -DWasPassword=(password) -DPortalAdminPwd=(password)
    La tâche peut être exécutée même si vous n'êtes pas sûr que des extensions sont activées. Si vous souhaitez vérifier si elles ont été activées, vous pouvez utiliser les tâches suivantes :
    • - for MLS use ConfigEngine.sh|bat action-is-wcm-mls-enabled
    • - for SMP use ConfigEngine.sh|bat action-is-wcm-smp-enabled
  7. Si vous avez configuré un serveur de recherche distant ou un serveur de conversion de documents à utiliser avec HCL 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. Refer to the HCL Portal Version 8.5 Combined cumulative fix instructions: recherche à distance pour plus de détails sur l'application du groupe de correctifs sur le serveur distant.
  8. Videz le cache du navigateur.
  9. Accédez à la page Support logiciel HCL pour prendre connaissance des mises à jour recommandées pour HCL Portal et HCL Web Content Manager version 8.5 afin d'appliquer le correctifs recommandés.
  10. Prior to CF07, it was recommended to set the DB2 database configuration parameter dft_queryopt to a value of 2 as this was tested to provide the best balance of query optimization time and query execution time for the SQL produced by the JCR. Pour le groupe de correctifs CF07 et ultérieurs, cette recommandation a été modifiée pour utiliser une valeur de 5 conformément au test et aux modifications apportées au JCR et au schéma JCR. Cela peut être fait manuellement par les clients en exécutant le SQL suivant au niveau de la base de données du domaine JCR :
    db2 update db cfg for JCRDBNAME using DFT_QUERYOPT 5
    ou en exécutant la tâche ConfigEngine suivante :
    configure-jcr-db2-dft-queryopt
  11. Si l'archivage des journaux DB2 est utilisé (par exemple, la reprise à haut niveau de disponibilité après incident (HADR) ou la récupération en aval), exécutez la tâche suivante après avoir arrêté le serveur HCL Portal :
    • UNIX/Linux :(profile_root)/ConfigEngine/ConfigEngine.sh reconfigure-jcr-for-hadr -DWasPassword=(password) -DPortalAdminPwd=(password)
    • Windows :(profile_root)\ConfigEngine\ConfigEngine.bat reconfigure-jcr-for-hadr -DWasPassword=(password) -DPortalAdminPwd=(password)
    • IBM i :(profile_root)/ConfigEngine/ConfigEngine.sh reconfigure-jcr-for-hadr -DWasPassword=(password) -DPortalAdminPwd=(password)
    Remarque : Cette tâche peut prendre beaucoup de temps et d'espace journal DB2 si elle n'a jamais été exécutée et si un volume de données important a été stocké dans Web Content Manager.

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.

REMARQUE : Les versions de Portal antérieures à CF12 ne prennent pas en charge JDK 8. Par conséquent, si JDK 8 a été activé dans un groupe de correctifs CF12 ou une version antérieure, la commande managesdk doit être utilisée pour revenir à JDK 7 ou 7.1 avant d'exécuter une rétrogradation vers la version CF11 ou une version antérieure.

Limitations
  1. La modification de la racine de contexte du serveur après la mise à niveau est un chemin de rétrogradation non pris en charge. Pour procéder à la rétrogradation après avoir modifié la racine de contexte, vous devez d'abord modifier la racine de contexte du serveur pour revenir aux valeurs de la version précédente.
  2. Lors de la rétrogradation d'une installation de groupe de correctifs, si vous avez configuré une racine de contexte vide, vous ne pouvez pas revenir à un niveau de groupe de correctifs qui ne prend pas en charge la possibilité de racine de contexte vide. Par exemple, si vous avez appliqué le groupe de correctifs CF08 et que vous avez configuré une racine de contexte vide, vous ne pouvez pas revenir au groupe de correctifs CF07. Si vous avez appliqué le groupe de correctifs CF09 et que vous avez configuré une racine de contexte vide, vous pouvez revenir au groupe de corretifs CF08, mais vous ne pourrez pas revenir en arrière si votre niveau de groupe de correctifs précédent était CF07 ou une version ultérieure.
  3. La configuration d'HCL Portal depuis en environnement autonome vers un environnement en cluster après la mise à niveau est un chemin de rétrogradation non pris en charge.
Avant de commencer la rétrogradation
  1. Les scripts de rétrogradation d'HCL Portal dépendent de la mise à jour et de la précision des wkplc.properties, particulièrement des propriétés du mot de passe. Si vous utilisez plusieurs profils, vérifiez que les informations de chaque profil sont correctes.
  2. Edit the (wp_profile root)/ConfigEngine/properties/wkplc.properties file and ensure the following values are set correctly:
    • WasRemoteHostName=(the hostname of your WAS instance)
    • WasSoapPort=(the soap port of your WAS instance)
    • WasUserid=(your WAS admin user)
    • WasPassword=(your WAS admin pwd)
    • PortalAdminId=(your Portal Admin ID)
    • PortalAdminPwd=(your Portal Admin password)
    • WpsHostName=(Your Portal hostname)
    • WpsHostPort=(The port you use to access Portal)
    • WpsContextRoot=(your Portal context root)
    Remarque : Dans un environnement Portal autonome, le WasRemoteHostName doit être le nom d'hôte local et le WasSoapPort doit être le port SOAP du serveur WebSphere_Portal.
  3. Edit the (wp_profile root)/ConfigEngine/properties/wkplc_dbdomain.properties file and ensure the following values are set correctly:
    • release.DbPassword=(your database user password)
    • community.DbPassword=(your database user password)
    • customization.DbPassword=(your database user password)
    • jcr.DbPassword=(your database user password)
    • likeminds.DbPassword=(your database user password)
    • feedback.DbPassword=(your database user password)
  4. Edit the (wp_profile root)/ConfigEngine/properties/wkplc_comp.properties file and ensure the following values are set correctly:
    XmlAccessHost=(your Portal hostname)
    XmlAccessPort=(the port you use to access Portal)

Unix, Linux, Windows et IBM i : Le processus de mise à jour supprime les mots de passe en texte clair des fichiers wkplc*.properties. To keep these passwords in the properties files, include the following line in the wkplc.properties file: PWordDelete=false.

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.

Utilisation de l'interface utilisateur graphique pour la rétrogradation (disponible sous les systèmes d'exploitation Windows, Linux et Unix)
  1. Si vous exécutez un serveur Web externe, 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 (wp_profile)/bin, puis à nouveau depuis le répertoire (cw_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 version 8.5.
  4. Sélectionnez « Rétrograder » dans la fenêtre principale d'Installation Manager et suivez les invites pour rétrograder HCL Portal au niveau souhaité.
  5. Une fois la rétrogradation terminée, procédez aux étapes post-rétrogradation.
Utilisation de l'interface de ligne de commande pour la rétrogradation (disponible sous les systèmes d'exploitation Windows, Linux et Unix)
  1. Si vous exécutez un serveur Web externe, arrêtez-le.
  2. Stop any active application servers by using the stopServer command. To see which application servers are active, use the serverStatus command from the (wp_profile)/bin directory and again from the (cw_profile)/bin directory:
    • UNIX/Linux : ./serverStatus.sh -all
    • Windows : serverStatus.bat -all
  3. Open a command window and switch to the eclipse/tools subdirectory of 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. Si vous rétrogradez le groupe de correctifs sur HCL Portal Express, passez à l'étape 5. Sinon, exécutez la commande suivante pour lancer le programme d'installation d'IBM Installation Manager. Les commandes sont présentées 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.SERVER.v85
    	-installationDirectory (portal_server_root)
    Pour Windows :
    imcl.exe rollback com.ibm.websphere.PORTAL.SERVER.v85
    	-installationDirectory (portal_server_root)
  5. Portal HCL Express uniquement (IBM i utilsier la méthode mode silencieux ou console) : Exécutez la commande suivante pour lancer le programme d'installation d'Installation Manager à partir du sous-répertroire eclipse/tools. Les commandes sont présentées 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 Linux :
    ./imcl rollback com.ibm.websphere.PORTAL.EXPRESS.v85 
    	-installationDirectory (portal_server_root)
    Pour Windows :
    imcl.exe rollback com.ibm.websphere.PORTAL.EXPRESS.v85 
    	-installationDirectory (portal_server_root)
  6. Une fois la rétrogradation terminée, procédez aux étapes post-rétrogradation.
Utilisation du mode silencieux pour la rétrogradation (disponible pur les systèmes d'exploitation Windows, Linux, Unix et IBM i)
  1. Si vous exécutez un serveur Web externe, arrêtez-le.
  2. Stop any active application servers by using the stopServer command. To see which application servers are active, use the serverStatus command from the (wp_profile)/bin directory and again from the (cw_profile)/bin directory:
    • 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/cw_profile/ConfigEngine/properties/wkplc.properties
  4. Open a command window and switch to the eclipse/tools subdirectory of 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. Une fois la rétrogradation terminée, procédez aux étapes post-rétrogradation.
Use Console Mode Interface (available on Windows, Linux, Unix and IBM i operating systems)
  1. Si vous exécutez un serveur Web externe, arrêtez-le.
  2. Arrêtez les serveurs d'applications et actifs en utilisant la commande stopServer. To see which application servers are active, use the serverStatus command from the (wp_profile)/bin directory and again from the (cw_profile)/bin directory:
    • 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/cw_profile/ConfigEngine/properties/wkplc.properties
  4. Open a command window and switch to the eclipse/tools subdirectory of 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
    Pour Windows :
    imcl.exe -c
    Pour IBM i :
    ./imcl  -c
  6. Sélectionnez Rétrograder et suivez les invites pour rétrograder HCL Portal.
  7. Une fois l'installation terminée, procédez aux étapes post-rétrogradation.

Etapes post-rétrogradation

Linux, Unix, Windows ou IBM i Utilisez les commandes suivantes pour rétrograder tous les profils. Ces étapes doivent être répétées pour chaque profil, si plusieurs profils existent. Tous les profils qui partagent le même répertoire d'installation Portal (option à profils multiples) doivent être au même niveau pour que les futures mises à niveau puissent être appliquées. Les étapes de configuration suivantes doivent être effectuées par l'utilisateur qui administre normalement le serveur Portal, qui peut être ou non le même utilisateur que celui qui exécute le programme d'installation. Si un serveur de recherche distante est utilisé dans cet environnement, il doit être démarré avant d'exécuter les commandes suivantes.
  1. Exécutez la commande suivante depuis le chemin du profil à configurer. Si vous rétrogradez le groupe de correctifs sur un portail vide, alors de nombreux artefacts attendus n'existeront pas et la commande rollbackCF échouera. Dans ce cas, vous devez définir la propriété isEmptyPortal dans la ligne de commande.
    Example: rollbackCF.sh -DisEmptyPortal=true
    Si la commande rollbackCF échoue pour l'une ou l'autre raison, consultez les journaux des erreurs, corrigez les erreurs, puis arrêtez WebSphere_Portal avant de l'exécuter à nouveau.
    • UNIX/Linux : (profile_root)/PortalServer/bin/rollbackCF.sh -DPortalAdminPwd=(password) -DWasPassword=(password)
    • Windows : (profile_root)\PortalServer\bin\rollbackCF.bat -DPortalAdminPwd=(password) -DWasPassword=(password)
    • IBM i : (profile_root)/PortalServer/bin/rollbackCF.sh -DPortalAdminPwd=(password) -DWasPassword=(password)
  2. Si vous exécutez un serveur Web externe et que vous utilisez la génération automatique de WebSphere Application Server et la propagation du plug-in, redémarrez alors le serveur Web. Si vous n'utilisez pas la génération automatique et la propagation automatique, régénérez simplement le plug-in du serveur Web, copiez le fichier plugin-cfg.xml dans le répertoire plugin et redémarrez le serveur Web.
  3. If you previously customized any configuration files in the wp_profile_root/PortalServer/config directory, check to see if rolling back the cumulative fix affected those files by restoring a version of the files that was saved when the cumulative fix was originally installed. En cas d'incidence sur les fichiers, vous devez personnaliser de la même façon la version restaurée de chaque fichier.
  4. Si nécessaire, redéployez tous les éléments personnalisés, y compris les JSP, sur les portlets WCM (si vous utilisez Web Content Manager), sur tout autre portlet ou toute autre application d'entreprise Portal, si vous les avez personnalisés, avant de rétrograder le groupe de correctifs.
  5. Si vous utilisez HCL Web Content Manager et que vous avez installé des extensions officielles (telles que la solution multilingue WCM ou le diffuseur de médias sociaux pour WCM), exécutez la tâche suivante pour les mettre à jour.
    • UNIX/Linux : (profile_root)/ConfigEngine/ConfigEngine.sh action-update-wcm-extensions -DWasPassword=(password) -DPortalAdminPwd=(password)
    • Windows : (profile_root)\ConfigEngine\ConfigEngine.bat action-update-wcm-extensions -DWasPassword=(password) -DPortalAdminPwd=(password)
    • IBM i : (profile_root)/ConfigEngine/ConfigEngine.sh action-update-wcm-extensions -DWasPassword=(password) -DPortalAdminPwd=(password)
    La tâche peut être exécutée même si vous n'êtes pas sûr que des extensions sont activées. Si vous souhaitez vérifier si elles ont été activées, vous pouvez utiliser les tâches suivantes :
    • - for MLS use ConfigEngine.sh|bat action-is-wcm-mls-enabled
    • - for SMP use ConfigEngine.sh|bat action-is-wcm-smp-enabled
  6. Pour la rétrogradation vers le niveau de groupe de correctifs CF03 ou antérieur uniquement : Si l'intégration Brightcove était activée, supprimez les anciens plugins Brightcove, puis configurez HCL Portal pour ajouter les nouveaux plugins Brightcove.
  7. Pour la rétrogradation vers le niveau de groupe de correctifs CF03 ou antérieur uniquement : Si vous utilisez Rich Media Edition, supprimez le plug-in Rich Media Edition, redemarrez Portal Server, puis configurez HCL Portal pour ajouter les nouvreaux plug-ins Rich Media Edition.
  8. Si vous avez configuré un serveur de recherche distant ou un serveur de conversion de documents à utiliser avec HCL Portal version 8.5, alors chaque fois que vous rétrogradez un groupe de correctifs sur le serveur du portail, vous devez également rétrograder le groupe de correctifs correspondant sur le serveur distant.
  9. Videz le cache du navigateur.