H9.4. Skriptbasiertes Dienstprogramm zur Ferndiagnose des Dr.Web Servers |
Das Dienstprogramm zur Ferndiagnose des Dr.Web Servers ermöglicht Ihnen, den Dr.Web Server remote zu verwalten und seine Statistik anzusehen. Im Unterschied zu drwcntl kann drwcmd mit Skripten umgehen. Folgende Konsolenversionen des skriptbasierten Dienstprogramms zur Ferndiagnose des Dr.Web Servers stehen zur Verfügung:
Die Einstellungen des Servers für die Verbindung mit dem Dienstprogramm zur Ferndiagnose des Dr.Web Servers werden im Administratorhandbuch unter Fernzugriff auf Dr.Web Server beschrieben. Format des Startbefehls: drwcmd [<Schalter>] [<Dateien>] Zulässige Schalter
•--? – Hilfe zu Schaltern anzeigen. •--help – Hilfe zu Schaltern anzeigen. •--commands=<Befehle> – die angegebenen Befehle ausführen (identisch mit den Tools drwcntl). Mehrere Befehle können mit dem Zeichen ; voneinander getrennt angegeben werden. •--debug=yes|no – Tool im Debug-Modus protokollieren (Standardausgabe stderr). Standardmäßig wird no verwendet. •--files=yes|no – Ausführung von Befehlen (identisch mit den Befehlen von drwcntl) aus den angegebenen Dateien erlauben. Standardmäßig wird yes verwendet. Jeder Befehl muss in einer eigenen Zeile stehen. Leere Zeilen werden nicht berücksichtigt. Kommentare können mit dem Rautezeichen # eingeleitet werden. •--keep=yes|no – Verbindung mit dem Server nach der Ausführung des letzten Befehls aufrechthalten, bis der Prozess des Tools abgeschlossen ist. Standardmäßig wird no verwendet. •--output=<Datei> – Datei für die Ausgabe der Serverantworten. Wenn keine Datei angegeben ist, wird die Standardausgabe stdout verwendet. Falls der Dateiname mit einem Pluszeichen (+) beginnt, wird das Ergebnis der Befehlsausführung am Ende der Datei eingefügt, andernfalls wird die Datei umgeschrieben. •--password=<Passwort> – Passwort zur Autorisierung am Server. Es kann in der im Schalter --resource angegebenen Datei definiert werden. •--read=yes|no – Lesen der Serververbindungsparameter in der Ressourcendatei zulassen. Standardmäßig wird yes verwendet. •--resource=<Datei> – Ressourcendatei mit den Serververbindungsparametern: Serveradresse und Administrator-Anmeldedaten für die Autorisierung am Server. Standardmäßig wird die Datei .drwcmdrc verwendet, die sich im folgenden Verzeichnis befindet: ▫Für UNIX-basierte Betriebssysteme: $HOME ▫Für Windows: %LOCALAPPDATA% Jede Zeile muss aus 3 folgenden durch Leerzeichen voneinander getrennten Wörtern bestehen: <Server> <Benutzer> <Passwort>. Falls Sie in einem dieser Wörter ein Leerzeichen angeben wollen, müssen Sie es mit der Zeichenfolge %S ersetzen. Falls Sie in einem dieser Wörter ein Prozentzeichen angeben wollen, müssen Sie es mit der Zeichenfolge %P ersetzen. Beispiel:
•--server=<Server> – Serveradresse. Standardmäßig wird ssl://127.0.0.1 verwendet. Sie kann in der im Schalter --resource angegebenen Datei definiert werden. •--user=<Benutzer> – Benutzername zur Autorisierung am Server. Er kann in der im Schalter --resource angegebenen Datei definiert werden. •--verbose=yes|no – ausführliche Serverantwort ausgeben (Standardausgabe stdout). Standardmäßig wird no verwendet. Die Verbindung mit dem Server erfolgt wie folgt: 1.Die in den Schaltern --server, --user und --password angegebenen Werte haben Vorrang beim Abrufen der Serververbindungsparameter. 2.Falls der Schalter --server nicht festgelegt ist, wird der Standardwert ssl://127.0.0.1 verwendet. 3.Falls der Schalter --user nicht festgelegt ist, wird in der Datei .drwcmdrc (kann im Schalter --resource neu definiert werden) nach dem benötigten Server gesucht, und der alphabetisch an erster Stelle stehende Benutzername wird verwendet. 4.Falls der Schalter --password nicht festgelegt ist, wird in der Datei .drwcmdrc (kann im Schalter --resource neu definiert werden) nach dem benötigten Server und Benutzernamen gesucht.
5.Wenn der Benutzername und das Passwort nicht in den Schaltern oder in der Ressourcendatei festgelegt sind, werden sie aufgefordert, die Anmeldedaten über die Konsole einzugeben. Besonderheiten der Befehlsausführung: •Wenn ein leerer Wert (-) für die Dateien mit Befehlen angegeben ist, liest das Tool die über die Konsole eingegebenen Befehle aus. •Wenn Befehle im Schalter --commands und die Dateiliste gleichzeitig angegeben sind, werden zunächst die im Schalter --commands angegebenen Befehle ausgeführt. •Wenn keine Dateien und keine Befehle im Schalter --commands angegeben sind, liest das Tool die über die Konsole eingegebenen Befehle aus. Beispiel Um die im Schalter --command angegebenen Befehle auszuführen und anschließend die Ausführung der Befehle aus der Konsole zu bewirken, geben Sie Folgendes ein:
Exit-Codes •0 – fehlerfreie Ausführung. •1 – Hilfe zu Befehlen wurde aufgerufen: --help oder --?. •2 – Fehler beim Analysieren der Befehlszeile: Keine Autorisierungsparameter wurden angegeben o. Ä. •3 – Fehler beim Erstellen der Datei zum Ausgeben der Serverantwort. •4 – Fehler beim Autorisieren am Server: Der Anmeldename und/oder das Administratorpasswort sind/ist nicht falsch. •5 – unerwartete Trennung der Serververbindung. •127 – unbekannter schwerwiegender Fehler. |