H7.4. Utilidad de diagnóstico remoto del Servidor Dr.Web para operar con scripts

Utilidad de diagnóstico remoto del Servidor Dr.Web permite conectarse de forma remota al Servidor Dr.Web para la administración básica y la visualización de estadísticas de trabajo. A diferencia de drwcntl, la utilidad drwcmd se puede usar en el trabajo con scripts.

Se proporcionan las siguientes versiones de la utilidad de consola de diagnóstico remoto del Servidor Dr.Web para trabajar con los scripts:

Archivo ejecutable

Ubicación

Descripción

drweb-cmd-<SO>-<valor_de_bits>

Centro de Control, sección Administración → Utilidades

Versión independiente de la utilidad. Se puede iniciar desde un directorio arbitrario y en cualquier computadora con el sistema operativo apropiado.

Directorio del Servidor webmin/utilities

drwcmd

Directorio del Servidor bin

La versión de la utilidad depende de la disponibilidad de las bibliotecas del servidor. Solo se puede iniciar desde el directorio de su ubicación.

Versión de la utilidad drweb-cmd-<SO>-<valor_de_bits> y drwcmd son similar en funcionalidad. La siguiente sección muestra la versión drwcmd, sin embargo, todos los ejemplos son relevantes para ambas versiones.

Para realizar la conexión de la utilidad de diagnóstico remoto del Servidor se requiere activar la extensión Dr.Web Server FrontDoor. Para ello, en la sección Configuración del Servidor Dr.Web, en la pestaña Módulos marque la casilla Extensión del Servidor Dr.Web Front Door.

 

Para poder conectar la utilidad de diagnóstico remoto del Servidor, es necesario que el administrador que se conecta a través de la utilidad tenga el privilegio Utilizar opciones adicionales. De lo contrario, se denegará el acceso al Servidor a través de la utilidad de diagnóstico remoto.

Descripción de la configuración del Servidor para la conectar la utilidad de diagnóstico remoto del Servidor Dr.Web se proporciona en el Manual de administrador, p. Acceso remoto al Servidor Dr.Web.

Formato del comando de ejecución:

drwcmd [<claves>] [<archivos>]

Claves aceptables

El principio de usar claves por la utilidad drwcmd obedece las reglas generales descritas en la sección Anexo H. Parámetros de la línea de comando de los programas que forman parte de Enterprise Security Suite Dr.Web.

--? — mostrar ayuda sobre las claves.

--help — mostrar ayuda sobre las claves.

--commands=<commands> — ejecutar comandos dados (similar a los comandos de la utilidad drwcntl). Se permite especificar varios comandos separados por un carácter ;.

--debug=yes|no — mantener el historial de operación de la utilidad en modo de depuración (flujo de salida estándar stderr). Por defecto no.

--files=yes|no — permitir la ejecución de comandos (similares a los comandos de la utilidad drwcntl) de los archivos especificados. Por defecto yes.

La asignación de comandos en el archivo debe ser realizada por un comando por línea. Las líneas en blanco se ignoran. Como el comienzo del comentario se puede usar el carácter #.

--keep=yes|no — mantener la conexión con el Servidor después de ejecutar el último comando hasta que se complete el proceso de la utilidad. Por defecto no.

--output=<archivo> — archivo para generar respuestas del Servidor. Por defecto, si no se especifica ningún archivo, se utiliza el flujo de salida estándar stdout.

Si el nombre del archivo comienza con el símbolo (+), el resultado de ejecución del comando se agregará al final del archivo; de lo contrario, el archivo se sobrescribirá.

--password=<contraseña> — la contraseña para autorización en el Servidor. Se puede definir en el archivo, especificado en la clave --resource.

--read=yes|no — permitir la lectura de parámetros de conexión al Servidor desde el archivo de recursos. Por defecto yes.

--resource=<archivo> — archivo de recursos con parámetros para conectarse al Servidor: dirección del Servidor y datos de registro del administrador para la autorización en el Servidor. El archivo predeterminado es .drwcmdrc, ubicado en el siguiente directorio:

Para SO de la familia UNIX: $HOME

Instalación del Servidor Dr.Web para SO Windows: %LOCALAPPDATA%

Cada línea en el archivo debe tener 3 palabras separadas por espacios: <Servidor> <usuario> <contraseña>.

Si necesita usar un espacio en el medio de la palabra, entonces se especifica como %S. Si se requiere un signo de porcentaje, entonces se especifica como %P.

Por ejemplo:

ssl://127.0.0.1 user1 password1

ssl://127.0.0.1 user2 password2

ssl://127.0.0.1 user pass%Sword

Cuando se usa una llave --resource es necesario también especificar una clave --server. La conexión se realiza al Servidor especificado en la clave --server, usando los datos de registro del archivo de recursos correspondiente a la dirección de este Servidor.

--server=<Servidor> — dirección del Servidor. Por defecto ssl://127.0.0.1. Puede definirse en el archivo especificado en la clave --resource.

--user=<usuario> — nombre de usuario para autorización en el Servidor. Puede definirse en el archivo especificado en la clave --resource.

--verbose=yes|no — generar la respuesta detallada del Servidor (flujo de salida estándar stdout). Por defecto no.

Parámetros de conexión al Servidor:

1.Al determinar los datos para conectarse al Servidor, son prioritarios los valores especificados en las claves --server, --user y --password.

2.Si la clave --server no está especificado, se utiliza su valor predeterminado — ssl://127.0.0.1.

3.Si la clave --user no está especificado, entonces en el archivo .drwcmdrc (se puede redefinir en la clave --resource) se realiza una búsqueda del Servidor necesario y se toma el primer nombre de usuario alfabéticamente.

4.Si la clave --password no está especificado, entonces en el archivo .drwcmdrc (se puede redefinir en la clave --resource) se realiza una búsqueda del Servidor y nombre de usuario necesario.

El nombre de usuario y la contraseña se leerán del archivo .drwcmdrc (se puede redefinir en la clave --resource), si no está prohibido por la clave --read.

5.Si el nombre de usuario y la contraseña no se especifican con las claves o mediante el archivo de recursos, la utilidad solicitará la entrada de credenciales a través de la consola.

Características de ejecución de los comandos:

Si los archivos de comando están configurados como espacio vacío (-), entonces se leen los comandos ingresados ​​a través de la consola.

Si al mismo tiempo se establecen los comandos en la clave --commands y una lista de archivos, entonces se ejecutan primero los comandos especificados en la clave --commands.

Si no se especifican ni los archivos ni los comandos en la clave --commands, entonces se leen los comandos ingresados ​​a través de la consola.

Por ejemplo:

Para ejecutar los comandos desde la clave --command, y luego los comandos de la consola, ingrese lo siguiente:

drwcmd --commands=<comandos> -- -

Códigos de finalización de trabajo

0 — ejecución exitosa.

1 — ayuda de claves solicitada: --help o --?.

2 — error de análisis de la línea de comando: no están configurados los parámetros de autorización, etc.

3 — error al crear el archivo para mostrar la respuesta del Servidor.

4 — error de autorización en el Servidor: nombre de administrador o contraseña incorrectos.

5 — desconexión de emergencia de la conexión al Servidor.

127 — error fatal indefinido.