test

Sun Java System Communications Express 6 2005Q4 管理指南

第 2 章 安装和配置 Communications Express

本章介绍了如何安装和配置 Communications Express。

本章包含以下主题：

注

注 –

通过 Java Enterprise System 安装程序安装 Communications Express

要安装 Communications Express，请执行以下步骤：

注 –

卸载以前安装的任何 Communications Express。

如果已使用早期版本的 Java Enterprise System 安装程序安装了 Communications Express，则需要使用 Java Enterprise System 卸载程序将其卸载。在 Solaris 上，可以从以下位置获取 Sun Java™ Enterprise System 卸载程序：/var/sadm/prod/SUNWentsys4/uninstall

Procedure安装 Communications Express

步骤

  1. 从 Sun Java™ Enterprise System 安装向导所显示的组件列表中选择 Sun Java™ System Communications Express。

    注 –

    选择了 Sun Java System Communications Express 之后，会自动选择 Communications Express 所依赖的产品。但是，如果已经在系统中安装了其中任一产品，则会禁用该选项。

  2. 将显示“安装目录”面板。浏览并指定每个组件产品的目标安装目录的名称。

    单击“下一步”。

  3. 在出现几个面板后，将显示“配置类型”面板。

    1. 确定所需的配置类型。可用选项为：

      • 立即配置。可以配置允许在安装时进行配置的组件产品。

      • 以后再配置。安装程序在指定的目录路径中安装软件包，然后继续执行操作而不对其进行配置。有关详细信息，请参阅 Sun Java Enterprise System 安装指南第 2 章中的“选择配置类型”部分。

      注 –

      不能使用 Sun Java™ Enterprise System 安装向导来配置 Communications Express。要配置 Communications Express，需要运行 Communications Express 配置器程序。

    2. 选择一种配置类型，然后单击“下一步”。

  4. 将出现“自定义配置”面板。

    单击“下一步”配置其他组件产品（如果有）。

  5. 完成安装过程。

配置 Communications Express 的先决条件

在运行 Communications Express 配置器程序之前，请确保执行以下步骤：

Procedure先决条件

步骤

  1. 选择模式。有关可用模式选项的信息，请参阅模式选项部分。

  2. 确保 Solaris 系统上的 /etc/hosts 文件包含以下条目：

    ip-of system FQHN hostname

    例如，

    129.158.230.64 budgie.siroe.varrius.com budgie

  3. 确保在配置 Communications Express 之前，已启动并运行以下组件。确保按以下顺序完成对 Communications Express 产品的配置：

    1. Directory Server

      1. Directory Server 管理控制台

      2. Application Server（如果已选择）或 Web Server（如果已选择）

        注 –

        在执行此步骤之后，请运行目录准备脚本 (comm_dssetup.pl) 以更新用户/组 Directory Server 中的模式详细信息。

        如果已成功配置了 Messaging Server 和 Calendar Server，请跳过此步骤。

        要运行目录准备脚本 (comm_dssetup.pl)，请键入：

        cd /root -of -the -directory -preparatory-script/SUNWcomds/sbin

        perl comm_dssetup.pl

      3. Access Manager（如果选择了 Sun Java System LDAP Schema, v.2）。

      4. Messaging Server

      5. Calendar Server

      6. Delegated Administrator（如果选择了 Sun Java System LDAP Schema, v.2）。

        有关产品配置过程的详细信息，请参阅 Sun Java Enterprise System 安装指南中的第 10 章。

    2. 验证用户是否能够正确登录到以下服务器。

      • Messaging Server

        • Calendar Server

        • 如果选择了 Sun Java System LDAP Schema, v.2，则还包括 Access Manager（以前称为 Identity Server）

模式选项

在安装和配置之前，需要确定要采用的模式模型。在部署 Communications Express 时，提供两个模式和 Web 容器选项。

对于每种模式和 Web 容器组合，配置器面板的显示将随所选模式和 Web 容器的不同而不同。附录 B，配置面板序列 列出了针对每种模式和 Web 容器组合显示的面板。

调用配置工具

本部分介绍了如何调用配置工具

