Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 44 / 612

Loading the Plug-In Configuration File
44 Netscape Directory Server Plug-In Programmer’s Guide • December 2003
Loading the Plug-In Configuration File
After you have written the plug-in configuration file, you must load it into the
dse.ldif
file, which is located in the
<server_root>/slapd-<instance_id>/config
directory. You can do this either
by using an LDAP utility, such as
ldapmodify
, or by editing the file directly. If you
choose to edit the file directly, be sure to shut down the Directory Server first.
The following line shows an example of an LDAP command that loads the plug-in
defined in the configuration file
example-plugin.ldif
:
ldapmodify -h my_host -p 389 -a -D "cn= Directory Manager" \
-w adminadmin -f example-plugin.ldif
Once the plug-in configuration is loaded, you must shut down the Directory Server
and then restart it before you can make calls to your plug-in. There are various
ways to shut down and restart the Directory Server; for example, you can:
• Use the Directory Server Console
• Use the UNIX scripts
stop-slapd
and
start-slapd
• Use the Windows NT Services applet, which can be found in the Control Panel
object
Declares an object plug-in. Object plug-ins can install
SLAPI_PLUGIN_START_FN
,
SLAPI_PLUGIN_CLOSE_FN
, and
SLAPI_PLUGIN_POSTSTART_FN
functions. They can also use the
slapi_register_plugin()
call to register any kind of plug-in they like.
Object plug-ins are typically used to simplify configuration of a group of related
plug-ins (one entry under
cn=config
instead of many).
Example of use: You can use this type when your plug-in doesn’t fit in any of
the other types listed in this table. For example, if your plug-in does more than
one thing, then you should use this directive. This type of plug-in will typically
register the types of operations it wants to handle using the internal API.
pwdstoragescheme
This directive will be supported in the future.
Table 3-1 Directives for Specifying Different Plug-In Types (Continued)
Directive Description