Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Communications Services 6 2005Q1 Delegated Administrator Guide 

Chapter 4
Customizing Delegated Administrator   

After you have installed and configured Delegated Administrator with the configuration program (config-commda), you can customize your configuration to meet your particular needs. This chapter offers examples of how to customize certain Delegated Administrator features.

This chapter describes the following topics:

Configuring the Preferred Mail Host Using the Service-Wide Default

If you want the Preferred Mail Host and Preferred Mail Store to be set using the server-wide default, you can perform the tasks described in this section.

If you need to remove the Preferred Mail Host field from the Console (specifically, from the New Organization Wizard and Organization Properties screens), you can should take the following steps:

The file lets you customize the Delegated Administrator Console for all or for individual roles.

The file is located in the directory da_base/da/WEB-INF/classes/com/sun/comm/da/resources

To remove the Preferred Mail Host from the Console, add the lines shown below to the file:

# Remove Preferred Mail Host from UI

CAUTION: You may add lines to this file for your own customization, but do not edit the lines already present. Editing existing lines could result in exceptions being thrown on the Console.

The properties in the file are of the form: Security Element Name=Permission

A Security Element Name is of the form:
Role Name.Container View Name.Console Element Name

A Security Element specifies the Console element and role for which the permission is being defined. If you do not know an element name, view the source of a page to match the name on the page to the Console element you are interested in.

The names on the page are fully qualified names. You need to pick up only the last two elements of the name, which form Container View Name.Console Element Name.

Valid role names for Delegated Administrator are as follows:

A permission must be one of the following strings:

Adding Plug-ins for Delegated Administrator

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

Enabling the Plug-Ins

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


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

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

# Plugin Configuration #

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



Plug-In Format

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

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:


You do not need to do anything with these classes.

Additional Flat File Required for Two Plug-Ins

Two plug-ins, MailHostStorePlugin and VolInternalLoginPlugin, require 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.

Customizing the User Log-In

When you run the Delegated Administrator configure program (config-commda), the value you use to log in to Delegated Administrator is set to be a uid.

For example, if you intend to log in as the TLA, and the TLA’s uid is john.doe, you would use john.doe to log in to Delegated Administrator.

You can customize Delegated Administrator to enable you to use additional values for the user log-in. For example, you could add the mail address (mail).

How the User Log-In Value Is Set

The config-commda program sets this value to uid with the loginAuth-idAttr property in the file, as shown in the following example:

              servicepackage-cosdefbasedn = <$rootSuffix>

where <$rootSuffix> is the root suffix in your directory.

The file is located in /var/opt/SUNWcomm/WEB-INF/classes/sun/comm/cli/server/servlet/

Adding a User Log-In Value

You can set additional values for the user log-in by editing the file.

For example, to enable you to use a mail address (such as to log in, you could add the following line to the file:

        servicepackage-cosdefbasedn = <$rootSuffix>

where <$rootSuffix> is the root suffix in your directory.

Note that you must add an increment to the loginAuth-idAttr property for each new value. In this example, a second value is added, so you add -2 to loginAuth-idAttr .

You can add multiple instances of the loginAuth-idAttr property:

         loginAuth-idAttr-n=<login-in value>

Previous      Contents      Index      Next     

Part No: 819-0114-10.   Copyright 2005 Sun Microsystems, Inc. All rights reserved.