18.2 了解 Remote Loader 的配置参数

您可以在命令行或配置文件中配置驱动程序实例。NetIQ 提供了 config8000.txt 示例文件，可帮助您配置要与应用程序 shim 配合使用的 Remote Loader 和驱动程序。默认情况下，该示例文件位于 /opt/novell/dirxml/doc 目录中。例如，该配置文件可能包含以下行：

-commandport 8000
-connection "port=8090 rootfile=/dirxmlremote/root.pem"
-module $DXML_HOME/dirxmlremote/libcskeldrv.so.0.0.0
-trace 3

请使用以下参数：

-description value (-desc value)

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

-description SAP

-desc SAP

-class name (-cl name)

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

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

注：

• 如果指定了 -module 选项，则不能使用上述选项。

• 如果使用制表符字符作为 -class 选项中的分隔符，Remote Loader 将不会自动启动，而必须由您手动启动。要让 Remote Loader 正常启动，您可以使用空格字符而不要使用制表符。

• 有关可为此选项指定的名称的详细信息，请参见了解 Java -class 参数的名称。

-commandport port_number (-cp port_number)

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

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

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

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

-config filename

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

-config config.txt

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

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

-connection “parameters” (-conn “parameters”)

指定用于连接到托管 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 连接的设置：

address=IP_address

（可选）指定 Remote Loader 是否侦听特定的本地 IP 地址。如果托管 Remote Loader 的服务器有多个 IP 地址，但 Remote Loader 只能监听其中一个地址时，这个参数将非常有用。以下值为有效值：

• address=address number

• address='localhost'

例如：

address=198.51.100.0

如果您未指定值，Remote Loader 将侦听所有本地 IP 地址。

fromaddress=IP_address

指定 Remote Loader 接受连接的来源服务器。应用程序将忽略来自其他地址的连接。指定服务器的 IP 地址或 DNS 名称。例如：

fromaddress=198.51.100.0

fromaddress=testserver1.company.com

handshaketimeout=milliseconds

（视情况而定）当来自 Identity Manager 引擎的其他有效连接发生握手超时适用。为 Remote Loader 与 Identity Manager 引擎之间的握手指定超时期限，以毫秒为单位。例如：

handshaketimeout=1000

您可以指定大于或等于零的整数。零表示连接永不超时。默认值为 1000 毫秒。

hostname=server

指定要在其上运行 Remote Loader 的服务器的 IP 地址或名称。例如：

hostname=198.51.100.0

keystore=filename

（视情况而定）当 .jar 文件中包含 Identity Manager 应用程序 shim 时适用。指定 Java 密钥存储区的文件名，该密钥存储区包含远程接口 shim 所用证书的颁发者的可信根证书。例如：

keystore=ca.pem

通常，您可指定托管远程接口 shim 的树的证书颁发机构。

kmo=name

指定包含用于 SSL 连接的密钥和证书的密钥材料对象的密钥名称。例如：

kmo=remote driver cert

localaddress=IP_address

指定要将客户端连接套接字绑定到的 IP 地址。例如：

localaddress=198.51.100.0

port=port_number

指定 Remote Loader 将用于监听来自远程接口 shim 的连接的 TCP/IP 端口。要指定默认端口，请输入 port=8090。

rootfile=trusted certname

（视情况而定）仅当您使用 SSL 并且希望 Remote Loader 与本机驱动程序通讯时才适用。指定包含远程接口 shim 所用证书颁发者的可信根证书的文件。该证书文件的格式必须是 Base 64 (PEM)。例如：

rootfile=server1.pem

通常，该文件是托管远程接口 shim 的树的证书颁发机构。

storepass=password

（视情况而定）仅当 .jar 文件中包含 Identity Manager 应用程序 shim 时，才对 Java Remote Loader 适用。指定您为 keystore 参数输入的 Java 密钥存储区的口令。例如：

storepass=mypassword

注：如果您要使用 SSL 并希望 Remote Loader 与 Java 驱动程序通讯，请使用以下语法指定键值对：

keystore=keystorename storepass=password

-datadir directory (-dd directory)

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

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

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

-help (-h)

指示应用程序显示帮助。

-java (-j)

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

注：如果您未同时指定 -class 值，请将此选项与 -setpasswords 选项结合使用。

-javadebugport port_number (-jdp port_number)

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

-javadebugport 8080

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

-javaparam parameters (-jp parameters)

