V 1.

Agente
English version available here.

Índice
Índice 2

1. ¿Qué función cumple un agente? 5

2. ¿Para qué sistemas operativos está disponible el Agente de Insight? 5

3. Requerimientos del Agente 5

3.1 Windows 5

3.2 Linux 5

3.3 macOS 6

4. Navegación 6

4.1 Windows 6

4.2 Linux / macOS 6

5. Instalación del Agente 6

5.1 Apple M1 y M2 6

6. ¿Qué información obtiene un agente? 7

7. ¿Cómo se identifica un agente ante Insight? 7

8. ¿Cada cuánto tiempo reporta un Agente a Insight? 8

9. ¿Qué sucede si un agente no puede reportar al servidor/proxy configurado? 8

10. ¿Qué sucede con un Asset si se elimina el Agente del dispositivo? 8

11. ¿Dónde se encuentra el Agent ID dentro de un dispositivo? 8

12. ¿Qué se debe tener en cuenta al realizar un clonado de disco? 9

12.1 Windows 9

2
 12.2 Linux 9

12.3 macOS 10

13. ¿Qué se debe hacer si se reinstala el agente en una computadora/servidor? 10

14. Resolución de conflictos 10

14.1. ¿Cuándo se puede generar un conflicto entre Assets? 10

14.2 Resolución de conflictos entre Assets 11

14.3 Merge automático 13

15. ¿Cómo descargar la última versión del Agente de Insight en instancias on-prem? 13

16. ¿Cómo se actualiza el Agente de Insight? 14

16.1 Automáticamente 14

16.2 Disaster Recovery 14

Windows 14

Linux 15

macOS 15

17. Agent troubleshooting 15

17.1 Windows 16

17.2 Linux 16

17.3 macOS 16

18. Comandos del Agente de Insight 16

18.1 Mostrar versión 17

18.2 Mostrar Agent ID 17

18.3 Mostrar configuración 17

18.4 Enviar un inventario 17

18.5 Generar zip con logs del agente 17

18.6 Agent troubleshooting 18

19. Forzar el envío de un inventario al servidor de Insight 18

19.1 Windows 18

3
19.2 Linux 18

19.3 macOS 18

4
1. ¿Qué función cumple un agente?
Para poder obtener información de los activos y el software de la organización, es necesario
instalar agentes de InvGate Insight, que serán los encargados de generar reportes y enviarlos
a Insight para poder ser procesados.

2. ¿Para qué sistemas operativos está disponible el

Agente de Insight?
El Agente de Insight se encuentra disponible para los siguientes sistemas operativos:

● Windows
○ Windows XP en adelante.
○ Windows Server 2003 en adelante.
● Linux
○ Ubuntu 12.04 en adelante.
○ Debian 8 en adelante.
○ CentOS 7 en adelante.
○ RHEL 7 en adelante.
○ Oracle Linux 6/7.
● macOS
○ macOS 10.13 (High Sierra) en adelante.
● Android
○ Android 5.0 en adelante.

Si tiene interés en algún sistema operativo que no figura en esta lista, por favor contáctenos.

3. Requerimientos del Agente

3.1 Windows
● Permisos de Administrador.
● Windows Management Instrumentation (WMI) activado.
● Powershell activado.

3.2 Linux
● Permisos de sudo.
● Dmidecode instalado en el sistema operativo.

5
3.3 macOS
● Permisos de sudo.
● Rosetta instalado.

4. Navegación
Si la navegación de los equipos internos se encuentra restringida ya sea por un proxy
corporativo o por un Firewall, se debe verificar que el agente pueda acceder a la instancia de
Insight, o sea capaz de reportar a un Insight Proxy.

Si las restricciones se aplican sobre el usuario logueado en el sistema, se debe validar que
tanto el usuario SYSTEM (Windows) como el usuario Root (Linux) puedan realizar peticiones
HTTP a la instancia de Insight.

Se puede validar la conexión del equipo ejecutando una terminal como administrador
(Windows) o sudo (Linux/macOS):

4.1 Windows
powershell -Command "(new-object net.webclient).DownloadString('[URL-Instancia]')"

4.2 Linux / macOS

curl -L [URL-Instancia]
wget -O - [URL-Instancia]

5. Instalación del Agente

El Agente de Insight puede instalarse de manera manual, remota en Windows, Linux y macOS
y mediante GPO para sistemas operativos Windows que se encuentran en Active Directory.

