第 2 部分 Calendar Server 6.3 软件的安装后配置

本部分中的章节介绍了安装 Calendar Server 之后，在使用前必须执行的配置和迁移步骤。

本部分包括以下章节：

• 第 2 章，Calendar Server 6.3 软件的初始运行时配置程序 (csconfigurator.sh)

• 第 3 章，Calendar Server 6.3 的数据库迁移实用程序

第 2 章 Calendar Server 6.3 软件的初始运行时配置程序 (csconfigurator.sh)

安装 Calendar Server 之后，必须在运行之前配置 Calendar Server。请注意，必须按照以下顺序运行这两个配置程序：

1. comm_dssetup.pl

   按照《Sun Java System Communications Suite 5 Installation and Configuration Guide》中的说明配置 LDAP 目录服务器。

2. csconfigurator.sh

   配置 Calendar Server，如本章所述。

本章包含以下主题：

• 2.1 收集 Calendar Server 6.3 软件的配置信息

• 2.2 运行 csconfigurator.sh

如果已安装了早期版本的 Calendar Server 或 Messaging Server，则可能需要将 LDAP 目录条目从 Schema 版本 1 迁移到 Schema 版本 2。

阅读 《Sun Java Communications Suite 5 Schema Migration Guide 》之前，请勿运行本章所介绍的配置实用程序。迁移指南将介绍运行配置实用程序的时间选择和选项。

2.1 收集 Calendar Server 6.3 软件的配置信息

Calendar Server 配置程序 csconfigurator.sh 会在以下目录中创建新的 ics.conf 配置文件：

对于 Solaris：/etc/opt/SUNWics5/config

对于 Linux：/etc/opt/sun/calendar/config

配置程序将询问您若干问题，您必须就这些问题输入安装的具体信息。

运行配置程序前，应收集以下配置信息：

• 2.1.1 LDAP 服务器选项

• 2.1.2 目录管理员选项

• 2.1.3 Calendar Server 管理员

• 2.1.4 电子邮件和电子邮件警报选项

• 2.1.5 运行时配置选项

• 2.1.6 启动 Calendar Server

• 2.1.7 数据库、日志和临时文件目录

为帮助您记录这些配置信息，请使用附录 B，Calendar Server 配置工作单 中的工作单。（但是，在运行 Java Enterprise System 安装程序之前必须确定此配置信息，以避免与其他组件产品冲突，例如端号发生冲突）。

2.1.1 LDAP 服务器选项

Calendar Server 需要 Directory Server 来进行用户验证以及用户首选项的存储和检索。下表列出了用于收集 LDAP 服务器的主机和端口信息的选项。

2.1.2 目录管理员选项

下表列出了用于收集被指定为 Directory Manager 用户的名称和密码的选项。

2.1.3 Calendar Server 管理员

Calendar Server 管理员是高于任何 Calendar Server ACL 的用户帐户。Calendar Server 管理员用户帐户必须存在于您的用户验证 Directory Server 中。此帐户同时也用于代理验证。下表列出了用于收集 Calendar Server 管理员的用户 ID 和密码的选项。

2.1.4 电子邮件和电子邮件警报选项

您可以将 Calendar Server 配置为在服务器出现故障时向 Calendar Server 管理员发送电子邮件警报消息。下表列出了用于收集电子邮件信息的选项。

2.1.5 运行时配置选项

您可以配置以下 Calendar Server 运行时选项和系统资源选项。

2.1.6 启动 Calendar Server

您可以配置以下选项以自动启动 Calendar Server。

2.1.7 数据库、日志和临时文件目录

Calendar Server 在特定目录中的日历数据库文件、日志文件和临时文件中创建和存储信息。

请勿更改日志文件目录和临时文件目录的位置或名称。

2.2 运行 csconfigurator.sh

您可以从图形用户界面 (GUI) 或从命令行运行配置程序。

如果要远程运行程序，必须正确设置 DISPLAY 环境变量并允许来自服务器的 X-Windows 连接显示在计算机上。例如，要使用 xhost 实用程序，在计算机上执行以下命令：

# xhost +

本节包含以下主题：

• 从命令行运行配置程序

• 从 GUI 运行配置程序

从命令行运行配置程序

1. 以超级用户 (root) 身份登录或成为超级用户。

2. 转到 /opt/SUNWics5/cal/sbin 目录。

3. 使用从下表中选择的选项运行脚本：

   选项	说明
   -nodisplay	在仅文本模式（非 GUI）下运行配置脚本。
   -noconsole	不显示文本输出。将该选项与 -nodisplay 结合使用，以在无提示模式下运行配置脚本。
   -novalidate	不验证输入字段文本。
   -saveState [statefile]	将您为响应配置问题所输入的答案保存到一个状态文件（文本文件）中。除非您指定状态文件的全限定路径，否则，此文件将被保存到以下默认目录中：/opt/SUNWics5/cal/jconfigure .
   -state [statefile]	使用状态文件设置输入值。此选项必须与 -novalidate 和 -noconsole 结合使用。

   例如，如果要以命令行模式运行配置脚本，发出以下命令：

   ./csconfigurator.sh -nodisplay

   命令行版本需要的信息以及进行的顺序都要与 GUI 相同。默认值显示在方括号 [] 中。要接受默认值，按键盘上的 Enter 键。

   ---

   注 –

   有关脚本提示的各种问题所包含信息的文本，请参见后面几节中所示的 GUI 屏幕中的文本。

   ---

从 GUI 运行配置程序

1. 以超级用户 (root) 身份登录或成为超级用户。

2. 转到 /opt/SUNWics5/cal/sbin 目录。