Procedure调用配置工具

步骤

  1. 以管理员身份（对于 UNIX 或 Linux，以超级用户身份）进行登录。

  2. 在调用配置向导之前，设置显示设置。

  3. 转到 uwc-basedir/SUNWuwc/sbin 目录。

  4. 然后键入

    ./config-uwc，以便在 GUI 模式下调用配置工具。

    ./config-uwc -nodisplay，以便在控制台模式下调用配置工具。

    注 –

    本版本不支持无提示安装模式。

  5. 将出现配置向导。

配置 Communications Express

以下步骤将指导您配置 Communications Express。

注 –

如果您在非英语语言环境下调用配置向导，请调整配置面板的大小以正确查看其内容。

Procedure配置 Communications Express

步骤

  1. “欢迎使用”面板。

    配置程序的第一个面板为版权页。选择“下一步”继续操作，或选择“取消”退出。

  2. 将出现“选择用于存储配置和数据文件的目录”面板。

    选择用于部署 Communications Express 的配置和数据文件的目录。例如 /var/opt/SUNWuwc。

    在本指南中，此目录为 uwc-deployed-path。

    单击“下一步”。

  3. 将出现“选择要配置的组件”面板。

    选择要配置的组件，并取消选择不希望配置的组件。

    • 邮件组件

    • 日历组件

    注 –

    至少要从“选择要配置的组件”面板中选择一个组件。

    虽然组件大小显示为零，但是已安装了邮件和日历组件。

    单击“下一步”。

  4. 将出现“网络连接”面板。

    配置程序尝试使用此面板中显示的主机名和 DNS 域名来建立网络连接。

    主机名。显示要配置 Communication Express 的主机的名称。

    DNS 域名。显示 DNS Server 维护的 DNS 域名。

    单击“下一步”。

  5. 将出现“选择 Web 容器”面板。

    从显示的选项中选择要使用的 Web 容器。可用选项为：

    • Web Server。有关 Web Server 面板的详细信息，请参见配置 Communications Express。

      Web Server

      如果已选择 Web Server 作为 Web 容器，则将出现以下面板：

      • “Web Server 配置详细信息”面板。

        指定本地 Web Server 实例详细信息。安装程序使用此处指定的 Web Server 详细信息在 Web Server 上部署 Communications Express。

        服务器根目录。浏览并选择 Web Server 的安装根目录。默认位置为 /opt/SUNWwbsvr/

        服务器实例标识符。输入要部署 Communications Express 的 Web Server 实例。例如 budgie.siroe.varrius.com。

        虚拟服务器标识符。输入要部署 Communications Express 的虚拟服务器标识符。例如 https-budgie.siroe.varrius.com

        HTTP 端口。输入 Web Server 侦听的 HTTP 端口号。这是访问 Communications Express 所使用的 HTTP 端口。

        注 –

        如果要配置安全的 HTTP 端口号，请在配置 Communications Express 后指定它。要配置安全的端口号，请参阅本指南第 3 章的配置安全套接字层 (Secure Socket Layer, SSL)部分中提供的后续配置步骤。

        单击“下一步”。

        您将看到一个很小的弹出窗口，指示正在验证 Web Server 实例。这可能需要几分钟的时间。

        如果配置工具无法连接到 Web Server 实例，则会显示一条错误消息。单击“接受”继续执行安装过程，或者单击“选择新的”指定其他 Web Server 配置详细信息。

      • “Web 容器用户和组”面板。

        指定 Web 容器用于运行服务的标识。

        Web 容器用户 ID。将显示用户数据库中的 Web 容器用户标识符。

        Web 容器组 ID。将显示组数据库中的 Web 容器组标识符。

        单击“下一步”。

        配置器程序将安装一些包含敏感数据（如密码）的文件和目录。这些文件和目录的拥有权将授予此面板中提到的 Web 容器用户和组。只有 Web 容器用户才被授予对包含敏感数据的文件和目录的读取权限和写入权限。

        注 –

        确保您在此面板中输入的 Web 容器用户 ID 和组 ID 值正确。如果输入错误的值，则可能会导致 Communications Express 启动失败。

        将 Web Server 配置为 Web 容器后，请转到配置 Communications Express。

    • Application Server。有关 Application Server 面板的详细信息，请参见配置 Communications Express。

      Application Server

      如果已选择 Application Server 作为 Web 容器，则将出现以下面板：

      • “Application Server 配置详细信息”面板。

        在“Application Server 配置详细信息”面板中，指定以下详细信息：

        安装目录。浏览并选择安装 Application Server 的本地安装目录。

        域目录。浏览并选择 Application Server 的域目录。

        文档根目录。浏览并选择 Application Server 的文档根目录。

        服务器目标名称。输入要配置 Communications Express 的 Application Server 目标的名称。Communications Express 配置器仅支持在 Application Server 8.1 上部署 Domain Administration Server (DAS)。

        虚拟服务器标识符。输入要配置 Communications Express 的虚拟服务器标识符。

        服务器实例 HTTP 端口。输入提供 HTTP 服务的 Application Server 端口号。这是访问 Communications Express 应用程序所使用的 HTTP 端口。

        单击“下一步”。

        注 –

        在此处指定 HTTP 端口号。如果要配置安全的 HTTP 端口号，请在配置 Communications Express 后指定它。要配置安全的端口号，请参阅本指南的配置安全套接字层 (Secure Socket Layer, SSL)部分中提供的后续配置步骤。

        您将看到一个很小的弹出窗口，指示正在验证 Application Server 实例。这可能需要几分钟的时间。

        如果配置工具无法连接到 Application Server 实例，则会显示一条错误消息。单击“接受”继续执行安装过程，或者单击“选择新的”再次指定 Application Server 配置详细信息。

      • “Application Server 管理实例详细信息”面板。

        指定 Application Server 的管理实例详细信息。配置器使用管理实例详细信息在 Application Server 上部署 Communications Express。

        Administration Server 端口。输入 Administration Server 端口号。

        注 –

        要在 Application Server 上配置 Communications Express，Application Server 的管理端口必须可用。

        管理员用户 ID。输入管理员的用户标识符。

        管理员密码。输入管理员的用户密码。

        安全 Administration Server 实例。选中此复选框可指定在安全模式下运行 Application Server 的管理实例。

        取消选中此复选框可指定在正常模式下运行 Application Server 的管理实例。

        单击“下一步”。

        根据所选内容，将出现一个弹出式窗口，确认 Application Server 管理实例当前的运行模式。单击“确定”退出弹出窗口。

        注 –

        在 Application Server 上部署 Communications Express 时，将修改 server.xml 和 server.policy 两个文件。

        在修改 server.xml 和 server.policy 文件之前，将由配置器程序维护这两个文件的备份。备份文件存储在以下目录中

        DOMAIN-DIRECTORY/SERVER-INSTANCE-NAME/config/ .CommsExpress_YYYYMMDDhhmmss

        其中，

        DOMAIN-DIRECTORY 为 Application Server 的域目录。

        SERVER-INSTANCE-NAME 为配置 Communications Express 的 Application Server 实例的名称。

        YYYYMMDDhhmmss 为备份目录的时间戳。

      • “此 Web 应用程序的模块名称”面板。

        输入在 Application Server 上部署 Communications Express 时使用的模块名称。

        单击“下一步”。

        将 Application Server 配置为 Web 容器后，请转到配置 Communications Express。

    单击“下一步”。

  6. 将出现“URI 路径设置”面板。

    输入应在其中部署 Communications Express 的 URI。例如 /uwc。

    注意 – 注意 –

    如果使用现有 URI 来部署 Communications Express，配置工具先删除先前的任何应用程序数据，然后再在该 URI 上部署 Communications Express。例如，如果您在部署了 Web 应用程序的 URI（如 /uwc）上部署 Communications Express，则 Communications Express 配置器先从 /uwc 中删除现有的 Web 应用程序，然后再部署 Communications Express。这会导致先前的应用程序数据丢失，且无法再访问该应用程序。

    单击“下一步”。

  7. 将出现“是否要启用托管域支持？” 面板。

    选择该选项可以启用 Communications Express 托管域支持。仅在 Calendar Server 中启用了托管域支持时才可选择此选项。

    单击“下一步”。

  8. 将出现“用户/组 Directory (LDAP) Server 详细信息”面板。

    输入以下详细信息：

    LdapURL。以 ldap://UG-LDAP-HOST:UG-LDAP-PORT 格式指定用户/组 LDAP URL。

    绑定 DN。输入用户/组管理员的 LDAP 标识名。

    绑定密码。输入用户/组管理员的绑定密码。

    单击“下一步”。

  9. 将出现“DC 树后缀”面板。

    输入 DC 树后缀的基本标识名。Communications Express 将使用此后缀来搜索域查找。

    单击“下一步”。

  10. 将出现“默认域名”面板。

    输入默认域名。

    每个域都具有某些属性。当用户登录到没有所需属性的域时，将从默认域名中选取属性。

  11. 将出现“启用 Access Manager 进行单点登录”面板。

    要使用 Access Manager 设置单点登录，请选择“为 Sun Java System Communications Express 启用标识支持”。

    仅当已为 Sun Java System Communications Express 启用了标识支持时，才会显示“Access Manager 首选项”面板。

    在此面板中输入 Access Manager 首选项，如登录 URL、Access Manager 管理员 DN 和密码。

    登录 URL。以 protocol://Access Manager hostname:Access Manager port/context -path-of-amserver/UI/Login 格式指定 Access Manager 登录 URL。

    管理员 DN。输入 Access Manager 管理员的完整 LDAP DN（标识名），如 DN=uid=amAdmin, ou=people, Access Manager- root suffix。

    管理员密码。输入 Access Manager 管理员的密码。

    单击“下一步”。

  12. 将出现“Messaging Express 端口”面板。

    仅在“选择要配置的组件”面板中选择了邮件组件时，才会出现此面板。

    输入提供 Messenger Express 服务所在的端口号。

    注 –

    确保将 Communications Express 与 Messenger Express 部署在同一台计算机上。

    单击“下一步”。

  13. 将出现“Calendar Server 主机和端口配置”面板。

    仅在“选择要配置的组件”面板中选择了日历组件时，才会出现此面板。

    Calendar Server 主机名。输入 Calendar Server 的主机名。

    Calendar Server HTTP 端口号。输入 Calendar Server 的 HTTP 端口号。

    单击“下一步”。

  14. 将出现“Calendar Server 管理详细信息”面板。

    仅在“选择要配置的组件”面板中选择了日历组件时，才会出现此面板。

    管理员用户 ID。输入 Calendar Server 的管理员名称。例如 calmaster。

    管理员用户密码。输入 Calendar Server 的管理员密码。

    注 –

    确保此处输入的日历管理员用户 ID 值与 Calendar Server 的 ics.conf 文件中提到的 service.admin.calmaster.userid 值相同。

    单击“下一步”。

  15. 将出现“PAB Directory Server 详细信息”面板。

    个人通讯录 LDAP Server 是用户个人通讯录所在的存储。在此面板中输入以下详细信息：

    LDAP URL。指定 PAB 存储的 LDAP 主机和端口。url 的格式应该为：ldap://PAB-ldap-hostname:PAB-ldap-portnumber

    绑定 DN。指定用于绑定到 PAB 存储的 LDAP DN。此处指定的绑定 DN 应该具有管理根后缀 o=PiServerDB 下数据的相应权限。

    密码。输入绑定密码。

    单击“下一步”。

  16. 将出现“准备配置”面板。

    配置程序将检查计算机上是否有足够的磁盘空间，然后列出准备配置的组件。

    单击“立即配置”可以配置 Communications Express。

    单击“返回”可以更改任何配置变量。

    单击“取消”可以退出配置程序。

  17. 将显示任务和序列状态的摘要。

    单击“下一步”。

  18. “配置摘要”面板列出配置程序的状态。单击“详细信息”按钮可以查看日志。

  19. 仅当配置成功时，才会出现“后续配置说明”面板。如果未安装所需的共享组件时，此面板可能会显示警告消息。

    要完成配置过程，请按照此处提供的后续配置说明进行操作。

