下表中的选项允许您配置远程装载程序。
表 B-1 远程装载程序选项
选项 |
别名 |
参数 |
说明 |
---|---|---|---|
address |
|
IP 地址 |
可选参数。 指定远程装载程序监听特定本地 IP 地址。 如果托管远程装载程序的服务器有多个 IP 地址,但远程装载程序只能监听其中一个地址时,这个参数将非常有用。 可以选择以下三项操作之一: address=地址号 address=’localhost’ 不使用此参数。 如果不使用 -address,则远程装载程序将监听所有本地 IP 地址。 示例: address=137.65.134.83 |
-class |
-cl |
Java 类名 |
指定被托管的 Identity Manager 应用程序 Shim 的 Java 类名称。 例如,对于 Java 驱动程序,键入以下内容之一: -class com.novell.nds.dirxml.driver.ldap.LDAPDriverShim -cl com.novell.nds.dirxml.driver.ldap.LDAPDriverShim Java 使用密钥存储区读取证书。 -class 选项和 -module 选项互相排斥。 若要查看 Java 类名列表,请参见表 B-2。 |
-commandport |
-cp |
端口号 |
指定远程装载程序实例进行控制时使用的 TCP/IP 端口。 如果远程装载程序实例要托管应用程序 Shim,则命令端口将是其它远程装载程序实例与托管 Shim 的实例通信的端口。 如果远程装载程序实例要将命令发送至托管应用程序 Shim 的实例,则命令端口将是托管实例监听的端口。 如果没有指定命令端口,则默认端口为 8000。通过指定不同的连接端口和命令端口,远程装载程序的多个实例可以在托管不同驱动程序实例的同一台服务器上运行。 示例: -commandport 8001 -cp 8001 |
-config |
无 |
文件名 |
指定配置文件。 配置文件可以包含除 config 之外的任意命令行选项。 命令行中指定的选项将覆盖配置文件中指定的选项。 示例: -config config.txt |
-connection |
-conn |
连接配置字符串 |
为运行 Identity Manager 远程接口 Shim 的 Metadirectory 服务器的连接指定连接参数。 远程装载程序的默认连接方式为使用 SSL 的 TCP/IP。 此连接的默认 TCP/IP 端口是 8090。远程装载程序的多个实例可以在同一台服务器上运行。 远程装载程序的每个实例都托管一个单独的 Identity Manager 应用程序 Shim 实例。 通过为每个远程装载程序实例指定不同的连接端口和命令端口,可以区分远程装载程序的多个实例。 示例: -connection "port=8091 rootfile=server1.pem" -conn "port=8091 rootfile=server1.pem" |
-description |
-desc |
简短说明 |
指定要用于跟踪窗口标题和 Novell® Audit 记录的简短描述字符串(例如 SAP)。 示例: -description SAP -desc SAP 远程装载程序控制台在配置文件中使用长格式。 可以使用长格式(例如 -description)或者短格式(例如 -desc)。 |
-help |
-? |
无 |
显示帮助。 示例: -help -? |
-java |
-j |
无 |
指定要为 Java Shim 实例设置口令。 此选项仅在与 setpasswords 选项一起使用时才有用。 如果与 -setpasswords 一起指定了 -class,则无需使用此选项。 |
-javadebugport |
-jdp |
端口号 |
指定该远程装载程序实例将会在指定端口启用 Java 调试。 此选项对 Identity Manager 应用程序 Shim 的开发者很有用。 示例: -javadebugport 8080 -jdp 8080 |
密钥存储区 |
|
|
条件性参数。 仅用于 .jar 文件中包含的 Identity Manager 应用程序 Shim。 指定 Java 密钥存储区文件名,密钥存储区中包含远程接口 Shim 所使用证书的颁发者的可信根证书。 这通常是托管远程接口 Shim 的 eDirectory™ 树的证书授权者。 如果要运行 SSL 并需要远程装载程序与 Java 驱动程序通讯,请键入键值对: keystore='keystorename' storepass='password' |
-module |
-m |
模块名 |
指定包含被托管的 Identity Manager 应用程序 Shim 的模块。 例如,对于本机驱动程序,请键入以下内容之一: -module "c:\Novell\RemoteLoader\Exchange5Shim.dll" -m "c:\Novell\RemoteLoader\Exchange5Shim.dll" 或者 -module "usr/lib/dirxml/NISDriverShim.so" -m "usr/lib/dirxml/NISDriverShim.so" -module 选项使用 rootfile 证书。 -module 选项和 -class 选项互相排斥。 |
-password |
-p |
口令 |
指定用于命令鉴定的口令。 通过 setpasswords 为命令所针对的装载程序实例指定的第一个口令必须与此口令相同。 如果指定了某一命令选项(例如,unload 或 tracechange),而未指定 password 选项,系统将提示用户输入作为命令目标的装载程序的口令。 示例: -password novell4 -p novell4 |
端口 |
|
十进制端口号 |
必需参数。 它指定远程装载程序监听与远程接口 Shim 的连接所使用的 TCP/IP 端口。 示例: port=8090 |
rootfile |
|
|
条件性参数。 如果要运行 SSL 并需要远程装载程序与本机驱动程序通讯,请键入 rootfile='trusted certname' |
-service |
-serv |
无、或安装/未安装 |
若要将实例安装为服务,请使用安装自变量以及任何其它托管应用程序 Shim 所必需的自变量。 例如,使用的自变量必须包括 -module,但是任何自变量都可以包括 -connection、‑commandport 等。 此选项将安装 Win32 服务但不会启动此服务。 若要卸装运行为服务的实例,请使用卸装自变量以及任何其它托管应用程序 Shim 所必需的自变量。 此选项的无自变量版本仅用在运行为 Win32 服务的实例的命令行中。 将实例安装为服务时,将自动设置此选项。 示例: -service install -serv uninstall 此选项不适用于 rdxml 或 Java 远程装载程序。 |
-setpasswords |
-sp |
口令 口令 |
指定远程装载程序实例口令、与此远程装载程序通讯的远程接口 Shim 的 Identity Manager 驱动程序对象口令。 自变量中的第一个口令是远程装载程序的口令。 可选自变量中的第二个口令是与 Metadirectory 服务器上远程接口 Shim 关联的 Identity Manager 驱动程序对象的口令。 可以不指定口令,但如果指定,则必须同时指定两个口令。 如果未指定口令,则远程装载程序将提示输入口令。 这是一个配置选项。 使用此选项可配置具有指定口令的远程装载程序实例,但不会加载 Identity Manager 应用程序 Shim 或与其它装载程序实例通讯。 示例: -setpasswords novell4 staccato3 -sp novell4 staccato3 |
-storepass |
|
存储区口令 |
仅用于 .jar 文件中包含的 Identity Manager 应用程序 Shim。 指定由 keystore 参数指定的 Java 密钥存储区口令。 示例: storepass=mypassword 此选项仅应用于 Java 远程装载程序。 |
-trace |
-t |
整数 |
指定跟踪级别。 仅当托管应用程序 Shim 时才可使用此选项。 跟踪级别与 Metadirectory 服务器中使用的级别相对应。 示例: -trace 3 -t 3 |
-tracechange |
-tc |
整数 |
支配将托管应用程序 Shim 的远程装载程序实例以更改其跟踪级别。 跟踪级别与 Metadirectory 服务器中使用的级别相对应。 示例: -tracechange 1 -tc 1 |
-tracefile |
-tf |
文件名 |
指定要写入跟踪讯息的文件。 如果跟踪级别大于 0,则将跟踪讯息写入此文件。 即使未打开跟踪窗口,也可将跟踪讯息写入此文件。 示例: -tracefile c:\temp\trace.txt -tf c:\temp\trace.txt |
-tracefilechange |
-tfc |
无,或文件名 |
支配将托管应用程序 Shim 的远程装载程序实例,以便开始使用跟踪文件,或关闭已使用的跟踪文件并使用一个新跟踪文件。 使用此选项的无自变量版本将导致托管实例关闭正在使用的任何跟踪文件。 示例: -tracefilechange c:\temp\newtrace.txt tfc c:\temp\newtrace.txt |
-tracefilemax |
-tfm |
大小 |
指定跟踪文件数据可占用的最大磁盘空间(近似值)。 如果指定此选项,将有一个由 tracefile 选项指定其名称的跟踪文件,以及最多 9 个附加的“翻转”文件。 翻转文件以其主跟踪文件的文件名作为基本名,后跟“_n”,其中 n 为从 1 到 9 的数字。 大小参数为字节数。 可使用后缀 K、M 或 G 来指定大小,它们分别代表 KB、MB 或 GB。 如果启动远程装载程序时跟踪文件数据大于指定的最大值,则在所有 10 个文件都完成翻转之前,跟踪文件数据都将大于指定的最大值 示例: -tracefilemax 1000M -tfm 1000M 在此示例中,跟踪文件仅为 1 GB。 |
-unload |
-u |
无 |
卸载远程装载程序实例。 如果远程装载程序运行为 Win32 服务,则此命令将停止该服务。 示例: -unload -u |
-window |
-w |
打开/关闭 |
在远程装载程序实例中打开或关闭跟踪窗口。 示例: -window on -w off 此选项仅适用于 Windows 平台。 不适用于 Java 远程装载程序。 |
-wizard |
-wiz |
无 |
启动“配置向导”。 运行不带有命令行参数的 dirxml_remote.exe 也可以启动此向导。 如果还指定了配置文件,此选项会很有用。 在这种情况下,向导启动时将使用配置文件中的值,并可使用向导更改配置,而无需直接编辑配置文件。 示例: -wizard -wiz 此选项仅适用于 Windows 平台。 不适用于 Java 远程装载程序。 |
表 B-2 Java 类名