Verwaltungs-Tasks für Katalogservicedomäne

Sie können die Scripting-Sprachen Jacl und Jython verwenden, um Katalogservicedomänen in Ihrer Konfiguration von WebSphere Application Server zu verwalten. Mit WebSphere DataPower XC10 Appliance können Sie Katalogservicedomänen zum Erstellen von Verbindungen mit den Katalogservern definieren, die für das Gerät ausgeführt werden. Die Erstellung dieser Konfiguration ist nur für die Daten-Grids des dynamischen Cache erforderlich.

Voraussetzungen

WebSphere eXtreme Scale Client muss in der Umgebung von WebSphere Application Server installiert sein.

Alle Verwaltungs-Tasks auflisten

Führen Sie den folgenden Befehl mit wsadmin aus, um eine Liste aller Verwaltungs-Tasks für Katalogservicedomänen abzurufen.
wsadmin>$AdminTask help XSDomainManagement 

Befehle

Die Verwaltungs-Tasks für Katalogservicedomänen umfassen die folgenden Befehle:

createXSDomain

Der Befehl "createXSDomain" registriert eine neue Katalogservicedomäne.
Tabelle 1. Argumente für den Befehl "createXSDomain"
Argument Beschreibung
-name (erforderlich) Gibt den Namen der Katalogservicedomäne an, die Sie erstellen möchten.
-default Gibt an, ob die Katalogservicedomäne die Standarddomäne für die Zelle ist. Der Standardwert ist true. (Boolescher Wert: true oder false)
-properties Gibt angepasste Eigenschaften für die Katalogservicedomäne.
Tabelle 2. Argumente für den Schritt "defineDomainServers"
Argument Beschreibung
Name_des_Endpunkts Gibt den Namen des Katalogserviceendpunkts an.
  • Für vorhandene Anwendungsserver: Der Name des Endpunkts muss das folgende Format haben: Zellenname\Knotenname\Servername.
  • Für ferne Server: Gibt den Hostnamen des fernen Servers an. Sie können denselben Namen für mehrere Endpunkte verwenden, aber die Client-Port-Werte müssen für jeden Endpunkt eindeutig sein.
angepasste_Eigenschaften Gibt angepasste Eigenschaften für den Endpunkt der Katalogservicedomäne an. Wenn Sie keine angepassten Eigenschaften haben, verwenden Sie für dieses Argument ein Paar doppelter Anführungszeichen ("").
Endpunktports
Gibt die Portnummern für den Endpunkt der Katalogservicedomäne an. Die Ports müssen in der folgenden Reihenfolge angegeben werden: <Client-Port>,<Listener-Port>.
Client-Port
Gibt den Port an, der für die Kommunikation zwischen den Katalogservern in der Katalogservicedomäne verwendet wird. Dieser Wert ist nur für Katalogserver erforderlich, die in Prozessen von WebSphere Application Server ausgeführt werden und kann auf jeden Port gesetzt werden, der noch nicht verwendet wird.
Listener-Port
Gibt den Port an, der für die Kommunikation mit Clients verwendet wird. Dieser Wert ist für ferne Endpunkte erforderlich und muss mit dem Wert übereinstimmen, der beim Start des Katalogservice verwendet wurde. Der Listener-Port wird von Clients und Containern für die Kommunikation mit dem Katalogservice verwendet.
Für ferne Endpunkte von WebSphere DataPower XC10 Appliance: Verwenden Sie den Wert 2809 für die fernen Endpunkte des Geräts.

Rückgabewert:

Beispielsyntax für den Stapelmodus

Im Stapelmodus ist eine korrekte Formatierung des Befehlseintrags erforderlich. Sie sollten den interaktiven Modus verwenden, wenn Sie sicherstellen möchten, dass die von Ihnen eingegebenen Werte ordnungsgemäß verarbeitet werden. Wenn Sie den Stapelmodus verwenden, müssen Sie die Argumente für den Schritt -defineDomainServers mit einem bestimmten Bereich von Eigenschaften definieren. Dieser Eigenschaftenbereich muss im folgenden Format angegeben werden: Name_des_Endpunkts angepasste_Eigenschaften Endpunktports. Der Wert für Endpunktports ist eine Liste von Ports, die Sie in der folgenden Reihenfolge angeben müssen: <Client-Port>,<Listener-Port>.

Beispielsyntax für den Dialogmodus:
  • Mit Jacl:
    $AdminTask createXSDomain {-interactive}
  • Mit Jython (Zeichenfolge):
    AdminTask.createXSDomain ('[-interactive]')

deleteXSDomain

Der Befehl "deleteXSDomain" löscht eine Katalogservicedomäne.

Erforderliche Parameter:
-name
Gibt den Namen der zu löschenden Katalogservicedomäne an.

Rückgabewert:

Beispielsyntax für den Stapelmodus
  • Mit Jacl:
    $AdminTask deleteXSDomain {-name TestDomain }
  • Mit Jython (Zeichenfolge):
    AdminTask.deleteXSDomain('[-name TestDomain ]')
