Adding Plug-ins for Delegated Administrator

You can customize Delegated Administrator to support the following plug-ins:

• MailHostStorePlugin

  By default, this plug-in is disabled. If no preferredmailhost is supplied when a business organization is created, an exception will be raised. If the plug-in is enabled, values from the flat file (described later in this section) will be used only if the corresponding attribute is absent.

• MailDomainReportAddressPlugin

  Uses the domain value to return the desired DSN address. The default implementation is to return the string MAILER-DAEMON@<domain>.

• UidPlugin

  Generates a unique id string. The default implementation generates a GUID to return to the caller.

Enabling the Plug-Ins

To enable these plug-ins, edit the commcli servlet resource.properties file, located in the following directory:

da_base/data/WEB-INF/classes/sun/comm/cli/server/servlet/
resource.properties

(By default, da_base is /opt/SUNWcomm.)

The plug-ins are located in the resource.properties file in a section headed as follows:

########################
# Plugin Configuration #
##########################

Each has "plugin" as the suffix. The current list looks like:

jdapi-mailhoststoreplugin=disabled

jdapi-mailhoststorepluginclass=sun.comm.cli.server.util.MailHostStorePlugin
jdapi-mailhoststorepluginfile=/tmp/mailhostmailstore
jdapi-maildomainreportaddressplugin=enabled
jdapi-maildomainreportaddresspluginclass=sun.comm.cli.server.
  util.MailDomainReportAddressPlugin
jdapi-uidautogenerationplugin=disabled
jdapi-uidautogenerationpluginclass=sun.comm.cli.server.util.UidPlugin

Plug-In Format

Each plug-in has at least two lines, which take the following form:

• jdapi-<name>plugin= “enabled” | “disabled”

• jdapi-<name>pluginclass=sun.comm.cli.server.util/ <java class name>

To enable a plug-in, change “disabled” to “enabled”.

Plug-in classes are supplied for all the plug-ins listed in this section. The classes are located in the following directory:

da_base/data/WEB-INF/classes/sun/comm/cli/server/util

You do not need to do anything with these classes.

Additional Flat File Required for MailHostStorePlugin

The MailHostStorePlugin requires a flat file, which is included in a third line for the plug-in. The plug-in reads the value in the flat file and uses it to set attribute values. If the plug-in is enabled, the file must be present, or an error will occur.

• jdapi-mailhoststoreplugin o jdapi-mailhoststoreplugininf=<full file name> o file has one line o value is that for : o preferredmailhost attribute o preferredmailmessagestore attribute o form o <mailhost>:<mailpartition>