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:
Ausführbare Datei |
Speicherort |
Beschreibung |
|---|---|---|
drweb-cmd-<OS>-<Bitanzahl> |
Verwaltungscenter Administration → Dienstprogramme |
Autonome Version des Dienstprogramms. Diese Version kann von einem beliebigen Verzeichnis aus auf einem beliebigen Rechner, auf dem ein entsprechendes Betriebssystem installiert ist, gestartet werden. |
Verzeichnis des Dr.Web Servers webmin/utilities |
||
drwcmd |
Verzeichnis des Dr.Web Servers bin |
Die jeweilige Version des Dienstprogramms hängt von den vorhandenen Serverbibliotheken ab. Sie kann nur aus dem Verzeichnis, in dem sie liegt, gestartet werden. |
|
Die Versionen des Dienstprogramms drweb-cmd-<OS>-<Bitanzahl> und drwcmd haben die gleichen Funktionalitäten. Nachfolgend wird die Version drwcmd erläutert, obwohl die aufgeführten Beispiele für die beiden Versionen gültig sind. |
|
Um das Dienstprogramm zur Ferndiagnose des Dr.Web Servers verwenden zu können, aktivieren Sie die Erweiterung Dr.Web Server FrontDoor. Aktivieren Sie dazu im Bereich Dr.Web Server-Konfiguration auf der Registerkarte Module das Kontrollkästchen Erweiterung Dr.Web Server FrontDoor.
Um das Dienstprogramm zur Ferndiagnose des Dr.Web Servers verwenden zu können, muss der Administrator über das Recht Zusätzliche Funktionen verwenden verfügen. Anderenfalls ist der Zugriff auf den Dr.Web Server über das Dienstprogramm zur Ferndiagnose nicht möglich. |
Die Einstellungen des Dr.Web 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
|
Das Tool drwcmd verwendet die Schalter entsprechend den Regeln, die unter Anhang H. Befehlszeilenparameter in Dr.Web Enterprise Security Suite beschrieben werden. |
•--? – Hilfe zu Schaltern anzeigen.
•--help – Hilfe zu Schaltern anzeigen.
•--commands=<Befehle> – die angegebenen Befehle ausführen (identisch mit den Befehlen des 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 des Tools 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 Dr.Web Server nach der Ausführung des letzten Befehls aufrechterhalten, bis der vom Tool ausgeführte Prozess abgeschlossen wird. Standardeinstellung: no.
•--output=<Datei> – Datei für die Ausgabe von Antworten des Dr.Web Servers. 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 für die Autorisierung am Dr.Web Server. Es kann in der im Schalter --resource angegebenen Datei definiert werden.
•--read=yes|no – Lesen von Parametern der Verbindung mit dem Dr.Web Server in der Ressourcendatei zulassen. Standardeinstellung: yes.
•--resource=<Datei> – Ressourcendatei mit den Parametern der Verbindung mit dem Dr.Web Server: Adresse des Dr.Web Servers und Anmeldedaten des Administrators für die Autorisierung am Dr.Web 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: <Dr.Web_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:
ssl://127.0.0.1 user1 password1 ssl://127.0.0.1 user2 password2 ssl://127.0.0.1 user pass%Sword |
|
Der Schalter --resource erfordert den Schalter --server. Die Verbindung wird mit dem im Schalter --server angegebenen Dr.Web Server anhand der in der Ressourcendatei angegebenen Anmeldeinformationen hergestellt, die der Adresse dieses Dr.Web Servers entsprechen. |
•--server=<Dr.Web_Server> – Adresse des Dr.Web Servers. Standardmäßig wird ssl://127.0.0.1 verwendet. Sie kann in der im Schalter --resource angegebenen Datei definiert werden.
•--user=<Benutzer> – Benutzername für die Autorisierung am Dr.Web Server. Er kann in der im Schalter --resource angegebenen Datei definiert werden.
•--verbose=yes|no – Ausführliche Antwort des Dr.Web Servers ausgeben (Standardausgabe: stdout). Standardeinstellung: no.
•--version – Informationen zur Version des Tools anzeigen.
Die Verbindung mit dem Dr.Web Server erfolgt wie folgt:
1.Die in den Schaltern --server, --user und --password angegebenen Werte haben Vorrang beim Abrufen von Parametern der Verbindung mit dem Dr.Web Server.
2.Falls der Schalter --server nicht angegeben 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 gewünschten Dr.Web Server gesucht. Dabei wird der alphabetisch an erster Stelle stehende Benutzername verwendet.
4.Falls der Schalter --password nicht festgelegt ist, wird in der Datei .drwcmdrc (kann im Schalter --resource neu definiert werden) nach dem Dr.Web Server und dem Benutzernamen gesucht.
|
Der Benutzername und das Passwort werden aus der Datei .drwcmdrc ausgelesen (kann im Schalter --resource neu definiert werden), falls der Schalter --read dies nicht verhindert. |
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:
drwcmd --commands=<Befehle> -- - |
Exit-Codes
•0 – fehlerfreie Ausführung.
•1 – Hilfe zu Befehlen wurde aufgerufen: --help oder --?.
•2 – Fehler beim Analysieren der Befehlszeile: Es wurden keine Autorisierungsparameter angegeben o. Ä.
•3 – Fehler beim Erstellen der Datei zum Ausgeben der Antwort des Dr.Web Servers.
•4 – Fehler beim Autorisieren am Dr.Web Server: Der Anmeldename und/oder das Administratorpasswort sind/ist falsch.
•5 – Unerwartete Trennung der Verbindung mit dem Dr.Web Server.
•127 – Unbekannter schwerwiegender Fehler.