Beispielsyntax für den Dialogmodus:
  • Mit Jacl:
    $AdminTask deleteXSDomain {-interactive}
  • Mit Jython (Zeichenfolge):
    AdminTask.deleteXSDomain ('[-interactive]')

getDefaultXSDomain

Der Befehl "getDefaultXSDomain" gibt die Standardkatalogservicedomäne für die Zelle zurück.

Erforderliche Parameter: Ohne

Rückgabewert: Der Name der Standardkatalogservicedomäne.

Beispielsyntax für den Stapelmodus
  • Mit Jacl:
    $AdminTask getDefaultXSDomain
  • Mit Jython (Zeichenfolge):
    AdminTask.getDefaultXSDomain
Beispielsyntax für den Dialogmodus:
  • Mit Jacl:
    $AdminTask getDefaultXSDomain {-interactive}
  • Mit Jython (Zeichenfolge):
    AdminTask.getDefaultXSDomain ('[-interactive]')

listXSDomains

Der Befehl "listXSDomains" gibt eine Liste vorhandener Katalogservicedomänen zurück.

Erforderliche Parameter: Ohne

Rückgabewert: Eine Liste aller Katalogservicedomänen in der Zelle.

Beispielsyntax für den Stapelmodus
  • Mit Jacl:
    $AdminTask listXSDomains
  • Mit Jython (Zeichenfolge):
    AdminTask.listXSDomains
Beispielsyntax für den Dialogmodus:
  • Mit Jacl:
    $AdminTask listXSDomains {-interactive}
  • Mit Jython (Zeichenfolge):
    AdminTask.listXSDomains ('[-interactive]')

modifyXSDomain

Der Befehl "modifyXSDomain" ändert eine vorhandene Katalogservicedomäne.

Im Stapelmodus ist eine korrekte Formatierung des Befehlseintrags erforderlich. Sie sollten den interaktiven Modus verwenden, wenn Sie sicherstellen möchten, dass die von Ihnen eingegebenen Werte ordnungsgemäß verarbeitet werden. Wenn Sie den Stapelmodus verwenden, müssen Sie die Argumente für die Schritte -modifyEndpoints, -addEndpoints und -removeEndpoints mit einem bestimmten Bereich von Eigenschaften definieren. Dieser Eigenschaftenbereich muss im folgenden Format angegeben werden: Name_des_Endpunkts Hostname angepasste_Eigenschaften Endpunktports. Der Wert für Endpunktports ist eine Liste von Ports, die Sie in der folgenden Reihenfolge angeben müssen: <Client-Port>,<Listener-Port>.

Tabelle 3. Argumente für den Befehl "modifyXSDomain"
Argument Beschreibung
-name (erforderlich) Gibt den Namen der Katalogservicedomäne an, die Sie bearbeiten möchten.
-default Wenn dieses Argument auf true gesetzt wird, ist die ausgewählte Katalogservicedomäne die Standarddomäne für die Zelle. (Boolean)
-properties Gibt angepasste Eigenschaften für die Katalogservicedomäne.
Tabelle 4. Argumente für den Schritt "modifyEndpoints"
Argument Beschreibung
Name_des_Endpunkts Gibt den Namen des Katalogserviceendpunkts an.
  • Für vorhandene Anwendungsserver: Der Name des Endpunkts muss das folgende Format haben: Zellenname\Knotenname\Servername.
  • Für ferne Server: Gibt den Hostnamen des fernen Servers an. Sie können denselben Namen für mehrere Endpunkte verwenden, aber die Listener-Port-Werte müssen für jeden Endpunkt eindeutig sein. Dieser Wert muss ein vollständig qualifizierter Domänenname sein, wenn Sie ein Gerät konfigurieren.
Endpunktports
Gibt die Portnummern für den Endpunkt der Katalogservicedomäne an. Die Endpunkte müssen in der folgenden Reihenfolge angegeben werden: <Client-Port>,<Listener-Port>.
Client-Port
Gibt den Port an, der für die Kommunikation zwischen den Katalogservern in der Katalogservicedomäne verwendet wird. Dieser Wert ist nur für Katalogserver erforderlich, die in Prozessen von WebSphere Application Server ausgeführt werden und kann auf jeden Port gesetzt werden, der noch nicht verwendet wird.
Listener-Port
Gibt den Port an, der für die Kommunikation mit Clients verwendet wird. Dieser Wert ist für ferne Endpunkte erforderlich und muss mit dem Wert übereinstimmen, der beim Start des Katalogservice verwendet wurde. Der Listener-Port wird von Clients und Containern für die Kommunikation mit dem Katalogservice verwendet.
Für ferne Endpunkte von WebSphere DataPower XC10 Appliance: Verwenden Sie den Wert 2809 für die fernen Endpunkte des Geräts.
Tabelle 5. Argumente für den Schritt "addEndpoints"
Argument Beschreibung
Name_des_Endpunkts Gibt den Namen des Katalogserviceendpunkts an.
  • Für vorhandene Anwendungsserver: Der Name des Endpunkts muss das folgende Format haben: Zellenname\Knotenname\Servername.
  • Für ferne Server: Gibt den Hostnamen des fernen Servers an. Sie können denselben Namen für mehrere Endpunkte verwenden, aber die Listener-Port-Werte müssen für jeden Endpunkt eindeutig sein. Dieser Wert muss ein vollständig qualifizierter Domänenname sein, wenn Sie ein Gerät konfigurieren.