Para realizar la instalación del agente se deberá ingresar a Insight con un usuario con rol de
Administrador y dirigirse a Settings → Network → Agent Deployment, seleccionar el sistema
operativo y método de instalación.

5.1 Apple M1 y M2
En algunos casos, los equipos con procesadores ARM de Apple (M1, M2) no cuentan con
Rosetta instalado/habilitado. Esta es una utilidad que permite ejecutar archivos binarios para
procesadores x86_64. Siendo que el agente de Insight se ejecuta desde un binario para
x86_64, esto termina resultando en el siguiente error:

6
 Bad CPU type in executable

Las causas para el error suelen ser las siguientes:

● No se ha instalado Rosetta 2 en el equipo. Esto puede solucionarse ejecutando

softwareupdate --install-rosetta en la terminal.
● La terminal por defecto no es zsh. Pueden modificar esto siguiendo las instrucciones
oficiales de Apple.

Si Rosetta ya se encuentra instalado en el sistema, y la terminal por defecto ya es zsh, ejecutar

por línea de comando el agente de la siguiente manera:

arch -x86_64 /usr/local/invgate/neo-assets/agent

6. ¿Qué información obtiene un agente?

● Estado del dispositivo
● Hardware instalado
● Software instalado
● Información del Sistema operativo
● Usuarios logueados
● Información de red
● Geolocalización (Windows 10 en adelante)

El tiempo tardado en procesar el inventario suele tardar menos de un minuto.

7. ¿Cómo se identifica un agente ante Insight?

Cuando se instala un agente, Insight le asigna un Agent ID, el cual lo identificará de forma
unívoca. El Agent ID permitirá relacionar el inventario enviado con el Asset, el cual se
actualizará cada vez que el agente reporte a Insight.

El Agent ID se puede encontrar dentro de “Source”, en los perfiles de los dispositivos que
reportan desde un agente.

7
8. ¿Cada cuánto tiempo reporta un Agente a Insight?
El Agente reporta el inventario al servidor de Insight en un intervalo de entre 8 y 12 horas, el
cual no puede ser modificado y el mismo estará reportando desde el momento en que se
instala el Agente. Cada vez que el agente envía un inventario, se calcula automáticamente la
fecha y hora del próximo reporte. Si el equipo se encontrase apagado al momento de enviar el
próximo inventario, el agente enviará el inventario apenas se inicie el equipo.

9. ¿Qué sucede si un agente no puede reportar al

servidor/proxy configurado?
Por defecto, cuando se instala un Agente, se especifica una URL o una IP a la cual el Agente
debe reportar (puede ser del servidor de Insight o de un Insight Proxy).

Cada vez que el agente se contacta con el servidor de Insight o un Insight Proxy, obtendrá la
información de conexión de los otros Insight Proxys configurados en la instancia. De esta
forma, si un agente no puede contactar al servidor o proxy especificado, realizará otros
intentos por los proxys configurados en la instancia de Insight.

10. ¿Qué sucede con un Asset si se elimina el Agente

del dispositivo?
Al desinstalar el agente de un dispositivo, el Asset relacionado no desaparece. El Asset
quedará offline y la información del mismo no se volverá a actualizar.

Si al momento de desinstalar el agente, el dispositivo cuenta con conexión a la instancia/proxy,

se generará una activity en Insight, reflejando la desinstalación del Agente en el dispositivo:

8
11. ¿Dónde se encuentra el Agent ID dentro de un
dispositivo?
El Agent ID se encuentra en dos archivos de configuración dentro del directorio del Agente de
Insight:

● Windows: “ %ProgramFiles(x86)%\InvGate\Insight Agent\etc\”.

● Linux: “/opt/invgate/insight-agent/etc/”.
● macOS X: “/usr/local/invgate/insight-agent/etc/”.

Los archivos son:

● invid.conf
● invid.conf.bkp

12. ¿Qué se debe tener en cuenta al realizar un

clonado de disco?
Previo a realizar el clon de un disco, es importante eliminar el archivo “invid.conf” e
“invid.conf.bkp”, los cuales contienen el Agent ID del agente. De no ser eliminado, todas las
computadoras clonadas reportarán con el mismo Agent ID. Esto causará que el perfil de un
Asset se actualice con la información de varios dispositivos.

