18.4 在 Windows 上为驱动程序实例配置 Remote Loader

Remote Loader 可以托管 .dll、.so 或 .jar 文件中包含的 Identity Manager 应用程序 shim。为使 Remote Loader 能够运行，应用程序需要一个配置文件（例如 LDAPShim.txt）。Remote Loader 控制台实用程序（简称控制台）可帮助您管理 Windows 服务器上运行的所有 Identity Manager 驱动程序实例。您可以启动、停止、添加、去除和编辑 Remote Loader 的每个实例。Remote Loader 的安装程序也会安装控制台。

如果您要升级，控制台将检测并导入现有的驱动程序实例。要自动导入某个驱动程序，必须将其配置文件储存在 Remote Loader 目录中（默认为 c:\novell\remoteloader）。然后，就可以使用控制台管理远程驱动程序。

您可以使用命令行或 Remote Loader 控制台来配置 Remote Loader，以识别 Windows 上的驱动程序。有关使用命令行的详细信息，请参见部分 18.2, 了解 Remote Loader 的配置参数。

本节提供了以下活动的说明：

18.4.1 在 Windows 上的 Remote Loader 中创建新驱动程序实例

  1. 打开 Remote Loader 控制台。

    注：如果您在安装期间已选择创建控制台的快捷方式，请使用桌面上的 Identity Manager Remote Loader 控制台图标。否则，请运行默认位于 C:\novell\remoteloader\nnbit 中的 rlconsole.exe。

  2. 要在此服务器上添加驱动程序的实例，请单击添加。

  3. 在说明中，提供一个简短名称用于描述该实例。

    控制台将在配置文件的默认值中使用此信息。

  4. 对于驱动程序，请选择 Java 类名。

    注：要使用 Active Directory 驱动程序，请选择 ADDriver.dll。有关每个驱动程序的类名的详细信息，请参见了解 Java -class 参数的名称。

  5. 对于配置文件，请指定 Remote Loader 储存其配置参数的文件路径。默认值为 C:\novell\remoteloader\nnbit\Description-config.txt。

  6. 指定 Remote Loader 和驱动程序对象的口令。

  7. （可选）要在 Remote Loader 与 Identity Manager 引擎服务器之间使用 TLS/SSL 连接，请完成以下步骤：

    1. 选择使用 SSL 连接。

      注：NetIQ 建议在 Identity Manager 引擎服务器和 Remote Loader 上使用相同的 SSL 版本。如果服务器与 Remote Loader 上的 SSL 版本不匹配，服务器将返回“SSL3_GET_RECORD：错误的版本号”错误讯息。此讯息仅作警告之用，服务器与 Remote Loader 之间的通讯并不会中断。但是，该错误可能会让用户感到困惑。

    2. 对于可信根文件，请指定从 eDirectory 树的组织证书颁发机构导出的自我签名证书。有关详细信息，请参见部分 18.1, 创建与 Identity Manager 引擎的安全连接。

  8. （可选）要配置 Remote Loader 的跟踪文件，请完成以下步骤：

    注：NetIQ 建议仅将跟踪功能用于查错。启用跟踪会降低 Remote Loader 的性能。因此，请不要在生产环境中启用跟踪。

    1. 对于跟踪级别，请指定一个大于零的值，该值定义了您希望在跟踪窗口中显示的 Remote Loader 和驱动程序所发信息讯息的级别。控制台预定义的值为 1 到 4。要创建您自己的讯息类型，请指定值 5 或更高。

      最常用的设置是跟踪级别 3，它可以提供一般处理、XML 文档和 Remote Loader 讯息。

    2. 对于跟踪文件，请指定要将跟踪讯息记录到的文件路径。例如：C:\novell\remoteloader\64bit\Test-Delimited-Trace.log。

      必须为特定计算机上运行的每个驱动程序实例指定唯一的跟踪文件。仅在跟踪级别大于零时才将跟踪讯息写入跟踪文件中。

    3. 对于所有跟踪日志可用的最大磁盘空间 (Mb)，请指定此实例的跟踪文件可占用的最大磁盘空间的近似值。

  9. （可选）要在启动计算机时自动启动 Remote Loader，请选择为此驱动程序实例建立 Remote Loader 服务。

  10. （视情况而定）要修改 Java 配置的参数，请完成以下步骤：

    1. 选择高级。

    2. 对于类路径，请指定 JVM 要在其中搜索包 (.jar) 和类 (.class) 文件的路径。要指定多个路径，请使用冒号（适用于 UNIX 或 Linux JVM）或分号（适用于 Windows JVM）分隔这些路径。

      此参数的作用与 java -classpath 命令相同。

    3. 对于 JVM 选项，请指定在启动驱动程序的 JVM 实例时要使用的选项。

    4. 指定 JVM 实例的初始和最大堆大小（以 MB 为单位）。

    5. 单击确定。

  11. 单击“确定”。

18.4.2 在 Windows 上的 Remote Loader 中修改现有驱动程序实例

  1. 在 Remote Loader 控制台上，从说明列中选择驱动程序实例。

  2. 单击停止。

  3. 输入 Remote Loader 的口令，然后单击确定。

  4. 单击编辑。

  5. 修改配置信息。有关每个参数的详细信息，请参见在 Windows 上的 Remote Loader 中创建新驱动程序实例。

  6. 要保存更改，请单击确定。