3. 运行以下命令：

   ./csconfigurator.sh

   配置程序将显示以下系列屏幕：

   • 2.3 欢迎屏幕

   • 2.4 管理、用户首选项和验证屏幕

   • 2.6 Calendar Server 6.3 的电子邮件和电子邮件警报屏幕

   • 2.7 Calendar Server 6.3 的运行时配置屏幕

   • 2.9 Calendar Server 6.3 的要存储配置和数据文件的目录屏幕

   • 2.10 Calendar Server 6.3 的归档并紧急备份配置屏幕

   • 2.11 Calendar Server 6.3 的准备配置屏幕

   • 2.13 Calendar Server 6.3 的配置摘要屏幕

   ---

   注意 –

   配置程序仅配置一个域。如果要使用多个域，需使用 Delegated Administrator 来添加域。

   ---

   ---

   注 –

   所有屏幕的标题栏都不正确。版本为 6.3，而不是显示的 6.5。

   ---

2.3 欢迎屏幕

图 2–1 Calendar Server 配置程序的欢迎屏幕

单击“下一步”继续，或单击“取消”退出。

2.4 管理、用户首选项和验证屏幕

图 2–2 管理、用户首选项和验证配置屏幕

2.4.1 用户首选项目录选项

LDAP 服务器主机名

要用于用户验证的 LDAP Directory Server 的主机名。默认值：当前主机

LDAP 服务器端口

LDAP 服务器侦听的端口号。默认值：389

Directory Manager DN

可以在 Directory Server 模式下进行更改的用户名。默认值：cn=Directory Manager

Directory Manager 密码

Directory Manager 的密码。它不会存储为纯文本格式。默认值：无

2.5 虚拟域和日历管理员屏幕

图 2–3 虚拟域和日历管理员屏幕

虚拟域、托管域和多域均表示同一功能，即拥有多个具有其对应的用户和组记录的 LDAP 域。

如果要从非虚拟域环境升级，必须选中“启用虚拟域支持”复选框。如果已具有多域环境，此复选框将显示为灰色。现在，虚拟域支持为 Calendar Server 的默认行为，且为不可选。

2.5.1 Calendar Server 6.3 的虚拟域设置

图 2–4 虚拟域结构

现在，对于全新的 Calendar Server 安装，虚拟域支持为其默认行为。通过配置程序图形用户界面，在“新建默认域”输入框中输入默认域名。然后，配置程序将为您创建域。

从”默认域”框内显示的域中选择一个作为默认域。如果已在之前的 Calendar Server 版本中使用多域，且不想使用“默认域”框中显示的域，单击此框查看可从中进行选择的域列表并选择新的默认域。

2.5.2 Calendar Server 6.3 的日历管理员名称和密码

用户名

Calendar Server 管理员的用户名。默认值：calmaster

管理员密码

Calendar Server 管理员的密码。默认值：无

电子邮件地址

Calendar Server 管理员的电子邮件地址。

站点管理员

站点管理员是具有跨域代理验证权限的用户。

单击相应的响应：Yes，如果日历管理员同时也是站点管理员。No ，如果日历管理员不是站点管理员。

单击“下一步”继续，单击“上一步”返回上一屏幕，或单击“取消”退出。

2.6 Calendar Server 6.3 的电子邮件和电子邮件警报屏幕

图 2–5 电子邮件和电子邮件警报配置屏幕

电子邮件警报

指定在服务器出现故障时 Calendar Server 是否向 Calendar Server 管理员发送电子邮件警报消息。默认值：disabled。如果选择 Disabled，将不会有管理员会收到针对服务器问题的电子邮件警报。

管理员电子邮件地址

将接收电子邮件警报信息的 Calendar Server 管理员的电子邮件地址。默认值：无

SMTP 主机名

用于发送警报消息的 SMTP 服务器的主机名。默认值：当前主机。

单击“下一步”继续，单击“上一步”返回上一屏幕，或单击“取消”退出。

2.7 Calendar Server 6.3 的运行时配置屏幕

图 2–6 运行时配置屏幕

服务端口

Calendar Server 用于侦听以向用户提供 Web (HTTP) 访问的端口号。默认值：80。

最大会话数

同时进行的 Calendar Server 会话的最大数目。默认值：5000

最大线程数

并发运行的 Calendar Server 线程的最大数目。默认值：20

服务器进程数

在服务器上运行的 Calendar Server 进程的最大数目。默认值：要安装 Calendar Server 的服务器上的 CPU 数目。

运行时用户 ID

Calendar Server 运行时使用的 UNIX 用户名。如果不存在该帐户，配置程序将创建它。默认值：icsuser

---

注意 –

请勿使用 root 作为“运行时用户 ID”。

---

运行时组 ID

Calendar Server 运行时使用的 UNIX 组。如果不存在该组，配置程序将创建它。默认值：icsgroup

Calendar Server 启动选项

单击复选框可选择一个或同时选择两个选项。

• 成功配置后启动

  指定是否在此配置程序成功运行完成后自动启动 Calendar Server。

• 系统启动时启动

  指定系统启动后是否自动启动 Calendar Server。

---

注 –

默认情况下，仅选中“系统启动时启动”复选框。

---

单击“下一步”继续，单击“上一步”返回上一屏幕，或单击“取消”退出。

2.8 Calendar Server 6.3 的设置前端-后端部署屏幕

选择将此服务器配置为单服务器部署还是前端-后端部署。如果选择具有 Calendar Server 的单服务器实例，则不要选中该屏幕上的此复选框。如果要将 Calendar Server 数据库放置在一个或多个服务器上，并且同时维持与另一服务器上的客户端之间的通信，选中复选框。

