3.1 在 Windows 上升级

3.1.1 准备升级

可以将新的驱动程序 Shim 与现有驱动程序配置一起使用,但前提条件是驱动程序 Shim 和配置需包含最新的修复功能。 确保已查看了针对所用驱动程序版本的所有 TID 和产品更新。

3.1.2 将驱动程序 Shim 和配置从 1.x 升级到 Identity Manager 3

  1. 安装 Identity Manager 3 时,确保选择了用来安装实用程序的选项(默认设置)。 这将安装升级所必需的 movecfg.exe 实用程序,如Step 5 所述。 《Identity Manager 3.0 安装指南》的《在 Windows 上安装已连接系统选项》或《在 UNIX/Linux 上安装已连接系统选项》中提供了相关说明。

    还可以从 Identity_Manager_3_Linux_NW_Win.iso 上的 Utilities 目录或 Identity_Manager_3_Unix.iso 映像 CD 下载 movecfg.exe 文件。

  2. 可以在安装 Metadirectory 引擎的同时(或之后)安装升级的驱动程序 Shim。 要在之后安装驱动程序 Shim,请运行 Identity Manager 安装程序并选择 Identity Manager Driver for Notes(称为 Notes.xml)。 《Identity Manager 3.0 安装指南》的《安装 Identity Manager》中提供了相关说明。

    新驱动程序 Shim 将替换以前的驱动程序 Shim。

    IMPORTANT:不支持与以前版本的 Metadirectory 引擎一起运行新驱动程序。

  3. 使用向导将现有配置转换为 3.0 格式。 请参见《Identity Manager 3.0 安装指南》中的《升级》。

  4. 从 Domino 服务器控制台卸载所有 ndsrep 实例。

  5. 使用 movecfg.exe 实用程序可以升级配置参数的布局,如Section A.0, 使用 Movecfg.exe 实用程序中所述。

    可以使用批文件,如Section A.2, 要使用的示例批文件中提供的示例。

    如果在安装 Identity Manager 的过程中,选择用来安装实用程序的选项,则会将 movecfg.exe 实用程序安装到 \utilities 目录中。

    例如,在 Windows 上:

    C:\novell\nds\DirXMLUtilities
    

    IMPORTANT:如果有多个 ndsrep 实例,则必须使用 -ndsrep 参数为每个实例运行一次 movecfg.exe

  6. (仅限 Windows)复制以下文件:

    • ndsrep.exe 从其安装位置 (\novell\NDS) 手动复制到 Domino 服务器可执行文件夹 (\Lotus\Domino)。
    • dsrepcfg.ntf 从其安装位置 (\novell\NDS) 手动复制到 Domino 服务器数据文件夹 (\Lotus\Domino\Data)。

      在 Linux 和 Solaris 上,包安装将该文件放到 /usr/lib/dirxml/rules/notes 文件夹中,并在 /local/notesdata 文件夹中为其创建一个符号链接。

    • Notes.jar\Lotus\Domino 目录手动复制到 \Novell\nds\lib 目录,或者 \novell\remote\loader\lib 目录(如果运行远程装载程序)。

    以上操作对于产品升级和新版本是必需的。

  7. 如果以前修改了 Domino 服务器 notes.ini 文件的 ServerTasks 行以自动装载 ndsrep(如装载和控制 Ndsrep中所述),则必须以参数形式将实例名称(默认为驱动程序名称)添加到 ndsrep 中。

    例如:

    ServerTasks=Router,Replica,Update,Amgr,AdminP,maps, ndsrep notesdrv1,ndsrep notesdrv2
    

    如果有多个 ndsrep 实例,则必须对每个实例执行此操作。 如果驱动程序名称包含空格,则必须用引号将名称引起来。

    例如,如果驱动程序名称为 CN=Notes Driver,则 notes.ini 可能类似以下内容:

    ServerTasks=Router,Replica,Update,Amgr,AdminP,maps, ndsrep notesdrv1,ndsrep "Notes Driver"
    
  8. 重启动 ndsrep 或 Domino 服务器。

  9. 停止然后重启动 eDirectory™ 以及系统驱动程序,以使用新的驱动程序 Shim 文件。

    此时,即使您只将配置转换为 Identity Manager 3 格式而没有对其进行其它更改,驱动程序也应运行。

  10. 如果要更改驱动程序配置(例如,对多个证明者使用命名口令或全局配置值 (GCV)),可以执行相应操作。

    请参见Section 4.0, 自定义驱动程序

    NOTE:有关新参数和新功能(如命名口令)的示例,请查看样本驱动程序配置。

  11. 如果使用的是 Lotus Notes 6.0.3 且希望使用 AdminP 进程功能,则需要将名为《允许 Domino AdminP 支持》的驱动程序参数添加到订购者选项中来打开这些功能。

    例如:

    <allow-adminp-support display-name=”Allow Domino AdminP Support”>True</allow-adminp-support>
    

    请参见Section 4.4.2, 订购者选项中的 Allow Domino AdminP Support

  12. 考虑将名为《Notes - Return Email Address》(Notes - 返回电子邮件地址)的样本策略 (NotesReturnEmail.xml) 添加到驱动程序配置中,该配置位于订购者通道上的命令转换策略集中。

    当 Identity Vault 中的新用户与 Notes 同步时,可以使用该策略将 Notes 电子邮件地址写回 Identity Vault。 在 1.x 驱动程序版本中,此功能的执行方式有所不同。 如果要在 3.0 驱动程序版本中继续使用此功能,则必须使用新策略。

    请参见导入为新用户写回 Notes 电子邮件地址的策略

  13. 激活驱动程序。请参见Section 2.4.5, 激活驱动程序

  14. 完成更改后,重启动驱动程序。

