QF-Test Startoptionen für den Betrieb und die Administration des Lizenzservers

5.2+ Für maximale Flexibilität wird bei den Namen der QF-Test Kommandozeilenargumente Groß-/Kleinschreibung ebenso ignoriert, wie enthaltene '-', '_', '.' oder ':'-Zeichen. Somit ist -licenseserver.logfile äquivalent zu --licenseserverLogfile oder -licenseserver-logfile. Letzteres ist die offiziell dokumentierte Form, da sie Konflikte mit der Windows PowerShell vermeidet.

WindowsDas Programm qftest.exe ist eine Windows GUI-Anwendung. Wird diese von der Eingabeaufforderung gestartet, wartet sie nicht darauf, dass QF-Test beendet wird, sondern kehrt sofort zurück, so dass keine Ausgaben von QF-Test auf der Konsole angezeigt werden. Für den Betrieb des QF-Test Lizenzservers als Windows service oder Autostart-Programm ist dies irrelevant. Für die Ausführung von der Eingabeaufforderung ist aber die Konsolen-Anwendung qftestc.exe besser geeignet. Sie wartet, bis QF-Test sich beendet, Ausgaben werden im Konsolenfenster angezeigt. Ansonsten gilt das, was in diesem Handbuch über qftest.exe gesagt wird auch für qftestc.exe.

Die folgenden Befehle beziehen sich auf den Lizenzserver. Sie müssen auf dem Rechner des Lizenzservers ausgeführt werden und benötigen eine Server-Lizenz.

Lizenzserver starten

Der Lizenzserver wird wie folgt gestartet:

qftest -batch [-dbg] [-java <Programm>] [-noconsole] [-J<java-argument>]* [-license <Datei>] [-licenseserver-logfile <Datei>] [-licenseserver-verbose <Wert>] [-option <Name>=<Wert>] [-options <Datei>] -licenseserver

Administratorkennwort für den Lizenzserver setzen

Um das Administratorkennwort für den Lizenzserver selbst zu setzen, wird der folgende Befehl für <user> admin verwendet:

Die folgenden Befehle können mit QF-Test entweder auf dem Rechner des Lizenzservers oder auf einem Client-Rechner ausgeführt werden. Es wird dafür eine zum Server passende Client-Lizenz benötigt.

Lizenzserver stoppen

Mit dem folgenden Befehl kann der Lizenzserver sauber heruntergefahren werden:

qftest -batch [-dbg] [-java <Programm>] [-noconsole] [-J<java-argument>]* [-license <Datei>] [-option <Name>=<Wert>] [-options <Datei>] [-licenseserver-password <Password>] -licenseserver-shutdown

Benutzer-Kennwort für den Lizenzserver sichern

Nach einmaliger Ausführung dieses Befehls ist das Administrationskennwort für den aktuell angemeldeten Anwender gespeichert, so dass zukünftig das Befehlszeilenargument -licenseserver-password <Password> nicht angegeben werden muss:

qftest -batch [-dbg] [-java <Programm>] [-noconsole] [-J<java-argument>]* [-license <Datei>] [-option <Name>=<Wert>] [-options <Datei>] -licenseserver-setpwd admin=<Passwort>

Aktuell wird nur der Anwender admin unterstützt.

Aktueller Lizenzverbrauch - Detaillierte Informationen

Eine Liste der aktuell verwendeten Lizenzen erhält man mittels folgenden Befehls:

qftest -batch [-dbg] [-java <Programm>] [-noconsole] [-J<java-argument>]* [-license <Datei>] [-option <Name>=<Wert>] [-options <Datei>] [-licenseserver-password <Password>] -licenseserver-dump

Das Ergebnis wird als kommaseparierte Liste (CSV Format) mit Titelzeile auf stdout ausgegeben.

Aktueller Lizenzverbrauch - Überblick

Eine Übersicht über die aktuell verwendeten Lizenzen bietet folgender Befehl:

qftest -batch [-dbg] [-java <Programm>] [-noconsole] [-J<java-argument>]* [-license <Datei>] [-option <Name>=<Wert>] [-options <Datei>] [-licenseserver-password <Password>] -licenseserver-dumptotal

