Importing an XML File

5-8 Oracle Fusion Middleware Administrators Guide for Oracle Identity Manager

8. Modify the values in the current resource instance and click Next, or click Skip to

skip the current resource instance, or click New Instance to create a new resource instance. The Confirmation page is displayed. 9. Confirm that the information displayed on the Confirmation page is correct. To go back and make changes, click Back, or click View Selections. The Deployment Manager Import page displays your current selections. The Import page also displays icons next to your current selections. The icons indicate what types of objects are selected. The icons on the right indicate the status of your selections. The file names of any selected files, summary information about the objects you are importing, and substitution information are displayed on the left side of the page. On the right, the Objects Removed from Import list displays any objects in the XML file that will not be imported. 10. Make any of the following adjustments: ■ Click Reset to clear the form. ■ Click Legend to see icon definitions. ■ To remove an object from the Current Selections list, right-click the object, select Remove from the shortcut menu, and then click Remove to confirm that you want to remove the object. If the object has child objects, then select Remove including children from the shortcut menu to remove all the child objects at the same time. The item is added to the Objects Removed From Import list. ■ To add an item back to the Current Selections list, right-click the list, and click Add . If the object has child objects, then select Add including children from the shortcut menu to add all the child objects at the same time. ■ To make substitutions, click Add Substitutions. ■ To add objects from another XML file, click Add File and repeat Steps 2 through 7. ■ Click Show Information to see information about your imported information. The Information page is displayed. To see more information, select the Show Info Level Messages option, and then click Show Messages. Click Close to close the Information page.

11. To import the current selections, click Import.

A confirmation dialog box is displayed.

12. Click Import.

The Import Success dialog box is displayed.

13. Click OK.

The objects are imported into Oracle Identity Manager. Importing and Exporting Data Using the Deployment Manager 5-9

5.4 Horizontal Migration of Entities

The Deployment Manager is used for performing migration of metadata entities from an Oracle Identity Manager deployment to another. However, for Oracle Identity Manager 11g Release 1 11.1.1, there are other non-metadata entitles that are not supported by the Deployment Manager. These entities include custom resource bundles and plug-ins. Therefore, a complete migration of entities is performed by using a command-line utility, which is the horizontal migration utility, along with the Deployment Manager. The horizontal migration command-line utility supports the migration of the following metadata entities that are not supported by the Deployment Manager: ■ Custom resource bundle ■ Plug-ins The migration of metadata entities take place in the following steps:

1. Export data:

When data from an Oracle Identity Manager deployment is exported by running the Deployment Manager and the horizontal migration command-line utility, a set of artifacts are generated. The Deployment Manager generates XML files, and the horizontal migration utility generates binaries and XML files. Figure 5–1 shows the exporting of data: Figure 5–1 Exporting Migration Data

2. Import data:

The Deployment Manager and the horizontal migration utility are run to import the metadata on the second Oracle Identity Manager deployment, as shown in Figure 5–2 : Figure 5–2 Importing Migration Data The horizontal migration utility is used to migrate the entities that are not supported by the Deployment Manager. This section describes the export and import of entities by using the horizontal migration utility in the following sections: ■ Creating a Backup of the Existing Entities Note: Deployment Manager supports the migration of all the entities in the form of XML. The command-line utility supports the migration of binaries, which are entities that are not exportable and importable in the form of XML. 5-10 Oracle Fusion Middleware Administrators Guide for Oracle Identity Manager ■ Running the Horizontal Migration Utility ■ Data Migration for Supported Entities ■ Horizontal Migration Report

5.4.1 Creating a Backup of the Existing Entities

Before performing the migration, create a backup of the existing entities in the Oracle Identity Manager deployment. If you are importing any entity, then create a backup of the existing ones so that you can roll back if required. To create the backup, use the horizontal migration utility in the export mode to extract the existing entities. See Running the Horizontal Migration Utility on page 5-10 for information about running the utility in export mode.

5.4.2 Running the Horizontal Migration Utility

When you run the horizontal migration utility in EXPORT mode, a ZIP file is created that contains all the artifacts of the entities to be migrated. You must migrate the ZIP file into the second deployment where the data is to be imported back. When you run the utility in IMPORT mode, the contents of the ZIP file is extracted in a temporary location and all the artifacts are imported in the Oracle Identity Manager deployment. The configuration in the properties file controls the export and import. All the configurations in the file are defined at runtime. In the EXPORT mode, you run the exportMetaData.sh or exportMetaData.bat script, which is in the OIM_HOMEbin directory. To run the horizontal migration utility in EXPORT mode: 1. Check the location of the Config.xml file. The Config.xml file contains the filter criterion for filtering the entities for export. You can modify this file to provide custom filters. Save the Config.xml file before running the utility. 2. In a text editor, edit the exportMetaData.sh or exportMetaData.bat script to specify the following parameters: ■ CONTEXT_FACTORY: Context to connect to Oracle Identity Manager ■ PACKAGE_LOCATION: Destination path for the package to be exported ■ CONFIGURATION_FILE: Configuration file that you must create with the definition of the parameters and filtering criteria for the Export of the metadata The following is a sample configuration XML file: ?xml version=1.0 encoding=UTF-8? MigrationDetails operation =Export entityDetails EntityTypeJarsEntityType FilteringCriteria Attribute NameOJ_NAMEName FilterFilter Attribute FilteringCriteria entityDetails entityDetails