Updating portlets URL | HCL Digital Experience

After migrating your portal environment, you must verify and update as needed the portlets URLs. In some cases, portlets have the incorrect URL after migration. URLs can be easily corrected using the XML configuration interface to export, update, and import the configurations.

About this task

Perform the following steps in the newly migrated environment.

Procedure

Export the portlet configuration.
  1. Change directory where the HCL Digital Experience tools are contained:
  2. Export the configuration using the provided sample file that is named ExportAllPortlets.xml by entering the following command:
    • AIX® Linux Solaris: ./xmlaccess.sh -in PortalServer_root/doc/xml-samples/ExportAllPortlets.xml -user wpsadmin -password wpsadminpwd -url http://server.example.com:port/wps/config -out Server_config.xml
    • IBM® i: xmlaccess.sh -in PortalServer_root/doc/xml-samples/ExportAllPortlets.xml -user wpsadmin -password wpsadminpwd -url http://server.example.com:port/wps/config -out Server_config.xml
    • Windows: xmlaccess.bat -in PortalServer_root\doc\xml-samples\ExportAllPortlets.xml -user wpsadmin -password wpsadminpwd -url http://server.example.com:port/wps/config -out Server_config.xml

    The exported configuration is stored in the XML file named Server_config.xml.

Verify output XML file and update URLs as needed.
  1. Open the Server_config.xml file and verify that all URLs are valid. This means that all the files that are listed in the XML file must be present and accessible in the specified locations.
    1. If the URLs do not match the actual location in your environment, update those entries according to the actual location of the files.
    2. If the files specified in the URL field do not exist in the migrated environment or are no longer needed in the configuration, remove those entries.
    Note: If you are making the updates on a clustered environment, modify the XML file to remove the global-settings and services-settings entries if available in the file.
Import XML file with the updated URLs.
  1. Change directory where the HCL Digital Experience tools are contained:
  2. Run the following command to import the updated configuration using the Server_config.xml file that you just updated:
    • AIX® Linux Solaris: ./xmlaccess.sh -in Server_config.xml -user wpsadmin -password wpsadminpwd -url http://Server.example.com:port/wps/config
    • IBM® i: xmlaccess.sh -in Server_config.xml -user wpsadmin -password wpsadminpwd -url http://Server.example.com:port/wps/config
    • Windows: xmlaccess.bat -in Server_config.xml -user wpsadmin -password wpsadminpwd -url http://Server.example.com:port/wps/config
  3. After the request is processed, make sure that the import process displays the following return message:
    <status element="all" result="ok">
For clustered environments only.
  1. Resync the cluster from the Deployment Manager console.
  2. Restart the Enterprise Applications from the Deployment Manager console.
  3. Run the following command on the cluster primary node to activate the deployed portlets:
    • AIX® Linux Solaris: ./ConfigEngine.sh activate-portlets -DWasPassword=password
    • IBM® i: From the UserData directory, ConfigEngine.sh activate-portlets -DWasPassword=password
    • Windows: ConfigEngine.bat activate-portlets -DWasPassword=password
  4. Restart the portal.