When importing a transport of the system configuration into a target database, you must follow the instructions described under General tips for transporting changes and consider the following special features:
-
Before performing the import, protect individual properties of the target database from being overwritten.
-
If you need custom schema extensions, such as database procedures, features, triggers, or views in the target database in addition to the system configuration, you should import these schema extensions before importing the system configuration.
-
After importing the system configuration, check the configuration settings in the target database.
-
Check the staging level of the target database.
-
Check at least the configuration settings for the DBQueue Processor. The settings are specified through the database staging level and configuration parameters.
You can find detailed information about configuring a One Identity Manager database for test, development, or production in the One Identity Manager Installation Guide.
-
After importing the system configuration, release the locked properties for editing again.
Related topics
You can group together several custom configuration packages into a cumulative transport package. You can define the sequence in which the transports are imported and, if required, define import conditions.
To create a cumulative transport
-
In the Database Transporter, on the Define transport data, select the Create cumulative transport export criteria.
-
Click Select and, on the Transport files page, add each transport package. You can drag and drop the transport packages onto the marked area or click Add to select them in the Explorer.
-
(Optional) You can use the 
and 
icons to change the import order of the selected transport. The transport packages are imported in the given order.
-
(Optional) Use the 
button to define import conditions for each transport individually.
-
Wait for internal database processing to complete after import.: Enable this option if there are DBQueue Processor tasks to be processed after importing the transport package. This can lead to longer import times under certain circumstances.
-
Compile database after this transport has been imported.: Enable this option to compile the database after importing this transport package has completed. This can lead to longer import times under certain circumstances.
-
Condition: Set a condition for the import, for example, whether the importing the transport package depends on another transport package. You have the following option:
-
No condition: No condition is used (default).
-
Query condition: Formulate the condition in the One Identity Manager query language. For more detailed information about the One Identity Manager query languages, see the One Identity Manager Configuration Guide.
-
SQL condition: Formulate the condition as an SQL query.
-
To accept the transports, click OK.
Related topics
IMPORTANT: Test changes in a test system before you load a transport package in a productive system.
To import a transport package
-
Start the Launchpad and log in to the One Identity Manager database.
-
In the Change & Extend view, select the Transport custom modifications entry and click Start.
This starts the Database Transporter program.
-
Select Import transport file on the home page.
-
On the Select the database connection page, check the One Identity Manager database connection data and change it if necessary.
-
Select the transport package file browser and click Open.
-
Specify your import options on Select transport file.
-
Create an import log file: Enable this option to create a log file for the data import. The log file is saved in the output directory of the transport file.
-
Import objects singly and ignore errors: Enable this option to import objects individually. Errors, which might occur during importing are ignored and displayed when importing is complete. If you do not enable this option, the import procedure is canceled when errors occur.
-
Ignore default data differences: Enable this option to ignore changes to default data. If you do not enable this option, the import procedure is canceled if changes to default data are included.
-
Import steps and import progress are displayed on the Importing transport data page. The import procedure can take some time. Calculation tasks are queued for the DBQueue Processor on termination.
NOTE: During import, if the expected value does not match with the actual value in the database, the Merge conflict dialog opens. For each conflict, you must decide which value is committed to the database.
-
If you want to keep database value, enable Current database value.
-
If you want the value from the transport package to overwrite the database value, enable Transport value.
-
If changes have been made to the system configuration, for example, processes, or scripts imported, you have to compile the database after the tasks have been processed. Compilation is started automatically once importing is complete.
-
To end the program, click Finish on the last page.
NOTE: Use the 
button to save any errors that occur whilst importing.
Related topics
To display the contents of a transport package
-
Start the Launchpad and log in to the One Identity Manager database.
-
In the Change & Extend view, select the Transport custom modifications entry and click Start.
This starts the Database Transporter program.
-
Select Show transport file.
-
Select the transport package file browser and click Open.
-
Click Next on the Select transport file page.
-
The contents of the transport file are displayed on the Show transport file page.
-
To display the sequence in which the objects are imported
-
Click + to select an entry in the transport file and select Sort in import order from the context menu.
-
Click OK and enter the connection credentials for the database. This step is only required when you established the first in the order.
The order in which the entry's objects are imported into the database is found.
-
Repeat this step for all other entries for which you want to determine the import order.
-
To display the objects required for an import in the target environment, select the entry for the .xml file and select Show required objects from the context menu.
Objects that are dependent on another object that is not part of the transport package are highlighted.
-
To end the program, click Finish on the last page.
TIP: You can start the import of the transport package from display mode. On the Show transport file page, click the name of the transport package and use the Import context menu.
Related topics
