Sun Java System Communications Express 6.3 管理指南

第 2 章安装和配置 Communications Express

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

本章包含以下主题：

开始之前

在配置 Communications Express 之前，请确保安装了以下相关组件：

确保安装并配置了 Messaging Server 和 Calendar Server。请确保已掌握有关安装设置的详细信息。例如，主机名、端口号、管理员用户名和密码。配置 Communications Express 时需要这些详细信息。
使用 Sun Java^TM Communications Suite 安装向导安装目录准备工具：comm_dssetup.pl。

Communications Express 文件目录布局

安装并配置 Communications Express 之后，相关文件和目录按表 2–1 中所示结构分布。此表并不详尽，仅列出了典型服务器管理任务的所需目录和文件。

表 2–1 Communications Express 目录和文件


目录和图例	默认位置和描述
Communications Express 基目录 `uwc-basedir`	默认位置： Solaris^TM：`/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` 目录。
Web 邮件目录	`uwc-deployed-dir/webmail` 包含 Communications Express 使用的所有 Web 邮件相关文件。
配置 `config`	`uwc-deployed-dir`/`WEB-INF/config/` 包含所有 Communications Express 配置文件。
域 `domain`	`uwc-deployed-dir`/`WEB-INF/domain/` 包含基于每个域的本地化文件和自定义文件。
外观 `skin`	`uwc-deployed-dir`/`WEB-INF/skin/` 包含基于每个域的主题。
日志 `logs`	`uwc-deployed-dir`/l`ogs/` 包含 Communications Express 日志文件。
系统管理员程序 `sbin`	`uwc-basedir`/`sbin/` 包含 Communications Express 系统管理员可执行程序和脚本。
帮助 `help`	`uwc-deployed-dir`/`help` 包含 Communications Express 帮助文件。

使用 Sun Java Communications Suite 安装向导安装 Communications Express

要重新安装 Communications Express，请卸载先前安装的 Communications Express。如果是使用早期版本的 Sun Java Communications Suite 安装程序安装了 Communications Express，则需要使用 Sun Java Communications Suite 卸载程序进行卸载。在 Solaris 上，Sun Java Communications Suite 卸载程序位于以下路径中：/var/sadm/prod/SUNWomm-entsys5。

安装 Communications Express

从 Sun Java Communications Suite 安装向导里显示的组件列表中选择 Sun Java System Communications Express。

注 –
选择了 Sun Java Communications Express 时，会自动选择 Communications Express 所依赖的产品。但是，如果系统中已安装其中任意一种产品，则已安装的相关产品处于禁用状态。

如果在远程主机上安装 Messaging Server、Calendar Server 和 Directory Server，则可以选择不在同一台计算机上安装这些组件。

单击“下一步”。此时将显示“安装目录”屏幕。

浏览并指定每个组件产品的目标安装目录的名称，然后单击“下一步”。

在出现几个屏幕之后，将显示“配置类型”屏幕。

选择所需的配置类型。

可用选项为：
- 立即配置：可以配置允许在安装时进行配置的组件产品。
- 以后配置：允许在指定的目录路径中安装软件包，然后继续执行操作而不对其进行配置。有关更多详细信息，请参阅《Sun Java Communications Suite 5 Installation Guide》。
注 –
不能使用 Sun Java Enterprise System 安装向导配置 Communications Express。需要运行 Communications Express 配置向导来配置 Communications Express。

选择配置类型，然后单击“下一步”。此时将出现“自定义配置”屏幕。

单击“下一步”配置其他组件产品，以完成安装过程。

配置 Communications Express 的先决条件

在运行 Communications Express 配置向导之前，请确保：

选择模式。有关可用模式的信息，请参阅模式选项一节。
确保 Solaris 系统上的 /etc/hosts 文件中有以下条目：

ip-of system Fully-Qualified-Hostname

例如，

129.158.230.64 budgie.siroe.varrius.com budgie
确保在配置 Communications Express 之前，已启动并运行以下组件。请确保按照以下顺序配置 Communications Express 的产品：
- Directory Server
- Application Server 或 Web Server
  
  注 –
  在执行此步骤之后，请运行目录准备脚本 comm_dssetup.pl 以更新用户/组目录服务器中的模式详细信息。
  
  要运行目录准备脚本 (comm_dssetup.pl)，请键入：
  
  cd /root -of -the -directory -preparatory-script/SUNWcomds/sbin。默认情况下，目录准备脚本位于以下路径中：
  - Solaris：/opt/SUNWcomds/sbin
  - Linux：/opt/sun/comms/dssetup/sbin
  perl comm_dssetup.pl
- Access Manager，如果要使用 Communications Express 在其他产品（例如，Portal Server）中执行 SSO（Single Sign On，单点登录）操作。
  
  注 –
  针对远程 AM SDK 部署进行配置时，应以 root 身份运行托管 Communications Express 的 Web Server。
