Chat now with support
Chat with Support

Identity Manager 8.1.4 - Target System Synchronization Reference Guide

Target system synchronization with the Synchronization Editor Working with the Synchronization Editor Basics of target system synchronization Setting up synchronization
Starting the Synchronization Editor Creating a synchronization project Configuring 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 the synchronization configuration Checking the consistency of the synchronization configuration Activating the synchronization project Defining start up sequences
Running synchronization Synchronization analysis Setting up synchronization with default connectors Updating existing synchronization projects Script library for synchronization projects Additional information for experts Resolving errors when connecting target systems Configuration parameters for target system synchronization Configuration file examples Glossary

Executing start up sequences

By default, start up sequences are started using scheduled process plans. In the Synchronization EditorClosed, it is also possible to start a start up sequence manually.

To start a start up sequence manually

  1. In the Synchronization Editor, select the Database | Manage start up sequences.
  2. In the Sequences pane, double-click the start up sequence.
  3. In the Included start up information, click .
Related topics

Monitoring start up sequences

Once a start up sequence is running, an instance of the start up sequence in added in the DPRStartSequence table. This instance contains information about the runtime status and errors of the entire start up sequence. A DPRStartSequenceHasProjection table is also saved for every start up configuration that is run. This instance contains information about the runtime status and errors of the current synchronizationClosed.

Instances can be shown and monitored in the Synchronization EditorClosed. The following instances are shown:

  • Start up sequences that are still running.
  • Start up sequences that quit on error assuming at least one start up configuration has the Sequence quits on error option set.

To display a start sequence instance

  1. In the Synchronization Editor, select the Database | Manage start up sequences menu item.

  2. In the Sequences pane, click .

  3. Double-click on the start up sequence instance.

    In the Included startup information view, you can see the runtime status of all the associated start up configurations.

  4. To update the view, in the Sequences toolbar, click .

Table 69: Runtime status of an instance



Progress state


The instance is created.



The start up configuration is waiting to run.



Synchronization is running.



Synchronization has successfully completed



Synchronization ended with an error.


Instances of completed start up sequences are deleted after a specified time period. The DPRStartSequence and DPRStartSequenceHasProjection tables are cleaned up in the process. By default, completed instances are kept for seven days.

To change the retention period for completed instances

  • In the Designer, set the DPR | StartSequnce | LifeTime configuration parameter and enter the maximum retention period.
Related topics

Handling unexpected termination of synchronization

If synchronizationClosed is executed with a start up configuration, some One Identity Manager processes are stopped. It is not possible to start this start up configuration again. The One Identity Manager saves start information of the current synchronization in the database. This start information is reset once synchronization is completely normally.

If synchronization was terminated unexpectedly, for example, a server was no available, you must manually reset the start information. You can only restart synchronization after this.

IMPORTANT: Start information may not be reset if synchronization is running normally.

Before you reset the start information, ensure that synchronization has really been aborted.

To reset synchronization start information

  1. Select the Configuration | Start up configurations category.
  2. Select a start up configuration in the document view and click Reset.
  3. Confirm the security prompt with Yes.

    The status "Broken" is entered in the synchronization log.

NOTE: If necessary, start information can be reset automatically. To do this, customize the process DPR_DPRProjectionStartInfo_Run_Synchronization. Changes made to the process are applied to all target systems connected to the One Identity Manager database when synchronization takes place.

Resetting revisions

SynchronizationClosed with revision filtering involves finding object pairs where one has newer change information than the last time it was synchronized. It may also be necessary to process those objects during synchronization, whose change information has not be updated since the last synchronization. This might be required if changes to data were made without the change information for the object being updated, for example. It is possible that data in one of the connected systems was restored from a backup. This means the change information for the objects is now older than before the last synchronization. Such objects are not processed by synchronization with revision filtering.

One Identity Manager provides an option to reset revision numbers in a start up configuration. The revision can be reset for one schema type or for all of a schema's types. The next time synchronization is run with this start up configuration, all affected objects are seen as changed.

To reset the revision number

  1. Select the category Configuration | Start up configurations.
  2. Select a start up-configuration in the document view and click Revisions...

    This opens the Manage revisions... dialog window. which displays all the schema types with their respective revision numbers. SchemaClosed types without a revision number, are not displayed.

  3. Select the schema for which you want to reset the revision number.

    - OR -

    From the target system schema or the One Identity Manager schema, select the schema type for which you want to reset the revision.

  4. Click Reset.
  5. Select another schema type if required.
  6. Click Apply.
  7. Confirm the security prompt with Yes.

    The revisions of the selected schema types are deleted from the start up configuration.

Related topics
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating