第 4 章升级到 Sun ONE Messaging Server

从 Messaging Server 5.2 升级到 Messaging Server 6.0 包括三个步骤。以下主题概括了此过程：


注	升级到 Sun ONE Messaging Server 6.0 之前，必须先升级或迁移到 Messaging Server 5.2。无法从 5.2 之前的版本直接升级或迁移到 Messaging Server 6.0。有关迁移到 Messaging Server 5.2 的详细信息，请参见 iPlanet Messaging Server 5.2 Migration Guide 和 iPlanet Messaging Server 5.2 Installation Guide。

创建升级文件以更新配置 (UpgradeMsg5toMsg6.pl)

运行升级实用程序 (do_the_upgrade.sh)

MTA 配置 (make_mta_config_changes.sh)

configutil 参数 (make_configutil_changes.sh)

备份配置 (make_backup_config_changes.sh)

mboxlist 数据库 (make_mboxlistdb_changes.sh)

迁移用户邮箱（可选）


注	在执行升级之前，请执行以下步骤：在 Messaging Server 5.2 所在的同一系统或其它系统上安装并配置 Messaging Server 6.0（使用第 2 章“安装 Messaging Server”中的说明）。使用 MTA Direct LDAP Lookup（而不是 imsimta dirsync）配置现有的 Messaging Server 5.2 安装。有关详细信息，请参见《Sun ONE Messaging Server 6.0 管理员指南》。

创建升级文件以更新配置

本节介绍了如何创建特殊的升级文件来更新 Messaging Server 6.0 系统上的配置：

概述

运行 UpgradeMsg5toMsg6.pl Perl 脚本

概述

运行升级实用程序从 Messaging Server 5.2 升级到 6.0 之前，需要先运行 UpgradeMsg5toMsg6.pl Perl 脚本（位于 msg_svr_base/sbin）。

UpgradeMsg5toMsg6.pl 将比较 5.2 配置文件和 6.0 配置文件，并为每个配置文件创建以下两个文件集：*.CHANGES 文件和 *.MERGED 文件。

将在工作区目录 /var/tmp/UpgradeMsg5toMsg6.ScratchDir 中生成 *.CHANGES 文件和 *.MERGED 文件。

*.CHANGES 文件显示了 Messaging Server 5.2 和 Messaging Server 6.0 之间的重要的配置文件差异。这些文件突出显示了仅在 Messaging Server 6.0 中发现的配置实体、来自 Messaging Server 5.2 但在 Messaging Server 6.0 中淘汰的配置实体以及仅在 Messaging Server 5.2 中发现的配置实体。请注意，并非所有 *.CHANGES 文件都会显示不同版本的配置文件之间的差异，而且并非所有配置文件都会生成 *.CHANGES 文件。

*.MERGED 文件合并了 Messaging Server 5.2 和 6.0 配置的值和设置。如果符合以下条件，通常 Messaging Server 6.0 版本将保留 Messaging Server 5.2 的配置参数值：

Messaging Server 6.0 版本中没有默认值，或

在 5.2 配置中指定的值不是默认设置。

表 4-1 生成 *.MERGED 或 *.CHANGES 文件的 Messaging Server 配置文件
配置信息	说明	生成 *.MERGED 文件	生成 *.CHANGES 文件
job_controller.cnf	作业控制程序文件	X	X
conversions	转换文件	X
channel_option（其中 channel 为 SMTP 通道）	SMTP 通道选项文件	X
native_option	本地通道选项文件（channel_option 除外）	X	X
channel_headers.opt（其中 channel 为 SMTP 通道）	标头选项文件	X
dispatcher.cnf	分发程序文件	X	X
imta_tailor	定制文件	X	X
option.dat	全局 MTA 选项文件	X	X
aliases	别名文件	X
imta.cnf	MTA 配置文件；仅更改了包含引用（如文件目录位置）。保留了 5.2 配置中的重写规则和通道设置。要在 imta.cnf 中包含 LMTP，请从 6.0 imta.cnf 文件中复制 LMTP 信息。	X	在某些实例中，可能会生成 *.CHANGES 文件。
mappings	映射文件	X
mappings.locale	本地化映射文件	X
internet.rules	Internet 规则配置文件	X
backup-groups.conf	备份组定义	X	X
configutil	对 local.conf 和 msg.conf 配置文件中的配置参数的更改。		X

运行 UpgradeMsg5toMsg6.pl Perl 脚本

要运行 UpgradeMsg5toMsg6.pl 以创建文件集（通过此文件集可以更新配置），请执行以下步骤：

如果 Messaging Server 5.2 和 6.0 版不在同一计算机上，将 Messaging Server 5.2 server-root 目录传送、解压缩并复制到 Messaging Server 6.0 系统。如果两个版本安装在同一计算机上，则可以跳过此步骤。

如果 Message Store 过大，无法从一个系统传送到另一个系统，则可以使用 umount (1M) 和 mount (1M) 命令将磁盘从 5.2 系统中卸载，再将它们安装到 6.0 系统中。



