Migration  Locate

Migration is used to migrate data from one database to another. You can migrate data during installation or during setup.

Migration using Setup Tool  Locate

To migrate data after installation, use the Setup tool described in Reconfiguring After Installation. Briefly:

  1. Launch the Setup tool by issuing the following command from the bin subdirectory of your installation:

    Windows: setup.bat
    UNIX: ./setup.sh

    See command-line parameters in Setup.

  2. Select the Migration tool on the first panel:

  3. Fill in the following properties:

    • Previous Registry Version - Oracle Service Registry version from which you are migrating data

    • Previous Registry Directory - the directory in which the previous Oracle Service Registry is installed. The existing data will be migrated from it.

    • Previous Registry Administrator Username - name of the user having rights to retrieve data from the previous Registry version.

    • Current Registry Administrator Username - name of the user having rights to save UDDI structure keys. By default, only the administrator can migrate all data including private data.

    • JDBC drivers - Set path to the directory in which the .jar (.zip) of JDBC drivers is located.

      [Important]Important

      Enter this path only if the previous Oracle Service Registry installation is configured with a different type of database than the current one.

Migration procedure  Locate

The following table summarizes what data is migrated by the migration tool in setup.

Table 2. Migration

Type of dataData detailMigrated by migration toolLocation
UDDI DataUDDI v3 (v2) data (business entities and their sub-entities, tModels, subscriptions, publisher assertions, taxonomies).YesDatabase
UDDI securityACLYes (it is a part of UDDI entity)Database
Configuration of PermissionsNoFile app/uddi/conf/permission_list.xml
Certificate storeNoFile conf/pstore.xml, conf/clientconf.xml
AccountsAccount (User Profile) and Group dataYesDatabase
LDAP configurationNoFile app/uddi/conf/directory.xml
ApprovalApproval requestsNoDatabase
Approval configurationNoFile app/uddi/conf/production.xml, app/uddi/conf/staging.xml
Temporary UDDI DataCustody transfer tokensNoDatabase
Other configurationConfiguration of URLsNo. URLs are already set up in the installation preceding migration in setup. Migrated registries often run in different environments.Multiple XML files in app/uddi/conf/, work/uddi/bsc.jar/conf/
Configuration of BSC, including BSC customizations (accessible in BSC UI: Configuration tab)NoFiles in work/uddi/bsc.jar/conf/
Configuration of Registry UI (accessible in Web UI: Manage->Registry control configuration)NoFiles in app/uddi/conf/
Configuration of Registry (accessible in Web UI: Manage->Registry configuration)NoFiles in app/uddi/conf/
Replication ItemsNo (manual steps are described below Manual migration of replications from older versions of Oracle Registry)File in app/uddi/conf/replication.xml, app/uddi/conf/replication_list.xml
Configurations which are stored in the database and their historyNoDatabase

Manual migration of replications from older versions of Oracle Registry  Locate

Replications in this version use a different configuration from previous versions. The main difference is that replications are now transactional. In previous versions it was common to have two replication items, one for business entities (and sub-entities) and another for tModels. In this version the replication item can contain several subscriptions, but they have to be complete, as failure to replicate any entity means failure of the whole replication (failed replication will not leave any incomplete entities). Another difference is that referenced tModels are not fetched automatically, a subscription for them is needed. Time is specified in a more reliable way. Older versions specified a time of replication by an interval measured from the start of the Registry. The new version allows time specification patterns fixed relative to time of day, day of the week, or day of the month. New replications have some new features like color coded reports and an option to preserve owners of replicated entities.

For each group of related replication items in old Registry:

  1. Create a new replication item which will reference all subscriptions from old items.

  2. If the old replication depended on the fact that referenced tModels were replicated, a new subscription for such tModels will be needed. Add a key of this subscription to the replication item.

  3. Convert the old time specification to the new one.

  4. Fill all other fields in the same way they were filled in the older version of Registry.