Referenzinformationen zum Dienstprogramm xsadmin

Sie können Argumente mit zwei verschiedenen Methoden an das Dienstprogramm xsadmin übergeben: mit einem Befehlszeilenargument oder mit einer Eigenschaftendatei.

Argumente für xsadmin

Sie können eine Eigenschaftendatei für das Dienstprogramm xsadmin mit WebSphere eXtreme Scale Client Version 7.1 Fix 1 oder höher definieren. Durch die Erstellung einer Eigenschaftendatei können Sie sich die Eingabe häufig verwendeter Argumente, wie z. B. des Benutzernamens, sparen. Die Eigenschaften, die Sie einer Eigenschaftendatei hinzufügen können, sind in der folgenden Tabelle aufgelistet. Wenn Sie eine Eigenschaft in einer Eigenschaftendatei und mit dem entsprechenden Befehlszeilenargument angeben, überschreibt der Wert des Befehlszeilenarguments den Wert in der Eigenschaftendatei.

Tabelle 1. Argumente für das Dienstprogramm xsadmin
Befehlszeilenargument Entsprechender Eigenschaftsname in der Eigenschaftendatei Beschreibung und gültige Werte
-bp Nicht zutreffend

Gibt den Listener-Port an.

Standardwert: 2809

-ch Nicht zutreffend

Gibt den JMX-Hostnamen für den Katalogserver an.

Standardwert: localhost

-clear Nicht zutreffend

Bereinigt die angegebene Map.

Die folgenden Filter sind zulässig: -fm

-containers Nicht zutreffend Zeigt für jedes Daten-Grid und jedes MapSet eine Liste von Container-Servern an.

Die folgenden Filter sind zulässig: -fnp

-continuous Nicht zutreffend Geben Sie dieses Flag an, wenn Sie fortlaufende Ergebnisse zur Map-Größe anzeigen möchten, um das Datengid zu überwachen. Wenn Sie diesen Befehl mit dem Argument -mapsizes ausführen, wird die Map-Größe alle 20 Sekunden angezeigt.
-coregroups Nicht zutreffend Zeigt alle Stammgruppen für den Katalogserver an. Dieses Argument wird für die erweiterte Diagnose verwendet.
-dismissLink <Katalogservicedomäne> Nicht zutreffend

Dieses Befehlszeilenargument gilt nicht für Konfigurationen von WebSphere DataPower XC10 Appliance.

-dmgr Nicht zutreffend

Dieses Befehlszeilenargument gilt nicht für Konfigurationen von WebSphere DataPower XC10 Appliance.

-empties Nicht zutreffend Geben Sie dieses Flag an, wenn Sie leere Container in der Ausgabe anzeigen möchten.
-establishLink <Name_der_fremden_Domäne> <Host1:Port1,Host2:Port2...> Nicht zutreffend

Dieses Befehlszeilenargument gilt nicht für Konfigurationen von WebSphere DataPower XC10 Appliance.

-fc Nicht zutreffend Filtert nur den angegebenen Container.
Wenn Sie Container-Server in einer Umgebung von WebSphere Application Server Network Deployment filtern möchten, verwenden Sie das folgende Format:
<Zellenname>/<Knotenname>/<Servername_Containersuffix>

Verwenden Sie diesen Filter mit den folgenden Argumenten: -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec

-fh Nicht zutreffend Filtert nur den angegebenen Host.

Verwenden Sie diesen Filter mit den folgenden Argumenten: -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec,-routetable

-fm Nicht zutreffend Filtert nur die angegebene Map.

Verwenden Sie diesen Filter mit den folgenden Argumenten: -clear, -mapsizes

-fnp Nicht zutreffend Filtert Server, die keine primären Shards haben.

Verwenden Sie diesen Filter mit den folgenden Argumenten: -containers

-fp Nicht zutreffend Filtert nur die angegebene Partition.

Verwenden Sie diesen Filter mit den folgenden Argumenten: -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec,-routetable

-fs Nicht zutreffend Filtert nur den angegebenen Server.
Wenn Sie Anwendungsserver in einer Umgebung von WebSphere Application Server Network Deployment filtern möchten, verwenden Sie das folgende Format:
<Zellenname>/<Knotenname>/<Servername>

Verwenden Sie diesen Filter mit den folgenden Argumenten: -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec

-fst Nicht zutreffend Filtert nur den angegebene Shard-Typ. Geben Sie P für primäre Shards, A für asynchrone Replikat-Shards und S für synchrone Replikat-Shards an.

Verwenden Sie diesen Filter mit den folgenden Argumenten: -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec

-fz Nicht zutreffend Filtert nur die angegebene Zone.

Verwenden Sie diesen Filter mit den folgenden Argumenten: -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec,-routetable

-force Nicht zutreffend Erzwingt die mit dem Befehl angegebene Aktion und inaktiviert damit alle präventiven Aufforderungen. Dieses Argument ist für die Ausführung von Befehlen in Stapeln hilfreich.
-g Nicht zutreffend Gibt den ObjectGrid-Namen an.
-getstatsspec Nicht zutreffend Zeigt die aktuelle Statistikspezifikation an. Sie können die Statistikspezifikation mit dem Argument -setstatsspec festlegen.

