20.2 了解 Remote Loader 的配置参数

（可选）以字符串格式指定简短说明（例如 SAP），应用程序将在跟踪窗口的标题中使用该说明，并将其用于审计日志记录。例如：

-description SAP

-desc SAP

（视情况而定）使用 Java 驱动程序时，指定要托管的 Identity Manager 应用程序 shim 的 Java 类名。此选项将告知应用程序使用 Java 密钥存储区来读取证书。例如：

-class com.novell.nds.dirxml.driver.ldap.LDAPDriverShim -cl com.novell.nds.dirxml.driver.ldap.LDAPDriverShim

指定驱动程序实例用于控制用途的 TCP/IP 端口。例如：-commandport 8001 或 -cp 8001。默认值是 8000。

要在同一个服务器上将多个驱动程序实例与 Remote Loader 配合使用，请为每个实例指定不同的连接端口和命令端口。

如果驱动程序实例要托管应用程序 shim，则命令端口将是另一个实例与托管 shim 的实例进行通讯的端口。如果驱动程序实例要将命令发送到托管应用程序 shim 的实例，则命令端口将是托管实例所要侦听的端口。

如果要从命令行将此参数发送到托管应用程序 shim 的实例，则命令端口表示托管实例所要侦听的端口。您可以在 Remote Loader 运行时发送此命令。

指定驱动程序实例的配置文件。例如：

-config config.txt

配置文件可以包含除 -config 以外的任意命令行选项。在命令行中指定的选项将覆盖配置文件中指定的选项。

您可以在 Remote Loader 运行时发送此命令。

指定用于连接到托管 Identity Manager 引擎并运行 Identity Manager 远程接口 shim 的服务器的设置。默认连接方法为使用 SSL 的 TCP/IP。

要在同一个服务器上将多个驱动程序实例与 Remote Loader 配合使用，请为每个实例指定不同的连接端口和命令端口。

使用以下语法输入连接字符串：

-connection "parameter parameter parameter"

例如：

-connection "port=8091 fromaddress=198.51.100.0 rootfile=server1.pem keystore=ca.pem localaddress=198.51.100.0 hostname=198.51.100.0 kmo=remote driver cert"

使用以下参数指定 TCP/IP 连接的设置：

指定 Remote Loader 使用的数据文件所在的目录。例如：

-datadir /var/opt/novell/dirxml/rdxml/data

如果您使用此命令，rdxml 进程会将其当前目录更改为指定的目录。将在此数据目录中创建不含明确的指定路径的跟踪文件和其他文件。

指示应用程序显示帮助。

（视情况而定）指定您想要为 Java 驱动程序 shim 实例设置口令。

指示实例在指定的端口上启用 Java 调试。例如：

-javadebugport 8080

在开发 Identity Manager 应用程序 shim 时请使用此命令。您可以在 Remote Loader 运行时发送此命令。

指定 Java 环境的参数。使用以下语法输入 Java 环境参数：

-javaparam parameter
-jp parameter
-jp parameter

要为单个参数指定多个值，请将该参数括在引号中。例如：

-javaparam DHOST_JVM_MAX_HEAP=512M
-jp DHOST_JVM_MAX_HEAP=512M
-jp "DHOST_JVM_OPTIONS=-Dfile.encoding=utf-8 -Duser.language=en"

使用以下参数设置 Java 环境：

（视情况而定）使用本机驱动器时，请指定包含要托管的 Identity Manager 应用程序 shim 的模块。此选项将告知应用程序使用 rootfile 证书。例如，对于本机驱动程序，请键入以下内容之一：

-module "c:\Novell\RemoteLoader\ADDriver.dll"
-m "c:\Novell\RemoteLoader\ADDriver.dll"

或者

-module "usr/lib/dirxml/NISDriverShim.so"
-m "usr/lib/dirxml/NISDriverShim.so"

当所发出命令会更改设置或影响实例操作时，请指定驱动程序实例的口令。您为所要发出命令的实例指定的口令必须与使用 setpasswords 指定的第一个口令相同。例如：

-password netiq4

如果您在发出命令时未发送该口令，驱动程序实例将提示您提供该口令。

您可以在 Remote Loader 运行时发送此命令。

指定 Remote Loader 进程使用的进程 ID 文件 (pidfile) 所在目录的路径。例如：

-piddir /var/opt/novell/dirxml/rdxml/data

pidfile 主要供 SysV-style init 脚本使用。默认值为 /var/run。另外，如果 Remote Loader 由权限不足的用户（无法打开 pidfile 以在 /var/run 中进行读取和写入）运行，那么，默认值将是当前目录。

此参数类似于 -datadir。

（仅限 Windows）指定是否要将某个实例配置为 Windows 计算机上的 Win32 服务。有效值为 install 和 uninstall，以及托管应用程序 shim 所需的其他参数。例如，您必须包含 -module，还可能需要包含 -commandport 和连接设置。

此命令只会安装或卸装用作服务的实例，而不会启动该服务。

您可以在 Remote Loader 运行时发送此命令。但是，您不能在 rdxml 或 Java Remote Loader 上使用此命令。

指定驱动程序实例的口令，以及与 Remote Loader 通讯的远程接口 shim 的 Identity Manager 驱动程序对象口令。

您不需要指定口令，Remote Loader 会提示您输入口令。但是，如果指定了 Remote Loader 的口令，则也必须指定与 Identity Manager 引擎服务器上远程接口 shim 关联的 Identity Manager 驱动程序对象的口令。要指定该口令，请使用以下语法：

-setpasswords Remote_Loader_password driver_object_password

例如：

-setpasswords netiq4 idmobject6

（视情况而定）在托管 Identity Manager 应用程序 shim 时，请为包含 Remote Loader 和此实例的驱动程序发来的信息讯息的跟踪文件指定设置。

在配置文件中添加以下参数：

指示卸载驱动程序实例。如果远程装载程序运行为 Win32 服务，则此命令将停止该服务。

您可以在 Remote Loader 运行时发送此命令。

（仅限 Windows）指示应用程序在 Windows 计算机上打开或关闭某个驱动程序实例的跟踪窗口。有效值为 on 和 off。例如：

-window on

您可以在 Remote Loader 运行时发送此命令。您不能在 Java Remote Loader 上使用此命令。

（仅限 Windows）在 Windows 计算机上起动 Remote Loader 的配置向导。也可以通过运行不带命令行参数的 dirxml_remote.exe 来起动该向导。

如果您运行此命令并指定了配置文件（-config 选项），向导将使用配置文件中的值启动。您可以使用该向导更改配置，而无需直接编辑配置文件。例如：

-wizard -config config.txt

您不能在 Java Remote Loader 上使用此命令。