Sun Java Communications Suite 5 发行说明

Calendar Server 安装说明

本部分包含在安装 Calendar Server 6.3 之前应该了解的信息，包括：

注意 –

Calendar Server 不支持挂载了网络文件系统 (Network File System, NFS) 的分区。请勿在挂载了 NFS 的分区上安装或创建 Calendar Server 的任何部分，包括可执行文件、数据库文件、配置文件、数据文件、临时文件和日志文件。

Calendar Server Linux 平台支持

如果 Java Enterprise System 是在 Linux 平台上运行，则用户感受到的主要区别在于产品安装目录的路径名不同。Linux 平台的安装目录不同于 Solaris 平台的安装目录。

下表显示了 Solaris 和 Linux 的默认安装目录路径：

Solaris 默认目录	Linux 默认目录
`/opt/SUNWics5/cal/` (`cal-svr-base`)	`/opt/sun/calendar` (`cal-svr-base`)
`/etc/opt/SUNWics5/config`	`/etc/opt/sun/calendar/config`
`/var/opt/SUNWics5`	`/var/opt/sun/calendar`

提示 –

在本文档中，Calendar Server 的默认安装目录是 cal-svr-base。

操作系统修补程序

安装 Calendar Server 之前，您必须应用所需的操作系统修补程序。有关所需修补程序的列表，请参见《Sun Java Enterprise System 5 Release Notes for UNIX》。

所需的权限

要在 Solaris 系统上运行 Sun Java Enterprise System 安装程序或 Calendar Server 6.3 配置程序，必须以超级用户身份登录或成为超级用户 (root)。

Linux 软件包名称

可以使用 Sun Java Enterprise System 安装程序安装 Calendar Server 6.3 。Java Enterprise System 安装程序将安装 Sun 组件产品软件包，包括 Calendar Server 6.3 以及各种产品使用的共享组件。

下表列出了与 Calendar Server 相关的各种组件相对应的 Linux 软件包名称。

组件	软件包名称
Calendar Server	`sun_calendar-core` `sun-calendar-api`
本地化软件包：
西班牙语	`sun-calendar-core-es`
韩文	`sun-calendar-core-ko`
法语	`sun-calendar-core-fr`
简体中文	`sun-calendar-core-zh_CN`
德语	`sun-calendar-core-de`
日语	`sun-calendar-core-ja`
繁体中文	`sun-calendar-core-zh_TW`

从 Calendar Server 6 的早期版本进行升级

无法使用 Sun Java System Communications Suite 安装程序升级到 Calendar Server version 6.3。必须使用 patchadd 进程。

有关升级到 Calendar Server 6.3 的详细信息，请参见《Sun Java Communications Suite 5 Upgrade Guide》。

升级日历数据库

在升级到 Calendar Server 6.3 之后，还必须使用本节提到的各种数据库工具升级您的数据库。可以在《Sun Java System Calendar Server 6.3 Administration Guide》中找到有关迁移工具的详细信息。

本节包含以下主题：

从 Calendar Server 的早期版本进行升级

如果以前的 Calendar Server 软件版本低于版本 5.1.1，请先请求技术支持帮助您将数据库迁移为与 Calendar Server 5.1.1 兼容的数据库。您无法直接迁移到任何 Calendar Server 6 发行版。在技术支持建议的过程中，您将需要安装 Calendar Server 5.1.1。在您的数据库文件与 Calendar Server 5.1.1 兼容后，安装 Calendar Server 6.3 并按列出的顺序运行如下数据库工具。

cs5migrate

运行此实用程序，将数据库从版本 5.1.1 升级到版本 6.2 级别。这是运行 csmigrate 实用程序将数据库升级到版本 6.3 级别之前一个必需的中间步骤。在安装 Calendar Server 6.3 之后，可以在 sbin 目录中找到 cs5migrate 实用程序。

您必须指定 -r 选项。然后，cs5migrate 实用程序为所有周期性事件和任务创建主记录和异常记录。以后，这些记录将由 Calendar Server 自动生成。

此实用程序对数据库执行以下更改：

将您的 Calendar Server 5.1.1 LDAP 数据库迁移成 Calendar Server 6.2 兼容的数据库。
将您的 Berkeley Data Base 迁移到版本 4.2。
将迁移状态写入 csmigrate.log 日志文件中。
将错误写入 csmigrateerror.log 日志文件中。

