Completing the context root change started during installation | HCL Digital Experience

If you changed the context root on the Configuration for HCL Digital Experience: Profile configuration details: Advanced pane during installation, there are more steps to take to complete the change.

About this task

If you are on Combined Cumulative Fix 7 or earlier, go to CF07 and earlier: Completing the portal URI change started during installation.

HCL Digital Experience and Web Services for Remote Portlets are installed with a default URI. You can change this URI after installation to better suit the requirements of your organization.

Notes:
  • To change the HCL Digital Experience URI: When you specify the context root, do not specify a value that is the same as a directory that exists in a portlet WAR directory. For example, you set the HCL Digital Experience context root to /images. There is a portlet with the directory structure /myPortlet.ear/myPortlet.war/images. This issue might cause a conflict if the portlet encodes URI references to resources in its own /images directory. In this situation, the portlet would be unable to display images. HCL Digital Experience looks for the image resources according to its own context root path instead of the directory path that is specified by the portlet WAR file.
  • For changing the URI of a WSRP Producer portal: Changing the WSRP Producer context root does not require that you redeploy all portlets. Run the modify-servlet-path configuration task only.
    Important: With Version 8, the URI of the context root for the WSRP Producer is /wps/wsrp. Before Version 8, this context root was /wsrp. If you migrated from an earlier version, you still might have WSRP Consumers that attempt to access the WSRP Producer with the previous context root (/wsrp). You can correct this issue in one of the following ways:
    • Modify the context root for the WSRP Producer to /wsrp. This change enables the Consumers to access the Producer without requiring further changes to the Consumers.
    • Update the configuration of the WSRP Consumers to use the new context root (/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. Log on to the HCL Portal syndicating to this instance. Click the Administration menu icon. Then, click Portal Content > Syndicators. Click the edit icon of the Syndicator you want to edit. Update the URL with the new context root information. Then, log on to the HCL Portal subscribing to this instance. Click the Administration menu icon. Then, click Portal Content > Subscribers. Click the edit icon of the subscriber you want to edit. Update the URL with the new context root information.

Procedure

  1. If necessary, start the HCL Portal server in a stand-alone environment or the deployment manager and node agent in a clustered environment.
  2. Complete the following steps if you are using an external web server, such as an HTTP Server:
    1. Choose one of the following options that are based on your HCL Digital Experience environment:
      Table 1. configurewebservername command options
      HCL Digital Experience environment Steps
      Stand-alone configuration Complete the following steps in a stand-alone configuration:
      1. Copy the following script from the plugin_root/bin directory of the web server to the wp_profile_rootwp_profile_root/bin directory on your HCL Digital Experience server:
        • AIX® HP-UX Linux Solaris: ./configurewebservername.sh
        • Windows: configurewebservername.bat
        • IBM® i: configurewebservername.sh
        • z/OS®: ./configurewebservername.sh

        where webservername is the web server definition name you defined previously when you configured the HTTP Server for HCL Digital Experience, for example: configurewebserver1.bat.

      2. Run the following command, from the wp_profile_rootwp_profile_root/bin directory:
        • AIX® HP-UX Linux Solaris: ./configurewebservername.sh
        • Windows: configurewebservername.bat
        • IBM® i: configurewebservername.sh
        • z/OS®: ./configurewebservername.sh
      Clustered configurationIdle standby configuration Complete the following steps in a clustered configurationidle standby configuration:
      1. Copy the following script from the plugin_root/bin directory of the web server to the dmgr_profile/bin directory on your Deployment Manager server:
        • AIX® HP-UX Linux Solaris: ./configurewebservername.sh
        • Windows: configurewebservername.bat
        • IBM® i: configurewebservername.sh
        • z/OS®: ./configurewebservername.sh

        where webservername is the web server definition name you defined previously when you configured the HTTP Server for HCL Digital Experience, for example: configurewebserver1.bat.

      2. Run the following command on the Deployment Manager server:
        • AIX® HP-UX Linux Solaris: ./configurewebservername.sh
        • Windows: configurewebservername.bat
        • IBM® i: configurewebservername.sh
        • z/OS®: ./configurewebservername.sh
    2. Regenerate the web server plug-in in WebSphere® Application Server. If you are using a remote web server, copy the generated plugin-cfg.xml file to the remote server.
      Important: Do not complete these steps if you are changing only the WSRP Producer URI.
    3. Restart the web server.
    4. Restart the HCL Portal server.
  3. Required if you use HCL Web Content Manager: Complete the following steps to manually change the JSP components in the Web Resources v70 Library:
    Cluster note: In a clustered environment, complete these steps on the primary node only.
    1. Log on to HCL Digital Experience.
    2. Go to Applications > Content > Web Content Authoring.
    3. Under Preferences, select Edit Shared Settings.
    4. Under Library Selection, add Web Resources v70 to the Selected Libraries list.
    5. Click OK.
    6. Under Item Views, select All Items > All > Components > JSP.
    7. Select every JSP component from the Web Resources v70 library and then click Edit.
    8. Update the Path field for every JSP component with the new context root path.

      The JSP path includes two parts, which are separated by a semi-colon. The first part is the context path to the HCL Web Content Manager extensions web application and then the second part is the path to the JSP. Update the path to the web application.

      For example, the other path might be: /wcmextension;/jsp/html/general/UpdateItem.jsp. If you changed the context root to mynewcontext, change the old path to /mynewcontext/wcmextension;/jsp/html/general/UpdateItem.jsp.

  4. Complete the following steps to edit the context root for every search collection:
    Attention: Edit the context root for each existing search collection.
    1. Log on to HCL Portal 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. Click the search collection that you want to update.
      For example: Default Search Collection.
    5. Click the Edit Content Source icon for the first content source in the list.
    6. Edit the URL listed in the Collect documents link from the URL with the new context root.
    7. Click Save.
    8. Edit the URL in each remaining content source and then save your changes.
    9. Start the HCL Portal crawler content source for each collection:
      • If the documents are not stored in the search collection but a schedule is defined for the crawler, the crawler automatically runs at the scheduled time. You can also start the crawler manually.
      • If the documents are already collected, select Regather documents to update the documents with the new context root information.
    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.
    Table 2. Steps to resynchronize the nodes and restart the cluster.
    Cluster type Steps
    Static clusterIdle standby Complete the following steps if you have a static clusteran idle standby environment:
    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. Click Servers > Clusters.
    4. Select the cluster and click Stop.
    5. After the cluster stops, restart it by selecting the cluster. Then, click Start.
    Dynamic cluster Complete the following steps if you have a dynamic cluster:
    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. Click Servers > Dynamic Clusters.
    4. Click the dynamic cluster that you want to stop and restart.
    5. Click Dynamic cluster members.
    6. Select the member name that you want to stop and then click Stop.
    7. Select the member name that you want to start and then click Start.