Sun Java System Communications Services 6 2005Q4 Delegated Administrator 指南

第 3 章配置 Delegated Administrator

Delegated Administrator 配置程序 (config-commda) 可根据您的特定要求来创建新的配置。此初始运行时配置程序执行的是最小配置。

运行此程序之后，应执行配置后任务中所述的步骤来完成初始配置。

通过执行第 4 章，自定义 Delegated Administrator中所述的任务，您可以进一步自定义 Delegated Administrator 配置。

可能还会需要执行其他配置，如 Sun Java System Messaging Server 管理指南中所述。

本章介绍了以下主题：

如果要从早期版本的 Delegated Administrator 进行升级

如果您是首次配置 Delegated Administrator，则可以跳过本节，直接转到选择要配置的组件一节。

如果要从早期版本的 Java Enterprise System 中升级到此版本的 Delegated Administrator，则在配置 Delegated Administrator 之前可能需要执行以下任务：

有关如何从早期版本的 Sun Java System 中升级 Delegated Administrator 的说明，请参见 Sun Java Enterprise System 升级指南中题目为“升级 Delegated Administrator”的一章。

保留现有配置

本节仅针对以前安装并配置了 Delegated Administrator，并自定义了 Delegated Administrator 配置的用户。

如果您具有自定义配置并且重新运行 Delegated Administrator 配置程序 config-commda，则配置文件中的属性将重置为其默认值。这些文件列在下面的Delegated Administrator 属性文件中。

有关如何自定义 Delegated Administrator 的信息，请参见第 4 章，自定义 Delegated Administrator。

在升级 Delegated Administrator 或由于任何其他原因而重新运行 Delegated Administrator 配置程序之前，应保留自定义配置。

Delegated Administrator 属性文件

Delegated Administrator 安装了以下属性文件：

resource.properties

默认位置：

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

默认位置：

da_base/data/WEB-INF/classes/com/sun/comm/da/resources
cli-usrprefs.properties

默认位置：/var/opt/SUNWcomm/config
security.properties

默认位置：da_base/data/da/WEB-INF/classes/com/sun/comm/da/resources
Resources.properties

默认位置：

da_base/data/da/WEB-INF/classes/com/sun/comm/da/resources
logger.properties

默认位置：

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

保留现有配置的步骤

步骤

备份已自定义的属性文件。

有关属性文件及其默认位置的列表，请参见 Delegated Administrator 属性文件。

运行 config-commda 程序，如以下几节所述。

剩下的步骤将使用 resource.properties 文件作为示例。您可以对每个自定义的文件重复这些步骤。

如下所示编辑由 config-commda 程序创建的新 resource.properties 文件：
1. 打开该新 resource.properties 文件。
2. 打开 resource.properties 文件的备份副本。
3. 找到在该备份副本中自定义的属性。将自定义值应用于新 resource.properties 文件中的相应属性。
  
  不要简单地用整个备份副本覆写新 resource.properties 文件。该新文件可能包含为支持此版本的 Delegated Administrator 而创建的新属性。

升级自定义服务包

本节仅针对从 Communications Services 6 2005Q1 Delegated Administrator 升级到 Communications Services 6 2005Q4 Delegated Administrator 并且在前一个版本 (6 2005Q1) 中创建了自定义服务包的用户。

在 Delegated Administrator 的当前版本 (6 2005Q4) 中，无论对于用户还是组，服务包都可以提供日历服务和邮件服务。在前一个版本 (6 2005Q1) 中，服务包仅对用户提供邮件服务。服务包定义中包括一个新属性，用来支持新增功能。

服务等级模板样例

运行 Delegated Administrator 配置程序后，以前由 Delegated Administrator 配置程序安装的服务等级模板样例将自动升级。（在此配置程序中，应选择服务包和组织样例中的装入样例服务包。）

如果仅使用样例模板来向用户和组分配服务包，则不需要执行任何操作。

自定义服务包

配置程序不会升级在 6 2005Q1 版本中创建的自定义服务包。您必须手动升级自定义服务包。

有关如何创建自定义服务包的信息，请参见创建您自己的服务包。

升级自定义服务包的步骤

步骤

通过将以下行添加到用于定义服务包的 ldif 文件来编辑每个自定义服务包：
daServiceType: mail user
daServiceType 属性用于定义服务类型（邮件或日历）和目标（用户或组）。

在前一个版本中创建的服务包仅对用户提供邮件服务。因此，daServiceType 的值应为 mail user。

以下示例显示了编辑后的 ldif 文件的外观：
dn: cn=myservicepackage,o=cosTemplates,o=mycompanysuffix changetype: modify replace: daServiceType daServiceType: mail user

使用 LDAP 目录工具 ldapmodify 来更新目录中的服务包。

例如，可以运行以下命令：

ldapmodify -D <directory manager> -w <password> -f myservicepackage

其中

<directory manager> 是 Directory Server 管理员的用户名。

<password> 是 Directory Server 管理员的密码。

myservicepackage 是用于定义自定义服务包的 ldif 文件的名称。

选择要配置的组件

配置程序中的第三个面板会询问您要配置哪些 Delegated Administrator 组件：

Delegated Administrator 实用程序（客户机）—使用 commadmin 调用的命令行界面。
Delegated Administrator 服务器—运行 Delegated Administrator 实用程序和控制台必需的 Delegated Administrator 服务器组件。
Delegated Administrator 控制台—Delegated Administrator 图形用户界面 (Graphical User Interface, GUI)。

配置程序将根据您选择的组件显示不同的面板。

