Guia de Instalacion para macOS

Version 2.2.0 | Actualizada: 2026-04-09 | Plataforma: macOS 10.15+ (Catalina, Big Sur, Monterey, Ventura, Sonoma) — Intel + Apple Silicon
Instalación

Abre Terminal y ejecuta el instalador automatico:

curl -sL https://glpi-deploy.reactorads.com/install-glpi-macos.sh | sudo bash

Que hace este comando:

  1. Descarga el instalador desde el servidor
  2. Valida prerequisitos (sudo, curl, Internet)
  3. Detecta arquitectura automaticamente (Intel o Apple Silicon)
  4. Obtiene la lista de entidades directamente desde GLPI
  5. Obtiene la lista de tecnicos autorizados desde GLPI
  6. Muestra menus interactivos para seleccionar entidad y tecnico
  7. Descarga el paquete .pkg correcto para tu arquitectura
  8. Instala con installer -pkg (Gatekeeper puede pedir confirmacion)
  9. Configura el agente con la URL y TAG correctos
  10. Inicia el servicio launchd y ejecuta el primer inventario
Requisitos Previos
RequisitoEstado
Sistema operativomacOS 10.15 (Catalina) o superior
ArquitecturaIntel (x86_64) o Apple Silicon (arm64) — deteccion automatica
PermisosAdministrator (sudo, obligatorio)
RedAcceso HTTPS a reactorads.com y glpi.reactorads.com
curlInstalado por defecto en macOS
Instalacion Paso a Paso

Paso 1: Abrir Terminal

Presiona Cmd + Space, escribe Terminal y presiona Enter.

Paso 2: Ejecutar el Instalador

curl -sL https://glpi-deploy.reactorads.com/install-glpi-macos.sh | sudo bash

Paso 3: Seleccionar Entidad

El script muestra las entidades principales obtenidas desde GLPI, ordenadas alfabeticamente:

========================================================= GLPI Agent - Seleccion de Entidad ========================================================= [1] ADS [2] Amaparts [3] Apic [4] CL [5] Corporativo EMF [6] Desamex [7] Hickok Selecciona entidad (1-7): _

Ingresa el numero de la entidad destino.

Paso 4: Seleccionar Tecnico

Solo los tecnicos autorizados aparecen en este menu, ordenados alfabeticamente:

========================================================= GLPI Agent - Tecnico que instala ========================================================= [1] Alan Hernandez (alan) [2] Antonio Betancourt (antonio) [3] Carlos Armas (carlos) [4] Edson Santana (edson) [5] Mario Ladrillero (mario) [6] Orlando Nolasco (orlando) Selecciona tecnico (1-6): _

Ingresa tu numero de tecnico.

Paso 5: Esperar la Instalacion

El script se encarga de todo automaticamente. Tiempo estimado: 2-3 minutos.

Paso 6: Verificar la Instalacion

sudo launchctl list | grep glpi-agent

Salida esperada: el servicio glpi-agent aparece en la lista.

Instalacion Manual con .pkg

Si prefieres instalar manualmente sin el script:

Paso 1: Descargar el .pkg Correcto

Elige el paquete segun tu arquitectura:

# Intel (x86_64)
# Apple Silicon (arm64)

Paso 2: Instalar el Paquete

sudo installer -pkg /tmp/glpi-agent-1.17-x86_64.pkg -target /

Nota: Gatekeeper puede mostrar una ventana de confirmacion. Haz clic en "Abrir" para continuar.

Paso 3: Configurar el Agente

sudo mkdir -p /Library/Preferences/GLPI-Agent
sudo tee /Library/Preferences/GLPI-Agent/99-autoinstall.cfg > /dev/null << EOF server = https://glpi.reactorads.com tag = Hickok EOF

Paso 4: Iniciar el Servicio

sudo launchctl load /Library/LaunchDaemons/com.glpi-project.agent.plist

Paso 5: Ejecutar Inventario

sudo glpi-agent --force
Verificacion Post-Instalacion

Verificar el Servicio

sudo launchctl list | grep glpi-agent

Verificar Configuracion

sudo defaults read /Library/Preferences/GLPI-Agent ServerURL
sudo defaults read /Library/Preferences/GLPI-Agent TAG

Verificar en la Interfaz Web de GLPI

  1. Abre https://glpi.reactorads.com
  2. Navega a: Activos -> Agentes
  3. Busca el nombre del equipo o el TAG
  4. Verifica que el Ultimo contacto sea reciente

Verificar el Log

tail -f /Library/Logs/GLPI-Agent/*.log
Solucion de Problemas

Error: "curl: command not found"

Causa: curl no disponible (raro en macOS).

Solucion: curl viene preinstalado en macOS. Si falta, reinstala las Command Line Tools:

xcode-select --install

Error: "Se requieren permisos de root"

Causa: El script no se ejecuto con sudo.

Solucion: Ejecuta de nuevo con sudo bash.

Error: "Permission denied"

Causa: Permisos insuficientes.

Solucion:

sudo /tmp/glpi-macos.sh

Error: "installer: The package is damaged"

Causa: Gatekeeper bloqueando la instalacion.

Solucion:

  1. Abre System Preferences → Security & Privacy
  2. Haz clic en "Open Anyway" junto al mensaje de bloqueo
  3. O ejecuta: xattr -rd com.apple.quarantine /tmp/glpi-agent-*.pkg

Error: "Certificate validation failed"

Causa: Certificado SSL no reconocido.

Solucion: Confiar en el certificado del servidor:

sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain /path/to/cert.crt

El Agente no aparece en GLPI

Solucion: Fuerza el inventario:

sudo glpi-agent --force

Error: "No se pudo descargar config.json"

Causa: No se puede alcanzar reactorads.com.

Solucion: Verifica conectividad:

curl -I https://glpi-deploy.reactorads.com/api/config.json
Soporte
Portalhttps://glpi-deploy.reactorads.com/
Panel de Controlhttps://glpi-deploy.reactorads.com/dashboard/
GLPIhttps://glpi.reactorads.com