Migrating the Repository

 

WebLogic Collaborate Release 2.0 provides a utility that helps you migrate repository data from a previous release of WebLogic Collaborate to the repository for Release 2.0. The Bulk Migrator utility converts a WebLogic Collaborate 1.0 or 1.0.1 repository data file to a WebLogic Collaborate Release 2.0 repository data file.

In WebLogic Collaborate Releases 1.0 and 1.01, the configuration data is distributed among the following components:

• Repository for the c-hub

• Configuration files for the c-enablers

• Run-time data, such as the data for conversations and roles

The following procedure for migrating repository data achieves only a partial migration; it migrates data from the c-hub repository. To modify and add data from the c-enabler configuration files and run-time data, you must use the WebLogic Collaborate Administration Console.

To migrate repository data, perform the following steps:

1. Use the Bulk Loader from the previous release of WebLogic Collaborate to export data from the old repository to a repository data file.

   Perform a repository export that is full and long. For instructions, see "Working with the Bulk Loader" in the BEA WebLogic Collaborate C-Hub Administration Guide in the documentation set for WebLogic Collaborate Release 1.0 or 1.01.

   As an alternative to running the Bulk Loader, you can use the C-Hub Administration Console from a previous version of WebLogic Collaborate to export the data. For instructions, see "Creating and Modifying C-Hubs" in the BEA WebLogic Collaborate C-Hub Administration Guide in the documentation set for WebLogic Collaborate Release 1.0 or 1.01.

   You can find the documentation sets for WebLogic Collaborate Releases 1.0 and 1.01 at the following URL:

   http://www.oracle.com/technology/documentation/index.html

2. Install Release 2.0 as described in Installing BEA WebLogic Collaborate.

3. Run the Bulk Migrator utility by entering the following command:

   bulkmigrator.cmd prev_rep_data_file new_rep_data_file

   This utility is delivered in the WLC_HOME\bin directory.

   In this command line:

   • prev_rep_data_file is the name of the repository data file that you created in step 1.

   • new_rep_data_file is the name of the new repository data file that will be created.

     The new repository data file includes a trading partner element for the old c-hub and for each trading partner that was configured in the old repository.

4. Set the end point values in the new repository data file.

   Each trading partner element in the new repository data file includes an end point value. The Bulk Migrator sets each end point value to <placeholder>. You must edit the new repository data file by setting each occurrence of <placeholder> to the correct end point value. The end point value specifies the trading partner end point. This end point is the URL for the trading partner.

   If you have access to a trading partner's c-enabler configuration file, you can get the URL from this file. The URL is the ref value for the enabler-url XML element. For information about the c-enabler configuration file, see "Configuring C-Enablers" in the BEA WebLogic Collaborate C-Enabler Administration Guide in the documentation set for WebLogic Collaborate Release 1.0 or 1.01. You can find these documentation sets at the following URL:

   http://www.oracle.com/technology/documentation/index.html

5. Use the Bulk Loader for WebLogic Collaborate Release 2.0 to import data from the new repository data file to the repository for Release 2.0.

   For instructions, see Working with the Bulk Loader in Administering BEA WebLogic Collaborate.

   As an alternative to running the Bulk Loader, you can use the WebLogic Collaborate Administration Console to import the data. For instructions, see Configuring WebLogic Collaborate in the BEA WebLogic Collaborate Administration Console Online Help.

   Note: After you migrate a WebLogic Collaborate Release 1.0 or 1.01 c-hub, the old c-hub is displayed in the WebLogic Collaborate Administration Console for Release 2.0 as a trading partner named C-Hub.

6. Modify files that access specific data elements in the repository. The following table shows the relationships between the repository data elements for WebLogic Collaborate Releases 1.0 and 1.01 and the repository data elements for WebLogic Collaborate Release 2.0.

   Table 1-1 Relationships Between Repository Data Elements

   WebLogic Collaborate Releases 1.0 and 1.01	WebLogic Collaborate Release 2.0
   Business protocol	Transport and end point
   Business protocol definition	Business protocol definition
   C-hub	WebLogic Collaborate
   Collaborator	Collaboration agreement
   Conversation definition	Conversation definition
   C-space	Delivery channel
   Extended property set	Extended property set
   Logic plug-in	Logic plug-in
   Logic plug-in chain	Logic plug-in chain
   Role	Role
   Subscription	Party
   Trading partner	Trading partner
   Trading partner protocol	Party identifier
   XPath expression	XPath expression