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 7 ou une version antérieure, accédez à CF07 et version antérieure : Finalisation de la modification d'URI de portail commencée lors de l'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 : 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 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 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.
  • For changing the URI of a WSRP Producer portal: 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).
  • If you use HCL Web Content Manager Syndication, the Syndicators and Subscribers servers that refer to this Portal instance must be updated with the modified URI. Connectez-vous à HCL 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 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. 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 :
      Tableau 1. Options de commande configurewebservername
      Environnement HCL 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 :
        • 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, 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, 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.
  3. 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. Log on to HCL.
    2. Go to Applications > Content > Web Content Authoring.
    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.

  4. 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. Log on to HCL as the administrator.
    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 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.
  5. Clustered environment only:Idle standby only: Resynchronize the nodes and restart the 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 > Noeuds, sélectionnez le noeud 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. Select the member name that you want to start and then click Start.