使用 Notes® 单用户到多用户迁移辅助工具

使用此过程可将现有的 Notes® 单用户安装或模拟多用户安装转换为单一 Notes® 发行版中的真正 Notes® 多用户安装。迁移后，可以升级 Notes® 多用户客户机的发行版级别。

开始之前

  • 查看了解 Notes® 单用户到多用户迁移辅助工具主题中的信息。
  • 要运行工具，您必须以管理员身份登录到 Windows™ 以获得复制和移动数据的许可权。
  • 在运行工具之前，请考虑备份 Notes® 客户机。有关详细信息，请参阅本主题末尾链接中包含的备份和恢复 Notes® 客户机数据。
  • 验证用户是否对新的目标目录具有必需的读/写/删除许可权。

关于此任务

过程

  1. 退出 Notes® 应用程序；Notes® 在迁移期间无法运行。
  2. 在 Notes® 安装工具包中的 Utility 文件夹中查找文件 MUMigrationAssistant.vbs 和 MUMigrationAssistant.ini。
  3. 打开 MUMigrationAssistant.vbs 脚本并查看其嵌入文档。
  4. 在文本编辑器中打开 MUMigrationAssistant.ini 配置文件并指定以下值：
    选项描述
    CURRENTINIPATH （必需）指定当前 NOTES.INI 文件的位置。此工具从用户的 NOTES.INI 文件中获取用户的数据目录位置。
    NOTESPROGRAM （可选）指定用户的 notes.exe 文件的当前位置。如果未指定，该工具将尝试首先从 Windows 注册表（对于 Notes V8.5.x 和更早版本，HKLM/SOFTWARE/Notes/version/Path；对于 Notes 9.0 或更高版本，HKLM/SOFTWARE/Notes/Path）来确定位置，然后再尝试从用户的 NOTES.INI 文件来确定位置。
    MULTIUSERBASEDIR （可选）指定用户数据目录的目标位置。运行工具时，它将确认指定的目录是否存在，以及工具是否对该目录具有读/写许可权。该工具会附加 Notes\Data（对于 Notes® 9.0 之前的版本）或附加 HCL\Notes\Data（对于 Notes® 9.0 或更高版本）。设置此值时，必须在 MULTIUSERBASEDIR 中包含 %USERNAME%。如果未指定 MULTIUSERBASEDIR 的值，将使用缺省值 CSIDL_APPDATA。
    重要： 如果指定了此设置的值，那么还必须指定 MULTIUSERCOMMONDIR 的值。
    MULTIUSERCOMMONDIR 指定公共共享数据目录所在的位置。运行工具时，它将确认要移动其数据的用户是否对该目录具有读许可权。

    如果指定了值，那么工具将检查该值是否包含 %USERNAME% 环境变量。如果未指定 MULTIUSERCOMMONDIR 的值，将使用缺省值 CSIDL_COMMON_APPDATA。

    该工具会附加 Notes\Data（对于 Notes® 9.0 之前的版本）或附加 HCL\Notes\Data（对于 Notes® 9.0 或更高版本）。

    重要： 如果指定了此设置的值，那么还必须指定 MULTIUSERBASEDIR 的值。
    DRYRUN （可选）
    • True（缺省值）- 运行工具时，它将生成一个报告，其中列出运行工具所导致的更改，但不会执行迁移。
    • False - 运行工具时，它将执行迁移
    MIGRATE_REGISTRY
    • True - 工具将迁移 HKLM 注册表设置并为所有用户更新桌面快捷方式和开始菜单快捷方式。
    • False - 工具不会迁移注册表设置或更新快捷方式。

    从模拟多用户 Notes® 安装迁移时，可以在运行 cscript 命令时在命令提示符处指定此选项。

    MIGRATE_USER_REGISTRY
    • True - 工具将迁移注册表设置并仅为运行此工具的用户更新桌面快捷方式和开始菜单快捷方式。
    • False - 工具不会迁移注册表设置或更新快捷方式。

    从模拟多用户 Notes® 安装迁移时，可以在运行 cscript 命令时在命令提示符处指定此选项。

    MIGRATE_SHARED_DIR
    • True - 工具将迁移要在所有用户之间共享的公用数据文件。这些文件将在 Notes® 多用户安装期间安装到公用共享目录。
    • False - 工具不会迁移公用数据文件。

    如果有其他文件要移动，例如用户的模板，可以将这些模板列在一个文件中，并在下一个设置 MIGRATE_SHARED_FILES 中指定该位置。

    要定制所移动文件的目标位置，请使用 MULTIUSERCOMMONDIR 设置。

    从模拟多用户 Notes® 安装迁移时，可以在运行 cscript 命令时在命令提示符处指定此选项。

    MIGRATE_SHARED_FILES 指定用于列出要移至目标共享目录的其他文件的 migratefilelist.txt 文本文件的名称和位置，例如用户定义的模板或 Notes® 未安装的模板。

    要使用此设置，必须将上一个设置 MIGRATE_SHARED_DIR 的值设置为 True。

    从模拟多用户 Notes® 安装迁移时，可以在运行 cscript 命令时在命令提示符处指定此选项。

    MIGRATE_USERDATA_DIR 仅当将模拟多用户安装迁移到真正的多用户安装时使用此设置。
    • True - 工具将所有的用户个人数据文件（例如，用户的标识、模板和数据库）迁移到 MULTIUSERBASEDIR 设置指定的目录。对于每个用户，此值都应设置为 true。
    • False - 工具不会移动个人数据。

    工具从 NOTES.INI 文件确定源数据目录的位置，然后确认数据目录中存在每个要迁移的文件并且工具具有对这些文件执行操作的许可权。

    可以在启动组或 RunOnce 注册表键中创建一个批处理文件，用于在迁移后每个用户首次登录到 Windows 时，运行脚本为这些用户自动迁移数据。如果每个用户的源数据目录驻留在不同的驱动器上，那么必须为每个用户分别运行工具。

    如果没有为 MULTIUSERBASEDIR 设置任何值，那么数据将迁移到缺省用户数据路径指定的位置。对于 Notes® V8.5x 和更早版本，缺省路径为：C:\Documents and Settings\username\Local Settings\Application Data\Notes\Data；对于 Notes® 9.0 或更高版本，缺省路径为：C:\Documents and Settings\username\Local Settings\Application Data\HCL\Notes\Data.

    从模拟多用户 Notes® 安装迁移时，可以在运行 cscript 命令时在命令提示符处指定此选项。

  5. 保存并关闭 MUMigrationAssistant.ini 文件。
  6. 关闭 MUMigrationAssistant.vbs 脚本。
  7. 通过将配置文件中 DRYRUN 选项的值设置为 true，然后在命令提示符处输入以下内容来执行迁移测试运行： 
    cscript MUMigrationAssistant.vbs configuration_setting=value

    运行工具时，它将在验证配置文件中的设置后，再执行迁移。如果用于指定 notes.exe 和 notes.ini 文件位置的 NOTESPATH 和 CURRENTINIPATH 设置无效，迁移将停止：

    注： 如果命令行上指定的设置与配置文件中指定的设置之间发生冲突，那么命令行上指定的设置优先。
  8. 复查输出报告并确定是否需要调整任何 MUMigrationAssistant.ini 文件。如果需要，请立即调整。
  9. 通过将配置文件中 DRYRUN 选项的值设置为 false，然后在命令提示符处输入以下内容来执行迁移： 
    cscript MUMigrationAssistant.vbs configuration_setting=value

    将在共享数据目录中生成 NOTES.INI 文件。原始 NOTES.INI 文件将移动到 MULTIUSERBASEDIR 变量所指定的目录。新的数据目录将位于 MULTIUSERBASEDIR 变量指定的目录中，共享目录将是 MULTIUSERCOMMONDIR 变量指定的目录。

