Deploying and registering your theme | HCL Digital Experience
After you copy your static and dynamic theme resources and modify your dynamic resource references, you are ready to deploy and register your theme on the server.
Procedure
- Navigate to the CustomThemeEAR project that you created when you copied your static theme and skin resources. Right-click on the project and select .
- Click Browse, then select the folder to which you want to export your EAR file.
- Click Save, then click Finish.
- Log on to the WebSphere® Integrated Solutions Console and click .
- Click Install.
- Click Browse. Then, find and select the EAR file that you exported and click Next.
- Select Fast Path. Then, expand Choose, select Generate Default Bindings, and click Next.
- Select your installation option values and click Next.
-
For Map Modules to Servers, select the custom theme module. Then, select
server=HCL Portal and HCL Web Content Manager
and click . - Click Finish.
- When the EAR file is installed, click Save directly to the master configuration.
- Check your CustomThemeEAR file in the table of enterprise applications and click Start.
-
In the PortalServer_root\bin directory, create the file
input.xml with the following contents:
<?xml version="1.0" encoding="UTF-8"?> <request xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="PortalConfig_8.5.0.xsd" type="export"> <portal action="locate"> <skin action="export" objectid="*" /> <theme action="export" objectid="*" /> </portal> </request>
-
From the command line, change to the PortalServer_root\bin directory and
run the following XMLAccess command to export all skin and theme definitions to the file
registerTheme.xml:
xmlaccess -user <admin userid> -password <admin password> -url <hostname>:10039/wps/config -in input.xml -out registerTheme.xml
-
Find the
Portal 8.5 - Hidden
skin in the file registerTheme.xml and delete all other skins. -
Make the following modifications to the Portal 8.5 - Hidden
skin:
-
Find the
Portal 8.5
theme in the registerTheme.xml file and delete all other themes. -
Make the following modifications to the
Portal 8.5
theme: -
Save all of your changes in the registerTheme.xml file. Then, from the
command line, run the following XMLAccess command to register your theme and skin in the
PortalServer_root\bin directory:
xmlaccess -user <admin userid> -password <admin password> -url <hostname>:10039/wps/config -in registerTheme.xml -out output.xml
-
From the command line, run the following XMLAccess command to export all of the theme and skin
definitions again to the file output2.xml:
xmlaccess -user admin userid -password admin password -url hostname:10039/wps/config -in input.xml -out output2.xml
- Edit the output2.xml file to verify that your theme and skin updates are correct. Then, delete the input.xml, output.xml, and output2.xml files.
- Save the file registerTheme.xml. You can use this XML file to register your custom theme and skin in the future.
What to do next
Note: Your custom theme includes ready-to-use modules
that are shared across themes and intentionally remain uncopied in the Theme Modules web
application. The Theme Modules web application and the web application for your theme must remain
started for your theme to operate.