导入为新用户写回 Notes 电子邮件地址的策略

使用该策略可为订购者通道上的用户添加事件生成电子邮件地址, 并为以前版本驱动程序中的功能提供向后兼容性。 在 1.x 驱动程序版本中,此功能的执行方式有所不同。

如果要在驱动程序配置升级到 3.0 版驱动程序后继续使用此功能,必须使用新策略。 (该策略始终是随驱动程序 2.1 版提供的样本配置的一部分。)

该策略提供的电子邮件地址的默认格式包含名、一个空格、姓氏以及导入策略时输入的域名。例如: Joe User@mydomain.com。可以在导入策略后对其进行编辑,以便根据需要自定义电子邮件地址的格式。

  1. 在 iManager 中,单击《Identity Manager 实用程序》>《导入驱动程序》

  2. 选择现有驱动程序所在的驱动程序集。

  3. 在显示的驱动程序配置列表中,向下滚动至《Additional Policies》(其它策略)标题,然后仅选择标有《Notes - 返回电子邮件地址》的项目。单击《下一步》

    将显示包含重要提示的列表。

  4. 选择现有驱动程序的名称。

  5. 指定要用作所生成电子邮件地址的后缀的域名。

    例如 mydomain.com。

  6. 单击《下一步》

    将显示包含以下讯息的页:《驱动程序集中已存在名为 your_driver_name 的驱动程序。 请选择下列选项之一。》

  7. 选择下列项目:

    • Update Only Selected Policies in That Driver(只更新该驱动程序中的选定策略)
    • Return Email Address (Subscriber - DirXML Script)(返回电子邮件地址(订购者 - DirXML 底稿))
  8. 单击《下一步》,然后单击《完成》以完成该向导。

    此时,即在驱动程序对象下创建了作为策略对象的新策略,但它还不是驱动程序配置的一部分。 要链接它,必须手动将其插入策略集中。

  9. 将新策略插入订购者通道上的命令转换策略集中。

    1. 单击 Identity Manager >《Identity Manager 概述》。 选择要更新的驱动程序所在的驱动程序集。

    2. 单击刚刚更新的驱动程序。 将打开一个页面,其中显示了驱动程序配置的图形表示形式。

    3. 单击订购者通道上的《命令转换》图标。

    4. 单击《插入》以添加新策略。 在显示的《插入》页中,单击《使用现有策略》,然后浏览并选择新策略对象。单击《确定》

    5. 如果策略集中包含多个策略,请使用箭头按钮 向上箭头图标 向下箭头图标 将新策略移到列表中正确的位置。

3.1.3 将驱动程序 Shim 和配置从 2.x 升级到 3.0

  1. 停止驱动程序。

  2. 安装新的驱动程序 Shim。

  3. 如果使用的是 Lotus Notes 6.0.3 或更高版本且希望使用 AdminP 进程功能,则需要将名为《允许 Domino AdminP 支持》的驱动程序参数添加到订购者选项中来打开这些功能。

    例如:

    <allow-adminp-support display-name=”Allow Domino AdminP Support”>True</allow-adminp-support>
    

    请参见Section 4.4.2, 订购者选项中的 Allow Domino AdminP Support

  4. 考虑将名为《NDSREP 控制台跟踪级别》的发布者选项驱动程序参数添加到驱动程序配置中。 请参见Section 4.4.3, 发布者选项中的 NDSREP Console Trace Level

  5. 有关可能对驱动程序配置有用的其它新驱动程序配置参数,请参见Section 4.0, 自定义驱动程序

  6. 完成更改后,重启动驱动程序。