H7.3. Utilidad de diagnóstico remoto del Servidor Dr.Web

Utilidad de diagnóstico remoto del Servidor Dr.Web le permite conectarse de forma remota al Servidor Dr.Web para la administración básica y visualización de la estadística de funcionamiento.

La utilidad está disponible en las siguientes versiones:

Para SO Windows — la versión gráfica.

Para SO de la familia UNIX — versión de consola.

Se proporcionan las siguientes versiones de la utilidad de diagnóstico remoto del Servidor Dr.Web:

Archivo ejecutable

Ubicación

Descripción

drweb-cntl-<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

drwcntl

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.

Las versiones de la utilidad drweb-cntl-<SO>-<valor de bits> y drwcntl son similares en funcionalidad. La siguiente sección muestra la versión drwcntl, 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.

 

Para conectar la utilidad (tanto gráfica como de consola) usando TLS, debe configurar directamente el protocolo al especificar la dirección del Servidor: ssl://<dirección IP o nombre DNS>.

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.

Versión de consola de la utilidad

Formato del comando de ejecución:

drwcntl [-?|-h|--help] [+<archivo_historial>] [<servidor> [<nombre_registro> [<contraseña>]]]

donde:

-? -h --help — mostrar ayuda sobre los comandos para usar la utilidad.

<archivo_historial> — escribir todas las acciones de utilidad en el archivo de historial en la ruta especificada.

<servidor> — línea de dirección del Servidor al que está conectada la utilidad en el formato [(tcp|ssl)://]<dirección IP o nombre DNS>[:<puerto>].

Para poder conectarse utilizando uno de los protocolos soportados, se deben cumplir las siguientes condiciones:

a)Para poder conectarse utilizando ssl el archivo de configuración frontdoor.conf debe tener el tag <ssl />. Con esto, solo será posible conectarse mediante ssl.

b)Para poder conectarse utilizando tcp el archivo de configuración frontdoor.conf debe tener el tag <ssl />. Con esto, solo será posible conectarse mediante tcp.

Si no se especifican los parámetros de conexión en la barra de direcciones del Servidor, se utilizan los siguientes valores:

Parámetro

Valor por defecto

Protocolo de conexión

tcp

Para conectarse a través de TCP, debe desmarcarse la casilla Utilizar TLS en el Centro de Control, en la sección Administración → Acceso remoto al Servidor Dr.Web. Esto deshabilita el tag <ssl /> en el archivo de configuración frontdoor.conf.

Dirección IP o el nombre DNS del Servidor

La utilidad le pedirá que ingrese la dirección del Servidor en el formato apropiado.

Puerto

10101

En el lado del Servidor, el puerto permitido se especifica en la sección Acceso remoto al Servidor Dr.Web y se guarda en el archivo de configuración frontdoor.conf. Si está utilizando un puerto alternativo en esta sección, debe especificar explícitamente este puerto al conectar la utilidad.

<nombre_registro> — nombre de registro del administrador del Servidor.

<contraseña> — contraseña para acceder al Servidor.

Si el nombre de usuario y la contraseña del administrador no se configuraron en la línea de conexión, la utilidad le pedirá que ingrese las credenciales apropiadas.

Comandos válidos:

cache <operación>— trabajar con caché de archivos. Para solicitar una operación específica, use los siguientes comandos:

clear — limpiar la caché de archivos,

list — muestra todo el contenido de la caché de archivos,

matched <expresión regular> — mostrar el contenido de la caché del archivo que coincide con la expresión regular establecida,

maxfilesize [<tamaño>] — mostrar/establecer el tamaño máximo de los objetos de archivo precargados. Cuando se inicia sin parámetros adicionales, muestra el tamaño actual. Para establecer el tamaño, especifique el tamaño requerido en bytes después del nombre del comando.

statistics — mostrar las estadísticas de uso de caché de archivos.

calculate <función> — cálculo de una secuencia dada. Use los siguientes comandos para solicitar una secuencia específica:

hash [<estándar>] [<línea>] — cálculo del hash de una línea establecida. Para establecer un estándar específico, use los siguientes comandos:

gost — сálculo del hash de una línea especificada según el estándar GOST,

md5 — сálculo del hash MD5 de una línea especificada,

