CF07 and earlier: Finalisation de la modification d'URI de portail commencée lors de l'installation

Si vous avez modifié la racine de contexte sur l'Configuration pour HCL Digital Experience Portal : Détails de configuration du profil : Advanced pane during installation, there are more steps to take to complete the change.

Pourquoi et quand exécuter cette tâche

Si vous êtes sous Combined Cumulative Fix 8, accédez à Modification de l'URL de site après une installation.

HCL Digital Experience and Web Services for Remote Portlets are installed with a default URI. Vous pouvez changer cet identificateur URI après l'installation, en fonction des besoins de votre organisation.

Notes :
  • Pour modifier l'URI d'HCL DX : Lors du choix de la racine de contexte, n'indiquez pas une valeur qui pourrait être identique à celle d'un répertoire existant dans le répertoire WAR d'un portlet. Par exemple, vous définissez la racine de contexte HCL DX sur /images. Il existe un portlet avec la structure de répertoire /myPortlet.ear/myPortlet.war/images. Ce problème peut générer un conflit si le portlet code les références d'URI sur les ressources dans son propre répertoire /images. Dans ce cas, le portlet ne pourra pas afficher les images. HCL DX recherche les ressources de l'image en fonction de son propre chemin racine de contexte plutôt que selon le chemin du répertoire spécifié par le fichier WAR du portlet.
  • Pour modifier l'URI d'un portail Producteur WSRP. La modification de la racine de contexte du Producteur WSRP ne requièrt pas le redéploiement de tous les portlets. Exécutez la tâche de configuration modify-servlet-path uniquement.
    Important : Avec la version 8, l'URI de la racine de contexte du producteur WSRP est /wps/wsrp. Avant la version 8, cette racine de contexte était /wsrp. Si vous avez effectué une migration à partir d'une version antérieure, vous disposez peut-être encore de consommateurs WSRP qui tentent d'accéder au producteur WSRP avec la racine de contexte précédente (/wsrp). Vous pouvez résoudre ce problème de l'une des manières suivantes :
    • Remplacez la racine de contexte du producteur WSRP par /wsrp. Cette modification permet aux consommateurs d'accéder au fournisseur sans avoir à modifier de nouveau les consommateurs.
    • Mettez à jour la configuration des consommateurs WSRP pour qu'ils utilisent la nouvelle racine de contexte (/wps/wsrp).
  • Si vous utilsiez la syndication HCL Web Content Manager, les serveurs Syndicateurs et Abonnés faisant référence à cette instance de portail doivent être mis à jour avec l'URI modifié. Connectez-vous à HCL DX qui syndique avec cette instance. Click the Administration menu icon. Then, click Portal Content > Syndicators. Cliquez sur l'icône d'édition du Syndicateur si vous souhaitez le modifier. Mettez à jour l'adresse URL avec les nouvelles informations de la racine de contexte. Ensuite, connectez-vous à HCL DX qui s'abonne à cette instance. Click the Administration menu icon. Then, click Portal Content > Subscribers. Cliquez sur l'icône d'édition de l'abonné que vous souhaitez éditer. Mettez à jour l'adresse URL avec les nouvelles informations de la racine de contexte.