本节包含以下主题：

• 2.8.1 Calendar Server 6.3 的单服务器部署

• 2.8.2 Calendar Server 6.3 的前端和后端部署

2.8.1 Calendar Server 6.3 的单服务器部署

图 2–7 单服务器部署

如果需要单服务器部署（即管理进程和数据库驻留在一台服务器上），则保持此屏幕不变。单击“下一步”继续。

如果要部署单独的前端和后端计算机，则选中以下复选框：“设置前端/后端部署”。屏幕将发生变化，且您可以分别配置前端和后端服务器（如以下两幅屏幕抓图所示）：

2.8.2 Calendar Server 6.3 的前端和后端部署

图 2–8 设置前端和后端服务器

要填写此屏幕，执行以下步骤：

1. 要配置后端服务器（即，在其中存储日历数据库的服务器），只需指定服务端口。

   “服务端口”输入框的预填值为 ics.conf 参数 service.dwp.server.hostname.port 和 service.dwp.port 中命名的端口。

   要更改端口号，在“服务端口”输入框中输入所需的端口号。

2. 要配置前端服务器，单击“添加主机”，然后输入要配置的服务器的主机名和 IP 地址。

   ---

   注 –

   仅将当前正在配置的服务器添加到列表中。如果计划配置其他前端服务器，则在配置这些服务器时再添加它们。（必须在每个添加到配置中的服务器上运行配置程序。）

   ---

3. 如果该服务器是默认的前端服务器，选中“默认”复选框。

4. 单击“下一步”。

   ---

   注 –

   还可通过单击“删除选定主机”从该列表中删除服务器。

   ---

2.9 Calendar Server 6.3 的要存储配置和数据文件的目录屏幕

接受此屏幕上的默认目录。尽管允许您选择用于存储配置和数据文件的目录，但不建议您这样做。

图 2–9 选择目录配置屏幕

配置目录

配置文件 (ics.conf) 所在的目录。

数据库目录

Calendar Server 在其中创建和存储日历数据库文件的目录。默认值：/var/opt/SUNWics5/csdb

附件存储目录

附件的存储目录。默认值：/var/opt/SUNWics5/astore

日志目录

Calendar Server 在其中写入日志文件的目录。默认值：/var/opt/SUNWics5/logs

临时文件目录

Calendar Server 在其中写入临时文件的目录。默认值：/var/opt/SUNWics5/tmp

然后，单击“下一步”继续，单击“上一步”返回上一屏幕，或单击“取消”退出。

如果这些目录中有任何一个尚不存在，则会针对每个缺失的目录出现一个弹出窗口。单击相应按钮以选择让配置程序创建一个新目录，或返回可从中选择另一目录的屏幕。

对于任何已存在但不为空的目录，将出现带有两个选项的弹出窗口。单击相应按钮以接受此目录，或返回可从中选择另一目录的屏幕。

2.10 Calendar Server 6.3 的归档并紧急备份配置屏幕

该屏幕允许同时选择两个自动备份类型或选择其中任一，或者均不选择。您可相应选定或取消选定这些复选框。强烈建议您同时使用归档备份和紧急备份。但是此时也可以不配置自动备份，而是以后再配置。

防止由于设备故障而造成所有数据库副本的严重丢失。请将您的自动备份副本保留在与动态数据库所在位置不同的磁盘或磁盘系统上。

有关自动备份及其配置方式的信息，参见第 9 章，配置自动备份。

图 2–10 归档并紧急备份配置屏幕

启用归档

如果选中此框（默认），系统将每隔 24 小时对日历数据库拍一次快照。在一天当中，它将定期把当天的事务日志文件与快照一起存储在归档备份目录下。

如果没有选中此框，“归档目录”输入字段将显示为灰色。

归档目录

通过单击“浏览”可选择备份目录，或者接受默认。

启用紧急备份

如果选中此框（默认），系统将每隔 24 小时对日历数据库拍一次快照，然后在一天中的设置时间间隔（默认值为两分钟）内将事务日志应用到快照中，从而确保对动态数据库进行尽可能完整的复制。

如果没有选中此框，则“紧急备份目录”输入字段将显示为灰色。

紧急备份目录

通过单击“浏览”可选择备份目录，或者接受默认。

归档文件保留时间（以天为单位）

只有在选中“启用归档”复选框时该字段才处于活动状态；否则它会显示为灰色。

单击“最少”和“最多”字段中的向上箭头或向下箭头，可选择将归档备份保留在备份目录中的天数范围。

紧急备份保留时间（以天为单位）

只有在选中“启用紧急备份”复选框时该字段才处于活动状态；否则它会显示为灰色。

可使用以下两种方法来设置要保留的紧急备份数：

• 单击“最少”和“最多”字段中的向上箭头或向下箭头，可选择将紧急备份保留在目录中的天数范围。

  在任何时间实际存储的副本数取决于文件大小和目录大小。当大小限制或副本的最大数目超过限制时，将清除最早的副本，以将副本数降至此配置屏幕中所指定的最小数目。

• 如果希望紧急备份的设置与归档备份的设置相同，可选中“与归档文件相同”复选框。

单击“下一步”继续，单击“上一步”返回上一屏幕，或单击“取消”退出配置程序。

2.11 Calendar Server 6.3 的准备配置屏幕

到目前为止，屏幕一直在收集配置所需的数据并执行某些有效性检查。此时，您可以返回并重做配置信息，或者开始配置。

图 2–11 准备配置屏幕

单击“立即配置”以配置 Calendar Server，单击“上一步”以返回上一屏幕，或单击“取消”退出。

2.12 Calendar Server 6.3 的序列启动完成屏幕

