Editing the One Identity Manager database during update with the Configuration Wizard
The One Identity Manager database is updated automatically by the Configuration Wizard. This procedure may take some time depending on the amount of data and system performance.
The Configuration Wizard performs the following steps:
- Updating the One Identity Manager schema.
Before the schema installation, the Configuration Wizard checks the database. Error messages are displayed in a separate window. The errors must be corrected manually. The schema update cannot be started until these are resolved.
All the tables, data types, and database procedures that are required are loaded into the database by the schema update. When a transport package is imported into a One Identity Manager database, the following operations are carried out:
Table 32: Operations when importing a migration package Operations Description Insert If the object is not found in the target database, a new object is generated with the key values. Refresh If the object is found in the target database, the object is updated. Delete Objects that are no longer needed are deleted. During a schema update, calculation tasks are queued in the database. These are processed by the DBQueue Processor.
For a schema update with the Configuration Wizard, the migration date and the migration status are recorded in the transport history of the database.
- Compiling the system.
Scripts, templates and processes are declared in the database. The System user authentication module with the specified system user is used for compilation.
- Uploading files for automatic software update.
In order to distribute One Identity Manager files using the automatic software updating mechanism, the files are loaded into the One Identity Manager database.
-
Migration of synchronization projects,
A process that migrates all existing synchronization project is queued in the Job queue. This updates the One Identity Manager schema and applies automatic patches.
Related Topics
- Automatic updating of One Identity Manager
- Displaying the transport history and checking the One Identity Manager version
Installing a hotfix in the One Identity Manager database
|
|
IMPORTANT: Test changes in a test system before you install a hotfix in a productive system. |
Hotfix packages contain:
- Transport packages which contain changes to the default configuration, such as templates, scripts, processes in the One Identity Manager database
- Modified files, such as *.exe, *.dll or *.vif
If you receive a transport package using a hotfix package, use the Database Transporter program to update the One Identity Manager database.
If a hotfix contains a modified file, copy the file to the install directory of the test computer for testing. To distribute the files to all workstations and servers using the automatic software automation, use the program Software Loader to import the files into the One Identity Manager database.
|
|
NOTE: If more custom configuration adjustments are made to a One Identity Manager database, then create a custom configuration package and import this transport package in the target database with the Database Transporter. There is no support for merging a hotfix package with a custom configuration package into one transport package. |
Detailed information about this topic
- Displaying the contents of a transport package with the Database Transporter
- Importing a transport package with the Database Transporter
- Importing files with the Software Loader
- Displaying the transport history and checking the One Identity Manager version
Displaying the contents of a transport package with the Database Transporter
You can display the contents of a transport package with the Database Transporter before you import.
|
|
NOTE: Always start the Database Transporter on an administrative workstation! |
To display the contents of a transport package
- Open Launchpad. In Change & Extend, select Transport custom modifications. 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 display the sequence in which the objects are imported
-
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
Importing a transport package with the Database Transporter
|
|
NOTE:
|
To import a transport package
- Open Launchpad. In Change & Extend, select Transport custom modifications. This starts the Database Transporter program.
- Select Import transport file on the start page.
- On the Select database connection page, enter the connection credentials for the One Identity Manager database into which you want to import the transport package.
-
Select the transport package file browser and click Open.
-
Specify your import options on Select transport file.
Table 33: Import options Setting
Description
Create a log file for the data import
Enable this option to create a log file for the 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 options 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 during the import. 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.
- 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.