以下步骤对配置选项进行了概要介绍。每个摘要步骤（如下）可链接到本章后面的一节，该部分逐步介绍了配置面板的实际情况。

配置选项摘要

步骤

开始进行配置

输入这些面板中请求的信息，从而开始进行配置。

配置 Delegated Administrator 实用程序

这些面板紧跟在选择要配置的组件面板后面。它们将请求用于配置 Delegated Administrator 实用程序的信息。

必须在所有要安装 Delegated Administrator 组件（服务器或控制台）的计算机上都配置 Delegated Administrator 实用程序。

因此，始终必须在这些面板中输入信息。

配置 Delegated Administrator 控制台

这些面板出现在用于配置实用程序的面板后面。

您可以选择是否配置 Delegated Administrator 控制台。
- 如果将 Delegated Administrator 控制台和服务器部署在同一台计算机上，则应当在选择要配置的组件面板中同时选择控制台和服务器。
- 也可以将 Delegated Administrator 控制台和服务器部署在不同的计算机上。
  
  在要部署控制台的计算机上，只能在选择要配置的组件面板中选择控制台。（始终要选中此实用程序。）
  
  在这种情况下，必须在要部署服务器的计算机上再次运行配置程序。
  
  如果将控制台和服务器部署在不同的计算机上，则在两台计算机上都要配置此实用程序。
根据您为控制台选择的 Web 容器，配置程序将显示不同的面板。您可以部署到以下 Web 容器之一：
- Sun Java System Web Server
- Sun Java System Application Server 7.x
- Sun Java System Application Server 8.x
如果将 Delegated Administrator 服务器和控制台配置在同一计算机上，则要按上述说明操作两次（一次针对服务器，一次针对控制台）。

配置 Delegated Administrator 服务器

这些面板出现在用于配置控制台的面板后面。

您可以选择是否在给定的计算机上配置 Delegated Administrator 服务器。

如果选择不在给定计算机上配置该服务器，配置程序将警告您必须在另一台计算机上配置该服务器。要运行实用程序和控制台，该服务器组件是必需的。

部署该服务器时的其他所有注意事项与部署控制台时的注意事项（如配置 Delegated Administrator 控制台中所述）相同。

另外还要注意的是，该服务器与 Access Manager 使用同一个 Web 容器。（配置程序会在请求 Access Manager 基本目录后请求 Web 容器信息。）

完成配置

输入这些面板中请求的信息，从而完成配置。

运行配置程序

本节中介绍的步骤将指导您逐步配置 Delegated Administrator。

启动配置程序

要运行配置程序，请作为（或成为）超级用户来登录，并转到 /opt/SUNWcomm/sbin 目录。然后输入以下命令：

# ./config-commda

运行 config-commda 命令之后，就会启动配置程序。

以下几节将逐步向您介绍各个配置面板。

开始进行配置

必须输入第一批配置程序面板中请求的信息。

开始进行配置的步骤

步骤

欢迎

配置程序中的第一个面板为版权页。单击下一步继续或单击取消退出。

选择用于存储配置和数据文件的目录

选择要用来存储 Delegated Administrator 配置和数据文件的目录。默认的配置目录为 /var/opt/SUNWcomm。此目录应当与 da_base 目录 (/opt/SUNWcomm) 分开。

输入此目录的名称，或保留默认名称，然后单击下一步继续。

如果指定的目录不存在，将会出现一个对话框，询问您是要创建该目录还是选择一个新目录。单击创建目录以创建目录或选择新目录以输入一个新目录。

将出现一个对话框，指出正在装入组件。这可能需要几分钟的时间。

选择要配置的组件

在“组件”面板上选择一个或多个要配置的组件。
- Delegated Administrator 实用程序（客户机）—使用 commadmin 调用的命令行界面。此组件是必需的组件，默认情况下处于选定状态。无法取消选定该组件。
- Delegated Administrator 服务器—运行 Delegated Administrator 控制台必需的 Delegated Administrator 服务器组件。
- Delegated Administrator 控制台—Delegated Administrator 图形用户界面 (Graphical User Interface, GUI)。
单击下一步继续，或单击上一步返回到前一个面板，或者单击取消退出。

有关如何选择组件的详细信息，请参见选择要配置的组件

如果选择不配置 Delegated Administrator 服务器，则会出现一个对话框，提醒您注意必须在另一台计算机上配置 Delegated Administrator 服务器。必须配置该服务器才能使用 Delegated Administrator 实用程序和控制台。

配置 Delegated Administrator 实用程序

必须在所有要安装 Delegated Administrator 组件（服务器或控制台）的计算机上都配置 Delegated Administrator 实用程序。

配置 Delegated Administrator 实用程序的步骤

步骤

Access Manager 主机名和端口号

输入 Access Manager（以前称为 Identity Server）的主机名和端口号。如果要安装 Delegated Administrator 服务器组件，则必须将其与 Access Manager 安装在同一台主机上。

单击下一步继续，或单击上一步返回到前一个面板，或者单击取消退出。

默认域

输入顶级管理员的默认域。在执行 commadmin 命令行实用程序时，如果没有通过 -n 选项显式指定某个域，则使用此域。它也称为默认组织。如果目录中不存在指定的域，将会创建该域。

单击下一步继续，或单击上一步返回到前一个面板，或者单击取消退出。

默认的客户机 SSL 端口

输入 Delegated Administrator 实用程序使用的默认 SSL 端口。

单击下一步继续，或单击上一步返回到前一个面板，或者单击取消退出。

如果选择仅配置 Delegated Administrator 实用程序，请转至

完成配置

如果选择配置 Delegated Administrator 控制台和服务器，或者选择仅配置该控制台，请转至

