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 or Oracle Directory Manager. 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 configuration set entry, then adding a profile to it
By selecting an existing configuration set 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 Integration Profile Configuration.
OR

Perform the following steps to start Oracle Directory Manager:
1. Run the following command to start Oracle Directory Manager:
```
oidadmin
```
2. In the navigator pane, expand Oracle Internet Directory Servers, then directory server instance, then Server Management, then Integration Server.
Select the configuration set where you want to create the profile. The Integration Connectors tab page appears in the right pane.
In the Integration Connectors tab, select Create. The Integration Connectors dialog box appears. You have two options:
- 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:
"Integration Connectors" for more information about the Integration Profiles dialog box
In the General tab page, fill in the fields.

The fields in the General tab page are described in Table A-3.
Click the Execution tab and fill in the fields.

The fields in the Execution tab page are described in Table A-4.
Click the Mapping tab and fill in the fields.

The fields in the Mapping tab page are described in Table A-5.
Click the Status 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-6.
After you enter the information, click OK. This returns you to the Configuration Sets dialog box, 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 Integration Profile Configuration.
OR

Perform the following steps to start Oracle Directory Manager:
1. Run the following command to start Oracle Directory Manager:
```
oidadmin
```
2. In the navigator pane, expand Oracle Internet Directory Servers, then directory server instance, then Server Management, then Integration Server.
Select the configuration set from which to modify the profile. The Integration Connectors tab page appears in the right pane.
In the Integration Connectors tab page, select the profile you want to modify.
Click Edit. The General tab page appears.
In the General tab page, modify the necessary fields.

The fields in the General tab page are described in Table A-3.
Click the Execution tab and modify the necessary fields.

The fields in the Execution tab page are described in Table A-4.
Click the Mapping tab and modify the necessary fields.

The fields in the Mapping tab page are described in Table A-5.
Click the Status tab and modify the necessary fields. Because this page shows the execution status of the connectors, most of the fields cannot be edited. If you do need to modify any fields on this tab that are editable, such as the Last Applied Change Number field, you must follow the procedures in "Modifying the Synchronization Status Attributes".

The fields in the Status tab page are described in Table A-6.
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 Integration Profile Configuration.
OR

Perform the following steps to start Oracle Directory Manager:
1. Run the following command to start Oracle Directory Manager:
```
oidadmin
```
2. In the navigator pane, expand Oracle Internet Directory Servers, then directory server instance, then Server Management, then Integration Server.
Select the configuration set containing the profile you want to delete. The Integration Connectors tab appears in the right pane.
In the Integration Connectors tab page, select the profile you want to delete.
Click Delete.

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.