下表中的選項可讓您設定「遠端載入器」的組態。
表 B-1 遠端載入器選項
|
選項 |
次要名稱 |
參數 |
描述 |
|---|---|---|---|
|
address |
|
IP address |
選擇性參數。 指定「遠端載入器」在特定本地 IP 位址上監聽。 如果代管「遠端載入器」的伺服器具有多個 IP 位址，並且「遠端載入器」必須僅在其中一個位址上監聽，此選項便很有用處。 有三個選項： address=address number address=’localhost’ Don't use this parameter. 如果不使用 -address，則「遠端載入器」會在所有本地 IP 位址上監聽。 範例： address=137.65.134.83 |
|
-class |
-cl |
Java class name |
指定要裝載之 Identity Manager 應用程式 Shim 的 Java 類別名稱。 例如，針對 Java 驅動程式，輸入下列其中一項： -class com.novell.nds.dirxml.driver.ldap.LDAPDriverShim -cl com.novell.nds.dirxml.driver.ldap.LDAPDriverShim Java 會使用 KeyStore 來讀取證書。 -class 選項與 -module 選項互斥。 若要查看 Java 類別名稱的清單，請參閱表 B-2。 |
|
-commandport |
-cp |
port number |
指定「遠端載入器」例項用於控制的 TCP/IP 連接埠。 如果「遠端載入器」例項正在裝載應用程式 Shim，則指令連接埠是另一個「遠端載入器」例項與裝載 Shim 之例項進行通訊的連接埠。 如果「遠端載入器」例項正在將指令傳送至裝載應用程式 Shim 的例項，則指令連接埠是裝載例項正在其上監聽的連接埠。 如果未指定，則預設指令連接埠為 8000。藉由指定不同的連接埠和指令連接埠，「遠端載入器」的多個例項可以在裝載不同驅動程式例項的同一伺服器上執行。 範例： -commandport 8001 -cp 8001 |
|
-config |
無 |
filename |
指定組態檔案。 組態檔案可以包含除 config 之外的任何指令行選項。在指令行上指定的選項會置換組態檔案中指定的選項。 範例： -config config.txt |
|
-connection |
-conn |
connection configuration string |
指定用於連接執行 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 |
short description |
指定要用於追蹤視窗標題和 Novell® Audit 記錄的簡短描述字串 (例如 SAP)。 範例： -description SAP -desc SAP 「遠端載入器主控台」在組態檔案中使用的是完整格式。 您可以使用完整格式 (例如 -description) 或簡短格式 (例如 -desc)。 |
|
-help |
-? |
無 |
顯示說明。 範例： -help -? |
|
-java |
-j |
無 |
指定要為 Java Shim 例項設定密碼。 只有在與 setpasswords 選項一起使用時，此選項才有用處。 如果指定 -class 的同時也指定了 –setpasswords，則不需要此選項。 |
|
-javadebugport |
-jdp |
Port number |
指定「遠端載入器」例項要在指定的連接埠上啟用 Java 除錯。 此選項對於 Identity Manager 應用程式 Shim 的開發人員而言很有用處。 範例： -javadebugport 8080 -jdp 8080 |
|
keystore |
|
|
條件參數。 僅用於 .jar 檔案中包含的 Identity Manager 應用程式 Shim。 指定 Java KeyStore 的檔名，該 Java KeyStore 包含遠端介面 Shim 使用之證書發證者的託管根部證書。 這通常是裝載遠端介面 Shim 之 eDirectory™ 網路樹的「證書權限」。 如果您正在執行保全插槽層 (SSL)，並需要「遠端載入器」來與 Java 驅動程式通訊，請輸入鍵值配對： keystore='keystorename' storepass='password' |
|
-module |
-m |
modulename |
指定包含要裝載之 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 選項會使用根部檔案證書。 -module 選項與 -class 選項互斥。 |
|
-password |
-p |
password |
指定用於指令驗證的密碼。 此密碼必須與第一個密碼 (即使用 setpasswords 對接受指令之載入器例項指定的密碼) 相同。 如果已指定指令選項 (例如 unload 或 tracechange)，但未指定 password 選項，則會提示使用者輸入指令的目標載入器密碼。 範例： -password novell4 -p novell4 |
|
port |
|
decimal port number |
必要的參數。 它會指定 TCP/IP 連接埠，「遠端載入器」會在該連接埠上監聽遠端介面 Shim 的連接。 範例： port=8090 |
|
rootfile |
|
|
條件參數。 如果您正在執行保全插槽層 (SSL)，並需要「遠端載入器」來與原生驅動程式通訊，請輸入 rootfile='trusted certname' |
|
-service |
-serv |
無或 install/uninstall |
若要安裝例項做為服務，請將 install 引數與裝載應用程式 Shim 所需的任何其他引數搭配使用。 例如，所使用的引數必須包含 -module，但是任何引數都可以包含 -connection、‑commandport 等等。 此選項會安裝 Win32 服務，但是不會啟動該服務。 若要解除安裝做為服務執行的例項，請將 uninstall 引數與裝載應用程式 Shim 所需的任何其他引數搭配使用。 僅針對做為 Win32 服務執行的例項，才會在指令行上使用此選項的無引數版本。 安裝例項做為服務時，會自動進行設定。 範例： -service install -serv uninstall 在 rdxml 或「Java 遠端載入器」上無法使用此選項。 |
|
-setpasswords |
-sp |
password password |
指定「遠端載入器」例項的密碼，以及與「遠端載入器」通訊之遠端介面 Shim 的「Identity Manager 驅動程式」物件密碼。 引數中的第一個密碼是「遠端載入器」的密碼。 選擇性引數中的第二個密碼是「Identity Manager 驅動程式」物件的密碼，該物件與 Metadirectory 伺服器上的遠端介面 Shim 相關聯。 您必須不指定密碼，或是兩個密碼都指定。 如果不指定密碼，則「遠端載入器」會提示您指定密碼。 這是組態選項。 使用此選項可以設定「遠端載入器」例項指定密碼，但不載入 Identity Manager 應用程式 Shim 或與其他載入器例項通訊。 範例： -setpasswords novell4 staccato3 -sp novell4 staccato3 |
|
-storepass |
|
storepass |
僅用於 .jar 檔案中包含的 Identity Manager 應用程式 Shim。 指定由 KeyStore 參數所指定的 Java KeyStore 密碼。 範例： storepass=mypassword 此選項僅適用於「Java 遠端載入器」。 |
|
-trace |
-t |
integer |
指定追蹤層級。 這僅在裝載應用程式 Shim 時使用。 追蹤層級對應 Metadirectory 伺服器上使用的追蹤層級。 範例： -trace 3 -t 3 |
|
-tracechange |
-tc |
integer |
指示裝載應用程式 Shim 的「遠端載入器」例項變更其追蹤層級。 追蹤層級對應 Metadirectory 伺服器上使用的追蹤層級。 範例： -tracechange 1 -tc 1 |
|
-tracefile |
-tf |
filename |
指定要在其中寫入追蹤訊息的檔案。 如果追蹤層級大於零，追蹤訊息就會寫入該檔案。 即使追蹤視窗未開啟，追蹤訊息也會寫入檔案。 範例： -tracefile c:\temp\trace.txt -tf c:\temp\trace.txt |
|
-tracefilechange |
-tfc |
無或 filename |
指示裝載應用程式 Shim 的「遠端載入器」例項開始使用追蹤檔案，或者關閉使用中的追蹤檔案並使用新的追蹤檔案。 使用此選項的無引數版本，會導致裝載的例項關閉任何正在使用的追蹤檔案。 範例： -tracefilechange c:\temp\newtrace.txt tfc c:\temp\newtrace.txt |
|
-tracefilemax |
-tfm |
size |
指定追蹤檔案資料可在磁碟上佔用的大約大小上限。 如果指定此選項，則會產生具有以 tracefile 選項指定之名稱的追蹤檔案，並會有最多 9 個額外的「延展」檔案。 延展檔案是以使用主追蹤檔名加上 “_n” 為其命名基礎，其中 n 是 1 至 9 的數字。 size 參數是位元組的數目。 使用字尾 K、M 或 G 來代表千位元組、百萬位元組或十億位元組，以指定大小。 「遠端載入器」啟動時，如果追蹤檔案資料大於指定的最大值，則在所有 10 個檔案都完成延展之前，追蹤檔案資料會保持大於指定的最大值。 範例： -tracefilemax 1000M -tfm 1000M 在此範例中，追蹤檔案可以只有 1 GB。 |
|
-unload |
-u |
無 |
卸載「遠端載入器」例項。 如果「遠端載入器」正在做為 Win32 服務執行，則此指令會停止該服務。 範例： -unload -u |
|
-window |
-w |
On/Off |
在「遠端載入器」例項中開啟或關閉追蹤視窗。 範例： -window on -w off 此選項只能用於 Windows 平台。 在「Java 遠端載入器」上無法使用它。 |
|
-wizard |
-wiz |
無 |
啟動「組態精靈」。 執行不帶指令行參數的 dirxml_remote.exe 亦會啟動該精靈。 如果同時指定了組態檔案，則此選項會很有用處。 在這種情況下，精靈啟動時會使用組態檔案中的值，並且您可以使用精靈來變更組態，而無需直接編輯組態檔案。 範例： -wizard -wiz 只有 Windows 平台上才有此選項可用， 在「Java 遠端載入器」上則無從使用。 |
表 B-2 Java 類別名稱