结果

工具将活动记录到 Install.log 文件，该文件驻留在安装用户的 My Documents 文件夹中以及迁移用户的数据目录中。

示例

示例：模拟多用户安装到（真正的）多用户安装
在此方案中，若干用户配置为在单个计算机上工作，而该计算机使用模拟多用户环境并且共享驱动器包含其公用和用户专有数据文件。
  • NOTES.INI 文件为 H:\data\notes.ini。
  • Notes® 安装程序 setup.exe 文件位于 C:\Program Files\HCL\Notes。
  • 用户的数据目录为 H:\data。
  • 共享数据目录为 C:\notes\common\Notes\data。
  • 位于从中运行迁移工具的目录中的 migratefilelist.txt 文件指定将移动以下更多文件：
    • H:\data\template1.ntf
    • H:\data\template2.ntf
    • H:\data\template3.ntf

根据适用的用例来迁移用户，如下所示：

用例 1 - 针对所有版本的 进行简单的单用户到多用户迁移 Notes®

在此用例中，Notes® 8.5.1 将以单用户方式安装，并且程序文件安装到 C:\Program Files\HCL\Notes，数据文件安装到 C:\Program Files\HCL\Notes\Data。

运行工具以执行以下操作：
  • 迁移注册表项以使其成为真正的多用户安装。
  • 将要由所有用户使用的通用文件迁移到 C:\Documents and Settings\AllUsers\Application Data\Notes\Data。
  • 将用户的数据文件和 NOTES.INI 迁移到 C:\Documents and Settings\username\Local Settings\Application Data\Notes\Data。

