Actualizar el agente de servidor

Actualizar el agente de servidor de Kabeen consiste en reinstalar el último paquete sobre la versión existente. La operación se realiza in situ: el binario se reemplaza, el servicio se reinicia automáticamente con la nueva versión y la configuración y la identidad del host se conservan.

No se necesita reconfiguración. El archivo config.toml (en C:\ProgramData\Kabeen\Server Agent\ en Windows, /etc/kabeen-server-agent/ en Linux) nunca se sobrescribe con una actualización. La clave API y la identidad del agente (agent_id) permanecen sin cambios: la máquina sigue reportándose con el mismo identificador en la consola de Kabeen y no reaparece como un host nuevo.

Comprobar la versión instalada

Antes y después de actualizar, compruebe la versión existente.

Windows (PowerShell como administrador):

Get-Package -Name "*Kabeen*" | Select-Object Name, Version

La versión también es visible en Panel de control > Programas y características.

Linux (Debian / Ubuntu):

dpkg -l kabeen-server-agent

Linux (Red Hat y derivados):

rpm -q kabeen-server-agent

La consola de Kabeen también muestra la versión del agente reportada por cada host (Infraestructura > seleccionar el servidor).

Descargar el último paquete

Los enlaces de descarga sirven siempre la última versión publicada. Obtenga el paquete correspondiente a su sistema operativo:

Actualización en Windows

El instalador MSI 3.0 gestiona una actualización mayor: basta con ejecutar el nuevo MSI, que desinstala limpiamente la versión anterior e instala la nueva, conservando config.toml.

En modo interactivo, haga doble clic en el nuevo MSI y siga el asistente. La pantalla Kabeen API key puede dejarse vacía: la clave ya presente en config.toml se conserva.

En modo silencioso (PowerShell como administrador):

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

No indique el parámetro APIKEY durante una actualización: la clave existente es suficiente. Solo es útil para (re)definir la clave cuando config.toml todavía no contiene ninguna.

El servicio KabeenServerAgent es detenido y reiniciado automáticamente por el instalador.

Actualización masiva por GPO

Para un parque Windows unido al dominio, la actualización se propaga a través de la misma GPO de instalación de software utilizada para el despliegue inicial, declarando el nuevo MSI como actualización del paquete anterior.

1. Copie el nuevo MSI en el recurso compartido de red utilizado por la GPO (conserve el paquete anterior hasta que la actualización se complete):

   \\servidor\recurso\kabeen\kabeen-server-agent-x86_64.msi

2. Abra la consola Administración de directivas de grupo, edite la GPO de despliegue y navegue a Configuración del equipo > Directivas > Configuración de software > Instalación de software.

3. Clic derecho > Nuevo > Paquete, seleccione el nuevo MSI a través de su ruta UNC y elija el método Asignada.

4. Abra las Propiedades del nuevo paquete > pestaña Actualizaciones > Agregar, y seleccione el paquete anterior. Elija Desinstalar el paquete existente y, a continuación, instalar el paquete de actualización, y marque Actualización requerida para los paquetes existentes.

5. En un servidor de prueba, fuerce la aplicación y luego reinicie (la instalación de software por GPO se aplica en el arranque):

   gpupdate /force

El archivo config.toml (clave API e identidad del agente) reside en C:\ProgramData\ y sobrevive a la actualización: no se necesita ninguna GPO de configuración adicional. A diferencia del primer despliegue, no es necesario volver a establecer la clave API.

Para el despliegue inicial por GPO, consulte Instalación del agente de servidor por GPO.

Actualización mediante Microsoft Intune

Para los servidores gestionados por Microsoft Intune, la actualización consiste en publicar la nueva versión del paquete; Intune la despliega después automáticamente en las máquinas de destino en su próximo registro.

1. Inicie sesión en el centro de administración de Intune.
2. Aplicaciones > Todas las aplicaciones, luego seleccione la aplicación Kabeen Server Agent existente (Aplicación de línea de negocio / line-of-business MSI).
3. Propiedades > sección Información de la aplicación > Editar, y cargue el nuevo MSI (cuya versión de producto sea superior a la instalada).
4. Guarde. Intune se basa en la versión de producto del MSI para la detección: instala la nueva versión sobre la anterior en los dispositivos cuya asignación es Obligatoria.

Si el agente se empaquetó como aplicación Win32 (.intunewin) en lugar de aplicación de línea de negocio, publique la nueva versión como una aplicación independiente y decláresela como reemplazo (supersedence) de la anterior.

Ningún perfil de configuración que modificar. El agente de servidor no se basa en plantillas ADMX (a diferencia del agente de usuario): su clave API y su identidad se conservan en config.toml. Solo hay que actualizar el paquete de la aplicación. Como en todo despliegue de Intune, cuente con un retraso de propagación de 24 a 48 horas.

Actualización en Linux (Debian / Ubuntu)

Instalar el nuevo paquete .deb sobre el anterior realiza la actualización; los archivos bajo /etc/kabeen-server-agent/ se conservan:

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

El paquete reinicia la unidad kabeen-server-agent.service con el nuevo binario.

Actualización en Linux (Red Hat y derivados)

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

Como en Debian, la configuración se conserva y el servicio se reinicia automáticamente.

Actualización desde un agente anterior (2.x / Kapsul)

El paso de un agente anterior (Kapsul 2.x, configuración application.conf, servicio .exe) al agente de servidor 3.0 no es una simple actualización de paquete: es una migración. Instale el agente de servidor 3.0 en paralelo: importa automáticamente la clave API y el agentUUID del agente anterior en el primer arranque, preservando la identidad del host; a continuación, desinstale el agente anterior.

El procedimiento detallado se describe en Instalación manual del agente de servidor.

Verificación tras la actualización

Compruebe que el servicio funciona y que la nueva versión está instalada.

Linux:

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

Windows (PowerShell como administrador):

Get-Service -Name KabeenServerAgent

Los registros deben mostrar All tasks running. Agent is operational., y la máquina debe seguir reportándose en la consola de Kabeen con un heartbeat reciente (menos de 2 minutos), bajo el mismo identificador que antes de la actualización.

Para la primera instalación, consulte Instalación manual del agente de servidor. Para eliminar el agente, consulte Desinstalar el agente de servidor.