图 2–12 序列启动完成屏幕

此面板提供了所有任务和部署的实时更新（通过或失败）。出现消息“所有任务均已通过”时，配置结束。检查所指示的日志文件以查看是否存在错误消息。

配置程序完成后，单击“下一步”。

2.13 Calendar Server 6.3 的配置摘要屏幕

图 2–13 配置摘要屏幕

单击“详细资料”以查看配置日志的详细信息或单击“关闭”以退出配置程序。

第 3 章 Calendar Server 6.3 的数据库迁移实用程序

本章描述在安装和配置 Calendar Server 6.3 软件后，可用于迁移日历数据库和 LDAP 数据库的各种数据库迁移实用程序。

本章包括以下各节：

• 3.1 Calendar Server 数据库迁移实用程序概述

• 3.2 选择正确的 Calendar Server 实用程序

• 3.3 csmigrate 实用程序

• 3.4 cs5migrate 实用程序

• 3.5 csmig 实用程序

• 3.6 csvdmig

• 3.7 commdirmig

如果要从 Calendar Server 6.0、6.1 或 6.2 版本执行迁移，可运行3.3 csmigrate 实用程序。如果未在之前的部署中对周期事件和任务运行 cs5migrate，则必须在运行 csmigrate 前先在现有的日历数据库上运行 cs5migrate。

如果要从 Calendar Server 5.1.1 执行迁移，可使用3.2 选择正确的 Calendar Server 实用程序中介绍的迁移实用程序来迁移日历数据库和 LDAP 数据库。

如果安装了更早版本的 Calendar Server，则需联系技术支持以获取数据迁移帮助。

3.1 Calendar Server 数据库迁移实用程序概述

本节介绍每一种迁移实用程序。仅使用需要的迁移实用程序，具体取决于之前所安装的 Calendar Server 版本。这些实用程序位于 sbin 目录中。

如果已对数据库运行了 cs5migrate 实用程序，但未使用 -r 选项，则必须在运行任何其他实用程序前再次使用 -r 选项来运行该实用程序。

迁移实用程序如下：

3.5 csmig 实用程序

为 Calendar Server 6 数据库中的每个日历指定一个所有者，并将每个日历 ID (calid) 映射到一个所有者（如果需要），这可以支持多域和 LDAP 日历查找数据库 (Calendar Lookup Database, CLD) 插件。

在 cs5migrate 之后和 csvdmig 之前运行该实用程序。

3.6 csvdmig

将 Calendar Server 6 站点升级为使用多域，方法是将日历的域 （@域名）添加到每个 calid 中。例如，在域 sesta.com 中，jdoe 的 calid 现在将是 jdoe@sesta.com。此实用程序打包在 Calendar Server 中。

在 csmig 之后和 cs5migrate 之前运行此实用程序。

3.4 cs5migrate 实用程序

将日历数据库的格式从 Calendar Server 版本 5 迁移到版本 6.2。必须对数据库运行此实用程序，并指定 -r 选项。如果在此之前已从 Calendar Server 版本 5.1.1 迁移到版本 6.2，但未运行带有 -r 选项的 cs5migrate 实用程序，则必须在运行 csmigrate 实用程序前先运行具有该选项的此实用程序。

在 csmig 及 csvdmig 之后和 csmigrate 之前运行此实用程序。

3.3 csmigrate 实用程序

迁移日历数据库以从 Calendar Server 版本 6.0、6.1 或 6.2 升级到 Calendar Server 版本 6.3。如果需要运行带有 -r 选项的 cs5migrate，则需先运行它再运行此实用程序。

3.7 commdirmig

将 LDAP 数据从 Schema 版本 1 迁移到 Schema 版本 2，以为用于 Access Manager（在传统模式下）而做好准备。

3.2 选择正确的 Calendar Server 实用程序

本节有助于确定需运行哪些实用程序来使所有日历数据库和 LDAP 数据库都处于 Calendar Server 6.3 软件级别。

使用下表来查找要运行的正确实用程序集合：

以给定的顺序运行实用程序。

3.3 csmigrate 实用程序

csmigrate 实用程序用于将 Calendar Server 6.0、6.1 或 6.2 数据库迁移到 Calendar Server 6.3 数据库。可在 Calendar Server 产品的 sbin 目录中找到 csmigrate 实用程序和其他管理工具。

本节包含以下主题：

• 3.3.1 csmigrate 实用程序语法

• 3.3.2 csmigrate 示例

• 如何运行 Calendar Server csmigrate 实用程序

3.3.1 csmigrate 实用程序语法

csmigrate 命令的语法为：

csmigrate [-q] [-d] [-l min|max] [-b backup_dir] source_dbdir target_dbdir

选项及其用法如下：

-q（可选）

指定静默模式且无打印说明。

-d（可选）

指定模拟运行模式且不会写入新数据库。

-l min|max（可选）

指定日志级别。将迁移日志写入默认日志目录中的 csmigrate.log，将错误写入该目录中的 csmigrateError.log。

-b backup_dir（可选）

指定备份源数据库的目录。程序将源数据库备份到此目录中，然后对此副本进行操作以防止损坏源数据库。默认位置为源数据库目录下的 backup。

-source_dbdir（必填）

迁移前数据库文件所在的目录。

-target_dbdir（必填）

在其中创建迁移后文件的目录。

-V（其他支持的选项）

打印工具的版本信息。

-?（其他支持的选项）

打印工具的使用信息。

程序的退出代码为 255 时表示失败，为 0 时表示成功。

3.3.2 csmigrate 示例

在 csmigrate 命令中使用选项的示例如下：

