Agente para Linux ARM64

Cómo instalar y verificar el agente NESS HQ en un equipo con procesador ARM 64 bits (arquitectura aarch64): servidores AWS Graviton, Mac con Asahi Linux, Raspberry Pi 4/5 (con OS de 64 bits), servidores Ampere, Oracle Cloud, etc.

Importante: si tu Mac usa Apple Silicon (M1/M2/M3/M4/M5), la guía correcta es macos.md. Este documento es solo para Linux sobre ARM64.

1. Requisitos

Requisito	Detalle
Distribución	Debian 12+ ARM64, Ubuntu 22.04+ ARM64, RHEL 9+ ARM64, Rocky 9+ ARM64, Fedora 39+ ARM64, openSUSE Tumbleweed ARM64.
Permisos	Usuario con acceso a sudo.
Red	HTTPS saliente (puerto 443) hacia cloud.nesshq.com.
RAM	1 GB mínimo libre (el agente consume menos de 100 MB).
Disco	2 GB libres. Ver requisitos: disco por confirmar.

Si tu distribución es Debian/Ubuntu x86, ve a linux-debian.md. Si es RHEL/Fedora/Rocky x86, ve a linux-rhel.md. Si es SUSE, ve a linux-suse.md.

2. Verificar que es ARM64

Antes de instalar, abre una Terminal y ejecuta:

uname -m

Debe decir aarch64.

Si dice armv7l o armv6l, tu sistema es ARM de 32 bits. La plataforma no soporta esa arquitectura; considera reinstalar con un OS de 64 bits.

Captura pendiente: 01 - Verificar arquitectura con uname

Imagen pendiente de incorporar.

3. Instalación paso a paso

3.1 Método rápido

1. Abre una Terminal.

2. Ejecuta (reemplaza TU_TOKEN por tu token):

   curl -fsSL https://storage.googleapis.com/repo.nesshq.com/scripts/install-arm64.sh \
     | NESS_TOKEN='TU_TOKEN' NESS_TIME='15' sudo -E bash

3. Te pedirá tu contraseña de sudo.

4. Al final debe decir "INSTALADO".

Captura pendiente: 02 - Comando de instalación

Imagen pendiente de incorporar.

Captura pendiente: 03 - Instalación exitosa

Imagen pendiente de incorporar.

3.2 Parámetros disponibles

Parámetro	Para qué sirve	Ejemplo
--token "<TOKEN>" (o -t)	Token de tu organización (obligatorio).	--token "<TOKEN>"
--time 15 (o -i)	Cada cuántos minutos el agente reporta.	--time 30
--services "nginx,mysql" (o -s)	Servicios adicionales a monitorear.	--services "nginx,mysql"
--silent	Modo silencioso.	--silent
--help (o -h)	Muestra la ayuda.	--help

4. Distribuciones ARM64 compatibles

Distribución	Notas
Debian	12+ ARM64.
Ubuntu Server	22.04 LTS+, 24.04 LTS+.
Raspberry Pi OS	Versión Bookworm de 64 bits (RPi 4/5).
RHEL / Rocky / AlmaLinux	9+ ARM64.
Fedora Server	39+ ARM64.
Oracle Linux	9 ARM64 (Ampere A1).
Amazon Linux 2023	ARM64 (Graviton).
openSUSE Tumbleweed	ARM64.
Asahi Linux	Fedora-based.

Proveedores cloud validados

• AWS: t4g, m6g, c6g, r6g, x2gd.
• Google Cloud: t2a, c3a, c4a (Axion).
• Azure: Dpsv5, Dplsv5, Epsv5.
• Oracle Cloud: Ampere A1 (free tier).
• DigitalOcean / Hetzner: series cax.

5. ¿Cómo verifico que está funcionando?

5.1 Desde el portal

Entra a https://cloud.nesshq.com → Hosts → busca tu equipo → debe aparecer verde.

Captura pendiente: 04 - Equipo en línea en el portal

Imagen pendiente de incorporar.

5.2 Desde la Terminal

sudo ness-core-service --doctor

Verás un reporte con verificaciones. Todas deben decir OK.

Captura pendiente: 05 - Diagnóstico doctor

Imagen pendiente de incorporar.

5.3 Ver los registros

sudo journalctl -u ness-core -n 100 --no-pager

6. ¿Qué hago si algo falla?

Síntoma	Causa probable	Solución
uname -m dice armv7l	OS de 32 bits	Cambia a un OS de 64 bits.
"Exec format error"	Instalaste el instalador equivocado	Verifica que usaste install-arm64.sh, no el de x86.
El equipo no aparece en el portal	Aún no pasaron 5 minutos	Espera y refresca.
El equipo está rojo Offline	Sin red, equipo apagado, o servicio detenido	Verifica la red y el servicio.
Raspberry Pi: OCR muy lento	CPU limitada	Habla con el administrador para deshabilitar OCR.

7. ¿Cómo actualizo el agente?

Automático, una vez al día. Para forzar:

sudo ness-updater --update

8. ¿Cómo desinstalo el agente?

8.1 Desde el portal

Hosts → selecciona tu equipo → Acciones → Desinstalar agente.

Captura pendiente: 06 - Desinstalar desde el portal

Imagen pendiente de incorporar.

8.2 Desde la Terminal

sudo /usr/local/bin/uninstall-arm64.sh

9. Soporte

• Web: https://nesshq.com
• Email: soporte@nesshq.com

Ruta completa

El instalador agrega los binarios de NESS al PATH, así que los comandos se usan por su nombre. También puedes usar la ruta completa, p. ej. & "C:\Program Files\NESS Core\ness-updater.exe" --update

Fuente

Guías para el cliente NESS HQ (2026). Ver Fuentes.