18.2 Erläuterungen zu den Kommunikationsparametern für den Remote Loader

Die Treiberinstanzen können über die Befehlszeile oder mithilfe einer Konfigurationsdatei konfiguriert werden. Die Beispieldatei config8000.txt von NetIQ hilft Ihnen dabei, den Remote Loader und die Treiber für das Anwendungsschnittstellenmodul zu konfigurieren. Die Beispieldatei befindet sich standardmäßig im Verzeichnis /opt/novell/dirxml/doc/. Die Konfigurationsdatei kann beispielsweise die folgenden Zeilen enthalten:

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

Die folgenden Parameter stehen zur Verfügung:

-description Wert (-desc Wert)

(Optional) Gibt eine kurze Beschreibung in Form einer Zeichenkette (z. B. SAP) an, die die Anwendung als Titel für das Trace-Fenster und für die Protokollierung heranzieht. Beispiel:

-description SAP

-desc SAP

-class Name (-cl Name)

(Bedingt) Bei Verwendung eines Java-Treibers geben Sie den Java-Klassennamen für das zu hostende Identity Manager-Anwendungsschnittstellenmodul an. Diese Option weist die Anwendung an, die Zertifikate aus einem Java-Keystore auszulesen. Beispiel:

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

HINWEIS:

• Diese Option ist nicht zulässig, wenn Sie die Option -module angeben.

• Wenn Sie das Tab-Zeichen als Begrenzungszeichen in der Option -class verwenden, wird der Remote Loader nicht automatisch gestartet. Stattdessen muss er manuell gestartet werden. Damit der Remote Loader ordnungsgemäß gestartet wird, ersetzen Sie das Tab-Zeichen durch ein Leerzeichen.

• Weitere Informationen zu den zulässigen Namen bei dieser Option finden Sie unter Erläuterungen zu den Namen für den Java-Parameter -class.

-commandport Portnummer (-cp Portnummer)

Gibt den TCP/IP-Port an, der von der Treiberinstanz zu Steuerungszwecken verwendet wird. Beispiel: -commandport 8001 oder -cp 8001. Der Standardwert ist 8000.

Sollen mehrere Treiberinstanzen mit dem Remote Loader auf einem einzigen Server verwendet werden, geben Sie für jede Instanz jeweils unterschiedliche Verbindungs- und Befehlsports an.

Wenn die Treiberinstanz ein Anwendungsschnittstellenmodul hostet, ist der Befehlsport der Port, über den eine andere Remote Loader-Instanz mit der Instanz kommuniziert, die das Schnittstellenmodul hostet. Wenn die Treiberinstanz einen Befehl an eine Instanz sendet, die ein Anwendungsschnittstellenmodul hostet, ist der Befehlsport der Port, der von der Host-Instanz überwacht wird.

Wenn Sie diesen Parameter über die Befehlszeile an eine Instanz senden, die ein Anwendungsschnittstellenmodul hostet, ist der Befehlsport der Port, der von der Host-Instanz überwacht wird. Sie können diesen Befehl senden, während der Remote Loader läuft.

-config Dateiname

Gibt eine Konfigurationsdatei für die Treiberinstanz an. Beispiel:

-config config.txt

Die Konfigurationsdatei kann bis auf -config beliebige Befehlszeilenoptionen enthalten. Die an der Befehlszeile angegebenen Optionen haben Vorrang vor den in der Konfigurationsdatei angegebenen Optionen.

Sie können diesen Befehl senden, während der Remote Loader läuft.

-connection „Parameter“ (-conn „Parameter“)

Gibt die Einstellungen zum Herstellen einer Verbindung zum Server an, auf dem die Identity Manager-Engine gehostet wird, die wiederum das Identity Manager-Remote-Schnittstellenmodul ausführt. Die Standardverbindungsmethode ist TCP/IP mit SSL.

Sollen mehrere Treiberinstanzen mit dem Remote Loader auf einem einzigen Server verwendet werden, geben Sie für jede Instanz jeweils unterschiedliche Verbindungs- und Befehlsports an.

Geben Sie die Verbindungseinstellungen mit der folgenden Syntax ein:

-connection "parameter parameter parameter"

Beispiel:

-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"

Legen Sie die Einstellungen für eine TCP/IP-Verbindung mit den folgenden Parametern fest:

address=IP_Adresse

(Optional) Gibt an, ob 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 Werte sind zulässig:

• address=Adressnummer

• address='localhost'

Beispiel:

address=198.51.100.0

Wenn Sie keinen Wert angeben, überwacht der Remote Loader alle lokalen IP-Adressen.

fromaddress=IP_Adresse

Gibt den Server an, von dem der Remote Loader Verbindungen akzeptiert. Verbindungen von anderen Adressen werden durch die Anwendung ignoriert. Geben Sie eine IP-Adresse oder den DNS-Namen des Servers an. Beispiel:

fromaddress=198.51.100.0

fromaddress=testserver1.company.com

handshaketimeout=Millisekunden

(Bedingt) Gilt, wenn eine Zeitüberschreitung beim Handshake im Zusammenhang mit anderweitig gültigen Verbindungen von der Identity Manager-Engine eintritt. Bestimmt den Zeitraum für die Zeitüberschreitung (in Millisekunden) beim Handshake zwischen dem Remote Loader und der Identity Manager-Engine. Beispiel:

handshaketimeout=1000

Sie können eine Ganzzahl größer oder gleich null angeben. Der Wert null bedeutet, dass niemals eine Zeitüberschreitung für die Verbindung eintritt. Der Standardwert ist 1000 Millisekunden.

hostname=Server

Gibt die IP-Adresse oder den Namen des Servers an, auf dem der Remote Loader ausgeführt wird. Beispiel:

hostname=198.51.100.0

keystore=Dateiname

(Bedingt) Gilt nur dann, wenn Identity Manager-Anwendungsschnittstellenmodule in .jar-Dateien enthalten sind. Gibt den Dateinamen des Java-Keystores an, der das Herkunftsverbürgungszertifikat des Herausgebers des Zertifikats enthält, das vom Remote-Schnittstellenmodul verwendet wird. Beispiel:

keystore=ca.pem

In der Regel geben Sie die Zertifizierungsstelle des Baums an, der das Remote-Schnittstellenmodul hostet.

kmo=Name

Gibt den Schlüsselnamen des Schlüsselmaterialobjekts (KMO) ein, das die für SSL-Verbindungen verwendeten Schlüssel und Zertifikate enthält. Beispiel:

kmo=remote driver cert

localaddress=IP_Adresse

Gibt die IP-Adresse an, an die der Socket für die Clientverbindung gebunden werden soll. Beispiel:

localaddress=198.51.100.0

port=Portnummer

Gibt den TCP/IP-Port an, den der Remote Loader auf Verbindungen vom Remote-Schnittstellenmodul überwacht. Mit port=8090 legen Sie den Standardport fest.

rootfile=Dateiname_Herkunftsverbürgungszertifikat

(Bedingt) Gilt nur dann, wenn Sie SSL verwenden und der Remote Loader mit einem nativen Treiber kommunizieren soll. Gibt die Datei an, die das Herkunftsverbürgungszertifikat des Herausgebers des Zertifikats enthält, das vom Remote-Schnittstellenmodul verwendet wird. Die Zertifikatsdatei muss im Base-64-Format (PEM) vorliegen. Beispiel:

rootfile=server1.pem

In der Regel ist die Datei die Zertifizierungsstelle des Baums, der das Remote-Schnittstellenmodul hostet.

storepass=Passwort

(Bedingt) Gilt nur für den Java Remote Loader, wenn Identity Manager-Anwendungsschnittstellenmodule in .jar-Dateien enthalten sind. Gibt das Passwort für den Java-Keystore an, den Sie im Parameter keystore festgelegt haben. Beispiel:

storepass=mypassword

HINWEIS: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 mit der folgenden Syntax ein:

keystore=keystorename storepass=password

-datadir Verzeichnis (-dd Verzeichnis)

Gibt das Verzeichnis für die Datendateien an, die von Remote Loader verwendet werden. Beispiel:

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

Mit diesem Befehl übernimmt der rdxml-Prozess das angegebene Verzeichnis als aktuelles Verzeichnis. In diesem Datenverzeichnis werden Trace-Dateien und andere Dateien, für die kein expliziter Pfad angegeben ist, erstellt.