csmigrate -b /var/opt/SUNWics5/tmpdb /var/opt/SUNWics5/old_db /var/opt/SUNWics5/new_db
csmigrate -q /var/opt/SUNWics5/old_db /var/opt/SUNWics5/new_db
csmigrate -l min old_db /var/opt/SUNWics5/new_db
csmigrate -l max old_db /var/opt/SUNWics5/new_db

如何运行 Calendar Server csmigrate 实用程序

1. 以超级用户权限身份登录。

2. 停止所有服务。

   例如，发出以下命令：

   stop-cal

3. 将当前数据库移动到临时目录。

   例如，将整个 csdb 目录移动到 oldcsdb。

   mv cal-svr-base/SUNWics5/csdb/* cal-svr-base/SUNWics5/oldcsdb

4. 确保新目录和该目录中的旧文件的所有者为默认管理员 (icsuser, icsgroup)。

   如果拥有权不正确，则使用以下命令来更改拥有权：

   chown -R icsuser:icsgroup /cal-svr-base/SUNWics5/oldcsdb/

5. 运行迁移工具。

   从新备份副本 (oldcsdb) 迁移到 csdb 目录，如以下示例所示：

   cd cal-svr-base/SUNWics5/cal/sbin/ 
   ./csmigrate -l max /cal-svr-base/SUNWics5/oldcsdb cal-svr-base/SUNWics5/csdb

6. 重新启动日历服务。

   例如，使用以下命令：

   start-cal

3.4 cs5migrate 实用程序

cs5migrate 实用程序用于将 Calendar Server 5.1.1 数据库迁移到 Calendar Server 6.3 级别。此外，如果要从某个较早的 Calendar Server 6 版本执行迁移，并且未使用周期选项，也需运行此实用程序。

cs5migrate 实用程序执行以下任务：

过去，如果您不打算使用 Connector for Microsoft Outlook，可选择运行此实用程序，而不执行周期数据转换。然而，从 Calendar Server 6.3 开始，必须将周期数据转换为新格式。

升级到 Calendar Server 6.3 软件后，可在 sbin 目录中找到此实用程序和其他管理工具。

3.5 csmig 实用程序

csmig 实用程序为日历数据库中的每个日历指定所有者，并将每个日历的 ID (calid) 映射到一个所有者（如果需要）。

csmig 实用程序支持多域和 LDAP 日历查找数据库 (Calendar Lookup Database, CLD) 插件。可以使用 LDAP CLD 插件访问已迁移的数据库中的日历。有关 LDAP CLD 插件的信息，参见 第 5 章，在 Calendar Server 版本 6.3 中配置跨多个计算机的日历数据库分发。

本节介绍以下主题：

• 3.5.1 csmig 实用程序功能

• 3.5.2 csmig 实用程序要求

• 3.5.3 csmig 语法

• 3.5.4 csmig 实用程序迁移步骤

• 3.5.5 csmig 提示和故障排除

3.5.1 csmig 实用程序功能

csmig 迁移实用程序执行以下功能：

• 3.5.1.1 迁移日历

• 3.5.1.2 为日历指定所有者

• 3.5.1.3 更新 LDAP 属性

3.5.1.1 迁移日历

csmig 迁移由 caldb.berkeleydb.homedir.path 参数指定的当前日历数据库（*.db 文件）中的用户和资源日历。在新的目标数据库中，csmig 更新日历属性 (calprops)、事件、待办事项（任务）和组调度引擎 (Group Scheduling Engine, GSE) 数据库文件中的 LDAP CLD 插件所需的条目。

csmig 仅对目标数据库执行写入操作，而不更新现有日历数据库。

3.5.1.2 为日历指定所有者

csmig 为日历数据库中的每个日历指定所有者，并将每个日历的 ID (calid) 映射到一个所有者（如果需要）。所有默认的 calid 都保持不变，并且不进行任何更改。

其他日历按如下方式进行映射：

• 不具有有效所有者的用户日历将属于通过 -c 选项传递给 csmig 的用户。例如，如果日历 ID jsmith 没有所有者，它将被转换为 orphan:jsmith（其中 orphan 由 -c 选项指定）。

• 不具有所有者的资源日历将属于通过 -r 选项传递给 csmig 的资源用户。

• 如果资源日历的名称包含多个冒号 (:)，则冒号将被转换为下划线，并使迁移后的名称只包含一个冒号。

  例如，所有者为 bkamdar 且名为 football 的日历将被转换为 bkamdar:football。所有者为 bkamdar 且名为 tchang:soccer 的日历将被转换为 bkamdar:tchang_soccer。所有者为 admin1 且名为 auditorium:room1 的资源日历将被转换为 admin1：auditorium_room1。

3.5.1.3 更新 LDAP 属性

csmig 更新所有相关的 LDAP 条目的 LDAP 属性，包括 icsSubscribed、icsCalendar、icsCalendarOwned、icsFreeBusy、icsSet 和资源日历的 uid。csmig 为 LDAP 目录服务器数据库中的每个日历创建 icsDWPHost 属性。icsDWPHost 指定日历驻留的后端服务器的主机名称。

3.5.2 csmig 实用程序要求

使用 csmig 的要求为：

• 日历数据库必须未被损坏。使用 csdb check 命令检查日历数据库；如果需要，运行 csdb rebuild 命令来重新建立数据库。有关这些命令的信息，请参见附录 D，Calendar Server 命令行实用程序参考。

• 您必须为新的目标数据库准备足够的磁盘空间。如果适用，也应为备份数据库准备足够的磁盘空间。

• 要运行 csmig，请以 icsuser（或以配置过程中指定的 Calendar Server 运行时用户 ID）身份登录。如果您以超级用户 (root) 身份运行 csmig，则可能需要重置已迁移文件的权限。

  您还必须具有管理存储用户首选项的 LDAP Directory Server 中的日历用户属性的权限。

• 必须停止 Calendar Server。

3.5.3 csmig 语法

csmig 实用程序有以下语法：

csmig [-t DestinationDB]
      [-b Backend-DWPHost]
      [-o OutputFile]
      [-e ErrorFile]
      [-m MappingFile]
      [-c calendarOwner]
      [-r resourceOwner]
      { migrate|dryrun }

下表列出了实用程序选项，并给出了每个选项的说明和默认值。

3.5.4 csmig 实用程序迁移步骤

如果拥有 Calendar Server 版本 5.1.1 之前的版本，则在安装和配置 Calendar Server 6.3 之后，运行 csmig 来迁移现有的 Calendar Server 和 LDAP 数据库。LDAP CLD 插件的正常工作需要进行 LDAP 数据的迁移。要使用 csmig 迁移日历数据，请按照以下步骤执行操作：

使用 csmig 的高级步骤

1. 使用 comm_dssetup.pl 配置 Directory Server。

   如果尚未使用 comm_dssetup.pl 为 LDAP 属性创建索引，则现在创建索引。这将大大提高 LDAP 数据迁移的性能。

2. 请使用分步服务器（非产品服务器）执行模拟运行测试。

   模拟运行会报告 csmig 在实际迁移过程中将要执行的操作，但模拟运行并不真地迁移任何数据。在模拟运行之后以及实际迁移之前，您可以更正任何错误，并确定处理任何未解析的日历的计划。

   有关如何执行模拟运行测试的说明，参见3.5.4 csmig 实用程序迁移步骤。

3. 迁移产品数据

   在产品运行过程中，csmig 迁移日历数据库（.db 文件）与 LDAP 数据（用户和组首选项数据）、icsSubscribed、icsCalendar、icsCalendarOwned、icsFreeBusy、icsSet 和用于资源日历的 uid。迁移之后，将为所有日历资源创建 LDAP 项。

   有关如何迁移产品数据的说明，请参见3.5.4 csmig 实用程序迁移步骤。

要执行模拟运行测试

1. 在分步服务器上安装 Calendar Server 6.3（如果需要）。

2. 将日历数据库的快照复制到分步服务器。

3. 通过执行以下任务在分步服务器上模仿生产 LDAP 环境：

   • 安装 Directory Server。

   • 在此服务器上安装 LDAP 数据库的快照。

4. 运行 comm_dssetup.pl 以配置分步 Directory Server。

5. 运行 csconfigurator.sh 以配置分步 Calendar Server。

6. 以 icsuser 身份登录（或者，如果不相同，以配置过程中指定的 Calendar Server 运行时用户 ID 登录）。如果您以超级用户 (root) 身份运行 csmig，则可能需要重置已迁移文件的权限。

7. 转到 cal-svr-base/SUNWics5/cal/sbin 目录。

8. 运行 csdb check 命令检查数据库中是否存在损坏。如果该命令检测出数据库中存在损坏，则运行 csdb rebuild 命令来重新建立数据库。

9. 考虑为不具有所有者的用户日历创建通用的 calid。例如，以下命令将创建 calid 为 orphan 的用户：

   ./csuser -g orphan -s adminuser -y password -l en -c orphan create orphan

10. 使用 stop-cal 命令停止 Calendar Server（如果需要）。

    cal-svr-base/SUNWics5/cal/sbin/stop-cal

11. 运行带有 -dryrun 选项的 csmig。例如，可以输入：

    ./csmig -b sesta.com -o csmig.out -e csmig.errors
     -m csmig.map -c orphan -r calmaster dryrun

    该命令将不具有所有者的用户日历（不带有所有者的日历）指定给所有者 orphan，将不具有所有者的资源日历指定给所有者 calmaster。

12. 检查输出的映射文件 (csmig.map)。映射文件列出了 LDAP 模式中需要更新的条目。

13. 检查输出、映射和出错文件。解析发现的任何 LDAP 问题或错误。在进行实际的迁移之前，确定如何处理未解析的日历。

    有以下若干选择：

    • 在迁移前，删除任何不需要的日历。

    • 为任何未解析的日历指定所有者。

    • 在迁移期间，使用 -c 和 -r 选项允许 csmig 为日历指定所有者。

14. 运行 csmig 以迁移分步日历数据库。

    例如，以下命令将把日历数据库迁移至 /var/opt/SUNWics5/testcsdb/ 目录：

    ./csmig -t /var/opt/SUNWics5/testcsdb/ -b sesta.com 
    -o csmig.out -e csmig.errors -m csmig.map -c orphan 
    -r calmaster migrate

15. 测试迁移完成之后，请执行以下步骤检查新迁移的日历数据库。

    1. 将已迁移的数据库复制到 caldb.berkeleydb.homedir.path 参数指定的 /csdb 目录中。或者编辑此参数，使其指向迁移的数据库的新位置。

    2. 对新的日历数据库运行 csdb check。迁移的数据库中事件和待办事项的数目应与迁移之前的总数相匹配。

    3. 搜索 icsCalendarOwned 条目，并确保这些条目与迁移前日历的数目相匹配。

    4. 登录到 Communications Express 并验证已迁移的数据库中的某些日历。

       如果成功完成了迁移测试，则可以开始迁移产品数据库。

要迁移产品数据

1. 以 icsuser（或在配置过程中指定的 Calendar Server 运行时用户 ID）身份登录。如果您以超级用户 (root) 身份运行 csmig，则可能需要重置已迁移文件的权限。

2. 转到 cal-svr-base/SUNWics5/cal/sbin 目录。

3. 使用 stop-cal 命令停止 Calendar Server。

   cal-svr-base/SUNWics5/cal/sbin/stop-cal

4. 备份以下数据：

   • 日历数据库（.db 文件）。

   • LDAP 数据：slapd 数据库目录和 LDAP 数据库。

   • ics.conf 文件。此步骤实际上并不需要，但如果要恢复为初始配置，该步骤则会很有帮助。

5. 运行带有 -migrate 选项的 csmig。

   例如，以下命令将把日历数据库迁移至 /var/opt/SUNWics5/newcsdb/ 目录：

   ./csmig -t /var/opt/SUNWics5/newcsdb/ -b sesta.com 
   -o csmig.out -e csmig.errors -m csmig.log -c orphan 
   -r calmaster migrate

6. 检查错误文件 (csmig.errors) 中是否有未解析的日历，并根据3.5.4 csmig 实用程序迁移步骤中的计划解析这些日历。

7. 运行 csdb check 命令以检查已迁移的数据库。如果该命令检测出数据库中存在损坏，则运行 csdb rebuild 命令来重新建立数据库。

8. 将新迁移的数据库复制到 caldb.berkeleydb.homedir.path 参数指定的 /csdb 目录中。或者编辑此参数，使其指向迁移的数据库的新位置。

9. 通过对 ics.conf 文件中的以下配置参数进行必要的更改来启用 LDAP CLD 插件：

   • service.dwp.enable= "yes"

   • service.dwp.port = "59779"

   • csapi.plugin.calendarlookup = "yes"

   • csapi.plugin.calendarlookup.name = "*"

   • caldb.cld.type = "directory"

   • caldb.dwp.server.default = "default-server-name"

   • caldb.dwp.server.server-hostname.ip = "server-hostname"（用于包含本地服务器的每个后端服务器）

   • caldb.cld.cache.enable = "yes"（如果要使用 CLD 高速缓存选项）

   • caldb.cld.cache.homedir.path 指定 CLD 高速缓存目录的位置。默认值为 /var/opt/SUNWics5/csdb/cld_cache。

     有关设置 LDAP CLD 插件的配置参数的信息，参见第 5 章，在 Calendar Server 版本 6.3 中配置跨多个计算机的日历数据库分发。

10. 使用 start-cal 命令重新启动 Calendar Server。

11. 登录到 Communications Express 并通过检查几个已迁移的日历来验证配置是否起到作用。

    要在检查时禁用警报，将 ics.conf 文件中的以下参数都设置为 "no"：

    • caldb.serveralarms = "no"

    • caldb.serveralarms.dispatch = "no"

    • service.ens.enable = "no"

    • service.notify.enable = "no"

    • ine.cancellation.enable = "no"

    • ine.invitation.enable = "no"

    • service.admin.alarm = "no"

3.5.5 csmig 提示和故障排除

本节介绍了以下提示和故障排除示例：

• 3.5.5.1 csmig 模拟运行日历显示了错误的日历所有者。

• 3.5.5.2 LDAP 日历搜索无法正常工作。

• 3.5.5.3 csmig 模拟运行指示重复的日历名称。

• 3.5.5.4 如何将不带有所有者的日历指定给不同的所有者？

• 3.5.5.5 如何将日历用户移动至其他后端服务器？

3.5.5.1 csmig 模拟运行日历显示了错误的日历所有者。

问题示例

名为 tchang:myCalendar 的日历的所有者在日历数据库中为 jsmith，csmig 模拟运行将映射显示为 jsmith:tchang_myCalendar。但是，您希望将此日历命名为 tchang:myCalendar，并将所有者指定为 tchang。

解决方案示例

在迁移之前，使用 cscal 实用程序将 tchang:myCalendar 日历的所有者更改为 tchang。执行此操作后，迁移操作会将此日历映射为 tchang:myCalendar，并针对用户 ID tchang 向 LDAP 条目中添加 icsCalendarowned。

3.5.5.2 LDAP 日历搜索无法正常工作。

问题示例

迁移之后，将启用 LDAP 日历搜索，但日历搜索对话框不返回任何结果，或仅返回部分结果。

解决方案示例

启用 LDAP 日历以使 Calendar Server 可以搜索 (&(objectclass=icscalendaruser)(icscalendarowned=*substr*))。

使用以下过滤器对 LDAP 数据手动运行两个不同的搜索，并比较输出结果：

• 使用过滤器 (&(objectclass=icscalendaruser)(icscalendarowned=*substr*)) 进行 LDAP 搜索

• 使用过滤器 (icscalendarowned=*substr* ) 进行 LDAP 搜索

因为服务器使用包含 icsCalendarUser 对象类的过滤器，所以可能已在禁用模式检查的情况下部署了 LDAP 服务器，并且可能在没有 icsCalendarUser 对象类的情况下置备了某些日历条目。

3.5.5.3 csmig 模拟运行指示重复的日历名称。

问题示例

csmig 模拟运行映射文件和输出结果文件指示存在重复的日历名称。

例如，在初始数据库中，jsmith 拥有以下日历：

• 具有 5 个事件的 basketball

• 具有 10 个事件的 jsmith:basketball

模拟运行的结果表示迁移时将合并这两个日历，生成的日历将为 jsmith:basketball，该日历的所有者为 jsmith 并总共具有 15 个事件

输出文件将包含以下警告消息：

Error modifying calendar properties, error=2

解决方案示例

如果不希望合并这两个日历，则在迁移之前将 basketball 的所有者更改为 jsmith 以外的用户。这可以保持这两个独立日历数据的完整性。

3.5.5.4 如何将不带有所有者的日历指定给不同的所有者？

问题示例

默认情况下，csmig 将所有不带有所有者的日历指定给一个所有者，但是我希望为其中的某些日历指定不同的所有者。

解决方案示例

csmig 不接受命令行中的映射文件。但是，可以在迁移之前为初始数据库中不带有所有者的日历指定所有者。检查所有不带有所有者的日历的空运行映射文件。然后，在迁移之前使用 cscal 实用程序为不带有所有者的日历指定所有者。在 -dryrun 模式下再次运行 csmig 以验证新的所有者。

3.5.5.5 如何将日历用户移动至其他后端服务器？

问题示例

如何将用户从一个后端服务器移动到另一个后端服务器？

解决方案示例

要移动日历用户，应通过 export 命令导出初始服务器上该用户的每个日历，然后通过 import 命令将日历导入到第二个服务器。移动日历后，可以删除初始服务器上的日历。有关如何移动日历的说明，参见15.6 管理用户日历。

3.6 csvdmig

csvdmig 实用程序准备要在多域环境中使用的日历数据库以及 LDAP 用户和组条目。即使计划仅使用默认域，也必须运行此实用程序。

如果在 Calendar Server 6.3 中从非域环境迁移到多域环境，确保在使用此实用程序前先运行 csmig。

本节包含以下主题：

• 3.6.1 csvdmig 功能

• 3.6.2 csvdmig 语法

• 3.6.3 csvdmig 示例

3.6.1 csvdmig 功能

csvdmig 实用程序对数据库和 LDAP 条目执行以下更改：

• 更改日历 ID (calid) 的格式：

  从：userid[:calendar-name]

  到： userid@domain[:calendar-name]

• 更改访问控制列表 (ACL) 访问规则：

  从：userid

  到：userid@domain

• 修改用于 Calendar Server 属性的 LDAP Directory Server 用户条目：

  将 userid[:calendar-name] 改为 userid@domain[:calendar-name]。

• 更新日历数据库中事件和任务的所有者和参与者字段。例如：

  如果域 sesta.com 中的 jsmith 是事件的所有者，则新的所有者字段将包含 jsmith@sesta.com。

csvdmig 实用程序将对数据库和 LDAP 目录进行相应更新。也就是说，该实用程序并不创建单独的迁移数据库，而是修改正在转换的数据库。因此，为了安全起见，针对数据库和 LDAP 目录的快照运行 csvdmig。

3.6.2 csvdmig 语法

csvdmig 实用程序的语法如下：

csvdmig [-t DestinationDB]
         [-c ConfigFile]
         [-e ErrorFile]
         [-m MappingFile]
         migrate [DB|LDAP]

下表列出了 csvdmig 使用的选项，并给出了每一个选项的描述。

3.6.2.1 映射文件

映射文件是输入文本文件，可将现有用户映射到其各自的域。运行 csvdmig 之前，必须创建映射文件。每行指定一个条目，在旧值和新值之间留有一个空格。例如：

user1 user1@sesta.com
user2 user2@siroe.com
user3 user3@sesta.com
 ...
usern usern@siroe.com

3.6.2.2 目标 DB

要迁移的数据库的位置。此实用程序会对文件进行相应更新。确保在使用 csvdmig 实用程序前已备份此目录。

如果未指定 -t 选项，则实用程序会尝试迁移当前目录（通过在命令行执行 pwd 所指定的目录）的内容，并会产生无法预知的结果。

3.6.3 csvdmig 示例

以下为 csvdmig 示例

• 使用默认值迁移 LDAP Directory Server 数据：

  csvdmig migrate LDAP

• 迁移 Calendar Server 数据库：

  csvdmig -t targetDB -e errorFile -m mappingFile migrate

3.7 commdirmig

commdirmig 实用程序将 LDAP 数据从 Sun Java System LDAP Schema 版本 1 迁移到 Schema 版本 2，为将 Access Manager 用于验证服务做好准备。如果之前的安装已使用 Schema 版本 2，则无需再运行此实用程序。

• 3.7.1 谁应运行 commdirmig 实用程序

• 3.7.2 何时运行 commdirmig 实用程序

• 3.7.3 何处查找有关 commdirmig 实用程序的文档

• 3.7.4 何处查找该实用程序

3.7.1 谁应运行 commdirmig 实用程序

此迁移实用程序将 Schema 版本 1 LDAP 数据库迁移到 Schema 版本 2。如果要使用 Access Manager 软件来进行验证，必须通过运行此实用程序将 LDAP 条目转换为 Schema 版本 2 格式。

如果使用的不是 Access Manager，由于 Schema 版本 2 是所有使用 LDAP 的 Communications Suite 产品首选的 LDAP 模式，所以仍应考虑迁移 LDAP 数据。

如果具有单独 LDAP 目录首选项，则必须在该 LDAP 和用于验证的 LDAP 上运行 commdirmig。

3.7.2 何时运行 commdirmig 实用程序

在已运行将日历和 LDAP 数据库从 Calendar Server 软件的之前版本迁移到 Calendar Server 软件版本 6.3 所需的所有其他迁移实用程序后，运行 commdirmig。

3.7.3 何处查找有关 commdirmig 实用程序的文档

commdirmig 迁移实用程序需要特殊的准备和规划。它在独立的指南中进行说明，参见《Sun Java Communications Suite 5 Schema Migration Guide》。

3.7.4 何处查找该实用程序

commdirmig 实用程序与通过 Communications Suite 安装程序安装的 Delegated Administrator 捆绑在一起。

也可以从技术支持处获得该实用程序的修补程序。