Verwaltungstasks für die Katalogservicedomäne

Sie können die Scripting-Sprachen Jacl und Jython verwenden, um Katalogservicedomänen in Ihrer Konfiguration von WebSphere Application Server zu verwalten.

Voraussetzungen

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

Alle Verwaltungstasks auflisten

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

Befehle

Die Verwaltungstasks 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 aufweisen: 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 Werte für den Client-Port müssen für jeden Endpunkt identisch sein.
angepasste_eigenschaften Gibt angepasste Eigenschaften für den Endpunkt der Katalogservicedomäne an. Wenn Sie über keine angepassten Eigenschaften verfügen, geben Sie für dieses Argument ein Paar hochgestellter Anführungszeichen ("") an.
endpunkt-ports
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. Die Angabe dieses Werts ist für Katalogserver erforderlich, die nur in Prozessen von WebSphere Application Server ausgeführt werden. Als Wert kann ein beliebiger Port definiert werden, der nicht an anderer Stelle 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 Starten des Katalogservice verwendet wurde. Der Listener-Port wird von Clients und Containern zum Kommunizieren mit dem Katalogservice verwendet.
Für ferne WebSphere DataPower XC10 Appliance-Endpunkte: Verwenden Sie den Wert 2809 für die fernen Geräteendpunkte.

Rückgabewert:

Beispielsyntax für den Stapelmodus

Für den Stapelmodus ist die korrekte Formatierung des Befehlseintrags erforderlich. Erwägen Sie die Verwendung des interaktiven Modus, um sicherzustellen, dass die von Ihnen eingegebenen Werte korrekt verarbeitet werden. Bei Verwendung des Stapelmodus müssen Sie die Argumente für den Schritt -defineDomainServers anhand eines bestimmten Arrays von Eigenschaften definieren. Dieser Array von Eigenschaften wird im Format name_des_endpunkts angepasste_eigenschaften endpunktports angegeben. Bei dem Wert für endpunkt-ports handelt es sich um eine Liste von Ports, deren Angabe in der folgenden Reihenfolge erfolgen muss: <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.

Für den Stapelmodus ist die korrekte Formatierung des Befehlseintrags erforderlich. Erwägen Sie die Verwendung des interaktiven Modus, um sicherzustellen, dass die von Ihnen eingegebenen Werte korrekt verarbeitet werden. Bei Verwendung des Stapelmodus müssen Sie die Argumente für die Schritte -modifyEndpoints, -addEndpoints und -removeEndpoints anhand eines bestimmten Arrays von Eigenschaften definieren. Dieser Array von Eigenschaften wird im Format name_des_endpunkts hostname angepasste_eigenschaften endpunkt-ports angegeben. Bei dem Wert für endpunkt-ports handelt es sich um eine Liste von Ports, deren Angabe in der folgenden Reihenfolge erfolgen muss: <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 aufweisen: 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 Werte für den Listener-Port müssen für jeden Endpunkt identisch sein. Dieser Wert muss ein vollständig qualifizierter Domänenname sein, wenn Sie ein Gerät konfigurieren.
endpunkt-ports
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. Die Angabe dieses Werts ist für Katalogserver erforderlich, die nur in Prozessen von WebSphere Application Server ausgeführt werden. Als Wert kann ein beliebiger Port definiert werden, der nicht an anderer Stelle 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 Starten des Katalogservice verwendet wurde. Der Listener-Port wird von Clients und Containern zum Kommunizieren mit dem Katalogservice verwendet.
Für ferne WebSphere DataPower XC10 Appliance-Endpunkte: Verwenden Sie den Wert 2809 für die fernen Geräteendpunkte.
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 aufweisen: 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 Werte für den Listener-Port müssen für jeden Endpunkt identisch 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 über keine angepassten Eigenschaften verfügen, geben Sie für dieses Argument ein Paar hochgestellter Anführungszeichen ("") an.
endpunkt-ports
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. Die Angabe dieses Werts ist für Katalogserver erforderlich, die nur in Prozessen von WebSphere Application Server ausgeführt werden. Als Wert kann ein beliebiger Port definiert werden, der nicht an anderer Stelle 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 Starten des Katalogservice verwendet wurde. Der Listener-Port wird von Clients und Containern zum Kommunizieren mit dem Katalogservice verwendet.
Für ferne WebSphere DataPower XC10 Appliance-Endpunkte: Verwenden Sie den Wert 2809 für die fernen Geräteendpunkte.
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]')