csmig

运行此实用程序，以使 LDAP CLD 插件正确工作。

csvdmig

运行此实用程序将非域日历数据库转换为与多域环境兼容的单域数据库。

csmigrate

由于您的 Calendar Server 数据库处于版本 6.2 模式下，请运行 csmigrate 实用程序将 Calendar Server 6.2 数据库迁移成与 Calendar Server 版本 6.3 兼容的数据库。

可以在新安装的 Calendar Server 6.3 软件的 sbin 目录中找到 csmigrate 实用程序和其他管理工具。有关 csmigrate 的详细信息，请参见《Sun Java System Calendar Server 6.3 Administration Guide》。

注意 –

如果从较旧版本的 Calendar Server 升级，且配置为使用有限虚拟域模式或在同一台计算机上存在多个 Calendar Server 实例，请与 Sun Microsystems, Inc. 销售代表联系，以对您的迁移要求进行评估并确保您拥有满足这些要求的特定迁移实用程序。

此外请牢记在迁移数据库之前首先执行完全备份。

将您的 Calendar Server 版本 6.0、6.1 或 6.2 数据库升级为与 Calendar Server 版本 6.3 兼容的数据库

运行 csmigrate 将日历数据库升级到版本 6.3 级别。

Calendar Server 安装后配置

安装或升级到 Calendar Server 6.3 之后，在使用 Calendar Server 之前，必须按照以下说明对其进行配置：

运行目录服务器设置脚本 (comm_dssetup.pl) 以将 Sun Java System Directory Server 配置为 Calendar Server 模式。有关说明，请参阅《Sun Java Communications Suite 5 Installation Guide》中的第 8 章 “Directory Preparation Tool (comm_dssetup.pl)”。
运行 Calendar Server 配置程序 (csconfigurator.sh)，将您的站点配置为满足特定要求。有关说明，请参阅《Sun Java System Calendar Server 6.3 Administration Guide》。

Calendar Server 数据和程序文件的位置

下表显示了针对 Solaris 和 Linux 平台本文档所引用的各种文件和程序的位置：

文件名	Solaris 位置	Linux 位置
管理员实用程序：`start-cal`、`stop-cal`、`csattribute`、`csbackup`、`cscal`、`cscomponents`、`csdb`、`csdomain`、`csexport`、`csimport`、`csmonitor`、`csplugin`、`cspurge`、`csrename`、`csresource`、`csrestore`、`csschedule`、`csstats`、`cstool` 和 `csuser`	`/opt/SUNWics5/cal/sbin`	`/opt/sun/calendar/sbin`
迁移实用程序：`csmig` 和 `csvdmig`	`/opt/SUNWics5/cal/sbin`	`/opt/sun/calendar/sbin`
配置文件：`ics.conf`、`version.conf`、`counter.conf` 和 `sslpassword.conf`	安装后，这些文件位于以下位置：`/opt/SUNWics5/cal/config-template` 在配置过程中，上述目录中的各种文件将被移至由您选择的配置选项所指定的位置。默认位置是：`/etc/opt/SunWics5/config`	安装后，这些文件位于以下位置：`/opt/sun/calendar/config-template` 在配置过程中，上述目录中的各种文件将被移至由您选择的配置选项所指定的位置。
邮件格式 (*.`fmt)` 文件	安装后，这些文件位于以下位置：`/opt/SUNWics5/cal/config-template` 配置后，这些文件位于以下位置：`/etc/opt/SUNWics5/ config/language` 其中 language 为 en、de、es、fr、ja、ko、zh-TW 或 zh-CN。	安装后，这些文件位于 `/opt/sun/calendar/config-template` 配置后，这些文件位于以下位置：`/etc/opt/sun/calendar/config/language` 其中 language 为 en、de、es、fr、ja、ko、zh-TW 或 zh-CN。
库 (.so) 文件 SSL 实用程序：`certutil` 和 `modutil`	`/opt/SUNWics5/cal/lib`	`/opt/sun/calendar/lib`
会话数据库	`/opt/SUNWics5/cal/data/ http`	`/opt/sun/calendar/data/http`
计数器统计信息文件：`counter` 和 `counter.dbstat`	`/opt/SUNWics5/cal/lib/counter`	`/opt/sun/calendar/lib/counter`
`timezones.ics` 文件	`/opt/SUNWics5/cal/config`	`/opt/sun/calendar/config`

调节 Calendar Server 的目录服务器性能

要改进 LDAP 目录服务器的性能（特别是，在使用 LDAP 目录的日历搜索功能时），请考虑以下事项：

为 LDAP 目录服务器属性创建索引

要提高 Calendar Server 访问 LDAP 目录服务器时的性能，请在 LDAP 配置文件中为各种属性添加索引。

配置程序 comm_dssetup.pl 将为您选择性地创建索引。

提示 –

要查看创建索引可以给您带来的性能差别，请执行以下测试：

创建索引之前，运行以下 LDAP 命令所花费的时间：
ldapsearch -b "base" "(&(icscalendarowned=* user*)(objectclass=icsCalendarUser))"
其中 base 是 Calendar Server 用户和资源数据所在的目录服务器的 LDAP 基标识名，user 是最终用户可以在日历搜索对话框中输入的值。
为 icsCalendarOwned 创建索引。
再次运行以下 LDAP 命令，并进行计时：
ldapsearch -b "base" "(&(icscalendarowned=*user*)(objectclass=icsCalendarUser))"
其中 base 是 Calendar Server 用户和资源数据所在的目录服务器的 LDAP 基标识名，user 是最终用户可以在日历搜索对话框中输入的值。
比较两者的时间。应具有较大的时间差值。

检查和设置大小限制参数和搜索限制参数

要确定是否已将搜索限制参数 (nsslapd-lookthroughlimit) 和大小限制参数 (nsslapd-sizelimit) 设置为适当的值，请尝试使用以下命令：

ldapsearch -b "base" "(&(icscalendarowned=*
user ID*)
(objectclass=icsCalendarUser))"

