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

If you are on Combined Cumulative Fix 7 or earlier, go to CF07 and earlier: Changing the portal URI after an 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 : 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.

Cluster note : Si vous modifiez l'URI dans un environnement groupé, ne suivez cette procédure que sur le noeud principal, sauf indication contraire. Vérifiez également que le paramètre AutoSynch est défini avec une fréquence de 1 minute.

Procédure

Procédez de la manière suivante pour modifier manuellement la racine de contexte d'HCL :
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.
  
  Remarque : Laisser cette valeur vide pourrait générer des conflits système. Si vous n'entrez pas de valeur, validez ce paramètre en utilisant l'assistant de configuration ou en suivant les étapes décrites dans Cibles de validation ConfigEngine.
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.
  
  Remarque : Laisser ces valeurs vides pourrait générer des conflits système. Si vous n'entrez pas de valeur, validez ce paramètre en utilisant l'assistant de configuration ou en suivant les étapes décrites dans Cibles de validation ConfigEngine.
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 noeud 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 :
  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.
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.

Complete the following steps if you are using an external web server, such as an HTTP Server:

Choisissez l'une des options suivantes en fonction de votre environnement HCL :

Tableau 1. Options de commande configure`webservername`
Environnement HCL	Etapes
Configuration autonome	Procédez comme suit dans une configuration autonome : 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. 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: 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. 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`

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.
Redémarrez le serveur Web.
Redémarrez le serveur WebSphere_Portal.

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.
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 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.
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.

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 : Open the deployment manager WebSphere® Integrated Solutions Console. Cliquez sur Administration système > Noeuds, sélectionnez le noeud principal dans la liste et cliquez sur Resynchronisation complète. Click Servers > Clusters. Select the cluster and click Stop. 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 : Open the deployment manager WebSphere® Integrated Solutions Console. Click System Administration > Nodes, select the primary node from the list, and click Full Resynchronize. Cliquez sur Serveurs > Clusters dynamiques. Cliquez sur le cluster dynamique que vous souhaitez arrêter et redémarrer. Cliquez sur Membres de cluster dynamique. Sélectionnez le nom du membre que vous souhaitez arrêter, puis cliquez sur Arrêter. Select the member name that you want to start and then click Start.