Preserving theme and layout changes after upgrading from 4.1.x | CTC for HCL Digital Experience
If you are upgrading to Content Template 4.4 from version 4.1.x, to make an existing theme or layout work with the new Content Template layouts and themes, some changes are required.
Upgrading Content Template 4.1.x layouts
The
layouts in Content Template 4.4 have been updated
so that the layout sections are named consistently with the other HCL Portal layouts. To upgrade
the Content Template layouts
in your site, run the configuration task update-ctc41-site:
- Go to your site and open the first-level page in edit mode.
- Edit the page properties and go to the advanced tab.
- Locate or create the unique name for the page. For example, the CTC Demo site uses the unique name, ctc.demo.
- Now run the upgrade-ctc41-site task from the ConfigEngine folder
of your server:
- Windows™
ConfigEngine.bat upgrade-ctc41-site -DuniqueName=UNIQUE_NAME
- AIX® HP-UX Linux™ z/OS®
./ConfigEngine.sh upgrade-ctc41-site -DuniqueName=UNIQUE_NAME
- Restart the server.
- Optional settings:
- By default the task uses the layout path that is used in version 4.1.x of CTC and update it to use the version 4.4 path. If you have created a custom theme that has a different layout, or you want to move to a custom theme, the following properties can be used to specify the location to use for the layouts.
- -DoldLayoutPath=OLD_PATH
- Use the format fs-type1/themes/YOUR_THEME/layout-templates where YOUR_THEME is replaced by the theme directory name. Defaults to fs-type1/themes/Portal8.0/CTC/layout-templates.
- -DnewLayoutPath=NEW_PATH
- Use the format fs-type1/themes/YOUR_PORTAL_85_THEME/CTC/layout-templates where YOUR_PORTAL_85_THEME is a theme based on the Portal 8.5 theme. Defaults to fs-type1/themes/Portal8.5/CTC/layout-templates.