指定 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 环境：

DHOST_JVM_ADD_CLASSPATH

指定 JVM 要在其中搜索包 (.jar) 和类 (.class) 文件的其他路径。要为 UNIX 或 Linux JVM 指定多个类路径，请在路径之间插入冒号分隔。对于 Windows JVM，请使用分号。

DHOST_JVM_INITIAL_HEAP

以十进制字节数指定初始（最小）JVM 堆大小。使用数字值后跟表示字节类型的 G、M 或 K。例如：

100M

如果您未指定字节类型，大小默认以字节为单位。使用此参数的效果与使用 Java -Xms 命令相同。

此参数优先于驱动程序集属性选项。增加初始堆大小可以减少启动时间并提高吞吐量性能。

DHOST_JVM_MAX_HEAP

以十进制字节数指定最大 JVM 堆大小。使用数字值后跟表示字节类型的 G、M 或 K。例如：

100M

如果您未指定字节类型，大小默认以字节为单位。

此参数优先于驱动程序集属性选项。

DHOST_JVM_OPTION

指定在启动驱动程序的 JVM 实例时要使用的自变量。请使用空格来分隔各选项字符串。例如：

-Xnoagent -Xdebug -Xrunjdwp: transport=dt_socket,server=y, address=8000

驱动程序集属性选项优先于此参数。此环境变量附加在驱动程序集属性选项的末尾。有关有效选项的详细信息，请参见 JVM 文档。

-module “name” (-m “name”)

（视情况而定）使用本机驱动器时，请指定包含要托管的 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"

注：

• 如果指定了 -class 选项，则不能使用上述选项。

• 如果使用制表符字符作为 -module 选项中的分隔符，Remote Loader 将不会自动启动，而必须由您手动启动。要让 Remote Loader 正常启动，您可以使用空格字符而不要使用制表符。

-password value (-p value)

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

-password netiq4

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

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

-piddir directory (-pd directory)

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

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

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

此参数类似于 -datadir。

-service value (-serv value)

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

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

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

-setpasswords Remote_Loader_pwd optional_pwd (-sp Remote_Loader_pwd optional_pwd)

指定驱动程序实例的口令，以及与 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 或与其他实例通讯。

跟踪文件设置

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

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

-trace integer (-t integer)

指定要在跟踪窗口中显示的讯息级别。例如：

-trace 3

Remote Loader 的跟踪级别对应于托管 Identity Manager 引擎的服务器上使用的级别。

-tracefile filepath (-tf filepath)

指定要将跟踪讯息记录到的文件的路径。必须为特定计算机上运行的每个驱动程序实例指定唯一的跟踪文件。例如：

-tracefile c:\temp\trace.txt

如果 -trace 参数大于零，应用程序会将讯息写入该文件。无需打开跟踪窗口就能将讯息写入该文件。

-tracefilemax size (-tf size)

指定此实例的跟踪文件大小限制。请使用字节类型的缩写指定以 KB、MB 或 GB 为单位的值。例如：

• -tracefilemax 1000K

• -tf 100M

• -tf 10G

注：

• 如果启动远程装载程序时跟踪文件数据大于指定的最大值，则在所有 10 个文件都完成翻转之前，跟踪文件数据都将大于指定的最大值。

• 将此选项添加到配置文件后，应用程序将为跟踪文件使用指定的名称，并最多包含 9 个“滚动更新”文件。滚动更新文件以其主跟踪文件的名称作为基本名，后跟 _n，其中 n 为从 1 到 9 的数字。

-tracechange integer (-tc integer)

（视情况而定）当某个现有驱动程序实例托管了应用程序 shim 时，指定新的信息讯息级别。跟踪级别与 Identity Manager 服务器上使用的级别相对应。例如：

-trace 3

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

-tracefilechange filepath (-tfc filepath)

（视情况而定）当某个现有驱动程序实例托管了应用程序 shim 时，指示该实例使用跟踪文件还是关闭已使用的文件而改用此新文件。例如：

-tracefilechange \temp\newtrace.txt

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

-unload (-u)

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

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

-window value (-w) value

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

-window on

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

-wizard (-wiz)

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

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

-wizard -config config.txt

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

当您使用 -class 参数配置 Remote Loader 和 Java Remote Loader 的驱动程序实例时，必须指定要托管的 Identity Manager 应用程序 shim 的 Java 类名。