配置 Delegated Administrator 控制台

如果选择仅配置 Delegated Administrator 服务器（以及必需的 Delegated Administrator 实用程序），请转至

配置 Delegated Administrator 服务器

配置 Delegated Administrator 控制台

现在，配置程序将显示以下面板：

为 Delegated Administrator 选择 Web 容器

选择部署 Delegated Administrator 控制台所基于的 Web 容器。可以基于以下组件来配置 Delegated Administrator

Sun Java System Web Server
Sun Java System Application Server 7.x
Sun Java System Application Server 8.x

单击下一步继续，或单击上一步返回到前一个面板，或者单击取消退出。

此面板以及接下来的几个面板用于收集有关 Delegated Administrator 控制台的 Web 容器的信息。请按照相应部分中的说明执行操作：

可以基于两个不同的 Web 容器、两个不同的 Web 容器实例或同一个 Web 容器来部署 Delegated Administrator 控制台和服务器。

如果选择在面板 3 中配置 Delegated Administrator 控制台和 Delegated Administrator 服务器，则另一系列的面板将会请求有关该服务器的 Web 容器的信息。

因此，您会两次看到 Web 容器配置面板。请按照相应的说明来部署每个 Delegated Administrator 组件。

完成 Web 容器配置面板后：

如果选择配置 Delegated Administrator 控制台和服务器，请转至

配置 Delegated Administrator 服务器
如果选择仅配置 Delegated Administrator 控制台（以及必需的 Delegated Administrator 实用程序），请转至

完成配置

Web Server 配置

如果要基于 Web Server 来部署 Delegated Administrator 服务器或控制台，请按照本节所述的步骤进行操作。

配置 Web Server 的步骤

步骤

Web Server 配置详细信息

此面板文本用于告知您是否在为 Delegated Administrator 服务器或控制台提供 Web Server 配置信息。

输入 Web Server 的根目录。可以通过浏览来选择该目录。

输入 Web Server 实例标识符。可以用 host.domain 名（例如 west.sesta.com）来指定此标识符。

输入虚拟服务器标识符。可以用 https-host.domain 名（例如 https-west.sesta.com）来指定此标识符。

有关 Web Server 实例标识符和虚拟服务器标识符的详细信息，请参见 Web Server 文档。

Web Server 实例的相关文件存储在 Web Server 安装目录下的 https-host.domain 目录中，例如 /opt/SUNWwbsvr/https-west.sesta.com。

输入 Web Server 的 HTTP 端口号。

单击下一步继续，或单击上一步返回到前一个面板，或者单击取消退出。

配置程序将检查您指定的值是否有效。如果某个目录或标识符无效或不存在，将会出现一个对话框，通知您选择新值。

然后，配置程序将检查 Web Server 实例连接是否处于活动状态。如果不是，将会出现一个对话框，警告您配置程序无法连接到指定的实例，配置可能无法完成。您可以接受指定的值，也可以选择新的 Web Server 配置值。

默认的域分隔符

此面板只有在配置 Delegated Administrator 控制台时才会显示。在配置控制台时需要使用域分隔符；此信息与 Web 容器无关。

输入用于在用户登录时进行验证的默认域分隔符。例如：@。

域分隔符值包含在 daconfig.properties 文件中。可以在运行配置程序之后编辑此属性值。有关详细信息，请参见第 4 章，自定义 Delegated Administrator。

如果要配置 Delegated Administrator 控制台：
- 如果选择配置 Delegated Administrator 控制台和服务器，请转至
  
  配置 Delegated Administrator 服务器
- 如果选择仅配置 Delegated Administrator 控制台（以及必需的 Delegated Administrator 实用程序），请转至
  
  完成配置
如果要配置 Delegated Administrator 服务器：

请转至

配置 Delegated Administrator 服务器中的步骤 3。

Application Server 7.x 配置

如果要基于 Application Server 7.x 来部署 Delegated Administrator 服务器或控制台，请按照本节所述的步骤进行操作。

配置 Application Server 7.x 的步骤

步骤

Application Server 7.x 配置详细信息

此面板文本用于告知您是否在为 Delegated Administrator 服务器或控制台提供 Application Server 7. x 配置信息。

输入 Application Server 安装目录。默认情况下，此目录为 /opt/SUNWappserver7。

输入 Application Server 域目录。默认情况下，此目录为 /var/opt/SUNWappserver7/domains/domain1。

输入 Application Server 文档根目录。默认情况下，此目录为 /var/opt/SUNWappserver7/domains/domain1/server1/docroot。

可以通过浏览来选择这些目录中的任何一个。

输入 Application Server 实例名称。例如：server1。

输入 Application Server 虚拟服务器标识符。例如：server1。

输入 Application Server 实例的 HTTP 端口号。

单击下一步继续，或单击上一步返回到前一个面板，或者单击取消退出。

配置程序将检查您指定的目录是否有效。如果某个目录无效或不存在，将会出现一个对话框，通知您选择新目录。

然后，配置程序将检查 Application Server 实例连接是否处于活动状态。如果不是，将会出现一个对话框，警告您配置程序无法连接到指定的实例，配置可能无法完成。您可以接受指定的值，也可以选择新的 Application Server 配置值。

Application Server 7.x：管理实例详细信息

输入 Administration Server 端口号。例如：4848

输入 Administration Server 管理员的用户 ID。例如：admin

输入管理员的用户密码。

如果要使用安全的 Administration Server 实例，应选中安全 Administration Server 实例框。如果不需要使用安全实例，则将此框保留为未选中状态。

单击下一步继续，或单击上一步返回到前一个面板，或又单击取消退出。

