Staging to production list
The items in the production list can be included in the staging to production Portal Application Archive (PAA) file. However, if we are not using the staging to production PAA file, use this list to determine the tools that are required to move your artifacts from the staging server to the production server. We can also use this list to determine what tool to use for the items not included in the staging to production PAA file. Within the Staging to production documentation, the following directories are the root directories where you place your subdirectories:
- Base portal: WebSpherePortal
- Virtual Portals: object_id
Themes and skins
Static resource options:
- Static resources in the WebDAV file store
- Follow the staging to production documentation to export and import the themes and skins. To include these resources in your initial or differential release PAA, use the -DexportWebDavTheme=true parameter. Use this method if we 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
- Use this method if we are building a custom PAA. Place the theme .ear files in the InstallableApps/ear directory. Follow the staging to production documentation to export and import the themes and skins. To include these resources in your initial or differential release PAA, use the parameter...
-DappsToExtract parameter
Portal Server artifacts
- action
- client
- component
- content-node (pages)
- credential-segment
- device-class
- global-settings
- language
- markup
- resource-type
- skin (definition)
- task
- theme (definition)
- services-settings
- servlet (definition)
- portal
- portlet-app
- portlet
- portletinstance
- proxy-config
- transformation
- transformation-app
- transformationinstance
- url-mapping-context
- virtual-resource
- web-app
- wsrp-producer
- cross-page-wire
- wire
These artifacts are included by default in your initial or differential release PAA. If we 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 with the XML configuration interface and XML configuration reference.
WebDAV files
- Directory
- Use this directory if we 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 subdirectories:
- themes
- skins
- layout-templates
- common-resources
- References
- See Export 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 we 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. For a custom PAA, then use the following tasks.Attention: Run the export task if the data set is less than 10,000 content items and behind a firewall. Syndicate the content if the data set is less than 10,000 content items and not behind a firewall. If the data set is large, clone the database and run the sycn-vanityurl-data task to synchronize your vanity URL data. Either clone the database or run the export task. Do not do both.
- 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 subdirectory 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 Export and import web content libraries.
Portlet WAR files
These artifacts are included by default in your initial or differential release PAA. If we 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.
- IBM API Portlets
- Place these portlets in the following directory: InstallableApps/war.
Note: Existing IBM 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 we create the initial or differential release PAA. If we 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 we 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.
For 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
The following list contains portal components that are not handled by the initial import and are configured on each system outside of xmlaccess and PAA files.
- Resource Environment Providers
To export, run: wsadmin update-properties
- External Security Manager
- Active Site Analytics Statistics There are no applicable tools for exporting or importing Active Site Analytics Statistics. Statistics from staging server are not typically exported or imported.
- Custom login commands
- Custom credential vault adapters
- Custom credentials
- Custom component property files
- Vanity URLs
- These artifacts are included by default in your initial or differential release PAA. A vanity URL is a portal artifact stored with the portal page that it targets. Vanity URLs are managed and stored in the Web Content Manager Portal Site library. Therefore, if we want to stage the portal to production, it is not enough to stage the portal pages using the portal xmlaccess.sh. We must transfer data on both the portal and the Web Content Manager side.