MUMigrationAssistant.ini 中的指定的值如下所示：

DRYRUN=true
CURRENTINIPATH=C:\Program Files\HCL\Notes\Data\notes.ini
NOTESPROGRAM=C:\Program Files\HCL\Notes
IS_SIMULATED_MODE=false
MIGRATE_REGISTRY=true
MIGRATE_USER_REGISTRY=true
MIGRATE_SHARED_DIR=true
MIGRATE_USERDATA_DIR=true
MULTIUSERCOMMONDIR= 
MULTIUSERBASEDIR=
注： 将 MULTIUSERBASEDIR 和 MULTIUSERCOMMONDIR 保留为空白可使用缺省值。

用例 2 - 模拟多用户到真正多用户迁移 - 首先运行工具以移动所有共享数据

在此用例中，Notes® 8.5.1 将以单用户方式安装，但每个用户的数据目录都将映射到网络驱动器。程序文件将安装到 C:\Program Files\HCL\Notes，数据文件安装到 H:\data。当所有用户的源数据目录均为本地目录或驻留在公共网络驱动器上时，可以运行工具将数据移至该 Notes® 客户机实例的所有用户的目标目录位置。

以管理员身份从有权访问用户映射数据驱动器的系统运行 MUMigrationAssistant，以便执行以下操作：
  • 转换 HKLM 注册表设置以指定真正的多用户安装。
  • 创建共享数据目录 C:\notes\common\Data
  • 将所有用户的公共文件迁移到共享目录。

MUMigrationAssistant.ini 中的指定的值如下所示：

DRYRUN=true
CURRENTINIPATH=H:\data\notes.ini
NOTESPROGRAM=C:\Program Files\HCL\Notes
IS_SIMULATED_MODE=true
MIGRATE_REGISTRY=true
MIGRATE_USER_REGISTRY=false
MIGRATE_SHARED_DIR=true
MIGRATE_USERDATA_DIR=false
MULTIUSERCOMMONDIR=C:\notes\common
MULTIUSERBASEDIR=H:\data

用例 3 - 模拟多用户到真正多用户迁移且在每个用户登录后运行工具以移动每个用户的数据

在此用例中，Notes® 8.5.1 将以单用户方式安装，但每个用户的数据目录都将驻留在映射的驱动器上。管理员已将 Notes® 客户机上的单用户设置迁移到多用户安装。（依据用例 2）。每个用户现在均登录到系统。

在用户登录时运行 MUMigrationAssistant 以执行以下操作：
  • 迁移该特定用户的 HKCU 注册表项。
  • 将用户数据从映射的驱动器移动到默认位置 C:\Documents and Settings\username\Local Settings\Application Data\Notes\Data。
MUMigrationAssistant.ini 中的指定的值如下所示：
DRYRUN=true
CURRENTINIPATH=H:\data\notes.ini
NOTESPROGRAM=C:\Program Files\HCL\Notes
IS_SIMULATED_MODE=true
MIGRATE_REGISTRY=false
MIGRATE_USER_REGISTRY=true
MIGRATE_SHARED_DIR=false
MIGRATE_USERDATA_DIR=true
MULTIUSERCOMMONDIR=C:\notes\common
MULTIUSERBASEDIR=
注： 将 MULTIUSERBASEDIR 保留为空表示使用其缺省值。