默认的域分隔符

此面板只有在配置 Delegated Administrator 控制台时才会显示。在配置控制台时需要使用域分隔符；此信息与 Web 容器无关。

输入用于在用户登录时进行验证的默认域分隔符。例如：@。

如果要配置 Delegated Administrator 控制台：
- 如果选择配置 Delegated Administrator 控制台和服务器，请转至
  
  配置 Delegated Administrator 服务器
- 如果选择仅配置 Delegated Administrator 控制台（以及必需的 Delegated Administrator 实用程序），请转至
  
  完成配置
如果要配置 Delegated Administrator 服务器：

请转至

配置 Delegated Administrator 服务器中的步骤 3。

Application Server 8.x 配置

如果要在 Application Server 8.x 上部署 Delegated Administrator 服务器或控制台，请按照本节所述的步骤进行操作。

配置 Application Server 8.x 的步骤

步骤

Application Server 8.x 配置详细信息

此面板文本用于告知您是否在为 Delegated Administrator 服务器或控制台提供 Application Server 8. x 配置信息。

输入 Application Server 安装目录。默认情况下，此目录为 /opt/SUNWappserver/appserver。

输入 Application Server 域目录。默认情况下，此目录为 /var/opt/SUNWappserver/domains/domain1。

输入 Application Server 文档根目录。默认情况下，此目录为 /var/opt/SUNWappserver/domains/domain1/docroot。

可以通过浏览来选择这些目录中的任何一个。

输入 Application Server 目标名称。例如：server。

输入 Application Server 虚拟服务器标识符。例如：server。

输入 Application Server 目标的 HTTP 端口号。

单击下一步继续，或单击上一步返回到前一个面板，或者单击取消退出。

配置程序将检查您指定的目录是否有效。如果某个目录无效或不存在，将会出现一个对话框，通知您选择新目录。

然后，配置程序将检查 Application Server 目标连接是否处于活动状态。如果不是，将会出现一个对话框，警告您配置程序无法连接到指定的目标，配置可能无法完成。您可以接受指定的值，也可以选择新的 Application Server 配置值。

Application Server 8.x：管理实例详细信息

输入 Administration Server 端口号。例如：4849

输入 Administration Server 管理员的用户 ID。例如：admin

输入管理员的用户密码。

如果要使用安全的 Administration Server 实例，应选中安全 Administration Server 实例框。如果不需要使用安全实例，则将此框保留为未选中状态。

单击下一步继续，或单击上一步返回到前一个面板，或又单击取消退出。

默认的域分隔符

此面板只有在配置 Delegated Administrator 控制台时才会显示。在配置控制台时需要使用域分隔符；此信息与 Web 容器无关。

输入用于在用户登录时进行验证的默认域分隔符。例如：@。

如果要配置 Delegated Administrator 控制台：
- 如果选择配置 Delegated Administrator 控制台和服务器，请转至
  
  配置 Delegated Administrator 服务器
- 如果选择仅配置 Delegated Administrator 控制台（以及必需的 Delegated Administrator 实用程序），请转至
  
  完成配置
如果要配置 Delegated Administrator 服务器：

请转至

配置 Delegated Administrator 服务器中的步骤 3。

配置 Delegated Administrator 服务器

如果您选择配置 Delegated Administrator 服务器，则配置程序将显示以下面板。

配置 Delegated Administrator 服务器的步骤

步骤

Access Manager 基本目录

输入 Access Manager 基本目录。默认目录为 /opt/SUNWam。

单击下一步继续，或单击上一步返回到前一个面板，或又单击取消退出。

配置程序将检查指定的 Access Manager 基本目录是否有效。如果无效，将会出现一个对话框，指出必须选择现有的 Access Manager 基本目录。

然后，将显示 Web 容器的配置详细信息面板。

如果选择了配置控制台和服务器，则这是第二次出现 Web 容器的配置详细信息面板。

Delegated Administrator 服务器将与 Access Manager 部署到同一 Web 容器。（无法为 Delegated Administrator 服务器选择 Web 容器。）

请按照相应部分中的说明执行操作：

Directory (LDAP) Server

此面板将请求有关连接到 LDAP Directory Server 的信息来作为用户/组后缀。

在相应的文本框中输入用户和组 Directory Server LDAP URL (LdapURL)、Directory Manager（绑定为）以及密码。

Directory Manager 对 Directory Server 以及使用 Directory Server 的所有 Sun Java System 服务器（例如 Delegated Administrator）具有总体管理员特权，并对 Directory Server 中的所有条目具有完全管理权限。默认推荐的标识名 (Distinguished Name, DN) 为 cn=Directory Manager。

单击下一步继续，或单击上一步返回到前一个面板，或者单击取消退出。

Access Manager 顶级管理员

输入 Access Manager 顶级管理员的用户 ID 和密码。在安装 Access Manager 时会创建该用户 ID 和密码。默认的用户 ID 为 amadmin。

单击下一步继续，或单击上一步返回到前一个面板，或者单击取消退出。

Access Manager 内部 LDAP 验证密码

输入 Access Manager 内部 LDAP 验证用户的密码。

验证用户名被硬编码为 amldapuser。它由 Access Manager 安装程序创建，并且是 LDAP 服务的绑定 DN 用户。

单击下一步继续，或单击上一步返回到前一个面板，或又单击取消退出。

组织标识名 (Distinguished Name, DN)

输入默认域的组织 DN。例如，如果组织 DN 为 o=siroe.com，则该组织中的所有用户都将放在 LDAP DN o=siroe.com, o=usergroup 下，其中 o=usergroup 为根后缀。