sha — сálculo del hash de una línea especificada según el estándar SHA,

sha1 — сálculo del hash de una línea especificada según el estándar SHA1,

sha224 — сálculo del hash de una línea especificada según el estándar SHA224,

sha256 — сálculo del hash de una línea especificada según el estándar SHA256,

sha384 — сálculo del hash de una línea especificada según el estándar SHA384,

sha512 — сálculo del hash de una línea especificada según el estándar SHA512.

hmac [<estándar>] [<línea>] — cálculo de HMAC de una línea establecida. Para establecer un estándar específico, use los siguientes comandos:

md5 — сálculo de HMAC-MD5 de una línea especificada,

sha256 — сálculo de HMAC-SHA256 de una línea especificada.

random — generación de un número aleatorio,

uuid — generación de un identificador único aleatorio.

clients <operación> — recepción de la información y gestión de clientes conectados al Servidor. Use los siguientes comandos para solicitar una función específica:

addresses [<expresión regular>] — muestra las direcciones de red de las estaciones que coinciden con una expresión regular establecida. Si no se especifica la expresión regular, muestre las direcciones de todas las estaciones.

caddresses [<expresión regular>] — mostrar el número de las direcciones IP de las estaciones que coinciden con una expresión regular establecida. Si no se especifica la expresión regular — mostrar el número de todas las estaciones.

chosts [<expresión regular>] — mostrar el número de los nombres de computadora de las estaciones que coinciden con la expresión regular establecida. Si no se especifica la expresión regular, mostrar el número de todas las estaciones.

cids [<expresión regular>] — mostrar el número de identificadores de las estaciones correspondientes a una expresión regular especificada. Si no se especifica la expresión regular, mostrar el número de todas las estaciones.

cnames [<expresión regular>] — mostrar el número de nombres de las estaciones que coinciden con la expresión regular especificada. Si no se especifica la expresión regular, mostrar el número de todas las estaciones.

disconnect [<expresión regular>] — interrumpir la conexión activa actual con las estaciones cuyos identificadores corresponden a una expresión regular especificada. Si no se establece la expresión regular — interrumpir la conexión con todas las estaciones conectadas.

enable [<modo>] — mostrar/establecer el modo de conectar los clientes al Servidor. Cuando se inicia sin parámetros adicionales, muestra el modo actual. Use los siguientes comandos adicionales para configurar el modo:

on — aceptar todos los conexiones con los clientes.

off — negar a todos los clientes para conectarse.

hosts <expresión regular> — mostrar los nombres de las computadoras de estaciones que coinciden con una expresión regular especificada.

ids <expresión regular> — mostrar los identificadores de las estaciones que coinciden con una expresión regular dada.

names <expresión regular> — mostrar los nombres de las estaciones que coinciden con una expresión regular especificada.

online <expresión regular> — mostrar la duración de la conexión de las estaciones cuyo identificador, nombre o dirección coincide con la expresión regular especificada. La duración de la conexión se considera desde el momento de la última conexión de estaciones al Servidor.

statistics <expresión regular> — mostrar estadísticas sobre el número de los clientes que coinciden con una expresión regular especificada.

traffic <expresión regular> — mostrar datos de tráfico de los clientes conectados actualmente que coinciden con la expresión regular dada.

core — escribir un vaciado de memoria del proceso del Servidor.

cpu <parámetro> — mostrar estadísticas sobre el uso de la CPU de la computadora en la que está instalado el Servidor. Para solicitar un parámetro específico, use los siguientes comandos:

clear — eliminar todas las estadísticas acumuladas,

day — muestra el gráfico de carga de la CPU para el día actual,

disable — deshabilitar el seguimiento de carga de la CPU,

enable — habilitar el seguimiento de carga de la CPU,

hour — mostrar el gráfico de carga de la CPU para la hora actual,

load — mostrar la carga promedio de la CPU,

minute — mostrar el gráfico de carga de la CPU del último minuto,

rawd — mostrar estadísticas numéricas sobre la carga de la CPU por día,

rawh — mostrar estadísticas numéricas sobre la utilización de la CPU en la última hora,

rawl — mostrar estadísticas numéricas sobre la carga promedio de CPU,

