Staging to production list | HCL Digital Experience

Themes and skins

Choose one of the following static resource options:

Static resources in the WebDAV file store

Follow the staging to production documentation to export and import your themes and skins. For more information, see Developing themes for a production portal. To include these resources in your initial or differential release PAA, use the -DexportWebDavTheme=true parameter.

Directory structure

Use this method if you are building a custom PAA. Compress the files that contain static theme content and place them in the content/webdav directory. This placement allows the themes to be automatically uploaded to the dav:fs-type1/themes/ directory in the WebDAV file store.

Static resources in an .ear file

Follow the staging to production documentation to export and import your themes and skins. Read Developing themes for a production portal. To include these resources in your initial or differential release PAA, use the -DappsToExtract parameter.

Directory structure

Use this method if you are building a custom PAA. Place the theme .ear files in the InstallableApps/ear directory.

Portal Server artifacts

These artifacts are included by default in your initial or differential release PAA. If you are building a custom PAA, use an XMLAccess.xml file for installation or uninstallation.

XMLAccess .xml files (for installation)

Place these files in the following directory: content/xmlaccess/install.

Note: These files might contain the statements to install portlets and transformations out of the war directory and to create pages.

XMLAccess .xml files (for uninstallation)

Place these files in the following directory: content/xmlaccess/uninstall.

Note: These files might contain the statements to remove portlets, transformations, and pages.

References

For information about the portal XML configuration interface and how to work with it, read Working with the XML configuration interface and XML configuration reference.

WebDAV files

Directory

Use this directory if you are building a custom PAA file. Put these files in the webdav directory. This directory and its subtree structure contain artifacts that must be uploaded to the WebDAV file store. There are the following possible sub-directories:

• themes
• skins
• layout-templates
• common-resources

References

See Exporting content from the filestore.

Personalization rules and campaigns

These artifacts are included by default in your initial or differential release PAA. Use these tasks if you are building a custom PAA.

Task

Use the pznload task to export and import the rules and campaigns.

Directory

Place the files in the content/pzn directory. Personalization-related artifacts, such as JAR files that contain business rules and personalization .nodes files, are in this directory.

References

See Staging Personalization rules to production.

Web Content Manager data

To include Web Content Manager data in your initial release PAA, use the -DexportWcmData=true parameter. If you are using a custom PAA, then use the following tasks.

Export task

Use the export-wcm-data task to export Web Content Manager data.

Import task

Use the import-wcm-data task to import Web Content Manager data.

Directory

Place the files in the content/wcm directory. Each sub-directory represents a separate web content library. These libraries are a specialized form of JCR artifact. Web content libraries are separated into their own directory.

References

Read Exporting and importing web content libraries.

Portlet WAR files

These artifacts are included by default in your initial or differential release PAA.

If you are building a custom PAA, choose one or more of the following portlet options:

JSR 168 and JSR 286 Portlets (without an XMLAccess script to deploy)

Place these portlets in the following directory: InstallableApps/portlets.

JSR 168 and JSR 286 Portlets (with an XMLAccess script to deploy)

Place these portlets in the following directory: InstallableApps/war.

HCL API Portlets

Place these portlets in the following directory: InstallableApps/war.

Note: Existing HCL portlets are not handled automatically. These portlets are copied to the archive and must be installed by an accompanied XMLAccess script.

Transformation .war files

Place these portlets in the following directory: InstallableApps/war.

Note: These .war files are not handled automatically. These files are copied to the archive and must be installed by an accompanied XMLAccess script.

Shared libraries

To create shared libraries in production, use the sharedAppResourcesRootDir and sharedExtResourcesRootDir parameters when you create the initial or differential release PAA. If you are deploying shared libraries manually, be sure that they are included on the production server and that their contents are up to date. Or, if you are manually creating a PAA, put the JAR files into either the shared/app or shared/ext directories of your custom PAA.

EAR files

To include EAR files in your initial or differential release PAA, use the -DappsToExtract parameter.

If you are using a custom PAA, place files in the WebSpherePortal.paa\WebSpherePortal\components\WebSpherePortal.shared\installableApps\ear directory. This directory contains any EAR files that must be deployed to the application server. It also contains WAR files that do not contain any portlets and must be installed directly to the application server.

More components to stage