如果您拥有早期版本的 Calendar Server(5.11 或更早版本),则在安装 Calendar Server 后执行安装后配置时您可能需要迁移组件数据库和 LDAP 数据库。
本章中的选择正确的实用程序一节可以帮助您选择要运行的正确实用程序。
本章包括以下各节:
安装 Sun Java System Calendar Server 后,如果您的日历数据库和 LDAP 数据库来自所安装的旧的 Calendar Server 5.1.1,请按照给定顺序运行以下实用程序:
cs5migrate
将日历数据库的格式从 Calendar Server 第 5 版迁移到第 6 版。可以从技术支持网站下载这些实用程序。
如果计划使用 Connector for Microsoft Outlook 并具有周期性组件,则请使用 cs5migrate_recurring,该实用程序将为每个周期性系列创建主记录和异常。
如果现有的数据库中没有周期性组件,或者有这样的组件但却并未打算使用 Connector for Microsoft Outlook,则请使用 cs5migrate。
无论 cs5migrate 或 cs5migrate_recurring 都仅可从技术支持处获得。他们未打包在产品中。
为 Calendar Server 6 数据库中的每个日历指定一个属主,并将每个日历 ID (calid) 映射到一个属主(如果需要),这可以支持托管(虚拟)域和 LDAP 日历查找数据库 (Calendar Lookup Database, CLD) 插件。此实用程序打包在 Calendar Server 中。在 cs5migrate 之后和 csvdmig 之前运行该实用程序。
将 Calendar Server 6 站点升级为使用托管(虚拟)域,方法是将日历的域 (@域名)添加到每个 calid 中。例如,在域 sesta.com 中,jdoe 的 calid 现在将是 jdoe@sesta.com。此实用程序打包在 Calendar Server 中。在 cs5migrate 之后和 csmig 之前运行该实用程序。
将 LDAP 数据从 Schema 1 迁移到 Schema 2,为与 Access Manager 6.1(或更高版本)配套使用做好准备。此实用程序打包在 Access Manager 中。
由于有很多可供选择的实用程序,因此请使用下面的图形选择要运行的实用程序。
该 csmig 实用程序为日历数据库中的每个日历指定一个属主并将每个日历 ID (calid) 映射到一个属主(如果需要)。
该 csmig 实用程序支持托管(虚拟)域和LDAP 日历查找数据库 (Calendar Lookup Database, CLD) 插件。可以使用 LDAP CLD 插件访问已迁移的数据库中的日历。有关 LDAP CLD 插件的信息,请参见第 6 章,在多个计算机上配置日历数据库分发。
本节介绍以下主题:
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.
csmig 更新所有相关的 LDAP 条目的 LDAP 属性,包括 icsSubscribed、icsCalendar、icsCalendarOwned、icsFreeBusy、icsSet 和资源日历的 uid。csmig 为 LDAP 目录服务器数据库中的每个日历创建 icsDWPHost 属性。icsDWPHost 指定日历驻留的后端服务器的主机名称。
日历数据库必须未被损坏。使用 csdb check 命令检查日历数据库;如果需要,运行 csdb rebuild 命令来重新建立数据库。有关这些命令的信息,请参见附录 D,Calendar Server 命令行实用程序参考。
您必须为新的目标数据库准备足够的磁盘空间。如果适用,也应为备份数据库准备足够的磁盘空间。
要运行 csmig,请以 icsuser(或以配置过程中指定的 Calendar Server 运行时用户 ID)身份登录。如果您以超级用户 (root) 身份运行 csmig,则可能需要重置已迁移文件的权限。
您还必须具有管理存储用户首选项的 LDAP Directory Server 中的日历用户属性的权限。
必须停止 Calendar Server。
csmig [-t DestinationDB] [-b Backend-DWPHost] [-o OutputFile] [-e ErrorFile] [-m MappingFile] [-c calendarOwner] [-r resourceOwner] { migrate|dryrun } |
下表列出了实用程序选项,并给出了每个选项的描述和默认值。
csmig 选项 |
说明和默认值 |
---|---|
-t DestinationDB |
指定 csmig 生成的目标数据库。默认值为 MigratedDB。 |
-b Backend-DWPHost |
指定 DWP 后端主机服务器的名称。该名称必须与 ics.conf 文件中指定的 DWP 后端主机服务器名称相匹配。 |
-o OutputFile |
指定输出文件,此文件将捕获 csmig 输出到屏幕的消息以及出现的任何错误。默认值为 MigrateOut。 |
-e ErrorFile |
csmig 向其中写入无法解决的错误或数据库条目的文件。如果数据库项无法解决,则不将它们写入目标数据库。默认值为 MigrateError。 |
-m MappingFile |
指定 dryrun 模式下生成的输出映射文件,它列出了 LDAP 模式中需要更改的条目。例如: 旧的:calid=jsmith 新的:calid=jsmith:basketball 映射文件仅提供了对 LDAP 模式所作的更改的列表。csmig 实际上并不对该模式进行这些更改。 migrate 模式中不使用该映射文件。 |
-c calendarOwner |
为不具有属主的用户日历指定属主。 |
-r resourceOwner |
为不具有属主的资源日历指定属主。 |
migrate|dryrun |
指定运行实用程序时所使用的模式。使用 migrate 模式执行迁移。在实际迁移之前,使用 dryrun 模式生成输出映射文件。 |
在安装并配置 Calendar Server 6 后,必须运行 csmig 才能迁移现有的 Calendar Server 和 LDAP 数据。LDAP CLD 插件的正常工作需要进行 LDAP 数据的迁移。要使用 csmig 迁移日历数据,请按照以下步骤执行操作:
使用 comm_dssetup.pl 配置 Directory Server。
如果尚未使用 comm_dssetup.pl 为 LDAP 属性创建索引,请现在创建索引。这将大大提高 LDAP 数据迁移的性能。
请使用分步服务器(非产品服务器)执行模拟运行测试。
模拟运行会报告 csmig 在实际迁移过程中将要执行的操作,但模拟运行并不真地迁移任何数据。在模拟运行之后以及实际迁移之前,您可以更正任何错误,并确定处理任何未解决的日历的计划。
有关如何执行模拟运行测试的说明,请参见csmig 迁移步骤。
迁移产品数据
在产品运行过程中,csmig 迁移日历数据库(.db 文件)与 LDAP 数据(用户和组首选项数据)、icsSubscribed、icsCalendar、icsCalendarOwned、icsFreeBusy、icsSet 和用于资源日历的 uid。迁移之后,将为所有日历资源创建 LDAP 项。
有关如何迁移产品数据的说明,请参见csmig 迁移步骤。
在分步服务器上安装 Calendar Server 6(如果需要)。
将日历数据库的快照复制到分步服务器。
通过执行以下任务在分步服务器上模仿产品 LDAP 环境:
安装 Directory Server。
在此服务器上安装 LDAP 数据库的快照。
运行 comm_dssetup.pl 以配置分步 Directory Server。
运行 csconfigurator.sh 以配置分步 Calendar Server。
以 icsuser 身份登录(或者,如果不相同,以配置过程中指定的 Calendar Server 运行时用户 ID 登录)。如果您以超级用户 (root) 身份运行 csmig,则可能需要重置已迁移文件的权限。
转至 cal_svr_base/SUNWics5/cal/sbin 目录。
运行 csdb check 命令检查数据库中是否存在损坏。如果该命令检测出数据库中存在损坏,则运行 csdb rebuild 命令来重新建立数据库。
考虑为不具有属主的用户日历创建通用的 calid。例如,以下命令将创建 calid 为 orphan 的用户:
./csuser -g orphan -s adminuser -y password -l en -c orphan create orphan |
使用 stop-cal 命令停止 Calendar Server(如果需要)。
cal_svr_base/SUNWics5/cal/sbin/stop-cal
运行带有 dryrun 选项的 csmig。例如,可以输入:
./csmig -b sesta.com -o csmig.out -e csmig.errors -m csmig.map -c orphan -r calmaster dryrun
该命令将不具有属主的用户日历(不带有属主的日历)指定给属主 orphan,将不具有属主的资源日历指定给属主 calmaster。
检查输出的映射文件 (csmig.map)。映射文件列出了 LDAP 模式中需要更新的条目。
检查输出、映射和出错文件。解决发现的任何 LDAP 问题或错误。在进行实际的迁移之前,确定如何处理未解决的日历。有以下若干选择:
在迁移前,删除任何不需要的日历。
为任何未解决的日历指定属主。
在迁移期间,使用 -c 和 -r 选项允许 csmig 为日历指定属主。
运行 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
测试迁移完成之后,请执行以下步骤检查新迁移的日历数据库。
以 icsuser(或在配置过程中指定的 Calendar Server 运行时用户 ID)身份登录。如果您以超级用户 (root) 身份运行 csmig,则可能需要重置已迁移文件的权限。
转至 cal_svr_base/SUNWics5/cal/sbin 目录。
使用 stop-cal 命令停止 Calendar Server(如果需要)。
cal_svr_base/SUNWics5/cal/sbin/stop-cal
备份以下数据:
日历数据库(.db 文件)。
LDAP 数据:slapd 数据库目录和 LDAP 数据库。
ics.conf 文件。此步骤实际上并不需要,但如果要恢复为初始配置,该步骤则会很有帮助。
运行带有 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
检查错误文件 (csmig.errors ) 中是否有未解决问题的日历,并根据csmig 迁移步骤中的计划解决这些日历中的问题。
运行 csdb check 命令以检查已迁移的数据库。如果该命令检测出数据库中存在损坏,则运行 csdb rebuild 命令来重新建立数据库。
将新迁移的数据库复制到 caldb.berkeleydb.homedir.path 参数指定的 /csdb 目录中。或者编辑此参数,使其指向迁移的数据库的新位置。
通过对 ics.conf 文件中的以下配置参数进行必要的更改来启用 LDAP CLD 插件:
caldb.dwp.server.server-hostname .ip = "server-hostname "(用于包含本地服务器的每个后端服务器)
caldb.cld.cache.homedir.path 指定 CLD 高速缓存目录的位置。默认值为 /var/opt/SUNWics5/csdb/cld_cache。
有关设置 LDAP CLD 插件的配置参数的信息,请参见第 6 章,在多个计算机上配置日历数据库分发。
使用 start-cal 命令重新启动 Calendar Server。
登录到 Communications Express 并通过检查几个已迁移的日历来验证配置是否起到作用。
要在检查时禁用警报,请将 ics.conf 文件中的以下参数都设置为 “no”:
本节介绍了以下提示和疑难解答示例:
名为 tchang:myCalendar 的日历的属主在日历数据库中为 jsmith,csmig 模拟运行将映射显示为 jsmith:tchang_myCalendar。但是,您希望将此日历命名为 tchang:myCalendar,并将属主指定为 tchang。
在迁移之前,使用 cscal 实用程序将 tchang:myCalendar 日历的属主更改为 tchang。执行此操作后,迁移操作会将此日历映射为 tchang:myCalendar,并针对用户 ID tchang 向 LDAP 条目中添加 icsCalendarowned。
迁移之后,将启用 LDAP 日历搜索,但日历搜索对话框不返回任何结果,或仅返回部分结果。
启用 LDAP 日历以使 Calendar Server 可以搜索 (&(objectclass=icscalendaruser)(icscalendarowned=*substr*))。
使用以下过滤器对 LDAP 数据手动运行两个不同的搜索,并比较输出结果:
使用过滤器 (&(objectclass=icscalendaruser)(icscalendarowned=*substr*)) 进行 LDAP 搜索
使用过滤器 (icscalendarowned=*substr* ) 进行 LDAP 搜索
因为服务器使用包含 icsCalendarUser 对象类的过滤器,所以可能已在禁用模式检查的情况下部署了 LDAP 服务器,并且可能在没有 icsCalendarUser 对象类的情况下置备了某些日历条目。
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 实用程序针对要使用托管(虚拟)域的站点修改 Calendar Server 数据库和 LDAP 目录服务器数据库。
如果实用程序是从非托管环境中移出的,请确保在使用该实用程序前运行 csmig。
本节包含以下主题:
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 [-t DestinationDB] [-c ConfigFile] [-e ErrorFile] [-m MappingFile] migrate [DB|LDAP] |
下表列出了 csvdmig 使用的选项,并给出了每一个选项的描述。
选项 |
说明和默认值 |
---|---|
-m MappingFile |
指定映射文件的输入参数。有关映射文件的更多信息,请参见映射文件。默认值为 MigrateMapping。 |
-c ConfigFile |
指定 Calendar Server 配置文件的输入参数。默认值为 ics.conf 文件。 |
-t DestinationDB |
指定数据库位置的输出参数。默认值为 MigratedDB。 提示 – 始终使用 -t 选项。在工作目录中尝试迁移数据库将产生难以预料的结果。请参见目标 DB。 |
-e ErrorFile |
为无法解决的错误指定错误文件的名称的输出参数。默认值为 MigrateError。 |
DB | LDAP |
指定要修改的数据库: DB—日历数据库 LDAP—LDAP 目录 默认值为日历数据库 (DB)。 |
表 4–1 csvdmig 的选项
选项 |
说明和默认值 |
---|---|
-m MappingFile |
指定映射文件的输入参数。有关映射文件的更多信息,请参见映射文件。默认值为 MigrateMapping。 |
-c ConfigFile |
指定 Calendar Server 配置文件的输入参数。默认值为 ics.conf 文件。 |
-t DestinationDB |
指定数据库位置的输出参数。默认值为 MigratedDB。请参见目标 DB。 |
-e ErrorFile |
为无法解决的错误指定错误文件的名称的输出参数。默认值为 MigrateError。 |
DB | LDAP |
指定要修改的数据库: DB—Calendar Server 数据库LDAP—LDAP 目录 默认值为日历数据库 (DB)。 |
映射文件是输入文本文件,可将现有用户映射到其各自的域。运行 csvdmig 之前,必须创建映射文件。每行指定一个条目,在旧值和新值之间留有一个空格。例如:
user1 user1@sesta.com user2 user2@siroe.com user3 user3@sesta.com ... usern usern@siroe.com
该实用程序不会将已迁移的文件移至新的 DestinationDB 中。如果指定了 -t 选项,则必须在运行 csvdmig 前将要迁移的数据库文件复制到该目录中。
如果不使用 -t 选项,实用程序将迁移工作目录中的文件,并生成难以预料的结果。
使用默认值迁移 LDAP Directory Server 数据:
csvdmig migrate LDAP
迁移 Calendar Server 数据库:
csvdmig -t targetDB -e errorFile -m mappingFile migrate
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 捆绑在一起。
也可以从技术支持处获得该实用程序的修补程序。