rawm — mostrar estadísticas numéricas sobre la utilización de la CPU en el último minuto,

status — mostrar el estado de seguimiento de las estadísticas de carga de la CPU.

debug <parámetro> — configuración de la depuración. Para establecer un parámetro específico, use comandos adicionales. Para aclarar la lista de los comandos adicionales, puede consultar la ayuda usando el comando: ? debug.

El comando debug signal está disponible solo para los Servidores en SO de la familia UNIX.

die — detener el Servidor y escribir un vaciado de memoria del proceso del Servidor.

Comando die es disponible solo para los Servidores con el SO de la familia UNIX.

dwcp <parámetro> — instalar/ver la configuración del Dr.Web Control Protocol (incluye los historiales del Servidor, los Agentes y los instaladores de los Agentes). Parámetros aceptables:

compression <modo> — establecer uno de los siguientes modos de compresión de tráfico:

on — compresión habilitada,

off — compresión deshabilitada,

possible — compresión posible.

encryption <modo> — establecer uno de los siguientes modos de cifrado de tráfico:

on — cifrado habilitado,

on — cifrado deshabilitado,

possible — cifrado posible.

show — mostrar las configuraciones actuales de Dr.Web Control Protocol.

io <parámetro> — mostrar las estadísticas de lectura/escritura de datos por el proceso del Servidor. Use los siguientes comandos para solicitar un parámetro específico:

clear — eliminar todas las estadísticas acumuladas,

disable — deshabilitar el seguimiento de estadísticas,

enable — habilitar el seguimiento de estadísticas,

rawdr — mostrar estadísticas numéricas de lectura de los datos por día,

rawdw — mostrar estadísticas numéricas de escritura de los datos de lectura de datos,

rawh — mostrar estadísticas numéricas de la última hora,

rawm — mostrar estadísticas numéricas para el último minuto,

rday — mostrar un gráfico de estadísticas de lectura de los datos por día,

rhour — mostrar el gráfico de estadísticas de lectura de los datos de la última hora,

rminute — mostrar el gráfico de estadísticas de lectura de los datos para el último minuto,

status — mostrar el estado de seguimiento de estadísticas,

wday — mostrar gráfico de estadísticas de escritura de los datos por día,

whour — mostrar gráfico de estadísticas de escritura de los datos de la última hora,

wminute — mostrar gráfico de estadísticas de escritura de datos para el último minuto.

log <parámetro> — escribir una línea en el archivo de historial del Servidor o establecer/ver el nivel de detalle del historial. Dependiendo de los parámetros especificados, se realizan las siguientes acciones:

log <línea> — escribir en el historial del Servidor la línea especificada con el nivel de detalle NOTICE.

log \s [<nivel>] — establecer/ver el nivel de detalle del historial. Al ejecutar con la clave \s sin especificar un nivel, se muestra el nivel de detalle actual. Niveles de detalle válidos: ALL, DEBUG3, DEBUG2, DEBUG1, DEBUG, TRACE3, TRACE2, TRACE1, TRACE, INFO, NOTICE, WARNING, ERROR, CRIT.

lua <script> — ejecutar el script LUA establecido.

mallopt <parámetro> — establecer la configuración de distribución de memoria. Use los comandos adicionales para especificar una configuración específica. Para aclarar la lista de comandos adicionales, puede llamar consultar la ayuda usando el comando ? mallopt.

El comando mallopt está disponible solo para los Servidores en SO de la familia Linux.

Para obtener detalles sobre las características de los parámetros de este comando, lea la descripción de la función mallopt() de la biblioteca glibc. Para obtener ayuda sobre esta función, puede usar, por ejemplo, el comando man mallopt.

memory <parámetro> — mostrar estadísticas sobre el uso de la memoria de la computadora en la que está instalado el Servidor. Para solicitar un parámetro específico, use los siguientes comandos:

all — mostrar toda la información y estadísticas,

heap — mostrar la información de la memoria dinámica,

malloc — mostrar estadísticas sobre la asignación de memoria,

sizes — mostrar estadísticas sobre el tamaño de la memoria asignada,

system — mostrar la información de la memoria del sistema.

Comando memory solo está disponible para los servidores en SO Windows, SO de la familia Linux y SO de familia FreeBSD. Las siguientes restricciones se aplican a los parámetros adicionales del comando memory:

system — solamente para los Servidores en SO Windows, SO de la familia Linux,

heap — solamente para los Servidores en SO Windows, SO de la familia Linux,

malloc — solamente para los Servidores en SO Windows, SO de la familia FreeBSD,

sizes — solamente para los Servidores en SO de la familia Linux, SO de la familia FreeBSD.

monitoring <modo> — establecer/ver el modo de monitoreo de uso de recursos de CPU (clave cpu <parámetro>) y entrada/salida (clave io <parámetro>) por el proceso del Servidor. Comandos aceptables:

disable — deshabilitar monitoreo,

enable — habilitar monitoreo,

show — mostrar modo actual.

printstat — escribir las estadísticas de operación del Servidor en el historial.

reload — recargar la extensión Dr.Web Server FrontDoor.

repository <parámetro> — gestión del repositorio. Para solicitar una función específica, use los siguientes comandos:

all — mostrar todos los productos del repositorio y el número de todos los archivos por producto,

clear — limpiar el contenido de la caché, independientemente del valor TTL de los objetos colocados en la caché,

fill — colocar todos los archivos del repositorio en caché,

keep — almacenar todos los archivos del repositorio ubicados actualmente en la caché, siempre, independientemente de su valor TTL,

loaded — mostrar todos los productos del repositorio y el número de todos los archivos por producto ubicados actualmente en la caché,

reload — recargar el repositorio desde el disco,

statistics — mostrar estadísticas de actualizaciones del repositorio.

restart — reiniciar el Servidor.

show <parámetro> — mostrar la información sobre el sistema en el que está instalado el Servidor. Para establecer un parámetro específico, use los comandos adicionales. Para aclarar la lista de los comandos adicionales, puede consultar la ayuda usando el comando ? show.

Las siguientes restricciones se aplican a las parámetros adicionales del comando show:

memory — solo para Servidores en SO Windows, OS de la familia Linux,

mapping — solo para Servidores en SO Windows, OS de la familia Linux,

limits — solo para Servidores en SO de la familia UNIX,

processors — solo para Servidores en SO de la familia Linux.

sql <solicitud> — ejecutar la solicitud SQL dada.

stop — detener el Servidor.

traffic <parámetro> — mostrar las estadísticas sobre el tráfico de red del Servidor. Use los siguientes comandos para solicitar un parámetro específico:

all — mostrar todo el tráfico desde el comienzo de operación del Servidor.

incremental — mostrar el incremento del tráfico en relación con la última ejecución del comando traffic incremental.

last — mostrar el cambio de tráfico desde el último punto fijo.

store — creación de un punto fijo para la clave last.

update <parámetro> — recepción de la información y gestión de actualizaciones. Use las siguientes claves para solicitar una función específica:

active — mostrar la lista de los Agentes que están realizando la actualización actualmente.

agent [<modo>] — mostrar/establecer el modo de actualización de los Agentes desde el Servidor. Al ejecutar sin parámetros adicionales, muestra el modo actual. Para configurar el modo, use las siguientes claves adicionales:

on — habilitar las actualizaciones de los Agentes.

off — deshabilitar las actualizaciones de los Agentes.

gus — iniciar la actualización del repositorio desde el SGA independientemente del estado del proceso de actualización desde SGA.

http [<modo>] — mostrar/configurar el modo de actualizaciones del repositorio del Servidor desde SGA. Al ejecutar sin parámetros adicionales, muestra el modo actual. Para configurar el modo, use las siguientes claves adicionales:

on — habilitar actualizaciones del repositorio desde SGA.

off — deshabilitar las actualizaciones de repositorio desde SGA.

inactive — mostrar una lista de los Agentes que no están realizando actualizaciones actualmente.

track [<modo>] — mostrar/establecer el modo de seguimiento de las actualizaciones de los Agentes. Al iniciar sin parámetros adicionales, muestra el modo actual. Para configurar el modo, use los siguientes comandos adicionales:

on — habilitar el seguimiento de actualizaciones de los Agentes.

off — deshabilitar el seguimiento de actualizaciones de los Agentes. En este caso, la clave update active no va a mostrar la lista de los Agentes actualizados.