Es importante que, luego de eliminar el archivo, la computadora/servidor (que contiene el

disco a ser clonado) no se contacte nuevamente con el servidor de Insight, para evitar que se
genere un Agent ID nuevo. Una vez que se haya generado el clon del disco, se puede volver a
utilizar.

Tenga en cuenta que si la computadora/servidor son reiniciados previamente al clonado del

disco, el servicio encenderá el agente y es posible que el mismo se contacte con el servidor de
Insight. En este caso se deberían repetir los pasos detallados previamente.

12.1 Windows
1. Detener el servicio del agente

a.

9
 2. Eliminar los archivos “invid.conf” e “invid.conf.bkp” (sección 11).
3. Apagar la computadora para realizar el clonado de disco.

12.2 Linux
1. Detener el agente para evitar que reporte al servidor de Insight:
a. Ubuntu: initctl stop invgate-insight-agent
b. Debian: systemctl stop invgate-insight-agent
c. CentOS: systemctl stop invgate-insight-agent
d. Red Hat: systemctl stop invgate-insight-agent
2. Eliminar los archivos “invid.conf” e “invid.conf.bkp” (sección 11).
3. Apagar la computadora para realizar el clonado de disco.

12.3 macOS
1. Detener el agente para evitar que reporte al servidor de Insight:
a. launchctl unload /Library/LaunchDaemons/com.invgate.insight.agent.plist
2. Eliminar los archivos “invid.conf” e “invid.conf.bkp” (sección 11).
3. Apagar la computadora para realizar el clonado de disco.

13. ¿Qué se debe hacer si se reinstala el agente en

una computadora/servidor?
Si debemos instalar el agente sobre un dispositivo que ya se encuentra en Insight, se deberá
utilizar el Agent ID que tenía previamente durante el proceso de instalación. Esto asociará el
nuevo Agente al dispositivo trackeado, y generará un activity “Agent Reinstalled” en el
dispositivo.

Los pasos para realizar la instalación de un agente se pueden encontrar ingresando en Settings
→ Network → Agent Deployment, seleccionar el sistema operativo que corresponda y en la
opción “Type” seleccionar “Reinstallation”. Se deberá ingresar el Agent ID y seguir los pasos de
instalación.

14. Resolución de conflictos

14.1. ¿Cuándo se puede generar un conflicto entre

Assets?

Los conflictos se pueden generar cuando:

10
 1. Se generó un Asset de forma manual y luego se instaló el Agente en el dispositivo
correspondiente.
2. Se descubrió un dispositivo mediante Discovery, se lo convirtió en Asset (dispositivo
trackeado) y luego se instaló el Agente en el mismo.
3. Se generó el Asset mediante alguna integración y se instaló el Agente en el mismo.

Estos casos también aplican si los pasos son ejecutados en el orden inverso.

Se puede optar por dos configuraciones para detectar conflictos entre Assets:

● Básico: Se comparan todos los números de serie del Asset.

● Avanzado: También se tiene en cuenta el modelo y fabricante del Asset.

14.2 Resolución de conflictos entre Assets

En la segunda columna del explorer, podemos ver si un Asset tiene conflictos. Se indicará con
un círculo rojo y un número que indica la cantidad de Asset con los que tiene conflictos.

Para resolver estos conflictos, será necesario hacer click en la casilla de selección del activo
correspondiente, lo cual habilitará el botón de resolución de conflictos, tal y como vemos en la
siguiente imagen:

11
Al hacer clic en este botón, el sistema indicará inmediatamente cuál es el conflicto en
cuestión, sugiriendo la Unificación de dos o más activos. El sistema ofrecerá la posibilidad de
seleccionar una de tres opciones desde un menú desplegable:

● Merge
● Remove Match
● Do nothing

Al hacer click en el botón “Next”, el sistema nos pedirá que seleccionemos con qué datos
deseamos quedarnos para el nuevo asset unificado.:

12
**Nota: El asset que quedará activo, como resultado del merge, será el que reportó por última vez. Es
importante destacar que este proceso no es reversible.

14.3 Merge automático

El merge automático, o unificación de activos, es una función de InvGate Insight que se
encarga de unificar automáticamente dos Assets de Insight que fueron creados en diferentes
momentos, pero que representan el mismo dispositivo físico. A su vez, estos conflictos podrán
ser corregidos de forma manual. En este documento se encuentra una guía detallada acerca
de esta funcionalidad.

15. ¿Cómo descargar la última versión del Agente de