注	无需将 Messaging Server 5.2 存储数据复制到 Messaging Server 6.0 系统，但是必须确保在升级过程中可以存取 Messaging Server 5.2 存储数据。

5.2 和 6.0 系统此时均可以运行。

针对 5.2 版的 msg-instance 和 6.0 版的 msg_svr_base 运行 UpgradeMsg5toMsg6.pl 升级脚本（位于 msg_svr_base/sbin）。例如：

perl UpgradeMsg5toMsg6.pl /usr/sunone/server5/msg-budgie \
/opt/SUNWmsgsr

其中 /usr/sunone/server5/msg-budgie 为 5.2 版 Messaging Server 的 msg-instance，/opt/SUNWmsgsr 为 6.0 版 Messaging Server 的 msg_svr_base。



注	Messaging Server 6.0 不支持多个实例。如果具有 Messaging Server 5.2 版的多个实例，则只能选择一个实例升级到 Messaging Server 6.0。此外，多次运行升级实用程序以尝试迁移多个实例将导致覆写配置。

将创建 *.MERGED 和 *.CHANGES 文件（如表 4-1 中所述）。

请仔细查看 *.MERGED 文件；如果您不想使用建议的设置，则必须手动调整设置。

此实用程序无法更新 Messenger Express 定制文件。因此，需要手动更改这些文件，以保存来自 Messaging Server 5.2 的相关信息并添加来自 Messaging Server 6.0 安装的所有新信息。

运行升级实用程序

本节介绍了 do_the_upgrade.sh 实用程序（位于 /var/tmp/UpgradeMsg5toMsg6.ScratchDir），该实用程序是由四个子脚本组成的 shell 脚本。本节包含以下主题：

概述 (do_the_upgrade.sh)

MTA 配置 (make_mta_config_changes.sh)

configutil 参数 (make_configutil_changes.sh)

备份配置 (make_backup_config_changes.sh)

mboxlist 数据库 (make_mboxlistdb_changes.sh)

概述

do_the_upgrade.sh 实用程序由四个 shell 脚本组成，它使用 *.MERGED 文件更新 Messaging Server 6.0 系统中 MTA 配置的配置和文件目录位置、configutil 参数、备份参数以及 mboxlist 数据库。

您可以运行 do_the_upgrade.sh 实用程序，也可以单独运行组成 do_the_upgrade.sh 实用程序的一个或多个脚本（make_mta_config_changes.sh、make_configutil_changes.sh、make_backup_config_changes.sh 和 make_mboxlistdb_changes.sh）。


注	执行 do_the_upgrade.sh 实用程序或任何子脚本时，请确保 Messaging Server 5.2 或 6.0 均未启动和运行。

运行 do_the_upgrade.sh 脚本后，您可以继续引用 5.2 版分区路径（但您将无法删除 Messaging Server 5.2 server-root 目录），也可以将 5.2 版存储分区手动移动到相应的 Messaging Server 6.0 目录位置。您应该在重新启动 Messaging Server 之前执行此步骤。

MTA 配置

作为 do_the_upgrade.sh 实用程序组成部分的 MTA 升级配置子脚本称为 make_mta_config_changes.sh （位于 /var/tmp/UpgradeMsg5toMsg6.ScratchDir）。

make_mta_config_changes.sh 脚本对 *.MERGED 服务器配置文件进行备份、重命名并将它们移动到 Messaging Server 6.0 文件目录结构中的原始名称和位置。

完成重命名并移动文件后，此脚本将自动运行 imsimta cnbuild 命令重新编译 MTA 配置。

configutil 参数


注	如果希望将 MTA 中继计算机从 Messaging Server 5.2 升级到 Messaging Server 6.0，则只需运行 make_mta_config_changes.sh 和 make_backup_config_changes.sh（如备份配置所述）。

作为 do_the_upgrade.sh 实用程序组成部分的 configutil 升级配置子脚本称为 make_configutil_changes.sh 脚本（位于 /var/tmp/UpgradeMsg5toMsg6.ScratchDir 中）。

make_configutil_changes.sh 脚本包含 msg.conf 和 local.conf 文件中的新参数或更新参数。如果 Messaging Server 6.0 的 configutil 参数中未指定默认值，则所有 Messaging Server 5.2 中的值将在 Messaging Server 6.0 版中继续使用。

备份配置

作为 do_the_upgrade.sh 实用程序组成部分的备份升级配置子脚本称为 make_backup_config_changes.sh 脚本（位于 /var/tmp/UpgradeMsg5toMsg6.ScratchDir 中）。

make_backup_config_changes.sh 脚本升级备份服务（例如 backup-groups.conf 文件中的服务）的配置。

mboxlist 数据库

作为 do_the_upgrade.sh 实用程序组成部分的 mboxlist 数据库升级配置子脚本称为 make_mboxlistdb_changes.sh 脚本（位于 /var/tmp/UpgradeMsg5toMsg6.ScratchDir）。

