Desinstalar
Cómo sacar el agente de un servidor (Linux o Windows), el monitoreo en detalle, Kubernetes y los SDK, y cómo quitar el servidor del portal.
En esta página
Para qué sirve#
Para sacar Lymen de un servidor que ya no querés medir, o para dejarlo limpio antes de reinstalar. Son dos cosas distintas y conviene hacer las dos:
- Desinstalar el programa del servidor (lo que explica esta página).
- Quitar el servidor del portal (Infraestructura › detalle del servidor › Quitar servidor). Eso revoca su credencial: el agente deja de poder mandar datos. Desinstalar el programa no lo quita del portal: el servidor sigue figurando hasta que lo quiten desde ahí.
El desinstalador no toca las aplicaciones del servidor.
Linux#
sudo /opt/lymen-agent/actual/lymen-desinstalar| Opción | Qué hace |
|---|---|
--si |
No pregunta antes de seguir. |
--conservar-datos |
Deja /var/lib/lymen-agent (la cola de datos y las claves del gateway). Útil si vas a reinstalar el mismo servidor. |
Sin --conservar-datos, también se borran las claves del gateway: si el servidor era gateway y lo reinstalás, las credenciales selladas para él quedan ilegibles y hay que volver a cargarlas en el Llavero.
Saca, en este orden: el monitoreo en detalle de aplicaciones (si estaba), el actualizador, el servicio del agente, el inventario del servidor, el monitoreo de equipos de red (si había), las unidades de systemd, la configuración y el entorno (con el token), los datos y los archivos del programa. También borra el usuario lymen-agent.
Windows#
Abrí PowerShell como administrador:
& "$env:ProgramFiles\lymen-agent\actual\lymen-desinstalar.ps1" [-Si] [-ConservarDatos]| Opción | Qué hace |
|---|---|
-Si |
No pregunta antes de seguir. |
-ConservarDatos |
Deja C:\ProgramData\lymen-agent (la cola de datos y las claves del gateway). |
Saca el monitoreo en detalle de aplicaciones (si estaba), la tarea del actualizador, el servicio Agente de Lymen, la carpeta del programa y la de datos.
El desinstalador de Windows no se probó todavía en un Windows real con el servicio instalado.
Sacar solo el monitoreo en detalle de aplicaciones#
Sin desinstalar el agente:
- Desde el portal: Desactivar cada aplicación (queda sin medirse cuando se reinicie) o Pausar el monitoreo en detalle en este servidor como medida de emergencia. Ver Instrumentación.
- En Linux, completo:
sudo /opt/lymen-agent/instrumentacion/bin/lymen-instrumentacion desinstalar.
Una aplicación que ya estaba medida sigue cargada hasta que se reinicie: ningún agente se descarga en caliente.
Kubernetes#
helm uninstall lymen -n lymenAlgunos recursos del operador se van recién cuando se quitan sus definiciones (CRD) del cluster. Quitá también la anotación de los pods que habías instrumentado y reinicialos. Ver Kubernetes.
SDK de sitios y apps#
Para dejar de medir un sitio o una app:
- Sacá el SDK del código (el
<script>o la dependencia) y publicá una versión nueva. - En Aplicaciones, apagá Recibir datos (pausa) o Eliminar la aplicación. Eliminada, Lymen deja de aceptar datos con su clave y lo ya guardado vence solo; si la volvés a crear, tiene una clave nueva.
Mientras haya versiones viejas instaladas en los teléfonos, seguirán intentando mandar datos: con la aplicación pausada o eliminada, esos envíos se rechazan.
Equipos de red#
Para dejar de monitorear un equipo, abrilo en Equipos de red y tocá Eliminar. Para que un gateway deje de poder consultar o escuchar, vaciá las listas de /etc/lymen-agent/red-permitidos.yaml (queda todo denegado).
Problemas comunes#
| Síntoma | Qué hacer |
|---|---|
| El servidor sigue apareciendo en Infraestructura | Quitalo desde el detalle: Quitar servidor. |
| "hay que correrlo como root" / "abrí PowerShell como administrador" | Corrélo con permisos de administrador. |
| Quedó un servicio colgado | Reiniciá el servidor y volvé a correr el desinstalador. |
| Quiero reinstalar el mismo servidor | Desinstalá (con --conservar-datos si era gateway), quitá el servidor del portal, generá un código nuevo en Agregar datos y reinstalá. |