Configuring the synchronization log
All the information, tips, warnings, and errors that occur during synchronization are recorded in the synchronization log. You can configure the type of information to record separately for each system connection and synchronization workflow.
To configure the content of the synchronization log for a system connection
-
To configure the synchronization log for target system connection, in the Synchronization Editor, select the Configuration > Target system category.
- OR -
To configure the synchronization log for the database connection, in the Synchronization Editor, select the Configuration > One Identity Manager connection category.
-
In the General section, click Setup.
-
In the Synchronization log section, set Create synchronization log.
-
Enable the data to be logged.
NOTE: Some content generates a particularly large volume of log data. The synchronization log should only contain data required for error analysis and other analyzes.
- Click OK.
To configure the content of the synchronization log for a synchronization workflow
-
In the Synchronization Editor, select the Workflows category.
-
Select a workflow in the navigation view.
-
In the General section, click Edit.
-
Select the Synchronization log tab.
-
Enable the data to be logged.
NOTE: Some content generates a particularly large volume of log data. The synchronization log should only contain data required for error analysis and other analyzes.
- Click OK.
Synchronization logs are stored for a fixed length of time.
To modify the retention period for synchronization logs
Related topics
SharePoint Online synchronization features
There are a number of features for synchronizing SharePoint Online environments, which are described here.
-
Only one SharePoint Online tenant is supported pro synchronization project. You cannot add more base objects.
-
The target system schema in One Identity Manager cannot be extended.
-
After you have set up the synchronization project, if the Legacy authentication type was selected, you must adjust the setting for the target system scope in the Synchronization Editor.
The scope should only include site collections in which the applicable synchronization user is entered in the SharePoint Online administration interface as the site collection administrator. There is no default user in SharePoint Online.
If the scope is not correctly set up, site collections cannot be loaded and synchronization is stopped.
To edit site collections in the scope of a SharePoint Online synchronization project
-
Open the Synchronization Editor.
-
Select the Configuration > Target system category.
-
Select the Scope view.
-
Click Edit scope. A list of site collections appears on the right-hand side.
-
Activate the site collections to synchronize.
In the list, select only the site collections for which the synchronization user is the same as the administrator in SharePoint Online.
-
Click Commit to database to save the changes.
Related topics
Customizing the synchronization configuration
Having used the Synchronization Editor to set up a synchronization project for initial synchronization of a SharePoint Online tenant, you can use the synchronization project to load SharePoint Online site collections into the One Identity Manager database. If you manage sites, users, and groups with One Identity Manager, the changes are provisioned to the SharePoint Online tenant.
Adjust the synchronization configuration in order to compare the One Identity Manager database with the SharePoint Online tenant on a regular basis and to synchronize changes.
-
To use One Identity Manager as the primary system during synchronization, create a workflow with synchronization in the direction of the Target system.
-
To specify which SharePoint Online objects and One Identity Manager database objects are included in the synchronization, edit the scope of the target system connection and the One Identity Manager database connection. 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 that contain the necessary information about the synchronization objects when synchronization starts. Variables can be implemented in base objects, schema classes, or processing method, for example.
-
Update the schema in the synchronization project if the One Identity Manager schema or target system schema has changed. Then you can add the changes to the mapping.
-
To synchronize additional schema properties, update the schema in the synchronization project. Include the schema extensions in the mapping.
For more information about configuring synchronization, see the One Identity Manager Target System Synchronization Reference Guide.
Detailed information about this topic
Configuring synchronization with SharePoint Online tenants
The synchronization project for initial synchronization provides a workflow for initial loading of target system objects (initial synchronization) and one for provisioning object modifications from the One Identity Manager database to the target system (provisioning). To use One Identity Manager as the primary system during synchronization, you also require a workflow with synchronization in the direction of the Target system.
To create a synchronization configuration for synchronizing SharePoint Online
-
In the Synchronization Editor, open the synchronization project.
-
Check whether the existing mappings can be used to synchronize into the target system. Create new maps if required.
-
Create a new workflow with the workflow wizard.
This creates a workflow with Target system as its direction of synchronization.
-
Create a new start up configuration. Use the new workflow to do this.
- Save the changes.
-
Run a consistency check.
