Para instalar un agente Outpost nuevo, primero se genera un token de inscripción en Portail ZAPP y después se ejecuta en la máquina el comando de instalación propuesto. El agente se presenta con ese token, que solo sirve una vez. Los paquetes de instalación subidos a Portail ZAPP sirven tanto para la instalación como para las actualizaciones.
Las pantallas están reservadas al grupo Administradores. Se accede a ellas desde el menú Outpost (entradas Outposts, Paquetes y Tokens de inscripción).
Generar un token de inscripción
En la página Outposts, haz clic en Generar un token de inscripción e indica:
- Hostname (opcional): si se indica, solo un agente que se anuncie exactamente con ese nombre podrá usar el token (letras, cifras, puntos, guiones y guiones bajos). En Linux, el comando generado impone ese nombre al agente. En Windows, debe ser el nombre del equipo (
%COMPUTERNAME%), como recuerda la página; - ID de máquina (opcional): mismo principio, con el identificador de hardware de la máquina;
- Duración de validez (minutos): entre 1 y 1440 minutos (24 h), 60 por defecto;
- Parámetros de instalación (opcional): ajustes de registro del agente, memorizados para toda la instancia y reutilizados en los comandos generados en el paso siguiente. Si se dejan en Valor predeterminado del agente, no aparecen en los comandos:
| Parámetro | Valores | Predeterminado del agente |
|---|---|---|
| LogSinks | file: archivos de registro en la carpeta de registros; native: Visor de eventos de Windows, o diario del sistema (journald) en Linux; both: ambos | both |
| LogLevel | Trace, Debug, Information, Warning, Error, Critical, del más detallado al más restringido | Information |
| Carpeta de registros (Windows) | ruta absoluta (letra de unidad, o recurso compartido \\servidor\recurso\…) en la que la cuenta del servicio puede escribir, sin comillas, acentos graves ni signo de dólar; solo sirve con file o both |
subcarpeta logs de la carpeta del agente en %ProgramData% |
| Carpeta de registros (Linux) | ruta absoluta que empieza por / en la que la cuenta del servicio puede escribir, sin barra invertida, comillas, apóstrofos, acentos graves ni signo de dólar; solo sirve con file o both |
/var/log/webbase-outpost |
Un nivel cambiado después desde la ficha del agente prevalece sobre LogLevel, incluso tras un reinicio. La carpeta de Windows solo se usa en el comando de Windows y la de Linux solo en el archivo de configuración de Linux. Un valor rechazado se señala campo por campo y no se genera ningún token. Si la dirección pública de la instancia no está configurada, los comandos contienen https://<App:BaseUrl>: sustitúyela por la dirección del servidor.
Haz clic en Generar. La página Token de inscripción generado muestra el token y su fecha de expiración: «Copia este token ahora.» No volverá a mostrarse después de salir de esta página, porque nunca se almacena en claro. El botón Copiar lo coloca en el portapapeles.
La sección Comando de instalación ofrece, listos para copiar:
- Windows (MSI): la descarga del paquete desde tu instancia y después la instalación silenciosa, que se ejecuta en un PowerShell de administrador (el token se pasa mediante un archivo temporal, eliminado tras su lectura);
- Linux (.deb): la descarga del paquete (el comando falla si no hay ningún paquete disponible), los comandos que crean el archivo de configuración
/etc/webbase-outpost/outpost.env, legible solo por root, y después la instalación.
Si el agente es rechazado en la inscripción, la respuesta del servidor indica el motivo: token caducado, ya usado, revocado o un nombre de máquina distinto del vinculado al token. En este último caso, el registro de la aplicación muestra el nombre anunciado por el agente.
La descarga usa el propio token: solo funciona mientras el token es válido, y solo si existe un paquete actual para la plataforma. Por último, haz clic en He copiado el token. Una vez instalado, el agente aparece en la lista de Outposts.
Los tokens de inscripción
La página Tokens de inscripción (botón del mismo nombre en la lista de Outposts) lista los tokens generados: estado, máquina a la que está Vinculado a (o Sin vincular), fechas de creación, expiración y uso, autor. Un token está Válido, Consumido (ya usado por un agente), Expirado o Revocado. Revocar (para un token válido) impide que se vuelva a usar.
Los paquetes de instalación
La página Paquetes de instalación de Outpost lista los paquetes subidos: plataforma, versión, archivo, tamaño, fecha y estado: Actual (la versión que se distribuye), Disponible (nunca activada: espera a que la actives) o Archivado (fue la versión actual y ya no lo es). Los más recientes aparecen primero; la lista se puede ordenar, filtrar y paginar.
- Subir un paquete: elige el Archivo, indica su Versión y un Patrón de plataforma (por ejemplo «Debian GNU/Linux 13»). Este texto se compara, sin tener en cuenta mayúsculas, con el sistema operativo que indica el inventario de cada agente para elegir el paquete adecuado;
- Activar convierte un paquete en la versión actual para su patrón de plataforma: la versión actual anterior pasa a Archivado. Desactivar (en la versión actual) retira ese estado sin activar otra: ya no se distribuye nada para esta plataforma (actualización automática, actualización manual, comandos de instalación) hasta la próxima activación. Eliminar retira un paquete, tras confirmación.
Sitio público de versiones: cuando la dirección del sitio está indicada en la configuración (Outpost:Packages:FeedUrl), Portail ZAPP comprueba cada hora la última versión publicada del agente y la añade a los paquetes, con el origen Sitio público. Se verifican la firma de la publicación y el tamaño y la huella de cada archivo: un archivo no conforme nunca se añade. Por defecto, la nueva versión se añade sin activarse, con el estado Disponible: haz clic en Activar para distribuirla (o ajusta Outpost:Packages:FeedAutoActivate a true). Una versión eliminada nunca se vuelve a importar, y una versión anterior a la actual se ignora. El recuadro Sitio público de versiones muestra la última comprobación y su resultado; Comprobar ahora la vuelve a lanzar. Tras varios fallos seguidos, aparece una alerta en la gestión de eventos.
Auto-actualización automática: cuando está Activado, Portail ZAPP envía la versión actual a cada agente activo que se conecta con otra versión. Un control periódico (por defecto cada 5 minutos) alcanza también a los agentes que siguen conectados. Cuando está Desactivado, un agente solo se actualiza si haces clic en Forzar el envío de la versión actual en su ficha.