Guia de Instalacion macOS

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:

Descarga el instalador desde el servidor
Valida prerequisitos (sudo, curl, osascript, Internet)
Detecta arquitectura automaticamente (Intel o Apple Silicon)
Obtiene la lista de entidades directamente desde GLPI
Obtiene la lista de tecnicos autorizados desde GLPI
Muestra menus interactivos para seleccionar entidad y tecnico
Descarga el paquete .pkg correcto para tu arquitectura
Verifica la integridad SHA256 del paquete descargado
Instala con installer -pkg (Gatekeeper puede pedir confirmacion)
Configura el agente con la URL y TAG correctos
Inicia el servicio launchd y ejecuta el primer inventario
Registra la instalacion en el panel de control

Nota: A diferencia de otras plataformas, macOS no incluye Python 3 por defecto. El instalador usa osascript (JavaScript for Automation), que es nativo de macOS y no requiere instalar nada adicional.

Requisitos Previos

Requisito	Estado
Sistema operativo	macOS 10.15 (Catalina) o superior
Arquitectura	Intel (x86_64) o Apple Silicon (arm64) — deteccion automatica
Permisos	Administrator (sudo, obligatorio)
Red	Acceso HTTPS a reactorads.com y glpi.reactorads.com
curl / osascript	Instalados por defecto en macOS (no requiere python3)

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: Descarga y Verificacion SHA256

El script descarga el paquete .pkg correcto para tu arquitectura y verifica automaticamente su integridad mediante SHA256. Si el checksum no coincide, la instalacion se cancela.

Paso 6: Esperar la Instalacion

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

Paso 7: Verificar la Instalacion

sudo launchctl list | grep teclib

Salida esperada: el servicio com.teclib.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:

Arquitectura	URL
Intel (x86_64)	glpi-agent-x86_64.pkg
Apple Silicon (arm64)	glpi-agent-arm64.pkg

Nota: Verifica la integridad del paquete descargado con SHA256:

curl -sL https://glpi-deploy.reactorads.com/glpi-agent-x86_64.pkg.sha256 | shasum -a 256 -c

Paso 2: Instalar el Paquete

sudo installer -pkg ~/Downloads/glpi-agent-x86_64.pkg -target /

Importante: La instalacion del .pkg puede mostrar una ventana de Gatekeeper. Haz clic en "Abrir" para continuar. Si no aparece, revisa System Settings > Privacy & Security.

Paso 3: Configurar el Agente

El agente lee la configuracion desde /Applications/GLPI-Agent/etc/. Crea un archivo en conf.d/ con los datos de tu entidad (reemplaza Hickok con el TAG correcto):

sudo mkdir -p /Applications/GLPI-Agent/etc/conf.d

sudo tee /Applications/GLPI-Agent/etc/conf.d/99-glpi-deploy.cfg > /dev/null << EOF server = https://glpi.reactorads.com tag = Hickok EOF

Paso 4: Iniciar el Servicio

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

Paso 5: Ejecutar Inventario

sudo /Applications/GLPI-Agent/bin/glpi-agent --force

TAG por Entidad

Usa el TAG correcto segun la entidad del equipo:

Entidad	TAG
ADS	`ADS`
Amaparts	`Amaparts`
Apic	`Apic`
Casa Lumbre	`CL`
Corporativo EMF	`Corporativo EMF`
Desamex	`Desamex`
Day International	`Day International`
Hickok	`Hickok`

Importante: El TAG distingue mayusculas/minusculas. Debe coincidir exactamente con el nombre de la entidad.

Verificacion Post-Instalacion

Verificar el Servicio

sudo launchctl list | grep teclib

Verificar Configuracion

cat /Applications/GLPI-Agent/etc/conf.d/99-glpi-deploy.cfg

Verificar Integridad SHA256

Si descargaste el .pkg manualmente, verifica su integridad:

curl -sL https://glpi-deploy.reactorads.com/glpi-agent-x86_64.pkg.sha256 | shasum -a 256 -c

Salida esperada: OK

Verificar en la Interfaz Web de GLPI

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

Verificar el Log

sudo tail -f /var/log/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: "installer: The package is damaged" o Gatekeeper bloquea

Causa: Gatekeeper bloqueando la instalacion del paquete.

Soluciones:

Abre System Settings → Privacy & Security
Desplazate a la seccion Security
Haz clic en "Open Anyway" junto al mensaje de bloqueo
O ejecuta: xattr -rd com.apple.quarantine ~/Downloads/glpi-agent-*.pkg
Verifica con: spctl --assess --verbose ~/Downloads/glpi-agent-*.pkg

Error: "SHA256 no coincide"

Causa: El paquete descargado esta corrupto o fue modificado.

Solucion: Descarga de nuevo el paquete:

rm -f ~/Downloads/glpi-agent-*.pkg && curl -sL -o ~/Downloads/glpi-agent-x86_64.pkg https://glpi-deploy.reactorads.com/glpi-agent-x86_64.pkg

El Agente no aparece en GLPI

Solucion: Fuerza el inventario:

sudo /Applications/GLPI-Agent/bin/glpi-agent --force

No se pudo descargar la configuracion

Causa: No se puede alcanzar los servidores de reactorads.com.

Solucion: Verifica conectividad:

curl -I https://glpi-deploy.reactorads.com/api/config.json

El servicio no inicia correctamente

Solucion: Intenta iniciar manualmente:

sudo launchctl load /Library/LaunchDaemons/com.teclib.glpi-agent.plist 2>/dev/null || sudo /Applications/GLPI-Agent/bin/glpi-agent --daemon --no-fork

Error con version de macOS (Sequoia 15+)

Causa: Las versiones recientes de macOS ya no incluyen Python 3 por defecto.

Nota: El instalador automatico usa osascript (JavaScript for Automation) para procesar JSON, por lo que no requiere Python 3. La instalacion manual tampoco necesita Python 3.

Soporte

Portal	https://glpi-deploy.reactorads.com/
Panel de Control	https://glpi-deploy.reactorads.com/dashboard/
GLPI	https://glpi.reactorads.com