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.
- 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.
(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.
- 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.
- Modifiez le fichier
(wp_profile root)/ConfigEngine/properties/wkplc.propertieset 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)
- Edit the
(wp_profile root)/ConfigEngine/properties/wkplc_dbdomain.propertiesfile 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)
- Edit the
(wp_profile root)/ConfigEngine/properties/wkplc_comp.propertiesfile 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
- 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.
- Ouvrez une fenêtre de ligne de commande.
- Exécutez cette commande pour vérifier votre paramètre unmask actuel :
umask - 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.
applyCF.sh ou applyCF.bat ou pour mettre à jour le profil de Portal, procédez comme suit : - 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/ConfigEngineWindows: C:\IBM\WebSphere\ConfigEngineIBM i: /QIBM/ProdData/WebSphere/ConfigEngine
- Effectuez une copie de sauvegarde du script ConfigEngine. Ce fichier est intitulé
pour Windows etConfigEngine.bat
pour toutes les plateformes.ConfigEngine.sh - Assurez-vous que vous disposez des droits en écriture pour le fichier de script et ouvrez-le dans un éditeur de texte.
- Recherchez le texte
EJBDEPLOY_JAVA_HOMEdans le script. - 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_HOMEdans la ligne. (Il doit y avoir 3 lignes de ce type dans le script .sh et 2 lignes dans le script .bat) - Enregistrez le fichier.
Vous pouvez maintenant poursuivre l'installation du groupe de correctifs (CF) de Portal.
Téléchargez le groupe de correctifs
- Accédez à la page du Support logiciel HCL et téléchargez le dernier fichier zip qui correspond à l'installation sur votre système.
- 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.
- Créez un sous-répertoire pour extraire le fichier zip approprié dans ce répertoire. The extraction results in a
repository.configfile 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.
- Si vous exécutez un serveur Web externe, arrêtez-le.
- Stop any active application servers by using the
stopServercommand. To see which application servers are active, use theserverStatuscommand from the(wp_profile)/bin directoryand again from the(cw_profile)/bindirectory:Unix/Linux: ./serverStatus.sh -allWindows: serverStatus.bat -all
- Lancez l'IBM Installation Manager qui a été utilisé pour installer HCL Portal version 8.5.
- Using Installation Manager, click File then Preferences.
- Go to the Repositories panel and click "Add Repository".
- Naviguez vers le fichier repository.config mentionné plus haut et sélectionnez-le.
- SélectionnezMettre à jour et suivez les invites pour mettre à jour HCL Portal.
- Une fois l'installation terminée, procédez aux « Etapes de configuration supplémentaires ».
- Si vous exécutez un serveur Web externe, arrêtez-le.
- Stop any active application servers by using the
stopServercommand. To see which application servers are active, use theserverStatuscommand from the( wp_profile)/bindirectory and again from the(cw_profile)/bindirectory:Unix/Linux: ./serverStatus.sh -allWindows: serverStatus.bat -all
- Lancez l'IBM Installation Manager qui a été utilisé pour installer HCL Portal version 8.5.
- Using Installation Manager, click File then Preferences.
- Go to the Repositories panel and click Search service repositories during installation and updates. Cliquez sur Appliquer.
- SélectionnezMettre à jour et suivez les invites pour mettre à jour HCL Portal.
- Une fois l'installation terminée, procédez aux « Etapes de configuration supplémentaires ».
- Si vous exécutez un serveur Web externe, arrêtez-le.
- Stop any active application servers by using the
stopServercommand. To see which application servers are active, use theserverStatuscommand from the( wp_profile)/bindirectory and again from the(cw_profile)/bindirectory:Unix/Linux: ./serverStatus.sh -allWindows: serverStatus.bat -all
- 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/toolsWindows: C:\Program Files\IBM\Installation Manager\eclipse\tools
- 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 :
Pour Windows :./imcl install com.ibm.websphere.PORTAL.SERVER.v85 -repositories (fullpath/to/repository.config) -installationDirectory (portal_server_root) -installationDirectory(portal_server_root) -acceptLicenseimcl.exe install com.hcl.websphere.PORTAL.SERVER.v85 -repositories (fullpath/to/repository.config) -installationDirectory (portal_server_root) -acceptLicense - 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 :
Pour Windows :./imcl install com.hcl.websphere.PORTAL.EXPRESS.v85 -repositories (fullpath/to/repository.config) -installationDirectory (portal_server_root) -acceptLicenseimcl.exe install com.ibm.websphere.PORTAL.EXPRESS.v85 -repositories (fullpath/to/repository.config) -installationDirectory (portal_server_root) -acceptLicense - Une fois l'installation terminée, procédez aux « Etapes de configuration supplémentaires ».
- Si vous exécutez un serveur Web externe, arrêtez-le.
- Stop any active application servers by using the
stopServercommand. To see which application servers are active, use theserverStatuscommand from the( wp_profile)/bindirectory and again from the(cw_profile)/bindirectory:- UNIX/Linux :
./serverStatus.sh -all - Windows :
serverStatus.bat -all - IBM i :
serverStatus -all
- UNIX/Linux :
- 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 - 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
- UNIX/Linux :
- 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
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,portal.profile'
.features='ce.install,portal.binary' - 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 - Une fois l'installation terminée, procédez aux « Etapes de configuration supplémentaires ».
- Si vous exécutez un serveur Web externe, arrêtez-le.
- Stop any active application servers by using the
stopServercommand. To see which application servers are active, use theserverStatuscommand from the( wp_profile)/bindirectory and again from the(cw_profile)/bindirectory:- UNIX/Linux :
./serverStatus.sh -all - Windows :
serverStatus.bat -all - IBM i :
serverStatus -all
- UNIX/Linux :
- 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 - 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
- UNIX/Linux :
- Exécutez la commande pour lancer l'IBM Installation Manager en mode console : Pour Unix/Linux :
Pour Windows :./imcl -c
Pour IBM i :imcl.exe -c./imcl -c - Pour ajouter les référentiels, procédez comme suit :
- Select Update and follow the prompts to update HCL Portal.
- Une fois l'installation terminée, procédez aux « Etapes de configuration supplémentaires ».
- 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 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.
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.
- 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
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-templatesAppliquez le groupe de correctifs
- Assurez-vous que le serveur WebSphere_Portal est arrêté sur le profil que vous souhaitez mettre à niveau.
- 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 commandeapplyCFé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)
- UNIX/Linux :
- 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 - 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)
- UNIX/Linux :
- 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
- UNIX/Linux :
- 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/bindirectory 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
- 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.xmldans le répertoire plugin et redémarrez le serveur Web. - 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.blacklistandcom.ibm.portal.resource.whitelistn'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. - 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.
- 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.
- 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.
- 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)
- for MLS use ConfigEngine.sh|bat action-is-wcm-mls-enabled- for SMP use ConfigEngine.sh|bat action-is-wcm-smp-enabled
- UNIX/Linux :
- 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.
- Videz le cache du navigateur.
- 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.
- Prior to CF07, it was recommended to set the DB2 database configuration parameter
dft_queryoptto 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 :
ou en exécutant la tâche ConfigEngine suivante :db2 update db cfg for JCRDBNAME using DFT_QUERYOPT 5configure-jcr-db2-dft-queryopt - 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)
- UNIX/Linux :
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.
- 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.
- 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.
- 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.
- 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. - Edit the
(wp_profile root)/ConfigEngine/properties/wkplc.propertiesfile 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)
WasRemoteHostNamedoit être le nom d'hôte local et leWasSoapPortdoit être le port SOAP du serveurWebSphere_Portal. - Edit the
(wp_profile root)/ConfigEngine/properties/wkplc_dbdomain.propertiesfile 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)
- Edit the
(wp_profile root)/ConfigEngine/properties/wkplc_comp.propertiesfile 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.
- 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.
- Si vous exécutez un serveur Web externe, arrêtez-le.
- Stop any active application servers by using the
stopServercommand. 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
- UNIX/Linux :
- Lancez l'IBM Installation Manager qui a été utilisé pour installer HCL Portal version 8.5.
- Sélectionnez « Rétrograder » dans la fenêtre principale d'Installation Manager et suivez les invites pour rétrograder HCL Portal au niveau souhaité.
- Une fois la rétrogradation terminée, procédez aux étapes post-rétrogradation.
- Si vous exécutez un serveur Web externe, arrêtez-le.
- Stop any active application servers by using the
stopServercommand. To see which application servers are active, use theserverStatuscommand from the(wp_profile)/bindirectory and again from the(cw_profile)/bindirectory:- UNIX/Linux :
./serverStatus.sh -all - Windows :
serverStatus.bat -all
- UNIX/Linux :
- Open a command window and switch to the
eclipse/toolssubdirectory 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
- UNIX/Linux :
- 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 :
Pour Windows :./imcl rollback com.ibm.websphere.PORTAL.SERVER.v85 -installationDirectory (portal_server_root)imcl.exe rollback com.ibm.websphere.PORTAL.SERVER.v85 -installationDirectory (portal_server_root) - 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 :
Pour Windows :./imcl rollback com.ibm.websphere.PORTAL.EXPRESS.v85 -installationDirectory (portal_server_root)imcl.exe rollback com.ibm.websphere.PORTAL.EXPRESS.v85 -installationDirectory (portal_server_root) - Une fois la rétrogradation terminée, procédez aux étapes post-rétrogradation.
- Si vous exécutez un serveur Web externe, arrêtez-le.
- Stop any active application servers by using the
stopServercommand. To see which application servers are active, use theserverStatuscommand from the(wp_profile)/bindirectory and again from the(cw_profile)/bindirectory:- UNIX/Linux :
./serverStatus.sh -all - Windows :
serverStatus.bat -all - IBM i :
serverStatus -all
- UNIX/Linux :
- 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 - Open a command window and switch to the
eclipse/toolssubdirectory 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
- UNIX/Linux :
- 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.
- 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 - Une fois la rétrogradation terminée, procédez aux étapes post-rétrogradation.
- Si vous exécutez un serveur Web externe, arrêtez-le.
- Arrêtez les serveurs d'applications et actifs en utilisant la commande stopServer. To see which application servers are active, use the
serverStatuscommand from the(wp_profile)/bindirectory and again from the(cw_profile)/bindirectory:- UNIX/Linux :
./serverStatus.sh -all - Windows :
serverStatus.bat -all - IBM i :
serverStatus -all
- UNIX/Linux :
- 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 - Open a command window and switch to the
eclipse/toolssubdirectory 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
- UNIX/Linux :
- Exécutez la commande pour lancer l'IBM Installation Manager en mode console. Pour Unix/Linux :
Pour Windows :./imcl -c
Pour IBM i :imcl.exe -c./imcl -c - Sélectionnez Rétrograder et suivez les invites pour rétrograder HCL Portal.
- Une fois l'installation terminée, procédez aux étapes post-rétrogradation.
Etapes post-rétrogradation
- 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é
isEmptyPortaldans la ligne de commande.
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.Example: rollbackCF.sh -DisEmptyPortal=true- 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)
- UNIX/Linux :
- 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.xmldans le répertoire plugin et redémarrez le serveur Web. - If you previously customized any configuration files in the
wp_profile_root/PortalServer/configdirectory, 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. - 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.
- 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)
- for MLS use ConfigEngine.sh|bat action-is-wcm-mls-enabled- for SMP use ConfigEngine.sh|bat action-is-wcm-smp-enabled
- UNIX/Linux :
- 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.
- 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.
- 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.
- Videz le cache du navigateur.