Mit den in der folgenden Tabelle aufgeführten Optionen können Sie einen Remote Loader konfigurieren.
Tabelle B-1 Remote Loader-Optionen
|
Option |
Kurzform |
Parameter |
Beschreibung |
|---|---|---|---|
|
address |
|
IP-Adresse |
Dieser Parameter ist optional. Er gibt an, dass der Remote Loader eine bestimmte lokale IP-Adresse überwacht. Dies ist hilfreich, wenn der Server, der den Remote Loader hostet, mehrere IP-Adressen hat und der Remote Loader nur eine dieser Adressen überwachen soll. Die folgenden drei Optionen sind verfügbar: address=Adressnummer address=’localhost’ Diesen Parameter nicht verwenden. Wenn Sie den Parameter „-address“ nicht verwenden, überwacht der Remote Loader alle lokalen IP-Adressen. Beispiel: address=137.65.134.83 |
|
-class |
-cl |
Java-Klassenname |
Gibt den Java-Klassennamen des zu hostenden Identity Manager-Anwendungsschnittstellenmoduls an. Einen Java-Treiber können Sie beispielsweise mit einer der folgenden Optionen angeben: -class com.novell.nds.dirxml.driver.ldap.LDAPDriverShim -cl com.novell.nds.dirxml.driver.ldap.LDAPDriverShim Java verwendet zum Lesen von Zertifikaten einen Keystore. Die Optionen „-class“ und „-module“ schließen sich gegenseitig aus. Eine Liste der Java-Klassennamen finden Sie in Tabelle B-2. |
|
-commandport |
-cp |
Portnummer |
Gibt den TCP/IP-Port an, der von der Remote Loader-Instanz zu Steuerungszwecken verwendet wird. Wenn die Remote Loader-Instanz ein Anwendungsschnittstellenmodul hostet, ist der Befehls-Port der Port, über den eine andere Remote Loader-Instanz mit der Instanz kommuniziert, die das Schnittstellenmodul hostet. Wenn die Remote Loader-Instanz einen Befehl an eine Instanz sendet, die ein Anwendungsschnittstellenmodul hostet, ist der Befehls-Port der Port, der von der Host-Instanz überwacht wird. Wenn kein Port angegeben ist, wird standardmäßig Befehls-Port 8000 verwendet. Durch die Angabe unterschiedlicher Verbindungs- und Befehls-Ports können auf dem Server, auf dem unterschiedliche Treiberinstanzen gehostet werden, mehrere Instanzen des Remote Loader ausgeführt werden. Beispiel: -commandport 8001 -cp 8001 |
|
-config |
kein |
Dateiname |
Gibt eine Konfigurationsdatei an. Die Konfigurationsdatei kann bis auf config beliebige Befehlszeilenoptionen enthalten. Die an der Befehlszeile angegebenen Optionen haben Vorrang vor den in der Konfigurationsdatei angegebenen Optionen. Beispiel: -config config.txt |
|
-connection |
-conn |
Zeichenkette für die Verbindungskonfiguration |
Gibt die Verbindungsparameter für die Verbindung zum Metaverzeichnis-Server an, auf dem das Identity Manager-Remote-Schnittstellenmodul ausgeführt wird. Die Standardverbindungsmethode für den Remote Loader ist TCP/IP mit SSL. Der TCP/IP-Standardport für diese Verbindung ist 8090. Es können mehrere Instanzen des Remote Loader auf demselben Server ausgeführt werden. Jede Instanz des Remote Loader hostet eine separate Anwendungsschnittstellenmodulinstanz des Identity Manager. Sie unterscheiden mehrere Instanzen des Remote Loader voneinander, indem Sie für jede Remote Loader-Instanz unterschiedliche Verbindungs- und Befehls-Ports angeben. Beispiel: -connection "port=8091 rootfile=server1.pem" -conn "port=8091 rootfile=server1.pem" |
|
-description |
-desc |
Kurzbeschreibung |
Geben Sie eine kurze Beschreibungszeichenkette (z. B. SAP) an, die für den Titel des Trace-Fensters und für die Novell® Audit-Protokollierung verwendet wird. Beispiel: -description SAP -desc SAP Die Remote Loader-Konsole schreibt lange Formen in die Konfigurationsdateien. Sie können entweder eine lange Form (z. B. -description) oder eine kurze Form (z. B. -desc) verwenden. |
|
-help |
-? |
kein |
Zeigt Hilfe-Informationen an. Beispiel: -help -? |
|
-java |
-j |
kein |
Gibt an, dass für eine Java-Schnittstellenmodulinstanz Passwörter festgelegt werden müssen. Diese Option ist nur in Verbindung mit der Option „setpasswords“ hilfreich. Wenn „-class“ mit „-setpasswords“ angegeben wird, ist diese Option nicht erforderlich. |
|
-javadebugport |
-jdp |
Portnummer |
Gibt an, dass die Remote Loader-Instanz das Java-Debugging auf dem angegebenen Port aktivieren soll. Dies ist hilfreich für Entwickler von Identity Manager-Anwendungsschnittstellenmodulen. Beispiel: -javadebugport 8080 -jdp 8080 |
|
Keystore |
|
|
Bedingte Parameter. Wird nur für Identity Manager-Anwendungsschnittstellenmodule in JAR-Dateien verwendet. Gibt den Dateinamen des Java-Keystores an, der das Herkunftsverbürgungszertifikat des Herausgebers des Zertifikats enthält, das vom Remote-Schnittstellenmodul verwendet wird. Dies ist in der Regel die Zertifizierungsstelle des eDirectory™-Baums, der das Remote-Schnittstellenmodul hostet. Wenn Sie SSL ausführen und den Remote Loader für die Kommunikation mit einem Java-Treiber benötigen, geben Sie ein Schlüssel/Wert-Paar ein: keystore='keystorename' storepass='passwort' |
|
-module |
-m |
Modulname |
Gibt das Modul an, in dem das zu hostende Identity Manager-Anwendungsschnittstellenmodul enthalten ist. Bei einem nativen Treiber können Sie beispielsweise eine der folgenden Optionen angeben: -module "c:\Novell\RemoteLoader\Exchange5Shim.dll" -m "c:\Novell\RemoteLoader\Exchange5Shim.dll" oder: -module "usr/lib/dirxml/NISDriverShim.so" -m "usr/lib/dirxml/NISDriverShim.so" Die Option „-module“ verwendet ein rootfile-Zertifikat. Die Optionen „-module“ und „-class“ schließen sich gegenseitig aus. |
|
-password |
-p |
Passwort |
Gibt das Passwort für die Befehlsauthentifizierung an. Dieses Passwort muss dasselbe Passwort sein, das mit setpasswords für die Loader-Instanz angegeben wurde, die Ziel der Befehle ist. Wenn eine Befehlsoption (beispielsweise „unload“ oder „tracechange“) angegeben und die -password-Option nicht angegeben ist, wird der Benutzer aufgefordert, das Passwort des Loaders einzugeben, auf den sich der Befehl bezieht. Beispiel: -password novell4 -p novell4 |
|
port |
|
Dezimale Portnummer |
Ein obligatorischer Parameter. Er gibt den TCP/IP-Port an, den der Remote Loader auf Verbindungen vom Remote-Schnittstellenmodul überwacht. Beispiel: port=8090 |
|
rootfile |
|
|
Ein bedingter Parameter. Wenn Sie SSL ausführen und den Remote Loader für die Kommunikation mit einem nativen Treiber benötigen, geben Sie Folgendes ein: rootfile='trusted certname' |
|
-service |
-serv |
Kein Parameter oder install/uninstall |
Zum Installieren einer Instanz als Dienst wird das Argument „install“ zusammen mit den zum Hosten eines Anwendungsschnittstellenmoduls erforderlichen Argumenten verwendet. Die verwendeten Argumente müssen z. B. „-module“ und können „-connection“, „-commandport“ usw. enthalten. Mit dieser Option wird der Win32-Dienst installiert, aber nicht gestartet. Zum Deinstallieren einer als Dienst ausgeführten Instanz wird das Argument „uninstall“ zusammen mit den zum Hosten eines Anwendungsschnittstellenmoduls erforderlichen Argumenten verwendet. Die Variante ohne Argument wird an der Befehlszeile nur für eine Instanz verwendet, die als Win32-Dienst ausgeführt wird. Dies wird beim Installieren einer Instanz als Dienst automatisch eingerichtet. Beispiel: -service install -serv uninstall Diese Option ist nicht für „rdxml“ oder den Java Remote Loader verfügbar. |
|
-setpasswords |
-sp |
Passwort Passwort |
Gibt das Passwort der Remote Loader-Instanz und das Passwort des Identity Manager-Treiberobjekts des Remote-Schnittstellenmoduls an, mit dem der Remote Loader kommuniziert. Das erste Passwort im Argument ist das Passwort für den Remote Loader. Das zweite Passwort in den optionalen Argumenten ist das Passwort für das Identity Manager-Treiberobjekt, das mit dem Remote-Schnittstellenmodul auf dem Metaverzeichnis-Server verknüpft ist. Es müssen entweder beide oder keine Passwörter angegeben werden. Wenn kein Passwort angegeben wird, fordert der Remote Loader zur Eingabe der Passwörter auf. Dies ist eine Konfigurationsoption. Mithilfe dieser Option wird die Remote Loader-Instanz mit den angegebenen Passwörtern konfiguriert. Es wird jedoch weder ein Identity Manager-Anwendungsschnittstellenmodul geladen noch mit anderen Loader-Instanzen kommuniziert. Beispiel: -setpasswords novell4 staccato3 -sp novell4 staccato3 |
|
-storepass |
|
Keystore-Passwort |
Wird nur für Identity Manager-Anwendungsschnittstellenmodule in JAR-Dateien verwendet. Gibt das Passwort für den Java-Keystore an, der im Parameter „keystore“ festgelegt ist. Beispiel: storepass=MeinPasswort Diese Option gilt nur für den Java Remote Loader. |
|
-trace |
-t |
Ganzzahl |
Gibt die Trace-Stufe an. Diese Option wird nur beim Hosten eines Anwendungsschnittstellenmoduls verwendet. Die Trace-Stufen entsprechen den auf dem Metaverzeichnis-Server verwendeten Trace-Stufen. Beispiel: -trace 3 -t 3 |
|
-tracechange |
-tc |
Ganzzahl |
Weist eine Remote Loader-Instanz an, die ein Anwendungsschnittstellenmodul hostet, ihre Trace-Stufe zu ändern. Die Trace-Stufen entsprechen den auf dem Metaverzeichnis-Server verwendeten Trace-Stufen. Beispiel: -tracechange 1 -tc 1 |
|
-tracefile |
-tf |
Dateiname |
Gibt eine Datei an, in die die Trace-Meldungen geschrieben werden sollen. Trace-Meldungen werden in die Datei geschrieben, wenn die Trace-Stufe größer als Null ist. Trace-Meldungen werden auch bei geschlossenem Trace-Fenster in die Datei geschrieben. Beispiel: -tracefile c:\temp\trace.txt -tf c:\temp\trace.txt |
|
-tracefilechange |
-tfc |
Keine oder „Dateiname“ |
Weist eine Remote Loader-Instanz, die ein Anwendungsschnittstellenmodul hostet, an, eine Trace-Datei zu verwenden, oder eine bereits geöffnete Datei zu schließen und eine neue zu verwenden. Wenn diese Option ohne Argumente verwendet wird, schließt die Host-Instanz alle geöffneten Trace-Dateien. Beispiel: -tracefilechange c:\temp\newtrace.txt tfc c:\temp\newtrace.txt |
|
-tracefilemax |
-tfm |
Größe |
Gibt die Maximalgröße an, die die Trace-Datei auf der Festplatte belegen darf. Bei Angabe dieser Option wird die Trace-Datei mit dem Namen verwendet, der mit der Option „tracefile“ angegeben wurde, sowie bis zu neun zusätzliche Rollover-Dateien. Die Rollover-Dateien werden benannt, indem an den Namen der Haupt-Trace-Datei “_n” angehängt wird, wobei 1 bis 9 gültige Werte für n sind. Der Parameter für die Größe gibt die Anzahl der Byte an. Geben Sie die Größe mithilfe der Erweiterungen K, M oder G für Kilobyte, Megabyte oder Gigabyte an. Wenn die Trace-Datei beim Starten des Remote Loader größer als das angegebene Maximum ist, dann behält die Trace-Datei diese Größe bei, bis das Rollover über alle 10 Dateien ausgeführt wurde. Beispiel: -tracefilemax 1000M -tfm 1000M In diesem Beispiel darf die Trace-Datei nicht größer als 1 GB sein. |
|
-unload |
-u |
kein |
Entlädt die Remote Loader-Instanz. Wenn der Remote Loader als Win32-Dienst ausgeführt wird, wird der Dienst durch diese Option gestoppt. Beispiel: -unload -u |
|
-window |
-w |
on/off |
Öffnet oder schließt das Trace-Fenster in einer Remote Loader-Instanz. Beispiel: -window on -w off Diese Option ist nur auf Windows-Plattformen verfügbar. Sie ist nicht für den Java Remote Loader verfügbar. |
|
-wizard |
-wiz |
kein |
Startet den Konfigurationsassistenten. Wenn Sie „dirxml_remote.exe“ ohne Befehlszeilenparameter ausführen, wird auch der Assistent gestartet. Diese Option ist hilfreich, wenn zudem eine Konfigurationsdatei angegeben ist. In diesem Fall wird der Assistent mit den Werten aus der Konfigurationsdatei gestartet und die Konfiguration kann mithilfe des Assistenten geändert werden, ohne die Konfigurationsdatei direkt bearbeiten zu müssen. Beispiel: -wizard -wiz Diese Option ist nur auf Windows-Plattformen verfügbar. Sie ist nicht für den Java Remote Loader verfügbar. |
Tabelle B-2 Java-Klassennamen