Das Ergebnis wird als kommaseparierte Liste (CSV Format) mit Titelzeile auf stdout ausgegeben. Die Zeilen spiegeln den aktuellen Lizenzverbrauch, die verbleibenden freien Lizenzen und die Gesamtzahl der verfügbaren Lizenzen wieder.

Spitzenverbrauch - Überblick

Der QF-Test Lizenzserver hat einen internen Zähler für den Spitzenverbrauch. Die Werte können über den folgenden Befehl angezeigt werden:

qftest -batch [-dbg] [-java <Programm>] [-noconsole] [-J<java-argument>]* [-license <Datei>] [-option <Name>=<Wert>] [-options <Datei>] [-licenseserver-password <Password>] [-licenseserver-verbose <Wert>] -licenseserver-dumppeak

Das Ergebnis wird auf stdout ausgegeben. Wenn die Einstellung für die Protokollierung -licenseserver-verbose <Wert> gleich VERBOSE oder mehr ist, wird die Uhrzeit, zu der der Spitzenwert erreicht wurde, mit angegeben. Wenn die Einstellung auf DETAIL gesetzt wird, werden zusätzlich die einzelnen Lizenzzuweisungen, die zu der Spitze führten, mit ausgegeben.

Interaktive Lizenzserveradministration

Der folgende Befehl started das zugehörige interaktive GUI für die Administration des Lizenzservers. Man kann dieses Fenster auch aus einer interaktiven QF-Test Instanz heraus über das Menü »Extras«-»Administrate Lizenzserver« starten.

qftest [-dbg] [-java <Programm>] [-J<java-argument>]* [-license <Datei>] [-option <Name>=<Wert>] [-options <Datei>] -licenseserver-admin

Die Kommandozeilenargumente für QF-Test gliedern sich in drei Kategorien.

Diese Argumente werden vom qftest Skript bzw. Programm ausgewertet und heben die Werte auf, die während der Installation gesetzt wurden. Unter Linux werden diese Einstellungen in der Datei launcher.cfg im QF-Test Wurzelverzeichnis abgespeichert, unter Windows in der Registry.

-batch: Startet QF-Test im Batchmodus. Dieses Argument ist zwingend für den Lizenzserver.
-dbg: Schaltet Debug-Ausgaben für das Startskript ein. Den selben Effekt erreichen Sie, wenn Sie die Umgebungsvariable QFTEST_DEBUG auf einen nichtleeren Wert setzen. Sofern nicht zusätzlich -noconsole angegeben ist, öffnet QF-Test unter Windows in diesem Fall ein Konsolenfenster, da die Ausgaben ansonsten nicht sichtbar wären.
-java <Programm>: Das Java Programm, das die Ausführung von QF-Test übernimmt. Standard sind java unter Linux und javaw.exe unter Windows, sofern während der Installation nichts anderes angegeben wurde.
-noconsole (Windows only): Verhindert das Öffnen eines Konsolenfensters unter Windows für den Fall, dass -dbg ebenfalls angegeben ist.

Sie können durch das Startskript Argumente an die Java VM weiterreichen, indem Sie diesen -J voranstellen, z.B. -J-Duser.language=en, um eine Systemvariable zu setzen.

Die restlichen Argumente werden von QF-Test selbst ausgewertet, wenn es von der Java VM ausgeführt wird. Diese Argumente können auch in eine Datei geschrieben werden. Das Format lautet <name>=<value> für Argumente mit Parametern und <name>=true oder <name>=false um ein einfaches Argument ein- oder auszuschalten. Normalerweise heisst diese Datei qftest.options, liegt im bin Verzeichnis von QF-Test und wird nur für interne Zwecke verwendet. Wenn Sie Änderungen an dieser Datei vornehmen, ist es sinnvoll, sie in das Wurzelverzeichnis von QF-Test zu kopieren, da diese Änderungen dadurch auch nach einem Update gültig bleiben. Alternativ können Sie über das -options <Datei> Argument eine andere Datei angeben. Argumente auf der Kommandozeile haben Vorrang vor Argumenten aus der Datei. Für Argumente, die mehrfach angegeben werden können, werden sowohl Angaben von der Kommandozeile, als auch aus der Datei übernommen.

