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:

• Edit the Security.properties file. This step is described in this section.

• Enable the MailHostStorePlugin. This step is described in the following section, Adding Plug-ins for Delegated Administrator.

The Security.properties file lets you customize the Delegated Administrator console for all or for individual roles.

To remove the Preferred Mail Host from the console

1. Add the lines shown below to the Security.properties file.

   # Remove Preferred Mail Host from UI *.NewOrganizationPage6.PreferredMailHostProperty=INVISIBLE *.NewOrganizationSummaryPage.PreferredMailHostSummaryProperty=INVISIBLE *.OrgProperties.MailHostName=INVISIBLE *.OrgProperties.MailHostNameText=INVISIBLE *.OrgProperties.MailHostValue=INVISIBLE

   The Security.properties file is located in the following directory:

   da-base/data/da/WEB-INF/classes/com/sun/comm/da/resources

   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.

2. Redeploy the edited Security.properties file to the Web container used by the Delegated Administrator console.

   Before the change can take effect, you must run the script that deploys the customized Security.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.

Syntax and Values for Security.properties File Properties

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:

“ProviderAdminRole” (SPA) For information about this role, see Appendix A, Service Provider Administrator and Service Provider Organizations.

“OrganizationAdminRole” (OA)

“Top-levelAdminRole” (TLA)

“*” (applies a permission to all roles unless it is overridden for a specific role)

A permission must be one of the following strings:

• EDITABLE– indicates that the security element is editable.

• NONEDITABLE– indicates that the security element is read-only.

• VISIBLE– indicates that the security element is visible and read-only.

• INVISIBLE– indicates that the security element is invisible.