后续配置说明

注 –

确保您熟悉 Communications Express 文件的位置。

请参阅本指南“前言”中默认的路径和文件名部分。

有关配置参数的详细信息，请参阅第 1 章，Communications Express 概述。

在执行后续配置步骤之前，请确保已经执行了以下步骤：

Procedure后续配置说明

步骤

  1. 假定已经安装了 Communications Express 软件包，请确保为使用 Access Manager 单点登录的设置添加了核心服务和 LDAP 服务。有关更多信息，请参阅本指南第 8 章的调节 Directory Server部分。

  2. 配置 Communications Express 之后，请执行以下步骤

    1. 要在 Communications Express 中启用“邮件”组件，请配置单点登录。有关配置 Messenger Express 和 Communications Express 的信息，请参阅第 1 章，Communications Express 概述。

    2. 转到 calendar-server-install-directory/SUNWics5/cal/bin/config（例如 /opt/SUNWics5/cal/bin/config）。

      编辑 ics.conf 文件并设置以下内容：

      • service.http.allowadminproxy = "yes"

        • service.http.admins = proxy-admin-for-calendar-http-service

          • service.admin.calmaster.userid = the-value-specified-for-calendar.wcap.adminid-in-uwcconfig.properties

          • service.admin.calmaster.cred = the-value-specified-for-calendar.wcap.passwd-in-uwcconfig.properties

          • service.wcap.anonymous.allowpubliccalendarwrite = "yes"

          • service.http.allowanonymouslogin = "yes"

          • service.calendarsearch.ldap = "no"

            如果已编辑了 ics.conf 文件，请重新启动 Calendar Server 以使更改生效。

  3. 重新启动 Web Server 或 Application Server，具体取决于将其中哪个选为 Web 容器。

  4. Communications Express 现已就绪，您可以从以下路径访问该应用程序：

    http://Web-Container-host: Web-Container-port/URI path

    其中

    Web-Container-host 为配置了 Communications Express 应用程序的 Web 容器实例的主机名。

    Web-Container-port 为配置了 Communications Express 的 Web 容器实例的端口号。

    URI path 为在“URI 路径设置”面板中指定的路径。