angepasste_Eigenschaften Gibt angepasste Eigenschaften für den Endpunkt der Katalogservicedomäne an. Wenn Sie keine angepassten Eigenschaften haben, verwenden Sie für dieses Argument ein Paar doppelter Anführungszeichen ("").
Endpunktports
Gibt die Portnummern für den Endpunkt der Katalogservicedomäne an. Die Endpunkte müssen in der folgenden Reihenfolge angegeben werden: <Client-Port>,<Listener-Port>.
Client-Port
Gibt den Port an, der für die Kommunikation zwischen den Katalogservern in der Katalogservicedomäne verwendet wird. Dieser Wert ist nur für Katalogserver erforderlich, die in Prozessen von WebSphere Application Server ausgeführt werden und kann auf jeden Port gesetzt werden, der noch nicht verwendet wird.
Listener-Port
Gibt den Port an, der für die Kommunikation mit Clients verwendet wird. Dieser Wert ist für ferne Endpunkte erforderlich und muss mit dem Wert übereinstimmen, der beim Start des Katalogservice verwendet wurde. Der Listener-Port wird von Clients und Containern für die Kommunikation mit dem Katalogservice verwendet.
Für ferne Endpunkte von WebSphere DataPower XC10 Appliance: Verwenden Sie den Wert 2809 für die fernen Endpunkte des Geräts.
Tabelle 6. Argumente für den Schritt "removeEndpoints"
Argument Beschreibung
Name_des_Endpunkts Gibt den Namen des zu löschenden Katalogserviceendpunkts an.

Rückgabewert:

Beispielsyntax für den Stapelmodus
  • Mit Jacl:
    $AdminTask modifyXSDomain {-name TestDomain -default true -modifyEndpoints 
    {{xhost1.ibm.com "" ,2809}} -addEndpoints {{xhost2.ibm.com "" ,2809}}} 
    -removeEndpoints {{xhost3.ibm.com}}}
  • Mit Jython (Zeichenfolge):
    AdminTask.modifyXSDomain('[-name TestDomain  
    -default false -modifyEndpoints [[xhost1.ibm.com "" ,2809]] 
    -addEndpoints [[xhost3.ibm.com "" ,2809]] 
    -removeEndpoints [[xhost2.ibm.com]]]')
Beispielsyntax für den Dialogmodus:
  • Mit Jacl:
    $AdminTask modifyXSDomain {-interactive}
  • Mit Jython (Zeichenfolge):
    AdminTask.modifyXSDomain ('[-interactive]')

testXSDomainConnection

Der Befehl "testXSDomainConnection" testet die Verbindung zu einer Katalogservicedomäne.

Erforderliche Parameter:
-name
Gibt den Namen der Katalogservicedomäne an, zu der die Verbindung getestet werden soll.
Optionale Parameter
-timeout
Gibt an, wie lange maximal (in Sekunden) auf die Verbindung gewartet wird.

Rückgabewert: Wenn eine Verbindung hergestellt werden kann, gibt der Befehl true zurück. Andernfalls werden Informationen zum Verbindungsfehler zurückgegeben.

Beispielsyntax für den Stapelmodus
  • Mit Jacl:
    $Admintask testXSDomainConnection
  • Mit Jython (Zeichenfolge):
    AdminTask.testXSDomainConnection
Beispielsyntax für den Dialogmodus:
  • Mit Jacl:
    $AdminTask testXSDomainConnection {-interactive}
  • Mit Jython (Zeichenfolge):
    AdminTask.testXSDomainConnection ('[-interactive]')

testXSServerConnection

Der Befehl "testXSServerConnection" testet die Verbindung zu einem Katalogserver. Dieser Befehl funktioniert für eigenständige Server und für Server, die zu einer Katalogservicedomäne gehören.

Erforderliche Parameter:
host
Gibt den Host an, auf dem sich der Katalogserver befindet.
listenerPort
Gibt den Listener-Port für den Katalogserver an.
Optionale Parameter
timeout
Gibt an, wie lange maximal (in Sekunden) auf eine Verbindung zum Katalogserver gewartet wird.

Rückgabewert:

Beispielsyntax für den Stapelmodus
  • Mit Jacl:
    $Admintask testXSServerConnection {-host xhost1.ibm.com -listenerPort 2809}
  • Mit Jython (Zeichenfolge):
    AdminTask.testXSServerConnection('[-host xshost3.ibm.com -listenerPort 2809]')
Beispielsyntax für den Dialogmodus:
  • Mit Jacl:
    $AdminTask testXSServerConnection {-interactive}
  • Mit Jython (Zeichenfolge):
    AdminTask.testXSServerConnection ('[-interactive]')