Skip Headers
Oracle® Fusion Middleware Administering Oracle WebCenter Content
11g Release 1 (11.1.1)

Part Number E26692-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

24 Understanding System Migration and Archiving

This chapter describes the various software tools used to migrate and archive (back up) Oracle WebCenter Content system metadata, content, and structure.

This chapter covers the following topics:

24.1 Migration Tools and Components

Several tools are available for archiving and migrating information from and to a Content Server instance. Each tool serves a different purpose and most can be used together.

24.2 Configuration Migration Utility

The Configuration Migration utility (provided by the ConfigMigrationUtility component) is used to select elements of your Content Server instance to migrate to another instance. This component is installed and enabled by default with Content Server.

Note:

The ConfigMigrationUtility component supports Contribution Folders (provide by the Folders_g component), but does not support Folders (provided by the FrameworkFolders component).

Overview

You can select individual elements (such as workflow tokens or content types) or entire sections (such as all user-related metadata or all metadata related to workflows). In addition, you can export and import an entire Content Server instance to create a snapshot of the Content Server instance at a certain point in time. It can be used to migrate a system from testing to production, or to provide an upgrade path from older versions of the Content Server instance. By using the migration tool, you can keep an older version of the Content Server software in production while testing new functionality on a newer version.

Each export configuration is packaged as a bundle which contains the information needed to re-create the configuration on another system. A bundle is a zip file that can be easily shared with other systems.

Functions

The Configuration Migration utility is used to configure migration bundles for exporting to other systems. It is also used to upload and import bundles on an importing system. There are four main functions:

By using the Configuration Migration utility with the Archiver, you can create a snapshot in time of your existing Content Server instance or you can use it to keep track of incremental updates to an existing system. The Configuration Migration utility captures configuration information while the Archiver captures content.

For more information about using the Configuration Migration utility, see Chapter 25, "Migrating System Configurations."

24.3 Archiver Application

Archiver can be used with the Configuration Migration utility to migrate a complete Content Server instance, including content, from one system to another.

Note:

This component supports Contribution Folders (provided by the Folders_g component), but supports only migrating tables for the Folders (provided by the FrameworkFolders component).

Note:

Archiver does not include Digital Asset Management (DAM) video and audio renditions in the archives it creates. The archives do include the native file, thumbnail, the zip rendition that contains storyboard thumbnails, and the web-viewable .hcsp file, but do not include any additional video and audio renditions created by Inbound Refinery.

This limitation is by design. Many video files would make the archive too large, surpassing the 2GB limit on zip files. Also, in man production instances the video renditions are likely to be stored on a separate file system.

When using the Archiver with the Electronic Signatures component, make sure to use the table archive feature to move the Esig table. If this is not done, an error is returned in the Signatures Listing section on the Signatures Information page after clicking the Signatures tab on a Content Information page.

Overview

Archiver can be run as an Admin Applet, accessed from the Administration menu, or as a standalone tool. The standalone tool is necessary to:

For more information, see Section 26.2.5, "Running the Archiver as a Standalone Application."

Functions

Archiver is a Java applet that is used to transfer and reorganize Content Server files and information. Archiver has four main functions:

The following illustration demonstrates these basic functions.

Figure 24-1 Archiver Functions

Description of Figure 24-1 follows
Description of "Figure 24-1 Archiver Functions"

Caution:

Do not use Archiver as your primary method of disaster recovery; use standard backup systems for the database and file system.

24.4 Folder Archiving Application

You cannot use the Archiver to move folder structure and content, but you can use Folder Archiving to migrate the total folder structure of your Content Server instance from one location to another. This does not archive the folder content, just the folder structure.

Using Folder Archiving you can export and import the folder hierarchical structure directly from the Folders administration interface. The entire folder hierarchy is exported to a text file in HDA format, which can then be read by the Content Server instance when it is imported.

This component supports Contribution Folders (provided by the Folders_g component), but does not support Folders (provided by the FrameworkFolders component).

24.5 Folder Structure Archive Application

The Folder Structure Archive component is a separate product from the Folders_g component and must be installed separately.

Note:

This component supports Contribution Folders (provided by the Folders_g component), but does not support Folders (provided by the FrameworkFolders component).

Overview

The Folder Structure Archive component can be used with the archiving aspect of the Folders component but its functionality differs in several ways:

Functions

This component can be used for three major purposes:

24.6 ArchiveReplicationExceptions Application

The ArchiverReplicationExceptions component is installed (enabled) by default with the Content Server instance. It enables administrators to prevent failed imports from stopping replication. It does this by capturing failed imports and putting them into an exceptions archive, then sending email to the administrator that a failed import has occurred.

For content items to be processed by the ArchiverReplicationExceptions component, the administrator must manually set configuration entries in the IntradocDir/config/config.cfg file. The configuration variables customize the behavior of the importing Content Server instance to allow for certain situations and to distribute the error reporting based on the configured criteria.

Note:

This component supports Contribution Folders (provided by the Folders_g component), but does not support Folders (provided by the FrameworkFolders component).

24.7 Archive Tool Summary and Comparison

The tools that can be used to archive Content Server structure, content, and folders all serve different purposes. All of the tools can be used together, but sometimes one might be preferred over the other. The following table summarizes each tool and its strengths and limitations.

Feature Configuration Migration Utility (CMU) Archiver Folder Archiving Folder Structure Archive Component

Primary purpose

A 'snapshot' tool, used to migrate one Content Server instance to another or to migrate to an upgraded instance.

Supports only Contribution Folders.

Primarily used for backup, storage, and transfer of data over sockets.

Supports Contribution Folders. Supports only migrating tables for the FrameworkFolders component.

Used to export and import a complete folder structure or hierarchy.

Supports only Contribution Folders.

Used to backup and duplicate a folder structure to synchronize the contents with another Content Server instance.

Supports only Contribution Folders.

Strengths

Enables you to choose specific parts of the Content Server instance to migrate.

Provides logging and trace files.

Works with older content.

Provides logging and trace files.

Ensures that the collection IDs on the target match those on the source.

Can export selected portions of the folder structure.

Limitations

Cannot be used on pre-6.2 versions of the Content Server software.

Migration of components can be difficult.

The standalone version is needed to create collections.

Imported revisions do not automatically enter a workflow.

All current folders and content items in the folders are removed from the Content Server instance and replaced by the imported folder hierarchy.

Does not ensure that the collection ID of folders on the target match those on the source content.

What it archives

  • Metadata

  • Security (roles and accounts)

  • Profiles

  • Schema

  • Workflow

  • Personalization

  • Add-on components

  • Content

  • Content types

  • User attributes

  • Subscriptions

  • Security groups

  • File Formats

  • Complete folder hierarchy (no content)

  • Complete or partial folder hierarchy and content

  • Only changed content (if desired)

What it does not archive

  • Content

  • Workflow state

  • Does not synchronize: this is an additive archive

  • Folder structure

  • Metadata, security and other features which are archived by CMU

  • Weblayout structure

  • Partial or selected folder hierarchy

  • Collaboration folders

  • Content

  • Metadata, security (other features which are archived by CMU)

Collaboration folders