Verwenden von encUtilCmd › server – Anzeige des Status des ENC-Gateway-Servers

server – Anzeige des Status des ENC-Gateway-Servers

Dieser Befehl zeigt den Status eines ENC-Gateway-Servers an. Darüber hinaus zeigt er Folgendes an:

• Die Liste der Clients und Server, die beim Gateway-Manager registriert sind.
• Die Liste der Verbindungen, die derzeit von einem Gateway-Router bedient werden.
• Die ENC-Topologie und andere Optionen.

Der Befehl bietet zudem Optionen zum Filtern oder zum Senden der Ausgabe an eine Datei.

Die Syntax lautet wie folgt:

Encutilcmd server [Abfrageoption] [Argumente] [-host <Hostname>] [-port <n>] [-v] [-dump <Datei>]

Abfrageoptionen

-client [[-fqdn <Hostname>] [-pattern]]

Fragt den Server nach registrierten Clients ab.

-connection

Fragt einen Router nach aktiven ENC-Verbindungen ab.

-general

Fragt den Status eines Servers ab.

-router

Fragt einen Server nach registrierten Gateway-Routern ab.

-server

Fragt einen ENC-Gateway-Manager nach den registrierten Servern ab.

-topology

Fragt einen ENC-Gateway-Manager nach der ENC-Netzwerk-Topologie ab.

Argumente

-dump <Dateiname>

Schreibt die Befehlsausgabe in eine XML-Datei. Diese kann in einem Web-Browser oder einem Texteditor angezeigt oder von anderen Programmen weiterverarbeitet werden.

-fqdn <Hostname>

Gibt einen Hostnamen oder ein Muster an, nach dem die Ausgabe von "-client" gefiltert werden soll.

Hinweis: Wenn "-pattern" angegeben wird, ist der Wert von "-fqdn" ein Muster, andernfalls ist er ein Hostname.

-host <Hostname>

Gibt den voll qualifizierten Domänennamen des Gateway-Servers an, der abgefragt werden soll.

Standard: Lokaler Host

-pattern

Gibt den Wert, der -fqdn folgt, als regulären Ausdruck an, um die übereinstimmenden Clients zu suchen.

Standard: Der voll qualifizierte Domänenname entspricht einem einzelnen Computer.

Hinweis: Die Syntax des regulären Ausdrucks entspricht dem Perl-Standard.

-port <n>

Gibt die Port-Nummer des Servers auf dem Zielcomputer an.

Standard: 443

-v

Gibt an, dass die Ausgabe ausführlich erfolgen soll, sofern möglich.

Dabei gilt:

-client

Mit dieser Option wird eine Liste der ENC-Clients abgerufen (encClient.exe), die beim angegebenen Server registriert sind.

Wenn der Zielserver ein ENC-Manager ist, werden alle Client zurückgegeben. Wenn der Zielserver ein ENC-Server ist, werden nur die Clients zurückgegeben, die bei diesem Server registriert sind.

Hinweis: Router geben nichts zurück.

Für eine Vielzahl an Clients können Sie die Ausgabe mit Hilfe des -dump-Arguments an eine Datei senden oder die Ausgabe mit Hilfe einer Musterübereinstimmung filtern.

Die Ausgabe für jeden Client umfasst folgende Informationen:

• Voll qualifizierter Domänenname
• Host-UUID
• Virtuelle ENC-Adresse
• Zeitzone

Beispiele: Alle Clients auflisten

• In diesem Beispiel werden alle Clients auf dem ENC-Server aufgelistet, der auf dem lokalen Host ausgeführt wird.

     encutilcmd server -client
  

• In diesem Beispiel werden alle Clients auf dem ENC-Server aufgelistet, der auf dem Computer "mymgr" ausgeführt wird.

     encutilcmd server -client -host mymgr 
  

