Sun Java System Communications Express 6.3 管理指南

迁移方案

可以通过两种方式进行数据迁移：

动态迁移

现有 Messenger Express 用户登录到 Communications Express 时，会发生动态迁移。在迁移完成后，用户会收到一封电子邮件。

在动态迁移过程中：

应用程序通过检查 pab_mig_required 参数来查看是否在 uwcuath.properties 文件中启用了迁移。

如果 pab_mig_required 参数设置为 true，则启动迁移过程。
接着登录逻辑对用户 LDAP 条目中的 nswmextendedprefs 属性进行比较。它会检查 mepabmigration 参数的值来确定先前是否迁移了用户数据。
完成 PAB 迁移后，Address Book Server 会将已登录用户条目中的 nswmextendedprefs、mepabmigration 属性设置为 1，表示已完成迁移过程。
在将 PAB 数据成功迁移到 Address Book Server 之后，用户会收到一封邮件。

要接收邮件，必须在 migrate.properties 文件中设置参数。

表 7–1 PAB 迁移电子邮件参数


参数	默认值	描述
`emailReqd`	True	允许在成功迁移 PAB 数据后发送邮件。可接受的值为 "True" 和 "False"。
`smtphost`	本地邮件主机例如：`budgie.siroe.com`	指定 SMTP 中继主机名。
`smtpport`	25	指定 SMTP 中继端口。
`mailsubject`	PAB 迁移状态	指定邮件的主题。
`from`	`admin@hostname`	指定发件人的姓名。

提示 –

建议管理员向所有用户发送一封电子邮件，通知他们在第一次登录过程中将触发 PAB 数据迁移，因此，他们在初始会话期间将不会看到通讯录数据。如果用户在两三天后还无法看到数据，就应该与管理员联系。

批量迁移

批量迁移过程是在服务器级进行的，不需要最终用户执行交互操作。管理员执行 runMigrate.sh 批处理脚本来迁移给定域中的邮件用户 PAB 数据。对于多个域中的邮件用户，管理员必须针对每个域调用 runMigrate.sh 脚本，以将用户 PAB 数据从给定 inetDomainBaseDN 迁移到 Address Book Server。

执行批量迁移

应在 runMigrate.sh 脚本中设置以下参数。此脚本位于 uwc-deployed-path/WEB-INF/classes 目录中。

BASE_DIR：将此参数设置为 Communications Express 安装的 uwc-deployed-path。
JAVA_HOME：将此参数设置为 Java 的安装目录。
o=siroe.com, o=isp：将 siroe.com 和 isp 的值替换为已配置域的 inetDomainBaseDN。

执行批量迁移脚本。

# ./runMigrate.sh

如果批量迁移失败，会在命令行提示符下显示异常。

迁移单个用户和一组用户

管理员可以使用迁移脚本迁移所有用户、单个用户或一组用户。如果运行批量迁移脚本时不带任何选项，则迁移整组用户。要迁移单个用户，可以指定用户的用户 ID。要迁移一组用户，应该使用文本文件提供用户列表。runMigrate.sh 命令语法如下：

./runMigrate.sh{ [-u < [uid] |  [-f <uids-file]} [-h]

其中：

-u 选项指示 runMigrate 脚本要迁移单个用户。—u 选项后面应接要迁移的用户的用户 ID。例如：
```
./runMigrate.sh -u user1
```
-f 选项指示 runMigrate 脚本要迁移已在文件中指定的一组用户。—f 选项后面应接文件的名称，其中要求该文件包含要迁移的选定用户组的用户 ID。例如：
```
./runMigrate.sh -f usersToMigrate.txt
```
usersToMigrate.txt 文件中，每行一个用户 ID。例如：
```
user1
user2
user3
...
....
等等
```