7 Administration of Directory Synchronization

This chapter explains how to manage synchronization profiles. It contains these topics:

Managing Synchronization Profiles
Managing Synchronization Profiles Using Command-Line Tools

Managing Synchronization Profiles

This section tells you how to register and deregister a profile by using the Oracle Directory Integration Server Administration tool. It contains these topics:

Creating a Profile
Modifying a Profile
Deleting a Profile
Modifying the Synchronization Status Attributes

Creating a Profile

You to create a profile in one of two ways:

By creating a new connector group entry, then adding a profile to it
By selecting an existing connector group entry, then adding a profile to it

To create a profile:

Perform the following steps to start the Oracle Directory Integration Server Administration tool:
1. Run the following command to start the Oracle Directory Integration Server Administration tool:
```
dipassistant -gui
```
2. In the navigator pane, select Connector Profile Management Window.
In the Connector Profile Management window, you have two options for creating a new connector profile:
- Create an integration profile by copying an existing one
  
  To do this, select the Oracle Directory Integration Platform profile you want to copy, then select Create Like. The Integration Profile dialog box displays the General tab page.
- Create an integration profile without copying an existing one
  
  To do this, select Create New. The Integration Profile dialog box displays the General tab page.
See Also:
"Connector Profile Management Window" for more information about the Connector Profiles Management window
In the General Tab tab page, fill in the fields.

The fields in the General tab page are described in Table A-10.
Click the Mapping Tab tab and fill in the fields.

The fields in the Mapping tab page are described in Table A-11.
Click the Filtering Tab tab and fill in the fields.

The fields in the Mapping tab page are described in Table A-9.
Click the Status Tab tab and fill in the fields. Because this page shows the execution status of the connectors, most of the fields cannot be edited.

The fields in the Status tab page are described in Table A-13.
Click the Others Tab tab and fill in the fields.

The fields in the Execution tab page are described in Table A-12.
After you enter the information, click OK. This returns you to the Connector Profile Management window, which now lists the integration profile you just created. The profile you created is now registered with Oracle Internet Directory.

Modifying a Profile

To modify a profile:

Perform the following steps to start the Oracle Directory Integration Server Administration tool:
1. Run the following command to start the Oracle Directory Integration Server Administration tool:
```
dipassistant -gui
```
2. In the navigator pane, select Connector Profile Management.
In the Connector Profile Management window, select the profile you want to modify.
Click Edit. The General Tab tab page appears.
In the General Tab tab page, modify the necessary fields.

The fields in the General tab page are described in Table A-10.
Click the Mapping Tab tab and modify the necessary fields.

The fields in the Mapping tab page are described in Table A-11.
Click the Filtering Tab tab and modify the necessary fields.

The fields in the Mapping tab page are described in Table A-9.
Click the Status Tab tab and modify the necessary fields. Because this page shows the execution status of the connectors, most of the fields cannot be edited.

The fields in the Status tab page are described in Table A-13.
Click the Others Tab tab and modify the necessary fields.

The fields in the Execution tab page are described in Table A-12.
When you have finishing modifying the information, click OK.

D eleting a Profile

To delete a profile:

Perform the following steps to start the Oracle Directory Integration Server Administration tool:
1. Run the following command to start the Oracle Directory Integration Server Administration tool:
```
dipassistant -gui
```
2. In the navigator pane, select Connector Profile Management.
In the Connector Profile Management, select the profile you want to delete.
Click Delete. A window that prompts you to confirm deletion of the connector profile.
Click Yes to confirm that you want to delete the profile.

Modifying the Synchronization Status Attributes

During the synchronization process, the server constantly updates the orcllastappliedchangenumber synchronization status attribute. In the Oracle Directory Integration Server Administration tool, this field is called OID last applied change number. Oracle does not recommend changing the synchronization status attributes. However, there may be cases when you need to update the lastappliedchangenumber attribute. For example, you may need to reapply some changes or skip synchronization of certain entries.

To change the synchronization status attributes by using the Oracle Directory Integration Server Administration tool:

Verify that the Oracle directory integration platform recognizes the disable flag for the profile.

In the default mode, it can take up to two minutes for the Oracle directory integration server to recognize this flag. To enable it to recognize this flag sooner, set the refresh interval to a lower value, as described in the odisrv section in the Oracle Internet Directory server administration tools chapter of Oracle Identity Management User Reference.
Disable the agent by using the Oracle Directory Integration Server Administration tool.
Modify the synchronization status attributes by following the procedures in "Modifying a Profile".
Reenable the agent after the change.

Managing Synchronization Profiles Using Command-Line Tools

You can create, modify, and delete a synchronization profile using the Directory Integration Assistant (dipassistant), as described in the dipassistant section of the Oracle Directory Integration Platform tools chapter in Oracle Identity Management User Reference.