- Messaging Server
- Calendar Server
- Delegated Administrator（如果选择了 Sun Java LDAP Schema v.2）
验证用户是否能够正常登录到以下服务器：
- Messaging Server
- Calendar Server
- uAccess Manager（以前称为 Identity Server，如果要使用 Communications Express 在其他产品中执行 SSO 操作）

模式选项

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

Sun Java LDAP Schema v.1
Sun Java LDAP Schema v.2

对于每个模式和 Web 容器的组合，显示的配置器屏幕随所选模式和 Web 容器的不同而不同。附录 A，配置面板序列列出了采用每种模式和 Web 容器组合的情况下显示的屏幕。

调用配置向导

本节介绍了如何调用配置工具。

调用配置向导

以管理员身份（对于 UNIX 或 Linux，为 root）登录。

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

转到 uwc-basedir/sbin/ 目录。

在命令提示符下，键入以下命令调用配置向导：

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

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

注 –
本章介绍了如何在 GUI 模式下配置 Communications Express。

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

配置 Communications Express

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

注 –

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

配置 Communications Express

按照调用配置向导中的步骤操作，运行配置向导。

此时将出现“欢迎”屏幕。单击“下一步”。此时将出现“选择用于存储配置和数据文件的目录”屏幕。

选择用于部署 Communications Express 的配置和数据文件的目录。

例如 /var/opt/SUNWuwc。在本指南中，此目录表示为 uwc-deployed-path。

单击“下一步”。此时将出现“选择要配置的组件”屏幕。

.

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

有下列组件：
- 邮件组件
- 日历组件
注 –
在“选择要配置的组件”屏幕中至少应选择一个组件。

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

单击“下一步”。此时将出现“网络连接”屏幕。配置程序尝试使用此屏幕中显示的主机名和 DNS 域名来建立网络连接。

主机名：显示配置 Communications Express 使用的主机名

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

单击“下一步”。此时将出现“选择 Web 容器”屏幕。

选择要使用的 Web 容器。

可用选项为：
- Web Server
- Application Server
单击“下一步”。

如果已选择 Web Server 作为 Web 容器，将出现以下屏幕。
- 执行以下步骤配置 Web Server。
  
  此时先出现“Web Server 配置详细资料”屏幕。
  1. 指定本地 Web Server 实例详细资料。
    - 服务器根目录：浏览并选择 Web Server 的安装根目录。默认位置为 /opt/SUNWwbsvr7/。
    - 服务器实例标识符：输入部署 Communications Express 要使用的 Web Server 实例。例如 budgie.siroe.varrius.com。
    - 虚拟服务器标识符：输入部署 Communications Express 要使用的虚拟服务器标识符。例如 https-budgie.siroe.varrius.com。
    - HTTP 端口：输入 Web Server 侦听的 HTTP 端口号。访问 Communications Express 时，Web Server 将侦听此 HTTP 端口号。
      
      注 –
      如果要配置安全的 HTTP 端口号，请在配置 Communications Express 后指定它。要配置安全的端口号，请参见配置安全套接口层。
    单击“下一步”。配置向导将检查 Web Server 连接实例是否处于活动状态。如果未启动并运行 Web Server 实例，将出现错误消息。有关配置 Communications Express 之前所需的先决条件的更多信息，请参阅配置 Communications Express 的先决条件。此时将出现“Web Server：管理实例详细资料”屏幕。
  2. 指定管理实例详细资料。
    
    选项如下
    - Administration Server 端口：输入 Web Server 管理服务器端口号。
    - 管理员用户 ID：输入 Web Server 管理员用户 ID。
    - 管理员密码：输入 Web Server 管理员密码。
    此时将出现一个小的弹出窗口，指示正在验证 Web Server 实例。这可能需要几分钟的时间。
    
    如果配置向导无法连接到 Web Server 实例，将显示错误消息。单击“接受”继续执行安装过程，或者单击“选择新的”指定其他 Web Server 配置详细资料。
    
    单击“下一步”。此时将出现“Web 容器用户和组”屏幕。
  3. 指定 Web 容器用于运行服务的标识。
    - Web 容器用户 ID：显示用户数据库中的 Web 容器用户标识符。
    - Web 容器组 ID：显示组数据库中的 Web 容器组标识符。
    单击“下一步”。配置向导将安装一些包含敏感数据（如密码）的文件和目录。此屏幕中输入的 Web 容器用户和组将持有这些文件和目录的拥有权。只有 Web 容器用户才会被授予对包含敏感数据的文件和目录的读取权限和写入权限。
    
    注 –
    确保在此屏幕中输入的 Web 容器用户 ID 和组 ID 值正确无误。如果输入了错误值，可能无法启动 Communications Express。
    
    单击“下一步”。