-help (-h)

Weist die Anwendung an, die Hilfe anzuzeigen.

-java (-j)

(Bedingt) Gibt an, dass Sie Passwörter für ein Java-Treiberschnittstellenmodul festlegen möchten.

HINWEIS:Verwenden Sie diese Option zusammen mit der Option -setpasswords, wenn Sie nicht auch einen Wert für -class angeben.

-javadebugport Portnummer (-jdp Portnummer)

Weist die Instanz an, das Java-Debugging auf dem angegebenen Port zu aktivieren. Beispiel:

-javadebugport 8080

Nutzen Sie diesen Befehl beim Entwickeln von Identity Manager-Anwendungsschnittstellenmodulen. Sie können diesen Befehl senden, während der Remote Loader läuft.

-javaparam Parameter (-jp Parameter)

Gibt die Parameter für die Java-Umgebung an. Geben Sie die Java-Umgebungsparameter mit der folgenden Syntax ein:

-javaparam parameter
-jp parameter
-jp parameter

Sollen mehrere Werte für einen einzelnen Parameter angegeben werden, schließen Sie die Parameter in Anführungszeichen ein. Beispiel:

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

Mit den folgenden Parametern richten Sie die Java-Umgebung ein:

DHOST_JVM_ADD_CLASSPATH

Gibt weitere Pfade an, in denen die JVM nach Paket- (.jar) und Klassendateien (.class) suchen soll. Sollen mehrere Klassenpfade für eine UNIX- oder Linux-JVM angegeben werden, trennen Sie die einzelnen Pfade jeweils mit Kommas voneinander ab. Bei einer Windows-JVM verwenden Sie ein Semikolon.

DHOST_JVM_INITIAL_HEAP

Gibt die anfängliche (minimale) JVM-Heap-Größe in Dezimalschreibweise in Byte an. Geben Sie einen numerischen Wert gefolgt von „G“, „M“ oder „K“ für den Byte-Typ ein. Beispiel:

100M

Wenn Sie keinen Byte-Typ angeben, wird die Größe standardmäßig in Byte dargestellt. Dieser Parameter entspricht dem Java-Befehl -Xms.

Dieser Parameter hat Vorrang vor der Option zum Festlegen der Attribute im Treiber. Durch das Erhöhen der Ausgangs-Heap-Größe können die Startzeit und die Durchsatzleistung verbessert werden.

DHOST_JVM_MAX_HEAP

Gibt die maximale JVM-Heap-Größe in Dezimalschreibweise in Byte an. Geben Sie einen numerischen Wert gefolgt von „G“, „M“ oder „K“ für den Byte-Typ ein. Beispiel:

100M

Wenn Sie keinen Byte-Typ angeben, wird die Größe standardmäßig in Byte dargestellt.

Dieser Parameter hat Vorrang vor der Option zum Festlegen der Attribute im Treiber.

DHOST_JVM_OPTION

Gibt die Argumente an, die beim Starten der JVM-Instanz des Treibers verwendet werden sollen. Trennen Sie die Optionszeichenfolgen jeweils mit Leerzeichen voneinander ab. Beispiel:

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

Die Option zum Festlegen der Attribute im Treiber hat Vorrang vor diesem Parameter. Diese Umgebungsvariable wird an das Ende der Option zum Festlegen der Attribute im Treiber angehängt. Weitere Informationen zu gültigen Optionen finden Sie in der JVM-Dokumentation.

-module „Name“ (-m „Name“)

(Bedingt) Gibt bei Verwendung eines nativen Treibers das Modul an, in dem sich das zu hostende Identity Manager-Anwendungsschnittstellenmodul befindet. Diese Option weist die Anwendung an, ein rootfile-Zertifikat zu verwenden. Bei einem nativen Treiber können Sie beispielsweise eine der folgenden Optionen angeben:

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

Alternativ:

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

HINWEIS:

• Diese Option ist nicht zulässig, wenn Sie die Option -class angeben.