Die folgenden Filter sind zulässig: -fst -fc -fz -fs -fh -fp

-getTraceSpec Nicht zutreffend Zeigt die aktuelle Tracespezifikation an. Sie können die Tracespezifikation mit dem Argument -settracespec festlegen.

Die folgenden Filter sind zulässig: -fst -fc -fz -fs -fh -fp

-h Nicht zutreffend Zeigt die Hilfe für das Dienstprogramm xsadmin an, die eine Liste von Argumenten enthält.
-hosts Nicht zutreffend Zeigt alle Hosts in der Konfiguration an.
-jmxUrl XSADMIN_JMX_URL Gibt die Adresse eines JMX-API-Connector-Servers im folgenden Format an: service:jmx:Protokoll:sap. Die Variablendefinitionen für protocol und sap folgen:
Protokoll
Gibt das Transportprotokoll an, das für die Herstellung der Verbindung zum Connector-Server verwendet werden soll.
sap
Gibt die Adresse an, unter der der Connector-Server zu erreichen ist.
Weitere Informationen zum Format des JMX-Service-URL finden Sie unter Class JMXServiceURL (Java 2 Platform SE 5.0).
-l Nicht zutreffend Zeigt alle bekannten Daten-Grids und MapSets an.
-m Nicht zutreffend Gibt den Namen des MapSets an.
-mapsizes Nicht zutreffend Zeigt die Größe jeder Map im Katalogserver an. Mithilfe dieser Informationen können Sie prüfen, ob die Schlüsselverteilung auf die Shards einheitlich erfolgt ist.

Die folgenden Filter sind zulässig: -fm -fst -fc -fz -fs -fh -fp

-mbeanservers Nicht zutreffend Zeigt eine Liste aller MBean-Server-Endpunkte an.
-overridequorum Nicht zutreffend

Dieses Befehlszeilenargument gilt nicht für Konfigurationen von WebSphere DataPower XC10 Appliance.

-password XSADMIN_PASSWORD Gibt das Kennwort für die Anmeldung beim Dienstprogramm xsadmin an. Geben Sie das Kennwort nicht in der Eigenschaftendatei an, wenn Sie möchten, dass Ihr Kennwort sicher bleibt.
-p Nicht zutreffend

Dieses Befehlszeilenargument gilt nicht für Konfigurationen von WebSphere DataPower XC10 Appliance.

  Nicht zutreffend Zeigt die konfigurierte Verteilung und die Laufzeitverteilung Ihrer Konfiguration an. Sie können eine Ausgabe für eine Kombination von Daten-Grids und MapSets oder für die gesamte Konfiguration erstellen:
  • Gesamte Konfiguration:
    -placementStatus
  • Bestimmtes Daten-Grid:
    -placementStatus -g my_grid
  • Bestimmtes MapSet:
    -placementStatus -m my_mapset
  • Bestimmtes Daten-Grid und bestimmtes MapSet:
    -placementStatus  -g my_grid 
    -m my_mapset
-primaries Nicht zutreffend Zeigt eine Liste der primären Shards an.
-profile Nicht zutreffend Gibt einen vollständig qualifizierten Pfad zur Eigenschaftendatei für das Dienstprogramm xsadmin an.
-quorumstatus Nicht zutreffend

Dieses Befehlszeilenargument gilt nicht für Konfigurationen von WebSphere DataPower XC10 Appliance.

-releaseShard <Name_des_Container-Servers> <ObjectGrid-Name> <MapSet-Name> <Partitionsname> Nicht zutreffend Wird zusammen mit dem Argument -reserveShard verwendet. Das Argument -releaseShard muss nach der Reservierung oder Verteilung eines Shards aufgerufen werden. Das Argument -releaseShard ruft die Methode ContainerMBean.release() auf.
-reserved Nicht zutreffend Wird mit dem Argument -containers verwendet, um nur die Shards anzuzeigen, die mit dem Argument -reserveShard reserviert wurden.
-reserveShard <Name_des_Container-Servers> <ObjectGrid-Name> <MapSet-Name> <Partitionsname> Nicht zutreffend Verschiebt ein primäres Shard in den angegebenen Container-Server. Die Methode ContainerMBean.reserve() wird von diesem Argument aufgerufen.

-resumeBalancing <ObjectGrid-Name> <MapSet-Name>

Nicht zutreffend Versucht, Anforderungen zu verteilen. Ermöglicht künftige Neuverteilungsversuche an das angegebene ObjectGrid und das angegebene MapSet.
-revisions Nicht zutreffend Zeigt Revisions-IDs für eine Katalogservicedomäne an, einschließlich Daten-Grids, Partitionsnummer, Partitionstyp (primär oder Replikat), Katalogservicedomäne, Lebensdauer-ID und Anzahl der Datenüberarbeitungen für jedes Shard. Sie können dieses Argument verwenden, um festzustellen, ob Sie ein asynchrones Replikat oder eine verbundene Domäne haben. Dieses Argument ruft die Methode ObjectGridMBean.getKnownRevisions() auf.

