No Silver Bullet

asadmin - Hilfestellungen

Bereits in der Einführung zu asadmin habe ich geschrieben, dass asadmin eine Vielzahl von Kommandos versteht. Um nicht alle Kommandos auswendig lernen zu müssen, bietet asadmin geeignete Hilfestellungen an.

Bspw. verwendet GlassFish IIOP- und HTTP-Listener. Will man nun einen neuen anlegen, so kann man einfach

asadmin listener

eingeben und bekommt alle Befehle, die den Text "listener" enthalten, aufgelistet:

Closest matching command(s):
    create-http-listener
    create-iiop-listener
    delete-http-listener
    delete-iiop-listener
    list-http-listeners
    list-iiop-listeners
CLI001 Ungültiger Befehl listener. Listen Sie die gültigen Befehle mithilfe von "asadmin help" auf.

Bei der Suche kann man zudem den Asterisk als Platzhalter für beliebige Zeichenfolgen verwenden. Will man alle Befehle anzeigen, die einen Listener erzeugen, gibt man anstelle des Obigen den folgenden Befehl ein:

asadmin create.*listener

Das Ergebnis sieht dann wie folgt aus:

Closest matching command(s):
    create-http-listener
    create-iiop-listener
CLI001 Ungültiger Befehl create.*listener. Listen Sie die gültigen Befehle mithilfe von "asadmin help" auf.

Zu beachten ist, dass wie bei regulären Ausdrücken ".*" und nicht einfach "*" zu verwenden ist. Leider funktionieren aber nicht alle reguläre Ausdrücke. Das Dollarzeichen für ein Zeilenende wird verwendet, das Caret (^) für den Zeilenanfang hingegen wird nicht ausgewertet.

Vergleichbare Hilfestellungen bekommt man, wenn man das Kommando falsch geschrieben hat. Auch dann werden die Kommandos gelistet, die dem eingegebenen am Ähnlichsten sind.

Gibt man ein Kommando ohne Argumente ein oder lässt man ein Pflichtattribut aus, so werden die benötigten Argumente angezeigt. Auch hierzu wieder ein Beispiel. Gibt man

asadmin create-http-listener

ein, so erhält man die folgende Ausgabe, die alle benötigten Attribute anzeigt, zusammen mit der Angabe, welche davon Pflichtattribute sind und welche nur optionale (anhand der []-Klammerung zu erkennen).

Verwendung: create-http-listener --listeneraddress address --listenerport listener_port --defaultvs virtual_server [--terse=false] [--echo=false] [--interactive=true] [--host localhost] [--port 4848|4849] [--secure | -s] [--user admin_user] [--passwordfile file_name] [--servername server_name] [--acceptorthreads acceptor_threads] [--xpowered=true] [--redirectport redirect_port] [--securityenabled=false] [--enabled=true] [--target target(Default server)] listener_id
CLI014 listenerport ist eine erforderliche Option.

Weitaus weniger komfortabel ist die direkte Hilfefunktion:

asadmin help

listet einem alle Befehle in einer rasch über den Bildschirm laufenden Liste auf. Glücklicherweise sollte diese Hilfe aufgrund der obigen Hilfestellungen nur selten notwendig sein. Weitaus nützlicher ist die Hilfe zu den einzelnen Kommandos, die man mit

asadmin help kommando

angezeigt bekommt. Auch hier wird die gesamte Hilfe auf einmal angezeigt. Ein geeigneter Pager (less oder more) bieten sich hier an. Die Hilfe bietet einem stets genaue Angaben zu den möglichen Attributen und einige allgemeine Hinweise zu dem Kommando. Sie ist letztlich eine im Ascii-Format abgelegte man-Page. Auf Solaris steht diese auch als reguläre man-Page zur Verfügung, bei den Linux- oder Mac OS X-Downloads ist dies derzeit aber leider noch nicht der Fall.

Gepostet am 03.06.2008 um 09:03  |  Kommentare[0]