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

After you edit the resource.properties file, redeploy it to the Web container used by the Delegated Administrator server.

Before the changes can take effect, you must run the script that deploys the customized resource.properties file to your Web container.

For instructions on how to deploy a customized properties file to a particular Web container, see To Deploy a Customized Configuration File.

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>