Die folgenden Filter sind zulässig: -fst -fc -fz -fs -fh -fp

-routetable Nicht zutreffend Zeigt den aktuellen Status des Daten-Grids aus der Perspektive des Client-Servers an. Die Routentabelle enthält die Informationen, die ein ObjectGrid-Client-Server verwendet, um mit dem Daten-Grid zu kommunizieren. Verwenden Sie die Routentabelle als Diagnosehilfe, wenn Sie versuchen, Verbindungsprobleme oder Ausnahmen des Typs TargetNotAvailable zu ermitteln.

Erforderliche Argumente: In einer eigenständigen Umgebung müssen Sie die Parameter -bp und -p mit diesem Argument angeben, wenn Sie die Standardwerte für den Bootstrap-Listener-Port und den JMX-Port für den Host des Katalogservers nicht verwenden.

Die folgenden Filter sind zulässig: -fz -fh -fp

-settracespec <Tracezeichenfolge> Nicht zutreffend

Dieses Befehlszeilenargument gilt nicht für Konfigurationen von WebSphere DataPower XC10 Appliance. Weitere Informationen zum Konfigurieren der Traceerstellung auf dem Gerät finden Sie unter Mit WebSphere DataPower XC10 Appliance-Protokolldateien arbeiten.

Die folgenden Filter sind zulässig: -fst -fc -fz -fs -fh -fp

-swapShardWithPrimary <Name_des_Container-Servers> <ObjectGrid-Name> <MapSet-Name> <Partitionsname>

Nicht zutreffend Tauscht das angegebene Replikat-Shard aus dem angegebenen Container-Server mit dem primären Shard aus. Mit diesem Befehl können Sie primäre Shards bei Bedarf manuell verteilten.
-setstatsspec <Statistikspezifikation> Nicht zutreffend Aktiviert die Statistikerfassung. Dieses Argument ruft die Methoden DynamicServerMBean.setStatsSpec und DynamicServerMBean.getStatsSpec auf.

Die folgenden Filter sind zulässig: -fm -fst -fc -fz -fs -fh -fp

-suspendBalancing <ObjectGrid-Name> <MapSet-Name>

Nicht zutreffend Verhindert künftige Versuche, das angegebene ObjectGrid und das angegebene MapSet zu verteilen.
-ssl Nicht zutreffend Gibt an, dass Secure Sockets Layer (SSL) aktiviert wird.
-teardown Nicht zutreffend

Die folgenden Filter sind zulässig: -fst -fc -fz -fs -fh -fp

Format für die Angabe der Serverliste:
Servername_1,Servername_2 ...
Zum Stoppen aller Server in einer Zone schließen Sie das Argument -fz ein:
–fz <Zonenname>
Zum Stoppen aller Server auf einem Host schließen Sie das Argument -fh ein:
–fh <Hostname>

Dieses Befehlszeilenargument gilt nicht für Konfigurationen von WebSphere DataPower XC10 Appliance.

  Nicht zutreffend Erzwingt die Durchführung der Shard-Verteilung, wobei der für numInitialContainers konfigurierte Wert in der XML-Implementierungsdatei ignoriert wird. Sie können dieses Argument verwenden, wenn Sie Wartungsarbeiten an den Servern vornehmen, um die Fortsetzung der Shard-Verteilung zuzulassen, selbst wenn der Wert von numInitialContainers kleiner ist als der konfigurierte Wert.
-trustPass XSADMIN_TRUST_PASS Gibt das Kennwort für den angegebenen Truststore an.
-trustPath XSADMIN_TRUST_PATH Gibt einen Pfad zur Truststore-Datei an.

Beispiel: etc/test/security/server.public

-trustType XSADMIN_TRUST_TYPE Gibt den Typ des Truststores an.

Die gültigen Werte sind JKS, JCEK, PKCS12 usw.

-unassigned Nicht zutreffend Zeigt eine Liste mit Shards an, die nicht im Daten-Grid verteilt werden können. Shards können nicht verteilt werden, wenn der Verteilungsservice eine Einschränkung aufweist, die die Verteilung verhindert.
-username XSADMIN_USERNAME Gibt den Benutzernamen für die Anmeldung beim Dienstprogramm xsadmin an.
-v Nicht zutreffend Aktiviert die ausführliche Befehlszeilenaktion. Verwenden Sie dieses Flag, wenn Sie Umgebungsvariablen und/oder eine Eigenschaftendatei verwenden, um bestimmte Befehlszeilenargumente anzugeben und deren Werte anzuzeigen.
-xml Nicht zutreffend Gibt die ungefilterte Ausgabe der Methode PlacementServiceMBean.listObjectGridPlacement() an. Die anderen xsadmin-Argumente filtern die Ausgabe dieser Methode und organisieren die Daten in einem benutzerfreundlicheren Format.
Übergeordnetes Thema: Überwachung mit dem Dienstprogramm xsadmin