-license <Datei>: Gibt den Speicherort der Lizenzdatei an.
-licenseserver: Startet QF-Test im Lizenzservermodus.
-licenseserver-admin: Öffnet die Bedienoberfläche für den Lizenzserver.
-licenseserver-dump: Gibt detaillierte Informationen über die aktuell verwendeten Lizenzen aus.
-licenseserver-dumptotal: Gibt einen Überblick über die aktuell verwendeten Lizenzen aus.
-licenseserver-dumppeak: Gibt Informatinen zum Spitzenverbrauch an Lizenzen aus. Falls die Detailtiefe für die Protokollierung mittels -licenseserver-verbose <Wert> auf DETAIL gesetzt ist, werden auch die einzelnen Lizenzzuweisungen, die zu der Spitze führten, aufgelistet.
-licenseserver-logfile <Datei>: Protokolleinträge werden in die angegebene Datei geschrieben. Die Standardprotokolldatei ist licenseserver.log im Verzeichnis log unter dem QF-Test Systemverzeichnis oder dem Anwenderverzeichnis. Um die Protokollierung auszuschalten, geben Sie dieses Argument mit einem leeren Wert an: -licenseserver.logfile=.
-licenseserver-password <Password>: Das Kennwort für die Anmeldung am Lizenzserver als Benutzer admin. Es kann weggelassen werden, wenn das Kennwort zuvor für den aktuellen Benutzer beim Start der Bedienoberfläche oder über das Kommandozeilenargument -licenseserver-setpwd admin=<Passwort> gesetzt wurde.
-licenseserver-setpwd admin=<Passwort>: Legt das Kennwort für die Lizenzserveradministration fest. Aktuell wird nur der Benutzer admin unterstützt. Wenn das Argument im Lizenzservermodus, d.h. Kombination mit -licenseserver ausgeführt wird, wird das Kennwort für den Lizenzserver neu gesetzt. Im Client-Modus wird das Kennwort für den aktuellen Benutzer gespeichert, so dass er sich beim Start der Lizenzserver-Bedienoberfläche nicht explizit anmelden muss und das Kennwort bei clientseitigen Operationen nicht über -licenseserver-password <Password> angegeben werden muss.
-licenseserver-shutdown: Fährt den Lizenzserver ordnungsgemäß herunter.
-licenseserver-verbose <Wert>: Legt die Detailtiefe der Protokollierung für den Lizenzserver fest. Serverseitig wird damit festgelegt, welche Informationen in die mittels -licenseserver-logfile <Datei> spezifizierte Protokolldatei geschrieben werden. Clientseitig gibt dies den Detaillierungsgrad für die Ausgabe von Befehlen wie -licenseserver-dumppeak an. Es kann die Zahlenwerte 0 bis 4, beziehungsweise die entsprechenden Konstanten NOTHING, ERRORS, TERSE, VERBOSE, DETAIL, annehmen. Der Standardwert ist TERSE.
-nomessagewindow: Wenn schwere Fehler im Batchmodus auftreten, gibt QF-Test eine Fehlermeldung in der Konsole aus und öffnet zur besseren Sichtbarkeit zusätzlich für ca. 30 Sekunden einen Fehlerdialog. Das Öffnen des Dialogs kann mit diesem Argument verhindert werden.
-option <Name>=<Wert>: Setzt Optionen. Mit -option <Name>=<Wert> wird die Option mit dem Name <Name> auf den Wert <Wert> gesetzt. Dieses Argument kann mehrfach angegeben werden, um mehrere Optionen zu setzen.
-options <Datei>: Legt die Datei fest, aus der weitere Argumente gelesen werden. Dieses Argument kann mehrfach angegeben werden, um Argumente aus mehreren Dateien zu lesen.
-version: Hiermit gibt QF-Test Versionsinformationen aus und beendet sich dann.

3 QF-Test Startoptionen für den Betrieb und die Administration des Lizenzservers

3.1 Aufrufsyntax

3.1.1 Serverseitige Befehle

3.1.2 Clientseitige Befehle

3.2 Kommandozeilenargumente

3.2.1 Kommandozeilenargumente für das Startskript

3.2.2 Argumente für die Java VM

3.2.3 Argumente für QF-Test