• In diesem Beispiel werden alle Clients auf dem ENC-Server aufgelistet, der auf dem Computer "mymgr" ausgeführt wird, der sich in der Domäne "fred.com" befindet.

     encutilcmd server -client -host mymgr -fqdn .*\.fred\.com -pattern
  

• Dieses Beispiel zeigt Informationen über den ENC-Client an, der auf "host1.fred.com" ausgeführt wird.

     encutilcmd server -client -host mymgr -fqdn host1.fred.com
  

-connection

Diese Option fragt einen Gateway-Router nach aktiven Verbindungen ab.

Für jede Verbindung wird Folgendes angezeigt:

• Der Host, der die Verbindung hergestellt hat.
• Der Host, der die Verbindung akzeptiert hat.

Während der Router Daten zwischen diesen Hosts überträgt, zeigt er für jeden Host Folgendes an:

• Die echte IP-Adresse
• Das Zertifikat, das von diesem Host für die Authentifizierung verwendet wird. Die Zertifikatsbeschreibung enthält den voll qualifizierten Domänennamen des Hosts.

-general

Diese Option zeigt die allgemeinen Informationen des Servers an. Diese Option wird auch als Standardabfrage verwendet, wenn keine andere Abfrage angegeben ist.

Die allgemeinen Informationen umfassen Folgendes:

• Servertyp (Manager, Server, Router oder Alle)
• Versions-ID
• Der Zeitraum, seit dem der Server ausgeführt wird.
• Die Port-Nummer für ENC-Verbindungen.
• Der voll qualifizierte Domänenname des ENC-Servers, bei dem er registriert ist. (ENC-Server oder Manager)
• Die Anzahl der registrierten Server.
• Der Adressbereich, den er verwendet, um Clients virtuelle ENC-Adressen zuzuordnen, falls der angegebene Host ein ENC-Gateway ist. Manager.

Beispiele: Allgemeine Informationen zum Server anzeigen

• In diesem Beispiel werden allgemeine Informationen zum Server auf dem lokalen Host angezeigt.

     encutilcmd server
  

• In diesem Beispiel werden allgemeine Informationen zum Server auf dem Host "myhost.xyz.com" angezeigt.

     encutilcmd server -general -host myhost.xyz.com
  

-router

Zeigt die Liste der Gateway-Router an, die beim Zielserver registriert sind.

Für jeden Router wird Folgendes angezeigt:

• Die Zertifikats-URL, die vom Router verwendet wird, um sich beim Manager zu authentifizieren.
• Servertyp (Server, Router oder beide)
• Die Port-Nummer für Client-Verbindungen
• Versions-ID

Das folgende Beispiel zeigt die Router, die bei "mymgr.xyz.com" registriert sind.

Encutilcmd server -router -host mymgr.xyz.com

-server

Diese Option zeigt die Liste der Gateway-Server an, die beim Zielserver registriert sind. Wenn diese Option mit einem Gateway-Manager verwendet wird, werden alle Server angezeigt. Bei Verwendung mit einem Gateway-Server werden alle bei diesem Server registrierten Router angezeigt. Die angezeigten Informationen sind mit den Informationen der -router-Option identisch.

Das folgende Beispiel zeigt die Server, die bei "mymgr.xyz.com" registriert sind.

Encutilcmd server -server -host mymgr.xyz.com

-topology

Diese Option zeigt die Topologie des ENC-Netzwerks an. Sie zeigt ganz oben den Gateway-Manager und darunter eine eingerückte Liste mit Servern und Routern an.

Für jeden Server werden die bei folgenden Komponenten registrierten Server angezeigt:

Manager

Server1 (Dieser Server wird beim Manager registriert.)

Server2 (Dieser Server wird ebenfalls beim Manager registriert.)

Router1 (Dieser Router wird bei Server2 registriert.)

Router2

Server3

Router3

Router4 (Dieser Router wird beim Manager registriert.)

Das folgende Beispiel zeigt die Topologie des ENC-Gateway-Managers "mymgr.xyz.com".

Encutilcmd server -topology -host mymgr.xyz.com