第 4 章 数据库迁移实用程序

如果您拥有早期版本的 Calendar Server（5.11 或更早版本），则在安装 Calendar Server 后执行安装后配置时您可能需要迁移组件数据库和 LDAP 数据库。

本章中的选择正确的实用程序一节可以帮助您选择要运行的正确实用程序。

本章包括以下各节：

• 安装后数据库迁移实用程序

• 选择正确的实用程序

• csmig

• csvdmig

• commdirmig

安装后数据库迁移实用程序

安装 Sun Java System Calendar Server 后，如果您的日历数据库和 LDAP 数据库来自所安装的旧的 Calendar Server 5.1.1，请按照给定顺序运行以下实用程序：

1. cs5migrate

   将日历数据库的格式从 Calendar Server 第 5 版迁移到第 6 版。可以从技术支持网站下载这些实用程序。

   如果计划使用 Connector for Microsoft Outlook 并具有周期性组件，则请使用 cs5migrate_recurring，该实用程序将为每个周期性系列创建主记录和异常。

   如果现有的数据库中没有周期性组件，或者有这样的组件但却并未打算使用 Connector for Microsoft Outlook，则请使用 cs5migrate。

   无论 cs5migrate 或 cs5migrate_recurring 都仅可从技术支持处获得。他们未打包在产品中。

2. csmig

   为 Calendar Server 6 数据库中的每个日历指定一个属主，并将每个日历 ID (calid) 映射到一个属主（如果需要），这可以支持托管（虚拟）域和 LDAP 日历查找数据库 (Calendar Lookup Database, CLD) 插件。此实用程序打包在 Calendar Server 中。在 cs5migrate 之后和 csvdmig 之前运行该实用程序。

3. csvdmig

   将 Calendar Server 6 站点升级为使用托管（虚拟）域，方法是将日历的域 （@域名）添加到每个 calid 中。例如，在域 sesta.com 中，jdoe 的 calid 现在将是 jdoe@sesta.com。此实用程序打包在 Calendar Server 中。在 cs5migrate 之后和 csmig 之前运行该实用程序。

4. commdirmig

   将 LDAP 数据从 Schema 1 迁移到 Schema 2，为与 Access Manager 6.1（或更高版本）配套使用做好准备。此实用程序打包在 Access Manager 中。

选择正确的实用程序

由于有很多可供选择的实用程序，因此请使用下面的图形选择要运行的实用程序。

图 4–1 选择要运行的迁移实用程序

csmig

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

该 csmig 实用程序支持托管（虚拟）域和LDAP 日历查找数据库 (Calendar Lookup Database, CLD) 插件。可以使用 LDAP CLD 插件访问已迁移的数据库中的日历。有关 LDAP CLD 插件的信息，请参见第 6 章，在多个计算机上配置日历数据库分发。

本节介绍以下主题：

• csmig 的功能

• csmig 的要求

• csmig 语法

• csmig 迁移步骤

• csmig 提示和疑难解答

csmig 的功能

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

• 迁移日历

• 为日历指定属主

• 更新 LDAP 属性

迁移日历

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

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

为日历指定属主

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

• 不具有有效属主的用户日历将属于通过 -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.

更新 LDAP 属性

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

csmig 的要求

使用 csmig 的要求有：

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

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

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

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

• 必须停止 Calendar Server。

csmig 语法

该 csmig 实用程序有以下语法：

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

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

csmig 迁移步骤

在安装并配置 Calendar Server 6 后，必须运行 csmig 才能迁移现有的 Calendar Server 和 LDAP 数据。LDAP CLD 插件的正常工作需要进行 LDAP 数据的迁移。要使用 csmig 迁移日历数据，请按照以下步骤执行操作：

使用 csmig 的高级步骤

步骤

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

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

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

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

   有关如何执行模拟运行测试的说明，请参见csmig 迁移步骤。

3. 迁移产品数据

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

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

要执行模拟运行测试

步骤

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

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 ) 中是否有未解决问题的日历，并根据csmig 迁移步骤中的计划解决这些日历中的问题。

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

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

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

   • service.dwp.enable = "yes"

   • service.dwp.port = "9779"

   • csapi.plugin.calendarlookup = "y"

   • 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 插件的配置参数的信息，请参见第 6 章，在多个计算机上配置日历数据库分发。

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"

csmig 提示和疑难解答

本节介绍了以下提示和疑难解答示例：

• csmig 模拟运行日历显示了日历的错误属主。

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

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

• 如何将不带有属主的日历指定给不同的属主？

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

csmig 模拟运行日历显示了日历的错误属主。

问题示例

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

解决方案示例

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

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

问题示例

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

解决方案示例

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

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

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

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

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

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

问题示例

csmig 模拟运行映射文件和输出结果文件指示存在重复的日历名称。例如，在初始数据库中，jsmith 拥有以下日历：

• 具有 5 个事件的 basketball

• 具有 10 个事件的 jsmith:basketball

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

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

Error modifying calendar properties, error=2

解决方案示例

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

如何将不带有属主的日历指定给不同的属主？

问题示例

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

解决方案示例

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

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

问题示例

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

解决方案示例

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

csvdmig

csvdmig 实用程序针对要使用托管（虚拟）域的站点修改 Calendar Server 数据库和 LDAP 目录服务器数据库。

如果实用程序是从非托管环境中移出的，请确保在使用该实用程序前运行 csmig。

本节包含以下主题：

• csvdmig 的功能

• csvdmig 语法

• csvdmig 示例

csvdmig 的功能

csvdmig 实用程序按以下方式将域名添加到用户 ID：

• 日历 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。

csvdmig 语法

csvdmig 实用程序的语法如下：

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

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

映射文件

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

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

目标 DB

该实用程序不会将已迁移的文件移至新的 DestinationDB 中。如果指定了 -t 选项，则必须在运行 csvdmig 前将要迁移的数据库文件复制到该目录中。

如果不使用 -t 选项，实用程序将迁移工作目录中的文件，并生成难以预料的结果。

csvdmig 示例

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

  csvdmig migrate LDAP

• 迁移 Calendar Server 数据库：

  csvdmig -t targetDB -e errorFile -m mappingFile migrate

commdirmig

commdirmig 实用程序将 LDAP 数据从 Sun LDAP Schema 1 迁移到 Schema 2，为将 Access Manager 用于验证服务做好准备。

本节包含以下主题：

• 谁应运行该实用程序

• 何时运行该实用程序

• 何处查找文档

• 何处查找该实用程序

谁应运行该实用程序

如果之前使用的是 Messaging Server 5 或 Calendar Server 5，则您的 LDAP 条目的格式为 Schema 1。在新的 Calendar Server 环境中，如果要使用 Access Manager 来进行验证，则必须运行此实用程序将 LDAP 条目转换为 Schema 2 格式。

如果使用的不是 Access Manager，由于 Schema 2 是所有使用 LDAP 的 Java Enterprise System 产品首选的 LDAP 模式，所以仍应考虑迁移 LDAP 数据。将来，更新的通信产品（Calendar、Messaging 和 Instant Messaging）版本可能不再支持 Schema 1。但是，如果您目前不打算使用 Access Manager，则可以在以后适当的时候进行迁移。

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

何时运行该实用程序

如果要从之前的 Java Enterprise System Calendar Server 版本进行迁移，请在运行 cs5migrate、csmig 和 csvdmig 之后运行此实用程序。

何处查找文档

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

何处查找该实用程序

commdirmig 实用程序与通过 Java Enterprise System 安装程序安装的 Delegated Administrator 捆绑在一起。

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