Insight en instancias on-prem?
Para actualizar los Agentes de forma automática, es necesario contar con la última versión del
mismo en el servidor de Insight.

Para las instancias Cloud, esto se realizará de forma automática cada vez que se publica una
nueva versión del mismo.

13
Para las instancias On-Premises, el agente se actualiza de forma automática cada vez que se
actualiza la instancia de Insight. Si fuese necesario actualizar la versión del Agente, sin
actualizar la instancia, se puede realizar ejecutando los siguientes comandos en el servidor:

source /usr/share/invgate/neoassets/neo-assets/.venv/bin/activate

cd /usr/share/invgate/neoassets/neo-assets/

python3 manage.py check_new_releases --settings=assets.settings.production

16. ¿Cómo se actualiza el Agente de Insight?

Para poder actualizar la versión de nuestros Agentes de Insight, primero, se debe descargar la
última versión del mismo en el servidor (sección 15). Una vez que se cuente con la última
versión en el servidor, el Agente podrá actualizarse de dos formas:

16.1 Automáticamente
Cada vez que el Agente se contacta con el Servidor de Insight, verifica si hay una nueva
versión para actualizarse. De ser así, descarga la última versión, y se actualiza a sí mismo de
forma automática.

16.2 Disaster Recovery

Durante la primera instalación del Agente, se instala y configura el “Agent Recovery”. El Agent
Recovery es el encargado de actualizar al Agente en caso de fallas que imposibiliten su
correcto funcionamiento.

El Agent Recovery se ejecuta de forma automática cada vez que se inicia el dispositivo donde
se encuentra instalado, o cada cinco horas. Esto permite que, en el caso de que una
actualización no finalice correctamente o una versión del Agente tenga problemas, se pueda
realizar la actualización automática del mismo sin tener que hacerla de forma manual en
todos los dispositivos.

Para esto, el Agente crea dos tareas programadas en el sistema operativo:

Windows

14
Linux

MacOS

17. Agent troubleshooting

El Agent troubleshooting ejecuta una serie de chequeos sobre el Agente de Insight para
detectar problemas conocidos relacionados a:

1. Servicios
2. Archivos de configuración
3. Espacio en disco
4. Conexión a la instancia/proxy
5. Source de información como WMI o DMI
6. Agent recovery tasks

15
17.1 Windows
Ejecutar como administrador “agent-troubleshooting.bat”
ubicado en “%programfiles(x86)%\InvGate\Insight Agent\Agent-troubleshooting.bat”:

17.2 Linux
sudo bash /opt/invgate/insight-agent/agent-troubleshooting.sh

17.3 macOS
sudo bash /usr/local/invgate/insight-agent/agent-troubleshooting.sh

18. Comandos del Agente de Insight

El Agente de Insight cuenta con una serie de parámetros que pueden ser utilizados para
obtener información y realizar ciertas acciones.

Para esto, se deberá ejecutar una consola como administrador.

El comando a utilizar dependerá del sistema operativo donde se desea ejecutar.

16
Windows

invgate-insight-agent

Linux

/opt/invgate/insight-agent/agent

macOS

/usr/local/invgate/insight-agent/agent

18.1 Mostrar versión

Mostrar la versión instalada del Agente de Insight.

[comando] -v
[comando] --version

18.2 Mostrar Agent ID

Mostrar el Agent ID del agente que es utilizado para reportar a la instancia de Insight.

[comando] -id
[comando] --agent-id

18.3 Mostrar configuración

Mostrar las configuraciones del Agente.

[comando] -c
[comando] --config

18.4 Enviar un inventario

Generar un inventario y enviarlo a la instancia de Insight.

[comando] -s
[comando] --send

18.5 Generar zip con logs del agente

Recolectar los logs del agente y generar un ZIP.

[comando] -zl

17
[comando] --zip-log

18.6 Agent troubleshooting

Ejecutar chequeos sobre el Agente para validar su correcto funcionamiento.

[comando] --doctor

19. Forzar el envío de un inventario al servidor de

Insight
19.1 Windows
Ejecutar como administrador el bat “send-inventory.bat” ubicado en la carpeta del Agente de
Insight.

19.2 Linux
Ejecutar el siguiente comando con un usuario con permisos de administrador:

/opt/invgate/insight-agent/agent -s

19.3 macOS
Ejecutar el siguiente comando con un usuario con permisos de administrador:

/usr/local/invgate/insight-agent/agent -s

18