默认情况下，配置程序会在 LDAP 目录中的根后缀下添加默认域。

如果要在根后缀处（而不是在其下）创建默认域，请从显示在组织标识名 (Distinguished Name, DN) 文本框中的 DN 中删除组织名称。

例如，如果组织 DN 为 o=siroe.com，根后缀为 o=usergroup，则从文本框中的 DN 中删除 “o=siroe.com”，仅保留 o=usergroup。

如果选择在根后缀处创建默认域，则以后决定使用托管域时，可能会很难迁移到托管域配置。config-commda 程序将会显示以下警告：

“所选的组织 DN 是用户/组后缀。尽管该选择有效，但是，如果您决定使用托管域，就会遇到迁移困难。如果您确实需要使用托管域，就指定一个比用户/组后缀低一级的 DN。”

有关详细信息，请参见支持单层结构的目录结构。

单击下一步继续，或单击上一步返回到前一个面板，或者单击取消退出。

默认组织的顶级管理员

为要在默认域（组织）中创建的顶级管理员输入用户 ID 和密码。

确认密码字段要求您再次输入该密码。

单击下一步继续，或单击上一步返回到前一个面板，或者单击取消退出。

服务包和组织样例

您可以选择向 LDAP 目录中添加样例服务包和样例组织。

装入样例服务包。如果要使用或修改样例服务包模板来创建您自己的服务等级包，则选中此选项。

装入样例组织。如果要在 LDAP 目录树中包含样例提供商组织节点和下属组织节点，则选中此选项。

您可以选择
- 同时选中样例服务包和样例组织
- 仅选中其中一个选项
- 不选中任何选项
用于样例的首选邮件主机。输入安装了 Messaging Server 的计算机的名称。

例如：mymachine.siroe.com

如果选择将样例组织装入到 LDAP 目录中，则必须为这些样例输入首选邮件主机名。

有关服务包和组织的信息，请参见第 2 章：“Delegated Administrator 概述”。

运行配置程序之后，必须修改服务包模板来创建您自己的服务等级包。有关此配置后任务的信息，请参见创建服务包。

完成配置

执行本节所述的步骤来完成配置程序。

完成配置的步骤

步骤

准备配置

验证面板会显示将要配置的项目。

单击立即配置开始进行配置，或单击上一步返回到前面任意一个面板以更改信息，或者单击取消退出。

任务序列

“任务序列”面板上会显示要执行的任务序列。此时将会实际开始进行配置。

当面板显示“所有任务已通过”时，您可以单击下一步继续或单击取消停止执行任务并退出。

将会出现一个对话框，提醒您要重新启动 Web 容器才能使配置更改生效。

安装摘要

“安装摘要”面板显示了安装的产品，并且具有详细信息...按钮，单击该按钮可显示有关此配置的详细信息。

将在 /opt/SUNWcomm/install 目录中创建 config-commda 程序的日志文件。该日志文件的名称为 commda-config_YYYYMMDDHHMMSS.log，其中 YYYYMMDDHHMMSS 标识了配置的年（4 位数）、月、日、小时、分钟和秒钟。

单击关闭以完成配置。

重新启动 Web 容器

完成 Delegated Administrator 配置后，必须重新启动将 Delegated Administrator 部署到的 Web 容器（以下组件之一）：

Web Server
Application Server 7.x
Application Server 8.x

由 `config-commda` 程序创建的配置文件和日志文件

配置文件

通过使用您在面板中提供的信息，config-commda 程序将为三个 Delegated Administrator 组件创建以下配置文件：

Delegated Administrator 实用程序：

配置文件名：cli-usrprefs.properties

默认位置：/var/opt/SUNWcomm/config
Delegated Administrator 服务器：

配置文件名：resource.properties

默认位置：

/opt/SUNWcomm/WEB-INF/classes/sun/comm/cli/server/servlet

或者

/var/opt/SUNWcomm/WEB-INF/classes/sun/comm/cli/server/servlet
Delegated Administrator 控制台：

配置文件名：daconfig.properties

默认位置：

/opt/SUNWcomm/WEB-INF/classes/com/sun/comm/da/resources

或者

/var/opt/SUNWcomm/WEB-INF/classes/com/sun/comm/da/resources

有关这些文件、它们所包含的属性以及如何编辑这些属性以自定义配置方面的信息，请参见第 4 章，自定义 Delegated Administrator。

日志文件

Delegated Administrator 控制台会创建运行时日志文件：

默认日志文件名：da.log

默认位置：/opt/SUNWcomm/log

有关此日志文件以及其他 Delegated Administrator 日志文件的详细信息，请参见附录 C，调试 Delegated Administrator。

执行无提示安装

Delegated Administrator 实用程序初始运行时配置程序将会自动创建无提示安装状态文件（称为 saveState）。此文件包含有关配置程序的内部信息，用于运行无提示安装。

无提示安装 saveState 文件存储在 /opt/SUNWcomm/data/setup/commda-config_YYYYMMDDHHMMSS/ 目录中，其中 YYYYMMDDHHMMSS 标识了 saveState 文件的年（4 位数）、月、日、小时、分钟和秒钟。

例如，一旦运行了一次 config-commda 程序后，就可以在无提示安装模式下运行该程序：

         
da_base/sbin/config-commda -nodisplay -noconsole -state
          fullpath/saveState

fullpath 变量是 saveState 文件所在位置的完整目录路径。

运行 Delegated Administrator 控制台和实用程序

启动控制台

通过访问将 Delegated Administrator 控制台部署到的 Web 容器来启动该 Delegated Administrator 控制台。

启动 Delegated Administrator 控制台的步骤

步骤

转至以下 URL：

http:// host:port/da/DA/Login

其中

host 为 Web 容器主机

port 为 Web 容器端口

例如：

http://siroe.com:8080/da/DA/Login

将显示 Delegated Administrator 控制台登录窗口。

登录到 Delegated Administrator 控制台。

可以使用在 Delegated Administrator 配置程序中指定的顶级管理员 (Top-Level Administrator, TLA) 的用户 ID 和密码。此信息是在以下面板中请求的：

默认组织的顶级管理员

注 –
运行 Delegated Administrator 控制台时，可以使用在 Access Manager 中设置的值来确定会话超时值。有关会话超时值的信息，请参见 Sun Java System Access Manager 管理指南中的“会话服务属性”。有关在 Access Manager 控制台中查看这些值的信息，请参见 Sun Java System Access Manager 管理指南中的“当前会话”。

运行命令行实用程序

可以通过在终端窗口中输入命令名称 commadmin 来运行 Delegated Administrator 实用程序。

运行命令行实用程序的步骤

步骤

转至 da_base/bin/ 目录。例如，转至 /opt/SUNWcomm/bin/。

输入 commadmin 命令。

示例 3–1 使用 `commadmin` 搜索用户

以下命令将搜索 varrius.com 域中的用户：

commadmin user search -D chris -w bolton -d varrius.com -n sesta.com

有关此 commadmin 命令的详细信息，请参见 commadmin user search。

`commadmin` 返回码

提示 –

当 commadmin 操作成功时，命令行将显示“确定”消息。

如果操作失败，则显示以下消息：

FAIL

<message>

其中 <message> 显示错误文本。

配置后任务

运行 Delegated Administrator 配置程序之后，应执行以下任务：

仅当在 Schema 2 兼容性模式下使用 LDAP 目录时，才需执行以下任务：

为 Schema 2 兼容性模式添加 ACI

向默认域添加邮件服务和日历服务

config-commda 程序会创建一个默认域。

如果要在该默认域中创建具有邮件服务或日历服务的用户，首先必须向该域添加邮件服务和日历服务。

要执行此任务，请使用带有 -S mail 和 -S cal 选项的 commadmin domain modify 命令。

以下示例显示了如何使用 commadmin domain modify 来向默认域添加邮件服务和日历服务：

commadmin domain modify -D chris -w bolton -n sesta.com -d siroe.com
 -S mail,cal -H test.siroe.com

有关 commadmin 命令的语法和详细信息，请参见第 5 章，命令行实用程序。

创建服务包

使用 Delegated Administrator 在 LDAP 目录中置备的每个用户和组都应具有服务包。一个用户或组可以具有多个服务包。

预定义的服务等级模板

在运行 Delegated Administrator 配置程序 (config-commda) 时，可以选择让 config-commda 程序在目录中安装服务等级模板样例。

有关服务等级模板样例以及服务包中的可用邮件属性的信息，请参见第 1 章，Delegated Administrator 概述中的服务包。

您可以使用服务等级模板样例来创建和分配服务包；但是这些模板样例只是一些示例。

创建您自己的服务包

您很可能会需要根据自定义的服务等级模板来创建自己的服务包，使属性值适用于您的安装中的用户和组。

要创建您自己的服务包，可使用存储在 da.cos.skeleton.ldif 文件中的服务等级模板。

此文件是专门作为编写自定义服务等级模板时所用的模板而创建的。配置 Delegated Administrator 时，未在 LDAP 目录中安装此文件。

da.cos.skeleton.ldif 文件包含四个参数化模板，每个模板对应于 Delegated Administrator 所提供的一个服务等级定义。

standardUserMail
standardUserCalendar
standardUserMailCalendar
standardGroupMail

您可以通过使用 da.cos.skeleton.ldif 文件中的一个或多个参数化模板来创建自己的服务等级模板。

da.cos.skeleton.ldif 文件中的服务等级模板如下：

# Templates for creating COS templates for service packages.
#
# There are four COS definitions :
#   standardUserMail
#   standardUserCalendar
#   standardUserMailCalendar
#   standardGroupMail
#
# Each definition can have zero or more COS templates which
# define specific values for the attributes listed in the 
# COS definition.
#
# Each COS definition points to a corresponding subdirectory
# in which COS templates for that definition (and no other
# definition) are found.  The templates directory structure
# is as follows:
# standardUserMail	      => o=mailuser,o=costemplates,<ugldapbasedn>
# standardUserCalendar      => o=calendaruser,o=costemplates,
#                               <ugldapbasedn>
# standardUserMailCalendar  => o=mailcalendaruser,o=costemplates,
#                               <ugldapbasedn>
# standardGroupMail	      => o=mailgroup,o=costemplates,
#                               <ugldapbasedn>
#
# Thus, all COS templates for the user mail service are found in the
# o=mailuser,o=costemplates,<ugldapbasedn> directory, etc.
#
# It is not necessary to have any templates for a given definition. 
# In that case default values are assumed for those attributes defined
# in the COS definition.
#
# If a template is created for a definition there should be at least
# one attribute with a defined value.
#
# Consult documentation for values for the attributes.  
# Documentation includes units and default values.
#
# The finished COS derived from this skeleton is added to the 
# directory with the following command:
# 
# ldapmodify -D <directory manager> -w <password> 
# -f <cos.finished.template.ldif>
#
#
############################################################
#
#	standardMailUser COS template
#
############################################################
# There must be a least one of the following attributes:
# - mailMsgMaxBlocks
# - mailQuota
# - mailMsgQuota
# - mailAllowedServiceAccess
#
dn: cn=<service package name>,o=mailuser,o=cosTemplates,<rootSuffix>
changetype: add
objectclass: top
objectclass: LDAPsubentry
objectclass: extensibleobject
objectclass: cosTemplate
cn: <service package name>
mailMsgMaxBlocks: <mailMsgMaxBlocksValue>
mailQuota: <ma:ilQuotaValue>
mailMsgQuota: <mailMsgQuotaValue>
mailAllowedServiceAccess: <mailAllowedServiceAccessValue>
#
#
############################################################
#
#	standardCalendarUser COS template
#
############################################################
# There must be a least one of the following attributes:
# - icsPreferredHost
# - icsDWPHost
# - icsFirstDay
#
dn: cn=<service package name>,o=calendaruser,o=cosTemplates,
    <ugldapbasedn>
changetype: add
objectclass: top
objectclass: LDAPsubentry
objectclass: extensibleobject
objectclass: cosTemplate
cn: <service package name>
icsPreferredHost: <preferredHostValue>
icsDWPHost: <dwpHostValue>
icsFirstDay: <firstDayValue>
daServiceType: calendar user
#
#
############################################################
#
#	standardMailCalendarUser COS template
#
############################################################
# There must be a least one of the following attributes:
# - mailMsgMaxBlocks
# - mailQuota
# - mailMsgQuota
# - mailAllowedServiceAccess
#
dn: cn=<service package name>,o=mailcalendaruser,o=cosTemplates,
    <ugldapbasedn>
changetype: add
objectclass: top
objectclass: LDAPsubentry
objectclass: extensibleobject
objectclass: cosTemplate
cn: <service package name>
mailMsgMaxBlocks: <mailMsgMaxBlocksValue>
mailquota: <mailQuotaValue>
mailmsgquota: <mailMsgQuotaValue>
mailAllowedServiceAccess: <mailAllowedServiceAccessValue>
daServiceType: calendar user
daServiceType: mail user
#
#
############################################################
#
#	standardMailGroup COS template
#
############################################################
# There must be a least one of the following attributes:
# - mailMsgMaxBlocks
#
#
dn: cn=<service package name>,o=mailgroup,o=cosTemplates,
    <ugldapbasedn>
changetype: add
objectclass: top
objectclass: LDAPsubentry
objectclass: extensibleobject
objectclass: cosTemplate
cn: <service package name>
mailMsgMaxBlocks: <mailMsgMaxBlocksValue>
daServiceType: mail group

创建您自己的服务包的步骤

步骤

复制并重命名 da.cos.skeleton.ldif 文件中的某一个参数化模板。

安装了 Delegated Administrator 后，da.cos.skeleton.ldif 文件将被安装在以下目录中：

da_base/lib/config-templates

选择 da.cos.skeleton.ldif 文件中的以下模板之一来进行复制和重命名：
standardUserMail standardUserCalendar standardUserMailCalendar standardGroupMail

在模板副本中编辑以下参数：
- <ugldapbasedn>
  
  将根后缀参数 <rootSuffix> 更改为您的根后缀（例如 o=usergroup）。
  
  <ugldapbasedn> 参数将显示在 DN 中。
- <service package name>
  
  将 <service package name> 参数更改为您自己的服务包名称。
  
  <service package name> 参数将显示在 DN 和 cn 中。
- 邮件属性值：
  <mailMsgMaxBlocksValue> <mailQuotaValue> <mailMsgQuotaValue> <mailAllowedServiceAccessValue>
  编辑这些值使其符合您的特定要求。
  
  例如，可以为邮件属性输入以下值：
  mailMsgMaxBlocks: 400 mailQuota: 400000000 mailMsgQuota: 5000 mailAllowedServiceAccess: imap:ALL$+pop:ALL$+smtp:ALL$+http:ALL
- 日历属性值：
  <preferredHostValue> <dwpHostValue> <firstDayValue>
  这些参数代表 LDAP 属性 icsPreferredHost、icsDWPHost 和 icsFirstDay 的值。
  
  编辑这些值使其符合您的特定要求。
有关这些属性的定义和说明，请参见 Sun Java System Communications Services Schema Reference 中的第 3 章 "Messaging Server and Calendar Server Attributes"。

在自定义的服务等级模板中，必须至少使用一个属性；但不必在自定义模板中使用全部四个邮件属性。可以从服务包中删除一个或多个属性。

使用 LDAP 目录工具 ldapmodify 将服务包安装到目录中。

例如，可以运行以下命令：

ldapmodify -D <directory manager> -w <password> -f <cos.finished.template.ldif>

其中

<directory manager> 是 Directory Server 管理员的用户名。

<password> 是 Directory Server 管理员的密码。

<cos.finished.template.ldif> 是编辑过的 ldif 文件的名称，该文件要作为服务包安装在目录中。

为 Schema 2 兼容性模式添加 ACI

如果要在 Schema 2 兼容性模式下使用 LDAP 目录，则必须手动向该目录中添加 ACI，以便 Delegated Administrator 能够在您的目录中进行置备。请执行以下步骤：

为 Schema 2 兼容性模式添加 ACI

步骤

将以下两个 ACI 添加到 OSI 根目录。可以在位于 /opt/SUNWcomm/config 目录中的 usergroup.ldif 文件中找到以下两个 ACI。

请确保用您的用户组后缀来替换 ugldapbasedn。将编辑后的 usergroup.ldif 文件添加到 LDAP 目录中。

#
# acis to limit Org Admin Role
#
########################################
# dn: <local.ugldapbasedn>
########################################
dn: <ugldapbasedn>
changetype: modify
add: aci
aci: (target="ldap:///($dn),<ugldapbasedn>")(targetattr="*")
(version 3.0; acl "Organization Admin Role access deny to org node";
deny (write,add,delete) roledn = "ldap:///cn=Organization Admin 
Role,($dn),<ugldapbasedn>";)

dn: <ugldapbasedn>
changetype: modify
add: aci
aci: (target="ldap:///($dn),<ugldapbasedn>")(targetattr="*")
(version 3.0; acl "Organization Admin Role access allow read 
to org node";
allow (read,search) roledn = "ldap:///cn=Organization Admin 
Role,($dn),<ugldapbasedn>";)

将以下两个 ACI 添加到 DC 树根后缀。可以在位于 /opt/SUNWcomm/config 目录中的 dctree.ldif 文件中找到以下两个 ACI。

请确保用您的 DC 树根后缀来替换 dctreebasedn，用您的用户组后缀来替换 ugldapbasedn。将编辑后的 dctree.ldif 文件添加到 LDAP 目录中。

#
# acis to limit Org Admin Role
#
########################################
# dn: <dctreebasedn>
########################################
dn: <dctreebasedn>
changetype: modify
add: aci
aci: (target="ldap:///($dn),<dctreebasedn>")(targetattr="*")
(version 3.0; acl "Organization Admin Role access deny to dc node"; 
deny (write,add,delete) roledn = "ldap:///cn=Organization Admin 
Role,($dn),<ugldapbasedn>";)

dn: <dctreebasedn>
changetype: modify
add: aci
aci: (target="ldap:///($dn),<dctreebasedn>")(targetattr="*")
(version 3.0; acl "Organization Admin Role access allow read to dc 
node"; allow (read,search) roledn = "ldap:///cn=Organization Admin 
Role,($dn),<ugldapbasedn>";)

将以下附加 ACI 添加到 DC 树根后缀。（这些 ACI 不在 dctree.ldif 文件中。）

dn:<dctreebasedn> 
changetype:modify
add:aci
aci: (target="ldap:///<dctreebasedn>")(targetattr="*")
(version 3.0; acl "S1IS Proxy user rights"; allow (proxy)
userdn = "ldap:///cn=puser,ou=DSAME Users,<ugldapbasedn>";)

dn:<dctreebasedn>
changetype:modify
add:aci
aci: (target="ldap:///<dctreebasedn>")(targetattr="*")
(version 3.0; acl "S1IS special dsame user rights for all under the 
root suffix"; allow (all) userdn ="ldap:///cn=dsameuser,ou=DSAME 
Users,<ugldapbasedn>";)

dn:<dctreebasedn>
changetype:modify
add:aci
aci: (target="ldap:///<dctreebasedn>")(targetattr="*")
(version 3.0; acl "S1IS Top-level admin rights"; 
allow (all) roledn = "ldap:///cn=Top-level Admin 
Role,<ugldapbasedn>";)

将 AMConfig.properties 文件中的 com.iplanet.am.domaincomponent 属性设置为您的 DC 树根后缀。

例如，修改 <AM_base_directory>/lib/AMConfig.properties 文件中的以下行：

from

com.iplanet.am.domaincomponent=o=isp

改为

com.iplanet.am.domaincomponent=o=internet

启用 Access Manager（以前称为 Identity Server）以使用兼容性模式。

在 Access Manager 控制台中，选中（启用）“管理控制台服务”页中的启用域组件树复选框。

将 inetdomain 对象类添加到所有 DC 树节点（例如 dc=com,o=internet），如以下示例所示：

/var/mps/serverroot/shared/bin 298% ./ldapmodify 
-D "cn=Directory Manager" -w password
dn: dc=com,o=internet
changetype: modify
add: objectclass
objectclass: inetdomain

重新启动 Web 容器。

第 3 章 配置 Delegated Administrator

如果要从早期版本的 Delegated Administrator 进行升级

保留现有配置

Delegated Administrator 属性文件

保留现有配置的步骤

步骤

升级自定义服务包

服务等级模板样例

自定义服务包

升级自定义服务包的步骤

步骤

选择要配置的组件

配置选项摘要

步骤

运行配置程序

启动配置程序

开始进行配置

开始进行配置的步骤

步骤

配置 Delegated Administrator 实用程序

配置 Delegated Administrator 实用程序的步骤

步骤

配置 Delegated Administrator 控制台

Web Server 配置

配置 Web Server 的步骤

步骤

Application Server 7.x 配置

配置 Application Server 7.x 的步骤

步骤

Application Server 8.x 配置

配置 Application Server 8.x 的步骤

步骤

配置 Delegated Administrator 服务器

配置 Delegated Administrator 服务器的步骤

步骤

完成配置

完成配置的步骤

步骤

重新启动 Web 容器

由 config-commda 程序创建的配置文件和日志文件

配置文件

日志文件

执行无提示安装

运行 Delegated Administrator 控制台和实用程序

启动控制台

启动 Delegated Administrator 控制台的步骤

步骤

运行命令行实用程序

运行命令行实用程序的步骤

步骤

示例 3–1 使用 commadmin 搜索用户

commadmin 返回码

配置后任务

向默认域添加邮件服务和日历服务

创建服务包

预定义的服务等级模板

创建您自己的服务包

创建您自己的服务包的步骤

步骤

为 Schema 2 兼容性模式添加 ACI

为 Schema 2 兼容性模式添加 ACI

步骤

第 3 章配置 Delegated Administrator

由 `config-commda` 程序创建的配置文件和日志文件

示例 3–1 使用 `commadmin` 搜索用户

`commadmin` 返回码