取消配置 Communications Express

如果已在 Web Server 或 Application Server 上配置了 Communications Express，并且需要取消配置 Communications Express，请执行以下步骤：

Communications Express 文件目录布局

安装和配置 Communications Express 之后，其目录和文件在组织中的排列方式如表 2-1 所示。此表并没有列出所有的目录和文件；它仅列出了与典型服务器管理任务最密切相关的那些目录和文件。

表 2–1 Communications Express 目录和文件

目录和图例 

默认位置和描述 

Communications Express 基本目录 

uwc-basedir

默认位置： 

Solaris：/opt/SUNWuwc/

Linux：/opt/sun/uwc/

此目录为 Communications Express 的安装位置。 

注：每台计算机只允许有一个 Communications Express 基本目录。 

已部署的目录 

uwc-deployed-dir

默认位置： 

Solaris：/var/opt/SUNWuwc/

Linux：/var/opt/sun/uwc/

Communications Express 是在此目录中部署的。在装入 Communications Express 时，Web 容器将从此位置获取文件。 

Web 应用程序根目录 

web-inf

uwc-deployed-dir/WEB-INF

Communications Express Web 应用程序的 WEB-INF 目录。 

配置 

config

uwc-deployed-dir/WEB-INF/config/

包含所有 Communication Express 配置文件。 

域 

domain

uwc-deployed-dir/WEB-INF/domain/

包含基于每个域的本地化文件和自定义文件。 

外观 

skin

uwc-deployed-dir/WEB-INF/skin/

包含基于每个域的主题。 

日志 

logs

uwc-deployed-dir/logs/

包含 Communications Express 日志文件。 

系统管理员程序 

sbin

uwc-basedir/sbin/

包含 Communications Express 系统管理员可执行程序和脚本。 

帮助 

help

uwc-deployed-dir/help

包含 Communications Express 帮助文件。