Export and import web content libraries

HCL Web Content Manager provides two methods for exporting and importing web content libraries: an export or import that operates on one library, and an export or import that creates a separate copy of a library. With either method, we can export the contents of a web content library to disk and import this data into another web content server. If you're working with a copy of a library, we can also import that library into the same web content server multiple times, resulting in a new library after each import without affecting previous copies. Export and import libraries can be used to make a backup copy of a web content library and can also be used to move data between servers. However, this function cannot be used to send updates, deletes, and moves. It is only suitable for populating new items. Before you begin, create an empty shared directory to hold the exported web content library. If you move data between servers, both systems must have write access to this directory. In addition, review the following considerations before you export or import web content libraries:

Import libraries into different versions

We can import libraries from a different version of Web Content Manager so long as the version we are importing the library into is later than the version you exported the library from. For example:

• we can import a library that is exported from version 6.1.0.1 into version 7.0
• we cannot import a library that is exported from version 7.0 into version 6.1.0.1

Upgrade to the most recent version of each release before you attempt to import libraries between versions. It is not possible to export libraries from releases before 6.0.

Export and import a web content library versus syndication.

This feature does not replace the syndication feature. Although this feature can be used to transfer data between servers, it is a manual process and is not meant to be used for regular updates between servers. Syndication is instead used to automatically keep two or more servers synchronized. Also, whereas syndication can be used to send updates, deletes and moves, the import feature is only suitable for populating new items.

Limitations of exporting and importing a web content library.

• Saved versions of items are not exported. Only the current version of each item is exported.
• Children are only exported and imported when the parent is successfully exported and imported.

• If an item exists on the target server with the same path, name and ID, then the item is overwritten.
• Library and item level access controls remain unchanged when a library is exported and imported. Run the member fixer tool on the imported library to fix references to missing users and groups.

• We cannot import an item if an item on the target server has the same ID but a different parent than the item that is being imported.
• Projects are not exported.

Disable JCR text search.

Disable JCR text search indexing on the HCL WebSphere Portal server before you export or import large libraries to reduce the load on the database during export and import.

1. Log in to the WebSphere Integrated Solutions Console.

2. Click Resources > Resource Environment > Resource Environment Providers > JCR ConfigService PortalContent > Custom properties.

   Cluster note: If we are using this web content server as part of a cluster, use the WebSphere Integrated Solutions Console for the deployment manager when editing configuration properties.

3. Change jcr.textsearch.enabled to false.

Note: We must restart the server any time you change these settings.After you export and import your library, we must then enable JCR text search again. It can take some time to rebuild the indexes when we re-enable JCR text search indexing.

Export and import large libraries

• When web content libraries are imported, a temporary directory is used to store the library files during the upload process. If the size of the uploaded files exceeds the available disk space for the temporary directory, the import operation fails. When large libraries are exported, ensure that there is sufficient disk space to accommodate the import.
  1. Log in to the WebSphere Integrated Solutions Console.

  2. Click Resources > Resource Environment > Resource Environment Providers > JCR ConfigService PortalContent > Custom properties.

  3. Make sure the location specified under jcr.binaryValueFileDir has sufficient disk space to accommodate the import.

• When you export or import large libraries, we might need to adjust the following settings:
  1. Log in to the WebSphere Integrated Solutions Console.

  2. Click Servers > Server Types > WebSphere application servers > portal_server > Container Services > Transaction Service.

  3. Change the total transaction lifetime timeout and the maximum transaction timeout settings to 360 seconds.

Personalization components.

Personalization rules that are created within a Personalization component are exported and imported along with the web content library.

If we are using Personalization rules that are created directly in the Personalization portlet, we need to export and import your rules to and from Personalization on the same servers as the web content using the same process as moving HCL Portal content from a staging system to a production system. Personalization export and import must be run before you export and import web content.

JSP components

If we are using JSP components that we must manually copy any related JSP files to and from the same servers that we are exporting and importing to.

• Export and import a web content library We can export the contents of a web content library to disk and import this data into another web content server. Use this feature to make a backup copy of a web content library, and to move data between servers. This function cannot be used to send updates, deletes, and moves. It is only suitable for populating new items.
• Export and import a web content library copy We can export the contents of a web content library to disk by creating a copy of the web content library. By working with an exported copy, we can import the copied library into the same web content server multiple times, resulting in a new library after each import without affecting previous copies. This is a quick way of creating new libraries that are fully populated with web content that we can adapt for other purposes.

References:

• Reset the web content event log
• Set service configuration properties