Convert the Portlet API Remote Web Content Viewer to the JSR 286 Web Content Viewer | HCL Digital Experience
If you use the Portlet API Remote Web Content Viewer portlet in your source environment, you must complete the following task after migration to convert to the JSR 286 Web Content Viewer.
About this task
Procedure
-
Check if you installed the Portlet API Web Content Viewer portlet and identify
potential portlet clones.
-
If you use the Portlet API Remote Web Content Viewer portlet, choose one of the
following methods to deliver your web content after completing the post migration
steps:
- Option 1: If you migrate from a source rendering portal that does not include HCL Web Content Manager to a target rendering portal that does not include HCL Web Content Manager, you must use the JSR 286 Web Content Viewer and the WSRP support in the portal.
- Option 2: If you migrate from a source rendering portal that does not include HCL Web Content Manager to a target rendering portal that includes HCL Web Content Manager, the preferred way to display your web content is to locally render it with the JSR 286 Web Content Viewer.
- Option 3: If your source rendering portal includes HCL Web Content Manager, the target rendering portal will also include HCL Web Content Manager. The preferred way to display your web content is to locally render it with the JSR 286 Web Content Viewer.
The following table summarizes the preferred options depending on the source and target rendering portal.Table 1. Preferred way to display web content in your portal after migration Each row entry provides the conditions for the source and target environments, specifically whether or not the HCL Web Content Manager is included in the source and target environments, and the preferred option for displaying the web content in your portal.
Source rendering portal Target rendering portal Preferred option Includes the HCL Web Content Manager Includes the HCL Web Content Manager Option 3: Local web content rendering with JSR 286 Web Content Viewer Includes the HCL Web Content Manager Does not include the HCL Web Content Manager Unsupported migration path Does not include HCL Web Content Manager Includes the HCL Web Content Manager Option 2: Local web content rendering with JSR 286 Web Content Viewer Does not include HCL Web Content Manager Does not include the HCL Web Content Manager Option 1: Remote web content rendering with JSR 286 Web Content Viewer via WSRP
Option 1: Remote web content rendering with JSR 286 Web Content Viewer via WSRP
The source rendering portal of the migration does not contain the web content it delivers. Instead the HCL Portlet API Remote Web Content Viewer connects to another portal of your source environment to retrieve the web content.
About this task
The target rendering portal that does not include HCL Web Content Manager and still uses the Portlet API Remote Web Content Viewer becomes the WSRP consumer. It consumes the JSR 286 Web Content Viewer from the target authoring portal that includes HCL Web Content Manager and contains the web content.
Procedure
- To configure remote rendering, follow the instructions at Enabling remote rendering with WSRP and the Web Content Viewer.
- On the target rendering portal that acts as WSRP consumer:
- Add instances of the consumed JSR 286 Web Content Viewer portlet to portal pages that contain instances of the Portlet API Remote Web Content Viewer portlet.
- Configure the consumed JSR 286 Web Content Viewer portlet instances to match the configuration of the Portlet API Remote Web Content Viewer portlet instances on each of the portal pages.
- After replacing all instances of the Portlet API Remote Web Content Viewer portlet and of its portlet clones, uninstall the ilwwcm-remoterendering-portlet.war web module.
Note: This option has limitations that do not exist when rendering web content locally. For more information, see Performing remote rendering with WSRP and the web content viewer.
Options 2 and 3: Local web content rendering with JSR 286 Web Content Viewer
The source rendering portal of the migration does not contain the web content it delivers. Instead the HCL Portlet API Remote Web Content Viewer connects to another portal of your source environment to retrieve the web content.
About this task
Procedure
- To make the web content available on the target rendering portal, syndicate the web content libraries from the target authoring portal to the target rendering portal. For more information, see Syndication.
- On the target rendering portal: