Instalación manual del agente de servidor

El agente de servidor de Kabeen es el componente encargado de recopilar información sobre la infraestructura del sistema de información: configuración del host, métricas del sistema, programas instalados y procesos en ejecución.

Es un servicio de sistema autónomo que debe instalarse en cada servidor que desee analizar en Kabeen. Los datos se transmiten al backend de Kabeen mediante gRPC sobre TLS, utilizando únicamente el puerto saliente 443/TCP.

Novedad en 3.0. El agente de servidor ahora se distribuye como un instalador MSI firmado en Windows (en sustitución del .exe) y su configuración utiliza un archivo TOML (config.toml) en lugar de application.conf. Si ya hay un agente anterior instalado en la máquina, su configuración se migra automáticamente en el primer inicio (consulte Migración desde el agente anterior).

Requisitos previos

• Conexión saliente permitida hacia intake.kabeen.io en el puerto 443/TCP. No se requiere ninguna conexión entrante.
• Privilegios de administrador (root en Linux, miembro de Administradores locales en Windows).
• En Linux, se requiere systemd como gestor de init.

Descarga del paquete

Descargue el paquete correspondiente a su sistema operativo desde su consola Kabeen (Infraestructura > Agregar un servidor > Instalación automática).

Instalación en Windows

1. Haga doble clic en el archivo MSI y acepte la elevación de UAC.
2. Lea y acepte el Acuerdo de licencia de usuario final (CLUF).
3. En la pantalla Kabeen API key, pegue la clave API obtenida de su cuenta Kabeen. También puede dejar el campo vacío e indicar la clave más tarde en config.toml.
4. Haga clic en Install.

El instalador copia el binario en C:\Program Files\Kabeen\Server Agent\, escribe la configuración en C:\ProgramData\Kabeen\Server Agent\config.toml, registra el servicio de Windows KabeenServerAgent (inicio automático) y lo arranca.

Instalación silenciosa. Para un equipo aislado, en PowerShell como administrador:

msiexec /i "kabeen-server-agent-x86_64.msi" /qn /norestart APIKEY="SU_CLAVE_API_KABEEN"

Para un despliegue masivo (GPO, Intune, SCCM), consulte las guías dedicadas de la sección Agente de infraestructura.

Instalación en Linux (Debian / Ubuntu)

Instale el paquete .deb descargado (apt-get install resuelve las dependencias automáticamente):

sudo apt-get install ./kabeen-server-agent_amd64.deb

La instalación crea el archivo de configuración, activa la unidad kabeen-server-agent.service y la arranca. A continuación, indique la clave API (consulte Configuración de la clave API).

Instalación en Linux (Red Hat y derivados)

Instale el paquete .rpm descargado:

sudo dnf install ./kabeen-server-agent.x86_64.rpm
# o, en distribuciones sin dnf:
sudo yum install ./kabeen-server-agent.x86_64.rpm

Al igual que en Debian, el servicio se activa y arranca automáticamente. Solo queda indicar la clave API.

Configuración de la clave API

En Linux, la clave API debe indicarse en el archivo /etc/kabeen-server-agent/config.toml:

api_key = "SU_CLAVE_API_KABEEN"

sudo install -m 600 -o root -g root /dev/stdin /etc/kabeen-server-agent/config.toml <<'EOF'
api_key = "SU_CLAVE_API_KABEEN"
EOF

En Windows, el archivo se encuentra en C:\ProgramData\Kabeen\Server Agent\config.toml.

No es necesario reiniciar el servicio. El agente vuelve a leer config.toml automáticamente cada 10 segundos: la nueva clave se tiene en cuenta en el siguiente ciclo. Como el archivo contiene una clave en texto plano, mantenga permisos restrictivos (0600 / root en Linux).

Migración desde el agente anterior

Si ya hay un agente anterior instalado, el agente de servidor de Kabeen importa automáticamente su configuración en el primer inicio:

La reutilización del agentUUID garantiza que la máquina conserve la misma identidad en la consola Kabeen — no aparece como un nuevo host.

La migración se realiza una sola vez y nunca sobrescribe una configuración ya indicada. Procedimiento recomendado: instale el agente de servidor, verifique en la consola Kabeen que la máquina aparece con el mismo identificador y luego desinstale el agente anterior.

Verificación del funcionamiento

Linux:

sudo systemctl status kabeen-server-agent.service
sudo journalctl -u kabeen-server-agent.service -f

Windows (PowerShell como administrador):

Get-Service -Name KabeenServerAgent

Una vez indicada una clave API válida, los registros deben mostrar All tasks running. Agent is operational., y la máquina debe aparecer en su consola Kabeen con un heartbeat reciente (menos de 2 minutos).