Updating scripts and removing deprecated features | HCL Digital Experience
To create new Virtual Portals with the same content as the portal from which you migrated, you must pre-configure the default content for creating the Virtual Portal. You must also remove or replace references to deprecated features.
About this task
When you migrate a Virtual Portal, HCL Digital Experience treats all pages in the portal as custom, customer-created content. As a result, if the Virtual Portal contains pages that are associated with features that are not available in the new installed version, HCL Digital Experience migrates those pages regardless.
For example, if you migrate a Virtual Portal that contains a Document Libraries page, HCL Digital Experience preserves that page. You can remove these pages manually after you migrate the Virtual Portal.
Procedure
- Register your filename.xml file
that you used in the previous system to pre-configure the default
content for creating the Virtual Portal.Note: The name of the file might change based on the release and editions of portal that you are using. The following are examples of file names: "InitVirtualContentPortal.xml, InitAdminVirtualPortal.xml."
- Use the WebSphere® Integrated Solutions Console to
update the virtual portal XML scripts to remove references to Dynamic
Person Tag portlet.Note: Your script can contain references to Dynamic Person Tag portlet. This portlet is no longer available and any reference to this portlet causes your script to fail.
- Use the WebSphere® Integrated
Solutions Console to update the virtual portal XML scripts to remove
references to CAI/TAI portlets. For example, the portlets are defined
in a web-app sequence like the following examples.Note: Your script can contain references to the CAI/TAI portlets. These portlets are no longer available and any reference to these portlets cause your script to fail.
<web-app action="locate" uid="com.ibm.workplace.community.portal"> <portlet-app action="locate" uid="com.ibm.workplace.community.portal.1"> <portlet action="locate" name="Community" objectid="Z3_CGAH47L0008270I7MOUHLP18C5"/> </portlet-app> </web-app>
<web-app action="locate" uid="com.ibm.workplace.builder.parameterPortlet.ParamConfigPortlet.40b0885181fd00171b3b9587aea11c02"> <portlet-app action="locate" uid="com.ibm.workplace.builder.parameterPortlet.ParamConfigPortlet.40b0885181fd00171b3b9587aea11c02.1"> <portlet action="locate" name="Parameters" objectid="Z3_CGAH47L0008270I7MOUHLP18O5"/> </portlet-app> </web-app>
<web-app action="locate" uid="com.ibm.workplace.policystatus.PolicyStatus"> <portlet-app action="locate" uid="com.ibm.workplace.policystatus.PolicyStatus.1"> <portlet action="locate" name="Policy Status Portlet" objectid="Z3_CGAH47L0008270I7MOUHLP18S5"/> </portlet-app> </web-app>
<web-app action="locate" uid="com.ibm.workplace.builder.propertiesPortlet.portal"> <portlet-app action="locate" uid="com.ibm.workplace.builder.propertiesPortlet.portal.1"> <portlet action="locate" name="Properties portlet" objectid="Z3_CGAH47L0008270I7MOUHLP1845"/> </portlet-app> </web-app>
<web-app action="locate" uid="com.ibm.workplace.builder.manageroles.ManageRoles.50047239651b0018123cdeae474aa5c4"> <portlet-app action="locate" uid="com.ibm.workplace.builder.manageroles.ManageRoles.50047239651b0018123cdeae474aa5c4.1"> <portlet action="locate" name="Roles portlet" objectid="Z3_CGAH47L0008270I7MOUHLP18K5"/> </portlet-app> </web-app>
<web-app action="locate" uid="com.ibm.workplace.cdo.portal"> <portlet-app action="locate" uid="com.ibm.workplace.cdo.portal.1"> <portlet action="locate" name="Application Catalog" objectid="Z3_CGAH47L00OJ790IAH1AFAN1067"/> </portlet-app> </web-app>
<web-app action="locate" uid="com.ibm.workplace.tai.tc"> <portlet-app action="locate" uid="com.ibm.workplace.tai.tc.1"> <portlet action="locate" name="Template Catalog Manager" objectid="Z3_CGAH47L00OJ790IAH1AFAN1060"/> </portlet-app> </web-app>
The pages that reference these portlets in sequences like the following examples.
<component action="update" active="true" deletable="false" domain="rel" modifiable="undefined" objectid="Z7_CGAH47L0008270I7MOUHLP18M7" ordinal="100" skinref="undefined" type="control" width="undefined"> <portletinstance action="update" domain="rel" objectid="Z5_CGAH47L0008270I7MOUHLP18E0" portletref="Z3_CGAH47L0008270I7MOUHLP18C5" shareref="Z5_CGAH47L0008270I7MOUHLP18E0"/> </component>
<component action="update" active="true" deletable="false" domain="rel" modifiable="undefined" objectid="Z7_CGAH47L0008270I7MOUHLP18I0" ordinal="100" skinref="undefined" type="control" width="undefined"> <portletinstance action="update" domain="rel" objectid="Z5_CGAH47L0008270I7MOUHLP18I4" portletref="Z3_CGAH47L0008270I7MOUHLP18O5" shareref="Z5_CGAH47L0008270I7MOUHLP18I4"/> </component>
<component action="update" active="true" deletable="false" domain="rel" modifiable="undefined" objectid="Z7_CGAH47L0008270I7MOUHLP18U4" ordinal="100" skinref="undefined" type="control" width="undefined"> <portletinstance action="update" domain="rel" objectid="Z5_CGAH47L0008270I7MOUHLP18U2" portletref="Z3_CGAH47L0008270I7MOUHLP18S5" shareref="Z5_CGAH47L0008270I7MOUHLP18U2"/> </component>
<component action="update" active="true" deletable="false" domain="rel" modifiable="undefined" objectid="Z7_CGAH47L0008270I7MOUHLP18Q6" ordinal="100" skinref="undefined" type="control" width="undefined"> <portletinstance action="update" domain="rel" objectid="Z5_CGAH47L0008270I7MOUHLP18Q1" portletref="Z3_CGAH47L0008270I7MOUHLP1845" shareref="Z5_CGAH47L0008270I7MOUHLP18Q1"/> </component>
<component action="update" active="true" deletable="false" domain="rel" modifiable="undefined" objectid="Z7_CGAH47L0008270I7MOUHLP1865" ordinal="100" skinref="undefined" type="control" width="undefined"> <portletinstance action="update" domain="rel" objectid="Z5_CGAH47L0008270I7MOUHLP1863" portletref="Z3_CGAH47L0008270I7MOUHLP18K5" shareref="Z5_CGAH47L0008270I7MOUHLP1863"/> </component>
The
portletref
attribute of theportletinstance
tag matches one of theobjectid
attributes from the portlet tags in the web-app section.<portlet action="locate" name="Roles portlet" objectid="Z3_CGAH47L0008270I7MOUHLP18K5"/> <portletinstance portletref="Z3_CGAH47L0008270I7MOUHLP18K5" ... />
Make sure to remove the web-app sequence that includes the opening
<web-app...>
and the closing</web-app>
tags, and everything in between. Also, remove the components that reference the portlets. It includes the opening<component ...>
and the closing</component>
tags, and everything in between. Theobject ids
,portletrefs
,sharerefs
, and other references in the example might vary in your installation.