make_mboxlistdb_changes.sh 脚本传送 5.2 版的 mboxlist 数据库并将其升级到 Messaging Server 6.0 目录结构。此脚本将四个 *.db 文件（folder.db、quota.db、peruser.db 和 subscr.db）从 Messaging Server 5.2 系统上的 server-root/msg-instance/store/mboxlist 复制到 Messaging Server 6.0 系统上的 msg_svr_base/data/store/mboxlist。

迁移用户邮箱

本节介绍了如何将用户邮箱从 Messaging Server 5.2 系统迁移到 Messaging Server 6.0 系统（可选）。如果 Messaging Server 5.2 和 6.0 安装在同一计算机上，则不必迁移用户邮箱。此外，如果可以继续访问存储用户邮箱的 5.2 计算机，则无需将用户邮箱迁移到 6.0 计算机。只有在对 Messaging Server 5.2 计算机不再具有访问权限的情况下，才需要迁移用户邮箱。

要以联机方式将用户邮箱数据从 Messaging Server 5.2 移动到 6.0，请执行本节中介绍的步骤。移动数据时无需关闭 Messaging Server。

要求

迁移说明

要求

迁移的唯一要求是存储的内容在旧的和新的邮件传送服务器上均可运行。

迁移说明

事先通知用户，在数据移动过程完成之前，他们将无法访问邮箱。请确保用户已在数据移动开始之前从其邮件系统注销。

将 5.2 邮件存储中所有用户条目的 mailUserStatus 用户 LDAP 属性从 active 更改为 hold，以将外来的用户邮件保留在保留队列中，并防止通过 IMAP、POP 和 HTTP 访问邮箱。

有关 mailUserStatus 的详细信息，请参见 Sun ONE Messaging Server Schema Reference Manual。

确保在此过程期间，5.2 和 6.0 Messaging Server 都已启动并正在运行。

将所有用户条目中的 mailHost 属性从旧邮件服务器更改为新邮件服务器。

要这样做，请使用以下 ldapsearch 命令查找需要修改其 mailHost 属性的用户条目：

ldapsearch -h ldap.siroe.com -b "o=internet" \ "(&(objectclass=maildomain)(mailHost=oldmail.siroe.com))"

然后使用 ldapmodify 命令将各个条目更改为相应的新邮件服务器。

有关 mailhost 的详细信息，请参见 Sun ONE Messaging Server Schema Reference Manual。

在旧系统中 (oldmail.siroe.com)，将用户条目分为均等的组（每行一个用户名）并放入用户文件中。

将用户数据从 Messaging 5.2 邮件存储移动到 Messaging Server 6.0 邮件存储中。您只需执行此步骤，如果：

您要从 Windows 迁移到 UNIX 或从 UNIX 迁移到 Windows。

您不想一次全部迁移整个邮件存储。

您需要重命名您的用户，包括 UID、域名和默认域更改。

成此步骤的方法如下：使用 imsbackup 实用程序备份 Messaging Server 5.2 邮件存储，然后使用 imsrestore 实用程序将邮件存储重新存储到 Messaging Server 6.0。

如果使用 imsbackup 和 imsrestore 实用程序进行迁移是所选的用来传送存储数据的方法，则分区路径不应被映射到 Messaging Server 5.2 分区，并且不应执行 mboxlist 升级步骤。由升级脚本生成的 make_configutil_changes.sh 脚本会自动将分区路径设置为映射到 Messaging Server 5.2 分区。这需要手动进行更改。此外，您不应运行 make_mboxlistdb_changes.sh 脚本。默认情况下，do_the_upgrade.sh 脚本会自动运行该脚本，因此必须手动删除该脚本。

有关 imsbackup 和 imsrestore 实用程序的语法和用法的详细信息，请参见 Sun ONE Messaging Server Reference Manual。

在 newmail.siroe.com 中运行以下命令：

rsh “ipaddress_of_oldmail.siroe.com /server-root/bin/msg/store/bin/imsbackup \
-f- -u user_file” | /opt/SUNWmsgsr/sbin/imsrestore -f- -cy -n -v1

其中 user_file 是包含用户邮箱名称的用户文件（如步骤 5 中所述）。

使用此用户文件运行多个并行的备份和恢复会话（10 至 15 个），以使重新存储到新邮件存储的速度最大化。

将 Messaging Server 6.0 设置为新的系统默认的邮件传送服务器。

将 oldmail.siroe.com 的 A 记录更改为指向 newmail.siroe.com（此服务器负责以前将 oldmail.siroe.com 作为主机的域）。

执行以下命令释放 Messaging Server 5.2 系统上保留队列中的邮件：

imsimta process_held -uid=user -domain=domain

其中 user 是用户 ID，domain 是用户所在的域。

确保用户客户机将指向新的邮件服务器。

升级完成后，通过用户的邮件客户机程序使用户指向新服务器（在此示例中，使用户从 oldmail.siroe.com 指向 newmail.siroe.com）。

或者使用 MMP，使用户无需将其客户机直接指向新邮件服务器。MMP 将从存储在 LDAP 用户条目中的 mailHost 属性中获取此信息，并自动将客户机重定向到新服务器。