Exporting and importing web content libraries

IBM® 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 enables you to work with a separate copy of a library. With either method, you 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, you 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. Exporting and importing libraries enables you 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 moving data between servers, both systems must have write access to this directory. In addition, review the following considerations before exporting or importing web content libraries:
Importing libraries into different versions
You can import libraries from a different version of Web Content Manager so long as the version you are importing the library into is later than the version you exported the library from. For example:
  • you can import a library exported from version 6.1.0.1 into version 7.0
  • you cannot import a library exported from version 7.0 into version 6.1.0.1

It is recommended that you upgrade to the latest version of each release before attempting to import libraries between versions. It is not possible to export libraries from releases before 6.0.

Exporting and importing 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. You need to run the member fixer tool on the imported library to fix references to missing users and groups.
  • You cannot import an item if an item on the target server has the same ID but a different parent than the item being imported.
Disabling JCR text search.
It is recommended you disable JCR text search indexing on your WebSphere® Portal server before exporting or importing large libraries to reduce the load on the database during export and import. Edit the wp_profile_root/PortalServer/jcr/lib/com/ibm/icm/icm.properties file and set the jcr.textsearch.enabled property to false. After the file is updated, restart your server for the changes to take effect. When you have completed exporting or importing your library you must then enable JCR text search again. It can take some time to rebuild the indexes when you re-enable JCR text search indexing.
Exporting and importing large libraries
  • When importing web content libraries, 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 uploading large libraries, ensure that there is sufficient disk space to accommodate the import. The location of the temporary directory is specified by the jcr.binaryValueFileDir property in the wp_profile_root/PortalServer/jcr/lib/com/ibm/icm/icm.properties file.
  • When exporting or importing large libraries, increase the total transaction lifetime timeout and the maximum transaction timeout of your server to 360 seconds through the WebSphere Integrated Solutions Console. To change these settings, go to Servers > Server Types > WebSphere application servers > portal_server > Container Services > Transaction Service.
Personalization components.
Personalization rules created within a Personalization component are exported and imported along with your web content library.

If you are using Personalization rules created directly in the Personalization portlet you need to export and import your rules to and from Personalization on the same servers as your web content by using the same process as moving WebSphere Portal content from a staging system to a production system. Personalization export and import must be performed before exporting and importing web content.

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