# Desinstalar

## 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:

1. **Desinstalar el programa** del servidor (lo que explica esta página).
2. **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

```sh
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**:

```powershell
& "$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](https://lymen.app/docs/instalacion/instrumentacion-aplicaciones/).
- 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

```sh
helm uninstall lymen -n lymen
```

Algunos 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](https://lymen.app/docs/instalacion/kubernetes/).

## SDK de sitios y apps

Para dejar de medir un sitio o una app:

1. Sacá el SDK del código (el `<script>` o la dependencia) y publicá una versión nueva.
2. 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á. |