• Wenn Sie das Tab-Zeichen als Begrenzungszeichen in der Option -module verwenden, wird der Remote Loader nicht automatisch gestartet. Stattdessen muss er manuell gestartet werden. Damit der Remote Loader ordnungsgemäß gestartet wird, ersetzen Sie das Tab-Zeichen durch ein Leerzeichen.

-password Wert (-p Wert)

Gibt das Passwort für die Treiberinstanz an, wenn Sie Befehle eingeben, die die Einstellungen ändern oder sich auf die Funktionsweise der Instanz auswirken. Sie müssen dasselbe Passwort als erstes Passwort mit „setpasswords“ für die Instanz festlegen, für das die Befehle eingegeben werden sollen. Beispiel:

-password netiq4

Wenn Sie das Passwort beim Eingeben der Befehle nicht mitsenden, werden Sie durch die Instanz dazu aufgefordert, das Passwort einzugeben.

Sie können diesen Befehl senden, während der Remote Loader läuft.

-piddir Verzeichnis (-pd Verzeichnis)

Gibt den Pfad zum Verzeichnis für die Prozess-ID-Datei (PID-Datei) an, die im Remote Loader-Prozess verwendet wird. Beispiel:

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

Die PID-Datei ist vorrangig für init-Skripte im SysV-Stil vorgesehen. Der Standardwert lautet /var/run. Alternativ entspricht der Standardwert dem aktuellen Verzeichnis, wenn der Remote Loader von einem Benutzer ausgeführt wird, der nicht über ausreichende Rechte zum Öffnen der PID-Datei zum Lesen und Schreiben in /var/run verfügt.

Dieser Parameter ist mit dem Parameter -datadir vergleichbar.

-service Wert (-serv Wert)

(Nur Windows) Gibt an, ob eine Instanz als Win32-Dienst auf einem Windows-Computer installiert werden soll. Zulässige Werte sind install und uninstall sowie die anderen Parameter, die zum Hosten eines Anwendungsschnittstellenmoduls erforderlich sind. Sie müssen beispielsweise den Parameter -module verwenden, während der Parameter -commandport und die Verbindungseinstellungen bei Bedarf angegeben werden können.

Mit diesem Befehl wird die Instanz lediglich als Dienst installiert oder deinstalliert. Der Dienst wird nicht gestartet.

Sie können diesen Befehl senden, während der Remote Loader läuft. Bei rdxml und dem Java Remote Loader ist dieser Befehl allerdings nicht zulässig.

-setpasswords Remote_Loader_Passwort Optionales_Passwort (-sp Remote_Loader_Passwort Optionales_Passwort)

Gibt das Passwort für die Treiberinstanz und das Passwort für das Identity Manager-Treiberobjekt des Remote-Schnittstellenmoduls an, mit dem der Remote Loader kommuniziert.

Sie müssen kein Passwort angeben. In diesem Fall werden Sie vom Remote Loader aufgefordert, die Passwörter einzugeben. Wenn Sie jedoch das Passwort für den Remote Loader angeben, müssen Sie auch das Passwort für das Identity Manager-Treiberobjekt nennen, das mit dem Remote-Schnittstellenmodul auf dem Server der Identity Manager-Engine verbunden ist. Geben Sie die Passwörter mit der folgenden Syntax an:

-setpasswords Remote_Loader_password driver_object_password

Beispiel:

-setpasswords netiq4 idmobject6

HINWEIS:Mithilfe dieser Option wird die Treiberinstanz mit den angegebenen Passwörtern konfiguriert. Es wird jedoch weder ein Identity Manager-Anwendungsschnittstellenmodul geladen noch mit anderen Instanzen kommuniziert.

Einstellungen für die Trace-Datei

(Bedingt) Gibt beim Hosten eines Identity Manager-Anwendungsschnittstellenmoduls die Einstellungen für eine Trace-Datei an, in der sich Informationsmeldungen vom Remote Loader und vom Treiber für diese Instanz befinden.

Fügen Sie der Konfigurationsdatei die folgenden Parameter hinzu:

-trace Ganzzahl (-t Ganzzahl)

Gibt die Stufen der Meldungen an, die in einem Trace-Fenster angezeigt werden sollen. Beispiel:

-trace 3