- 如果已选择 Application Server 作为 Web 容器，将出现以下屏幕：
  
  执行以下步骤配置 Application Server。此时先出现“Application Server 配置详细资料”屏幕。
  1. 指定配置向导可用于通过 Application Server 配置 Communications Express 的 Application Server 配置详细资料。
    - 安装目录：浏览并选择安装 Application Server 的本地安装目录。
    - 域目录：浏览并选择 Application Server 的域目录。
    - 文档根目录：浏览并选择 Application Server 的文档根目录。
    - 服务器目标名称：输入要为 Communications Express 配置的 Application Server 目标的名称。Communications Express 配置向导仅支持在 Application Server 上部署域管理服务器 (Domain Administration Server, DAS)。
    - 虚拟服务器标识符：输入要为 Communications Express 配置的虚拟服务器标识符。
    - 服务器实例 HTTP 端口：输入提供 HTTP 服务的 Application Server 端口号。这是访问 Communications Express 应用程序所使用的 HTTP 端口。
    注 –
    在此处指定 HTTP 端口号。如果要配置安全的 HTTP 端口号，请在配置 Communications Express 后指定它。要配置安全的端口号，请参阅配置安全套接口层一节中介绍的后续配置步骤。
    
    单击“下一步”。此时将出现一个弹出窗口，指示正在验证 Application Server 实例。这可能需要几分钟的时间。如果配置工具无法连接到 Application Server 实例，则会显示一条错误消息。单击“接受”继续执行安装过程，或者单击“选择新的”再次指定 Application Server 配置详细资料。配置向导成功验证 Application Server 实例后，将显示“Application Server：管理实例详细资料”屏幕。
  2. 指定 Application Server 的管理实例详细资料。
    
    配置向导使用管理实例详细资料在 Application Server 上部署 Communications Express：
    - Administration Server 端口：输入 Administration Server 端口号。
      
      注 –
      指定的 Application Server 管理端口必须可用于在 Application Server 上配置 Communications Express。
    - 管理员用户 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 应用程序的模块名称”屏幕。
  3. 输入在 Application Server 上部署 Communications Express 时使用的模块名称。
现在，配置向导收集了在所选的 Web 容器中配置 Communications Express 时所需的参数。

单击“下一步”。此时将出现“Web 容器用户和组”屏幕。

指定 Web 容器用于运行服务的标识。
- Web 容器用户 ID：显示用户数据库中的 Web 容器用户标识符。
- Web 容器组 ID：显示组数据库中的 Web 容器组标识符。
单击“下一步”。配置向导将安装一些包含敏感数据（如密码）的文件和目录。此屏幕中输入的 Web 容器用户和组将持有这些文件和目录的拥有权。只有 Web 容器用户才会被授予对包含敏感数据的文件和目录的读取权限和写入权限。

注 –
确保在此屏幕中输入的 Web 容器用户 ID 和组 ID 值正确。如果输入了错误值，可能无法启动 Communications Express。

单击“下一步”。此时将出现“URI 路径设置”屏幕。

输入部署 Communications Express 要使用的 URI。

例如 /uwc。

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

单击“下一步”。此时将出现“是否要启用托管域支持？”屏幕。

选择“对 Communications Express 启用托管域支持”选项。

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

单击“下一步”。此时将出现“用户/组目录 (LDAP) 服务器详细资料”屏幕。

输入以下详细信息：

LdapURL：以 ldap://UG-LDAP-HOST:UG-LDAP-PORT 格式指定用户或组 LDAP URL，其中：
- UG-LDAP-HOST 是用户或组的 LDAP 主机名
- UG-LDAP-PORT 是 LDAP 端口号
绑定 DN：输入用户/组管理员的 LDAP 标识名。

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

单击“下一步”。此时将出现“DC 树后缀”屏幕。

输入 DC 树后缀的基本标识名。

Communications Express 使用此后缀来搜索域查找。

单击“下一步”。此时将出现“默认域名”屏幕。

输入默认域名。

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

单击“下一步”。此时将出现“启用 Access Manager 进行单点登录”屏幕。

选择“为 Communications Express 启用身份认证支持 (Enable Identity Support for Communications Express)”（如果要启用 Access Manager 进行单点登录）。

仅当为 Communications Express 启用了身份认证支持时，才会显示“Access Manager 首选项”屏幕。

在此屏幕中输入 Access Manager 首选项，如登录 URL、Access Manager 管理员 DN 和密码。
- 管理员 DN：输入 Access Manager 管理员的完整 LDAP DN（distinguished name，标识名），如 DN=uid=amAdmin, ou=people, Access Manager- root suffix。
- 管理员密码：输入 Access Manager 管理员的密码。
单击“下一步”。此时将出现“Webmail Server 主机和端口配置”屏幕。

指定 Messaging Server 的相关参数。

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

