CF07 et versions antérieures : Modification de l'URI de portail après une installation

Vous pouvez modifier l'identificateur URI de portail par défaut à tout moment après l'installation de HCL Digital Experience. Certaines d'applications ont une racine de contexte fixe qui ne peut pas être modifiée.

Pourquoi et quand exécuter cette tâche

Si vous êtes sur Groupe de correctifs combinés 8, accédez à Modification de l'URI de portail après une installation.

HCL Digital Experience et Web Services for Remote Portlets sont installés avec un URI par défaut. 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 requiert 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 utilisez 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.
Cluster note : Si vous modifiez l'URI dans un environnement groupé, ne suivez cette procédure que sur le nœud principal, sauf indication contraire. Vérifiez également que le paramètre AutoSynch est défini avec une fréquence de 1 minute.

Procédure

  1. Procédez de la manière suivante pour modifier manuellement la racine de contexte d'HCL DX :
    1. Arrêtez le serveur WebSphere_Portal.
    2. 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.
    3. 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.
    4. Enregistrez et fermez le fichier.
    5. 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.
    6. Enregistrez et fermez le fichier.
    7. Démarrez le serveur WebSphere_Portal dans un environnement autonome ou le gestionnaire de déploiement et l'agent de nœud dans un environnement groupé.
    8. Ouvrez une invite de commande et accédez au répertoire wp_profile_root/ConfigEngine.
    9. Procédez comme suit pour changer l'URI d'HCL DX :
      1. Pour modifier la racine de contexte des valeurs entrées dans les propriétés WpsContextRoot, WsrpContextRoot, WpsPersonalizedHome et/ou WpsDefaultHome, exécutez la tâche suivante :
        • AIX® HP-UX Linux™ Solaris :./ConfigEngine.sh modify-servlet-path -DPortalAdminPwd=password -DWasPassword=password
        • Windows™ : ConfigEngine.bat modify-servlet-path -DPortalAdminPwd=password -DWasPassword=password
        • IBM® i: ConfigEngine.sh modify-servlet-path -DPortalAdminPwd=password -DWasPassword=password
        • z/OS® :./ConfigEngine.sh modify-servlet-path -DPortalAdminPwd=password -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.
      2. Redémarrez le serveur WebSphere_Portal.
    10. Exécutez la tâche pour modifier la racine de contexte pour les portlets :
      • AIX® HP-UX Linux™ Solaris: ./ConfigEngine.sh modify-servlet-path-portlets -DPortalAdminPwd=password -DWasPassword=password
      • Windows™ : ConfigEngine.bat modify-servlet-path-portlets -DPortalAdminPwd=password -DWasPassword=password
      • IBM® i: ConfigEngine.sh modify-servlet-path-portlets -DPortalAdminPwd=password -DWasPassword=password
      • z/OS® : ./ConfigEngine.sh modify-servlet-path-portlets -DPortalAdminPwd=password -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.
  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 Proprié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. Déconnectez-vous de la console WebSphere® Integrated Solutions Console du gestionnaire de déploiement.
  3. Si nécessaire, démarrez le serveur WebSphere_Portal dans un environnement autonome ou le gestionnaire de déploiement et l'agent de nœud dans un environnement en cluster.
  4. Procédez comme suit si vous utilisez un serveur Web externe, tel que 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_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_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.
  5. 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 nœud 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 nœud :
      • 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 nœud :
      • 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.
  6. 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 noeud principal.
    1. Connectez-vous à HCL DX.
    2. Accédez à Applications > Contenu > Créer un contenu Web.
    3. Sous Préférences, cliquez sur Editer les paramètres partagés.
    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. Sélectionnez tous les composants JSP dans la bibliothèque Web Resources v70 et cliquez sur Editer.
    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.

  7. Facultatif : Mettez à jour vos thèmes personnalisés pour qu'ils référencent la racine de contexte Dojo appropriée.

    La racine de contexte Dojo par défaut dans HCL DX est /wps/portal_dojo. Une fois que vous avez exécuté les tâches modify-servlet-path et modify-servlet-path-portlets, la racine de contexte Dojo est modifiée et la nouvelle valeur du paramètre WpsContextRoot lui est ajoutée en tant que préfixe. Par exemple, si la nouvelle valeur de WpsContextRoot est myco, la nouvelle racine de contexte Dojo est /myco/portal_dojo. Si votre thème contient des références à "/wps/portal_dojo" qui sont codées en dur, mettez à jour ces références avec la nouvelle racine de contexte. Si vous avez migré un thème personnalisé, il se peut qu'il contienne des références à /portal_dojo sans le préfixe /wps. Recherchez ces références dans le fichier WAR et dans le stockage WebDAV de votre thème.

    Cluster note : Dans un environnement en cluster, exécutez ces étapes uniquement sur le noeud principal.
  8. 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. Cliquez sur Collections from all services dans le trajet de navigation et sélectionnez la prochaine collection de recherche à modifier.
  9. Procédez comme suit si vous avez modifié la racine de contexte et que vous disposez de portées de recherche existantes :
    1. To open the Manage Search portlet, click the Administration menu icon. Then, click Search Administration > Manage Search. Cliquez ensuite sur Portées de la recherche.
    2. Supprimez les portées de recherche suivantes :
      • Tous les hôtes
      • Contenu Web géré
    3. Redémarrez le serveur de portail pour recréer les portées de recherche avec le contexte approprié.
  10. Pour modifier la racine de contexte pour Seedlist_Servlet, procédez comme suit :
    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.
  11. 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 nœuds 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. Cliquez sur Serveurs > Clusters.
    4. Sélectionnez le cluster, puis cliquez sur Arrêter.
    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.
  12. Procédez comme suit sur le serveur autonome ou sur chaque nœud 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.
  13. Resynchronisez les nœuds et redémarrez le cluster.