Die Trace-Stufen für den Remote Loader sind mit den Stufen identisch, die auf dem Server verwendet werden, auf dem die Identity Manager-Engine gehostet wird.

-tracefile Dateipfad (-tf Dateipfad)

Gibt den Pfad zu einer Datei an, in der die Trace-Meldungen protokolliert werden sollen. Für jede Treiberinstanz auf einem Computer müssen Sie eine eindeutige Trace-Datei festlegen. Beispiel:

-tracefile c:\temp\trace.txt

Die Anwendung schreibt Meldungen in die Datei, wenn der Parameter -trace größer als null ist. Die Meldungen werden auch dann in die Datei geschrieben, wenn das Trace-Fenster nicht geöffnet ist.

-tracefilemax Größe (-tf Größe)

Gibt die maximale Größe der Trace-Datei für diese Instanz an. Legen Sie den Wert in Kilobyte, Megabyte oder Gigabyte fest, und nennen Sie auch die Abkürzung für den Byte-Typ. Beispiel:

• -tracefilemax 1000K

• -tf 100M

• -tf 10G

HINWEIS:

• Wenn die Trace-Datei beim Starten des Remote Loaders 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.

• Wenn Sie diese Option in die Konfigurationsdatei aufnehmen, nutzt die Anwendung den angegebenen Namen für die Trace-Datei, und es werden bis zu 9 „Rollover“-Dateien eingeschlossen. Der Name der Rollover-Dateien wird aus dem Namen der Haupt-Trace-Datei und dem Suffix _n zusammengesetzt, wobei 1 bis 9 gültige Werte für n sind.

-tracechange Ganzzahl (-tc Ganzzahl)

(Bedingt) Wenn bereits eine Treiberinstanz vorhanden ist, die ein Anwendungsschnittstellenmodul hostet: Gibt eine neue Stufe für Informationsmeldungen an. Die Trace-Stufen entsprechen den auf dem Identity Manager-Server verwendeten Trace-Stufen. Beispiel:

-trace 3

Sie können diesen Befehl senden, während der Remote Loader läuft.

-tracefilechange Dateipfad (-tfc Dateipfad)

(Bedingt) Wenn bereits eine Treiberinstanz vorhanden ist, die ein Anwendungsschnittstellenmodul hostet: Weist diese Instanz an, eine Trace-Datei zu verwenden bzw. die bisher genutzte Datei zu schließen und zu dieser neuen Datei zu wechseln. Beispiel:

-tracefilechange \temp\newtrace.txt

Sie können diesen Befehl senden, während der Remote Loader läuft.

-unload (-u)

Weist die Treiberinstanz an, sich zu entladen. Wenn der Remote Loader als Win32-Dienst ausgeführt wird, wird der Dienst durch diese Option gestoppt.

Sie können diesen Befehl senden, während der Remote Loader läuft.

-window Wert (-w) Wert

(Nur Windows) Weist die Anwendung an, das Trace-Fenster für eine Treiberinstanz auf einem Windows-Computer zu öffnen oder zu schließen. Zulässige Werte sind Ein und Aus. Beispiel:

-window on

Sie können diesen Befehl senden, während der Remote Loader läuft. Beim Java Remote Loader ist dieser Befehl nicht zulässig.

-wizard (-wiz)

(Nur Windows) Startet den Konfigurationsassistenten für den Remote Loader auf einem Windows-Computer. Mit dem Befehl dirxml_remote.exe (ohne Befehlszeilenparameter) können Sie den Assistenten auch direkt ausführen.

Wenn Sie diesen Befehl ausführen und dabei eine Konfigurationsdatei angeben (Option -config), wird der Assistent mit den Werten aus der Konfigurationsdatei gestartet. Im Assistenten können Sie die Konfiguration ändern, ohne die Konfigurationsdatei direkt bearbeiten zu müssen. Beispiel:

-wizard -config config.txt

Beim Java Remote Loader ist dieser Befehl nicht zulässig.

Wenn Sie mit dem Parameter eine Treiberinstanz -class für den Remote Loader und den Java Remote Loader konfigurieren, müssen Sie den Java-Klassennamen für das zu hostende Identity Manager-Anwendungsschnittstellenmodul angeben.