其中 base 是 Calendar Server 用户和资源数据所在的目录服务器的 LDAP 基标识名，user ID 是最终用户可以在 Communications Express 的日历搜索对话框中输入的值。

如果 LDAP 服务器返回了错误，则可能是 nsslapd-sizelimit 或 nsslapd-lookthroughlimit 参数的值不够大。请按以下准则设置这些参数：

请确保 slapd.conf 或等效文件中 nsslapd-sizelimit 参数的值足够大，可以返回所需的全部结果；否则，会发生截断，且不显示任何结果。
请确保 slapd.ldbm.conf 或等效文件中 nsslapd-lookthroughlimit 参数的值足够大，可以搜索 LDAP 目录中所有的用户和资源。如有可能，可将 nsslapd-lookthroughlimit 设置为 -1，这样则不会使用任何限制。

在 Communications Express 中使用 Schema 1

在 Communications Express 中使用 Schema 1 存在两个问题：

如果您运行的是使用 Sun LDAP Schema 1 的 Communications Express，则在运行 Communications Express 配置程序之前，必须使用 ldapmodify 将 DC 根节点添加到 LDAP。该条目应类似于以下内容：
```
dn: o=internet
 objectClass: organization
 o: internet
 description: Root level node in the Domain Component (DC) tree
```
日历实用程序 csuser（用于在 Schema 1 中置备用户）是为 Calendar Express 设计的，用户无法使用该实用程序获得 Communications Express 所需的通讯录服务。

Calendar Server 置备工具

可以使用以下两种工具来置备 Calendar Server 的用户、组和域：Delegated Administrator 实用程序和 Calendar Server 实用程序。Delegated Administrator 实用程序有两种用户界面：控制台（图形用户界面）和实用程序（命令行界面）。有关 Delegated Administrator 的信息，请参见《Sun Java System Communications Services 6 2005Q4 Delegated Administrator 指南》。有关控制台使用的说明，请参见 Delegated Administrator 控制台联机帮助。

有关 Calendar Server 实用程序的信息，请参见《Sun Java System Calendar Server 6.3 Administration Guide》。

注意 –

请勿尝试通过 Access Manager 控制台来置备用户。虽然可以创建用户并为其指定日历服务，但是请勿使用此方法，因为其结果是不可预测的，并会对部署产生负面影响。