Chat now with support
Chat with Support

Identity Manager 8.0 - Target System Synchronization Reference Guide

Target Synchronization with the Synchronization Editor Basics of Target System Synchronization Setting up Synchronization
Starting the Synchronization Editor Creating a Synchronization Project How to Configure Synchronization
Setting Up Mappings Setting up Synchronization Workflows Connecting Systems Editing the Scope Using Variables and Variable Sets Setting up Start up Configurations Setting up Base Objects
Overview of schema Classes Customizing Synchronization Configuration Checking Synchronization Configuration Consistency Activating the Synchronization Project
Running Synchronization Synchronization Analysis Setting up Synchronization with Default Connectors Updating Existing Synchronization Projects Additional Information for Experts Error Handling Appendix: Example of a Configuration File

Customizing Synchronization Configuration

Customizing Synchronization Configuration

Use the project wizard to set up a synchronization project for initial synchronization of a target system. You can use this synchronization project to load target system objects into the One Identity Manager database. These objects can be edited with One Identity Manager tools. You must customize synchronization configuration in order to compare the database with the target system regularly and to synchronize changes. You can configure a synchronization project such that the necessary information about the direction of synchronization, objects to synchronize and the property mapping rules to be applied, is made available when synchronization starts.

Edit the target system connection scope and the One Identity Manager database connection to specify which target system and database object are handled by synchronization. To prevent data inconsistencies, define the same scope in both systems. If no scope is defined, all objects will be synchronized.

  • You can use variables to create generally applicable synchronization configurations which contain the necessary information about the synchronization objects when synchronization starts. Variables can be implemented in base objects, schema classes or processing methods, for example.

    Use variables to set up a synchronization project which can be used for several different target systems. For this, connection parameters for logging onto target systems are stored as variables.

  • Checking Synchronization Configuration Consistency

    Checking Synchronization Configuration Consistency

    Before activating a synchronization project, check the consistency of the synchronization configuration. The consistency check detects configuration errors which would lead to errors during synchronization. The synchronization project cannot be activated until the configuration error are corrected.

    The consistency check amongst others whether:

    • All mandatory properties are mapped through property mapping rules.
    • Dependencies can be automatically resolved in workflows.
    • Different schema classes of a schema type are differentiated from one another by filters.

    To check consistency the loaded synchronization project

    1. Select General on the start page.
    2. Click on Verify project.

    Activating the Synchronization Project

    Activating the Synchronization Project

    Once you have collected all the data in the synchronization project you require for synchronizing from the One Identity Manager database to a target system, you must activate the project. This optimizes the size of the synchronization project. Data is removed which is not required, for example, unused schema types. SynchronizationClosed can be run after activating.

    Tip: To prevent synchronization errors, run a consistency check before activating.
    Table 64: Meaning of Icons on the Start Page
    Icon Meaning
    The synchronization project is activated.
    The synchronization project is deactivated.

    To activate the loaded synchronization project

    1. Select General on the start page.
    2. Click Activate project.

    An activated synchronization project can only be edited to a limited extend. The schema in the synchronization project must be updated if schema modifications are required. The synchronization project is deactivated in this case and can be edited again.

    Furthermore, the synchronization project must be deactivated if synchronization should not be started by any means (not even manually).

    To deactivate the loaded synchronization project

    1. Select General on the start page.
    2. Click Deactivate project.
    Related Topics

    Running Synchronization

    SynchronizationClosed is started using scheduled process plans. It is possible to start synchronization manually in the Synchronization EditorClosed. You can simulate synchronization beforehand to estimate synchronization results and discover errors in the synchronization configuration. If synchronization was terminated unexpectedly, you must reset the start information to be able to restart synchronization.

    IMPORTANT: As long as synchronization is running, you must not start another synchronization for the same target system. This applies especially, if the same synchronization objects would be processed.

    • The moment another synchronization is started with the same start up configuration, the running synchronization process is stopped and given the status, "Frozen". An error message is written to the One Identity Manager Service log file.
    • If another synchronization is started with another start up configuration, that addresses same target system, it may lead to synchronization error or loss of data. Plan your start times carefully. If possible, specify your start times so that synchronization does not overlap.

    To start synchronization manually

    1. Select the category Configuration | Start up configurations.
    2. Select a start up configuration in the document view and click Execute.
    3. Confirm the security prompt with Yes.
    Detailed information about this topic
    Related Documents