Instalar los agentes

Los agentes se instalan desde su servidor principal: los demás servidores no necesitan el paquete de distribución. El comando de instalación descarga el programa desde el servidor principal, verifica su suma SHA-256, escribe /etc/3rmonitor/agent.conf, crea el servicio 3rmonitor-agent (que se ejecuta con el usuario sin privilegios 3rmonitor-agent) y su ayudante root 3rmonitor-helper, confía en la clave de firma del servidor principal y en sus llaves de acceso, y envía un reporte de prueba.

Cada servidor necesita Linux con systemd, acceso de root, curl o wget, y acceso saliente a la dirección del panel. Consulte Requisitos.

Opción 1: un servidor a la vezCopy Anchor Link

Úsela cuando agrega los servidores de uno en uno.

curl -fsSL 'https://monitor.example.com/dl/install.sh?t=TOKEN' | sudo bash -s -- agent --master 'https://monitor.example.com' --token 'TOKEN' --master-key MASTER_FP --approvers PASSKEY_FP

Cada servidor tiene su propio token. Para ver el comando otra vez, abra el menú ⋯ en la fila del servidor y elija Comando de instalación.

Opción 2: muchos servidores con un solo comandoCopy Anchor Link

Úsela para agregar muchos servidores a la vez, o desde una herramienta de automatización.

Al final de Servidores, en Registrar muchos servidores con un comando, active Comando de registro, copie el comando, que contiene la clave de registro, y ejecútelo en todos los servidores que desee. Cada servidor se registra solo. El nombre predeterminado es el nombre del host del servidor; agregue --name y --group al final del comando para elegirlos:

curl -fsSL 'https://monitor.example.com/dl/install.sh?t=CLAVE_DE_REGISTRO' | sudo bash -s -- agent --master 'https://monitor.example.com' --enroll 'CLAVE_DE_REGISTRO' --master-key MASTER_FP --approvers PASSKEY_FP --name web-2 --group Produccion

• Cambiar clave de registro → Cambiar: el comando anterior deja de funcionar de inmediato. Los servidores ya registrados no se ven afectados.
• Desactive Comando de registro: a partir de entonces, los servidores solo se pueden agregar de uno en uno, con ＋ Agregar servidor.

Desde la línea de comandos del servidor principalCopy Anchor Link

También puede dar de alta un servidor en el servidor principal y obtener su token sin abrir el panel:

sudo 3rmonitor server add --name web-2 --group Produccion

Muestra el token del servidor nuevo. Luego, en el servidor nuevo, ejecute el comando de instalación con la dirección de su panel y ese token:

curl -fsSL 'https://monitor.example.com/dl/install.sh?t=TOKEN' | sudo bash -s -- agent --master 'https://monitor.example.com' --token 'TOKEN'

Agregue --reuse a server add para obtener el token de un servidor existente con el mismo nombre en lugar de darlo de alta dos veces, algo útil en scripts. Un servidor instalado de esta forma, sin --master-key, todavía no confía en sus llaves de acceso: ejecute sudo 3rmonitor approvers trust en él si quiere reparaciones de IA aprobadas allí.

Otras formas de instalar un agenteCopy Anchor Link

Instalación manual explica cada una:

• desde el paquete de distribución, con el programa del paquete en lugar del servidor principal;
• descargando primero el instalador, para leerlo antes de ejecutarlo o para responder a sus preguntas;
• con wget en servidores sin curl;
• desde SSH, cloud-init o Ansible;
• completamente a mano, sin install.sh.

La dirección que usan los agentesCopy Anchor Link

Los comandos de instalación usan la Dirección pública del panel de Configuración → General. Debe ser una dirección a la que puedan llegar los demás servidores: no 127.0.0.1, ni una IP de la red local si los servidores están en otras redes.

• Si el servidor principal usa HTTPS con un certificado autofirmado, agregue -k a curl (curl -fsSLk …) y --insecure al final del comando. --insecure configura insecure = true en agent.conf. Consulte Un servidor principal con certificado autofirmado.
• Si cambia la dirección del panel más adelante, los agentes ya instalados siguen reportando a la dirección anterior. Para trasladarlos, consulte la sección siguiente.

Volver a registrar un agente ya instaladoCopy Anchor Link

Cuando un agente deba reportar a otro servidor principal, usar un token nuevo o reemplazar un servidor por otro, no necesita reinstalarlo. En Servidores → ⋯ → Comando de instalación, abra ¿El agente ya está instalado? Solo vuelva a registrarlo como este servidor y ejecute el comando que aparece:

sudo 3rmonitor bind --master 'https://monitor.example.com' --token 'TOKEN'

Comprobar que funcionaCopy Anchor Link

En el servidor del agente:

3rmonitor status                     # modo de instalación y estado de los servicios
sudo 3rmonitor agent --test          # reporta una vez ahora y muestra el resultado
journalctl -u 3rmonitor-agent -f     # registro del agente
journalctl -u 3rmonitor-helper -f    # registro del ayudante root

El resumen del instalador muestra "El agente se ejecuta como el usuario sin privilegios 3rmonitor-agent…". Si muestra que esto falló, el agente sigue monitoreando el servidor, pero la IA no ejecuta nada allí hasta que lo corrija con sudo 3rmonitor agent secure.

Si el servidor no aparece en el panel, consulte Solución de problemas.

ActualizacionesCopy Anchor Link

Usted no actualiza los agentes: cada vez que actualiza el servidor principal, los agentes se actualizan solos a la misma versión (auto_update = true en agent.conf). Los agentes anteriores a la 1.1.0 que se ejecutaban como root pasan solos al usuario sin privilegios cuando se actualizan. Desde la 1.1.1, los agentes solo instalan programas firmados por 3R Soft, así que instale y actualice el servidor principal con el paquete de distribución oficial. Consulte Actualización y desinstalación.

Quitar un servidorCopy Anchor Link

1. En Servidores, abra el menú ⋯ en la fila del servidor y elija Eliminar. También se elimina su historial y su agente ya no podrá reportar.
2. En ese servidor, quite el agente: sudo bash /opt/3rmonitor/install.sh uninstall.