Procédure

  1. Si nécessaire, démarrez le serveur WebSphere_Portal dans un environnement autonome ou le gestionnaire de déploiement et l'agent de noeud dans un environnement en cluster.
  2. Effectuez les étapes suivantes sur le serveur de gestionnaire de déploiement :
    1. Connectez-vous à la console WebSphere® Integrated Solutions Console du gestionnaire de déploiement.
    2. Accédez à Sécurité > Sécurité globale.
    3. Sous Web et sécurité SIP, cliquez sur Relation de confiance.
    4. Cliquez sur Intercepteurs dans la section ropriétés supplémentaires.
    5. Cliquez sur com.ibm.portal.auth.tai.HTTPBasicAuthTAI.
    6. Modifiez les paramètres urlBlackList et urlWhiteList avec le nouveau chemin de contexte, par exemple :
      • urlBlackList : /wpsmodified/myportalmodified*
      • urlWhiteList : /wpsmodified/mycontenthandler*
    7. Cliquez sur Appliquer.
    8. Enregistrez les modifications.
    9. Log out of the Deployment Manager WebSphere® Integrated Solutions Console.
  3. Complete the following steps if you are using an external web server, such as an HTTP Server:
    1. Choisissez l'une des options suivantes en fonction de votre environnement HCL DX :
      Tableau 1. Options de commande configurewebservername
      Environnement HCL DX Etapes
      Configuration autonome Procédez comme suit dans une configuration autonome :
      1. Copiez le script suivant depuis le répertoire plugin_root/bin du serveur Web vers le répertoire wp_profile_rootwp_profile_root/bin du serveur HCL DX  :
        • AIX® HP-UX Linux™ Solaris: ./configurewebservername.sh
        • Windows™ : configurewebservername.bat
        • IBM® i: configurewebservername.sh
        • z/OS® : ./configurewebservername.sh

        où webservername est le nom de la définition du serveur Web que vous avez défini lors de la configuration de HTTP Server pour HCL DX, par exemple : configurewebserver1.bat.

      2. Exécutez la commande suivante à partir du répertoire wp_profile_rootwp_profile_root/bin :
        • AIX® HP-UX Linux™ Solaris: ./configurewebservername.sh
        • Windows™ : configurewebservername.bat
        • IBM® i: configurewebservername.sh
        • z/OS® : ./configurewebservername.sh
      Configuration en clusterConfiguration de machine de secours en veille Procédez comme suit dans une configuration groupéeconfiguration en veille inactive: 
      1. Copiez le script suivant depuis le répertoire plugin_root/bin du serveur Web vers le répertoire dmgr_profile/bin du serveur de gestionnaire de déploiement :
        • AIX® HP-UX Linux™ Solaris : ./configurewebservername.sh
        • Windows™ : configurewebservername.bat
        • IBM® i: configurewebservername.sh
        • z/OS® : ./configurewebservername.sh

        où webservername est le nom de la définition du serveur Web que vous avez défini lors de la configuration de HTTP Server pour HCL DX, par exemple : configurewebserver1.bat.

      2. Exécutez la commande suivante sur le serveur de gestionnaire de déploiement :
        • AIX® HP-UX Linux™ Solaris: ./configurewebservername.sh
        • Windows™ : configurewebservername.bat
        • IBM® i: configurewebservername.sh
        • z/OS® : ./configurewebservername.sh
    2. Régénérez le plug-in de serveur Web dans WebSphere® Application Server. Si vous utilisez un serveur Web distant, copiez sur ce dernier le fichier plugin-cfg.xml généré.
      Important : N'exécutez pas les étapes suivantes si vous modifiez uniquement l'URI du Producteur WSRP.
    3. Redémarrez le serveur Web.
    4. Redémarrez le serveur WebSphere_Portal.
  4. Procédez comme suit pour mettre à jour les entrées d'URI d'applications enregistrées dans la table JCR.ICMSTJCRNODEREGISTER :
    Cluster note : Dans un environnement en cluster, exécutez ces étapes uniquement sur le noeud principal.
    1. Arrêtez le serveur WebSphere_Portal.
    2. Sauvegardez la base de données.
    3. Si vous disposez d'un groupe de correctifs antérieur à CF04, démarrez le serveur WebSphere_Portal. Si vous disposez d'un groupe de correctifs CF04 ou de niveau ultérieur, ne redémarrez pas le serveur WebSphere_Portal.
    4. Procédez comme suit pour désenregistrer les types de noeud :
      • Ouvrez le fichier ibmcontentwcm.registernodetypes qui se trouve dans le répertoire /WebSphere/PortalServer/wcm/prereq.wcm/config/nodetypes/.
      • Modifiez <registerAction action="register"/> en <registerAction action="deregister"/>.
      • Sauvegardez vos modifications.
      • Exécutez la tâche suivante :
        • AIX® HP-UX Linux™ Solaris: ./ConfigEngine.sh action-register-wcm-nodetypes -DWasPassword=password -DPortalAdminPwd=password
        • Windows™ : ConfigEngine.bat action-register-wcm-nodetypes -DWasPassword=password -DPortalAdminPwd=password
        • IBM® i: ConfigEngine.sh action-register-wcm-nodetypes -DWasPassword=password -DPortalAdminPwd=password
        • HP-UX: ./ConfigEngine.sh action-register-wcm-nodetypes -DWasPassword=password -DPortalAdminPwd=password
    5. Procédez comme suit pour enregistrer les types de noeud :
      • Ouvrez le fichier ibmcontentwcm.registernodetypes qui se trouve dans le répertoire /WebSphere/PortalServer/wcm/prereq.wcm/config/nodetypes/.
      • Modifiez <registerAction action="deregister"/> en <registerAction action="register"/>.
      • Mettez à jour toutes les lignes qui renferment le contenu <ApplicationURI name="wps/mypoc/?view=auth&uri=wcm:oid:"/>.

        Modifiez le nom de la valeur d'attribut pour répercuter la nouvelle valeur de WpsContextRoot figurant dans le fichier wkplc.properties. Par exemple, si la valeur d'origine de WpsContextRoot était wps et la nouvelle valeur est wp8, remplacez les lignes par <ApplicationURI name="wp8/mypoc/?view=auth&uri=wcm:oid:"/>.

      • Exécutez la tâche suivante :
        • AIX® HP-UX Linux™ Solaris: ./ConfigEngine.sh action-register-wcm-nodetypes -DWasPassword=password -DPortalAdminPwd=password
        • Windows™ : ConfigEngine.bat action-register-wcm-nodetypes -DWasPassword=password -DPortalAdminPwd=password
        • IBM® i: ConfigEngine.sh action-register-wcm-nodetypes -DWasPassword=password -DPortalAdminPwd=password
        • z/OS® : ./ConfigEngine.sh action-register-wcm-nodetypes -DWasPassword=password -DPortalAdminPwd=password
    6. Exécutez la requête SQL suivante pour vérifier que les entrées de la table contiennent le nouvel URI : 
      select * from JCR.ICMSTJCRNODEREGISTER
    7. Redémarrez le serveur WebSphere_Portal.
  5. Obligatoire si vous utilisez HCL Web Content Manager : Procédez comme suit pour modifier manuellement les composants JSP qui se trouvent dans la bibliothèque Web Resources v70 :
    Cluster note : Dans un environnement en cluster, exécutez ces étapes uniquement sur le nœud principal.
    1. Log on to HCL DX.
    2. Accédez à Applications > Contenu > Créer un contenu Web.
    3. Under Preferences, select Edit Shared Settings.
    4. Sous Sélection de bibliothèque, ajoutez Web Resources v70 à la liste Bibliothèques sélectionnées.
    5. Cliquez sur OK.
    6. Sous Vues d'élément, sélectionnez Tous les éléments > Tout > Composants > JSP.
    7. Select every JSP component from the Web Resources v70 library and then click Edit.
    8. Mettez à jour la zone Chemin pour chaque composant JSP à l'aide du nouveau chemin de racine de contexte.

      Le chemin JSP est composé de deux parties qui sont séparées par un point-virgule. La première partie correspond au chemin de contexte de l'application Web des extensions HCL Web Content Manager et la seconde partie est le chemin d'accès à JSP. Mettez à jour le chemin d'accès à l'application Web.

      Par exemple, l'autre chemin peut être : /wcmextension;/jsp/html/general/UpdateItem.jsp. Si vous avez remplacé la racine de contexte par mynewcontext, remplacez l'ancien chemin par /mynewcontext/wcmextension;/jsp/html/general/UpdateItem.jsp.

  6. Pour éditer la racine de contexte pour chaque collection de recherche, procédez comme suit :
    Avertissement : Editez la racine de contexte pour chaque collection de recherche existante.
    1. Connectez-vous à HCL DX en tant qu'administrateur.
    2. To open the Manage Search portlet, click the Administration menu icon. Then, click Search Administration > Manage Search.
    3. Click Search Collections.
    4. Cliquez sur la collection de recherche que vous souhaitez mettre à jour.
      Par exemple: Collection de recherche par défaut.
    5. Cliquez sur l'icône Editer la source de contenu pour la première source de contenu de la liste.
    6. Editer l'URL répertoriée dans Collecter les documents liés à cette URL avec la nouvelle racine de contexte.
    7. Cliquez sur Sauvegarder.
    8. Editez l'URL dans chaque source de contenu restante, puis sauvegardez vos modifications.
    9. Ouvrez la source de contenu du moteur de balayage HCL DX pour chaque collection :
      • Si les documents ne sont pas stockés dans la collection de recherche mais qu'une planification est définie pour le moteur de balayage, le moteur de balayage s'exécute automatiquement à l'heure planifiée. Vous pouvez également démarrer le moteur de balayage manuellement.
      • Si les documents sont déjà collectés, sélectionnez Regrouper les documents pour mettre à jour les documents avec les nouvelles informations de racine de contexte.
    10. Click Collections from All Services in the breadcrumb trail and select the next search collection to modify.
  7. Complete the following steps to change the context root for the Seedlist_Servlet:
    1. Log in to the WebSphere® Integrated Solutions Console.
    2. Accédez à Applications > Types d'application > Applications d'entreprise WebSphere.
    3. Cliquez sur le lien de l'application Seedlist_Servlet.
    4. Cliquez sur Racine du contexte pour les modules Web.
    5. Modifiez la racine de contexte et cliquez sur OK.
    6. Sauvegardez vos modifications.
  8. Environnement de cluster uniquement :Machine de secours en veille uniquement : Resynchronisez les nœuds et redémarrez le cluster.
    Tableau 2. Etapes pour la resynchronisation des noeuds et le redémarrage du cluster.
    Type de cluster Etapes
    Cluster statiqueMachine de secours en veille Procédez comme suit si vous possédez un cluster statiqueun environnement de machine de secours en veille :
    1. Open the deployment manager WebSphere® Integrated Solutions Console.
    2. Cliquez sur Administration système > nœuds, sélectionnez le nœud principal dans la liste et cliquez sur Resynchronisation complète.
    3. Click Servers > Clusters.
    4. Select the cluster and click Stop.
    5. Une fois le cluster arrêté, redémarrez-le en le sélectionnant, Puis cliquez sur Démarrer.
    Cluster dynamique Procédez comme suit si vous possédez un cluster dynamique :
    1. Open the deployment manager WebSphere® Integrated Solutions Console.
    2. Click System Administration > Nodes, select the primary node from the list, and click Full Resynchronize.
    3. Cliquez sur Serveurs > Clusters dynamiques.
    4. Cliquez sur le cluster dynamique que vous souhaitez arrêter et redémarrer.
    5. Cliquez sur Membres de cluster dynamique.
    6. Sélectionnez le nom du membre que vous souhaitez arrêter, puis cliquez sur Arrêter.
    7. Sélectionnez le nom du membre que vous souhaitez arrêter, puis cliquez sur Démarrer.
  9. Procédez comme suit sur le serveur autonome ou sur chaque noeud de votre cluster pour créer les variables d'environnement WebSphere requises par HCL Web Content Manager :
    1. Localisez les fichiers wkplc.properties et wkplc_comp.properties dans le répertoire wp_profile_root/ConfigEngine/properties et créez des copies de sauvegarde avant de modifier des valeurs.
    2. A l'aide d'un éditeur de texte, ouvrez le fichier wkplc.properties et entrez la valeur appropriée pour votre environnement dans la propriété WpsContextRoot.
    3. Enregistrez et fermez le fichier.
    4. A l'aide d'un éditeur de texte, ouvrez le fichier wkplc_comp.properties et entrez la valeur appropriée pour votre environnement dans les propriétés suivantes :
      • WsrpContextRoot
      • WpsPersonalizedHome
      • WpsDefaultHome
      Avertissement : N'entrez pas la même valeur pour WpsPersonalizedHome et WpsDefaultHome.
    5. Enregistrez et fermez le fichier.
    6. Exécutez la tâche suivante pour créer des variables d'environnement WebSphere pour Web Content Manager :
      • AIX® HP-UX Linux™ Solaris: ./ConfigEngine.sh create-wcm-servletpath-variables -DServerName=your_application_server_name -DWasPassword=password
      • Windows™ : ConfigEngine.bat create-wcm-servletpath-variables -DServerName=your_application_server_name -DWasPassword=password
      • IBM® i: ConfigEngine.sh create-wcm-servletpath-variables -DServerName=your_application_server_name -DWasPassword=password
      • z/OS® : ./ConfigEngine.sh create-wcm-servletpath-variables -DServerName=your_application_server_name -DWasPassword=password
      Remarque : Avant de passer à la tâche suivante, vérifiez les éventuels messages d'erreur en sortie. Si l'une des tâches de configuration échoue, vérifiez les valeurs dans les fichiers wkplc.properties et wkplc_comp.properties.
  10. Resynchronisez les nœuds et redémarrez le cluster.