created for a test database, for example, can be transported to a live database. You use the to do this. To use the synchronization project in the target database, check the connection credentials and change the synchronization configuration to match the target database’s requirements.
Prerequisite
- The schema of both One Identity Manager databases are identical. Customized schema extensions used in the mapping exist in both databases.
To transport a synchronization project to another One Identity Manager database
- Create a transport package for the synchronization project using the Database Transporter.
- Set the Transport synchronization projects option.
-
To select the synchronization project, click Select.
- Click Next.
This exports the data.
NOTE: The transport package does not contain a root object, , or assignments of schedules to start up configurations.
- Import the transport package into the target database with the Database Transporter.
On the Import configuration page, configure the import.
-
If there is a synchronization project in the target database already, configure here, which changes are imported into the target database.
-
Do not change the start up configuration settings: Specifies whether start up configurations, variables, and variable sets are imported.
Set this option so that changes to these objects are not overwritten in the target database. If this option is not set, changes made to these objects in the target database are overwritten by the transport package.
-
Details: Shows an overview of all the objects with their change status. Click Details to show the overview.
To show details of the modification, expand the respective node in the Objects column. To exclude certain object changes from the import package, disable the object.
- Click Next.
Then the transport package data is imported.
After importing is complete, the database is compiled.
- Modify the synchronization project in the target database.
-
Modify the One Identity Manager database connection data and update the schema.
-
Check the target system connection data and the variable set.
-
Configure the base object.
-
Assign a schedule to the start up configuration.
-
Configure the synchronization log.
-
Make any other necessary changes to the settings.
-
Run a consistency check.
-
Activate the synchronization project.
For more information about creating and importing transport packages, see the One Identity Manager Operational Guide.
Detailed information about this topic
In order to provision object modifications and perform single object , you must specify which should be used for this task. When setting up the synchronization using the default , the required single object operations will be created. If you create your own provisioning processes or would like to include tables in the provisioning or single object synchronization, then you need to define your own single object operations.
To define single object operations
-
Select the Process Orchestration > process operations category in the .
-
Select the menu item Object > New.
-
Edit the operation properties.
- Save the changes.
-
Use this operation in the pre-script to generate the provisioning process or process for single object synchronization as a parameter for script DPR_GetAdHocData.
Table 83: Single object operations
Name |
Name of the operation. |
Synchronization workflow |
that is to be used for provisioning or single object synchronization. |
System connection |
connection of the target system to be used. |
Table |
Table for which the operation has been defined. Provisioning or single object synchronization can only be run for the objects in this table. |
Display name |
Operation display name in the One Identity Manager tools' user interface. |
Description |
Text field for additional explanation. |
Processing status |
Only used internally by One Identity Manager. |
You can accelerate provisioning and single object by distributing processes over several Job servers. To do this, you use the base objects to specify, which Job servers will handle the objects in parallel.
Load balancing can be implemented to manage spikes in data traffic, for example, when a college semester begins, numerous accounts must be added and provisioned in the target system.
If a property of a user account is changed after restructuring in the target system, you can use single object synchronization to select all the affected user accounts and load the changed property into the One Identity Manager database.
There are specific Job servers configured for cases like this. For each base object, a server function is defined and assigned to the . All Job servers with this attribute run provisioning and single object synchronization processes in parallel.
NOTE: You should not implement load balancing for provisioning or single object synchronization on a permanent basis. Parallel processing of objects might result in dependencies not being resolved because referenced objects from another Job server have not been completely processed.
Once load balancing is no longer required, ensure that the runs the provisioning processes and single object synchronization.
To configure load balancing for a target system
-
Configure the servers and declare them as Job servers in One Identity Manager.
All Job servers must be able to access the same target system as the synchronization server for the respective base object. For more information about setting up the synchronization server, see the administration guides for connecting to target systems.
-
Use the to create a server function for the target system's base object.
-
On the base object's main data form, click next to the Service function field.
-
Enter a name for the server function.
-
Enable all the Job servers to which the server function will be assigned.
Only enable the Job servers that can access the same target system as the base object's synchronization server.
- Click OK.
To use the synchronization server without load balancing.
- In the Synchronization Editor, remove the server function from the base object.
Restrictions
Load balancing is only used if the number of maximum instances for the run or is set to 0 or >1.
If the maximum number of instances on the process task or process component is set to 1 or -1, load balancing cannot take place. This affects processes, which use the following process tasks:
- AdHocProjectionSingle
- AdHocProjectionSinglex86
- UpdateProjectionSingle
- UpdateProjectionSinglex86
These process tasks are used, for example, by different provisioning processes for the HCL Domino and Google Workspace target system types.
For more information about these process tasks, see the One Identity Manager Configuration Guide.
Detailed information about this topic
You can create automatically. This can be particularly useful if you want to set up synchronization projects for different Active Directory domains, which require the same configuration. A new synchronization project is generated from the command line or with a Windows PowerShell CmdLet using the configuration of a reference project. The reference project's configuration is supplied in a configuration file. which you can modify. You can define variable settings, like the target system to connect or password, in parameters, which are used passed values when the command is called.
Existing synchronization projects for which patches are available can be updated in the same way. A configuration file is made available using a reference project that contains a list of all the patches that are to be applied. Only patches that do not require any user input can be applied.
To set up automatic creation of synchronization projects:
-
Enable expert mode in the .
-
Create the reference project using the project wizard.
-
Create a new synchronization project.
- (Optional) If a remote connection is going to be used for automatically creating synchronization projects, establish a remote connection when the reference project is set up.
-
Click Save configuration on the last page of the project wizard.
-
Select a repository for the configuration file and give it a name.
The file is saved as a Synchronization Editor workspace file with the extension sews.
-
End the project wizard.
-
the synchronization configuration in the configuration file.
-
To create synchronization projects with this configuration
-
Open up the .
- OR -
-
Load the .
-
To automatically create synchronization projects, use scripts which run the Synchronization Editor Command Line Interface or the Synchronization Editor for Windows PowerShell.
To set up automatic updating of synchronization projects:
-
Enable expert mode in the Synchronization Editor.
-
Create the configuration file.
-
Open the reference project.
-
(Optional) If a remote connection is going to be used to automatically update the synchronization project, establish the connection now.
-
Select Edit > Update synchronization project from the menu.
-
Optional: Select the patches to be applied under Available patches. Select at least one patch or milestone. Multi-select is possible.
-
Click Save configuration.
-
Select a repository for the configuration file and give it a name.
The file is saved as a Synchronization Editor workspace file with the extension sews.
-
Customize the synchronization configuration in the configuration file.
-
To update synchronization projects with this configuration:
-
To automatically update synchronization projects, use scripts which run the Synchronization Editor Command Line Interface or the Synchronization Editor Module for Windows PowerShell.
TIP: A configuration file created for setting up new synchronization projects can also be used for updating synchronization projects. Add the necessary editor and parameters to the configuration file.
Detailed information about this topic