选项如下：
- Webmail Server 主机名：指定安装 Webmail Server 的主机名。
- Webmail Server 端口号：指定 Webmail Server 侦听的端口号。
- 启用以安全模式登录：希望用户以安全模式登录时选择此选项。
- Webmail Server SSL 端口号：如果已将 Webmail Server 配置为在 SSL 模式下运行，请输入 SSL 端口号。
- Webmail Server 管理员用户 ID：指定 Webmail Server 的管理员用户 ID。
- 管理密码：输入 Webmail Server 的管理员密码。
单击“下一步”。此时将出现“Calendar Server 主机和端口配置”屏幕。

指定 Calendar Server 主机和端口。

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

可用选项为：
- Calendar Server 主机名：输入 Calendar Server 的主机名。
- Calendar Server 端口号：输入 Calendar Server 的 HTTP 端口号。
单击“下一步”。此时将出现“Calendar Server 管理员详细资料”屏幕。

输入 Calendar Server 用户 ID 和密码。
- 管理员用户 ID：输入 Calendar Server 的管理员名称。例如 calmaster。
- 管理员用户密码：输入 Calendar Server 的管理员密码。
注 –
确保此处输入的日历管理员用户 ID 值与 Calendar Server 的 ics.conf 文件中存在的 service.admin.calmaster.userid 值相同。

单击“下一步”。此时将出现“PAB Directory Server 详细资料”屏幕。

指定有关 PAB 条目在 LDAP 服务器中的存储位置的详细信息。

个人通讯录 LDAP Server 是用户个人通讯录所在的存储。在此屏幕中输入以下详细信息：
- LDAP URL：指定 PAB 存储的 LDAP 主机和端口。URL 的格式应该为：ldap://PAB-ldap-hostname:PAB-ldap-portnumber
- 绑定 DN：指定用于绑定到 PAB 存储的 LDAP DN。此处指定的绑定 DN 应该具有管理后缀为 o=PiServerDB 的根目录下数据的相应权限。
- 绑定密码：输入绑定密码。
单击“下一步”。此时将出现“准备配置”屏幕。

配置程序将检查计算机上是否有足够的磁盘空间，然后列出准备配置的组件。
- 单击“立即配置”可以配置 Communications Express。
- 单击“返回”可以更改任何配置变量。
- 单击“取消”可以退出配置程序。
如果单击了“立即配置”，会显示任务和序列状态摘要。单击“下一步”。“配置摘要”屏幕上将列出配置程序的状态。单击“详细信息”按钮可以查看日志。

仅当配置成功时，才会出现“后续配置说明”屏幕。如果未安装所需的共享组件，此屏幕上可能会显示警告消息。要完成配置过程，请按照此处提供的后续配置说明进行操作。

后续配置说明

要完成配置过程，请按照后续配置步骤进行操作。

注 –

请确保知道 Communications Express 文件的位置。请参阅默认的路径和文件名一节。

有关配置参数的更多详细信息，请参阅第 3 章，配置详细信息。

安装后配置 Communications Express

安装 Communications Express 之后，请确保针对使用 Access Manager 单点登录的设置，添加了核心服务和 LDAP 服务。有关更多信息，请参阅本指南第 8 章中的调节 LDAP 的相关配置参数一节。

配置了 Communications Express 之后，执行以下步骤：

通过配置单点登录，在 Communications Express 中启用邮件组件。

有关配置 Messenger Express 和 Communications Express 的信息，请参阅第 1 章，Communications Express 概述。

设置以下参数：
- local.webmail.sso.uwccontexturi = context-uri-for-communications-express-installation
- local.webmail.sso.uwcport = uwc-port-for-communications-express-installation
- local.webmail.sso.uwcsslport = uwc—ssl-port-for-communications-express-installation
- local.webmail.sso.uwcenabled =1

转到 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"
- service.http.ui.enabled = "yes"
如果编辑了 ics.conf 文件，请重新启动 Calendar Server 以使更改生效。

键入以下命令重新启动 Messaging Server。

<msg-svr-base>/sbin/ stop-msg

<msg-svr-base> /sbin/start-msg

键入以下命令重新启动 Calendar Server。

<cal-svr-base>/cal/sbin/ stop-cal

<cal-svr-base> /cal/sbin/start-cal

重新启动 Web 容器。

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 Web 应用程序。有关如何取消部署应用程序的信息，请参阅 Web Server 和 Application Server 的相关文档。

第 2 章 安装和配置 Communications Express

开始之前

Communications Express 文件目录布局

使用 Sun Java Communications Suite 安装向导安装 Communications Express

安装 Communications Express

配置 Communications Express 的先决条件

模式选项

调用配置向导

调用配置向导

配置 Communications Express

配置 Communications Express

后续配置说明

安装后配置 Communications Express

取消部署 Communications Express

第 2 章安装和配置 Communications Express