13.3. Using the DIOP Feature

This section explains how you can verify whether the DIOP feature works in Directory Server. After you have successfully installed and configured two instances of Directory Servers, as explained in the preceding sections, follow the instructions in this section.
To help you understand the DIOP feature, a sample plug-in is provided. Details of this plug-in is covered in Section 13.3, “Using the DIOP Feature”. It is recommended that you review the sample plug-in first and use that as an example to develop your own plug-in.
To verify the DIOP feature, you may use the sample plug-in or reconfigure Directory Server to use your own plug-in. You can also remove the plug-in altogether from the server.
  1. If you want to use the sample plug-in, first build the plug-in, and then load it into the server:
    1. Shut down your DIOP-enabled Directory Server.
    2. Go to the directory in which the sample plug-in is located. 
      # cd /usr/lib64/dirsrv/plugins/
    3. Build the plug-in. 
      # gmake
    4. Modify the /etc/dirsrv/slapd-instance/dse.ldif file to include an entry for the plug-in. For instructions on to modify the dse.ldif file, refer to Section 13.3, “Using the DIOP Feature”. The entry shown below is for the sample plug-in. 
      dn: cn=datainterop,cn=plugins,cn=config objectClass: top objectClass: nsSlapdPlugin 
cn: datainterop nsslapd-pluginPath: /usr/lib64/dirsrv/plugins/libtest-plugin.so 
nsslapd-pluginInitfunc: nullsuffix_init nsslapd-pluginType: preoperation nsslapd-pluginEnabled: on 
nsslapd-pluginId: nullsuffix-preop nsslapd-pluginVersion: 7.1 nsslapd-pluginVendor: Red Hat, Inc. 
nsslapd-pluginDescription: sample pre-operation null suffix plugin
    5. Restart the server to load the modified configuration.
  2. If you want to reconfigure the server to use your own plug-in:
    1. Shut down your DIOP-enabled Directory Server.
    2. Open the /etc/dirsrv/slapd-instance/dse.ldif file in a text editor.
    3. Modify the cn=datainterop,cn=plugins,cn=config entry, which holds the plug-in information, with data from your proprietary database plug-in.
    4. After you have done the required changes, restart the server to load the modified configuration.
  3. If you want to delete the sample plug-in from the server:
    1. Shut down your DIOP-enabled Directory Server.
    2. Open the /etc/dirsrv/slapd-instance/dse.ldif file in a text editor.
    3. Delete the cn=datainterop,cn=plugins,cn=config entry, which holds the plug-in information.
    4. Restart the server to load the modified configuration.
You can also use the ldapmodify command to make these changes.