Operar

Usa esta página una vez inscritas las máquinas: para mantener el cliente actualizado, trabajar con los registros que guarda en cada máquina y desinstalarlo.

Actualizaciones

El cliente puede comprobar si hay una versión nueva y actualizarse. La descarga se comprueba en integridad antes de sustituir nada en la máquina: se compara un resumen SHA-512 con el que publica el registro de paquetes para esa versión, así que nunca se aplica una descarga dañada o truncada. Esa comprobación detecta daños y truncamientos; no protege frente a un registro comprometido. Deja activada la actualización automática en las instalaciones que hace un desarrollador por sí mismo, donde mantiene la máquina al día sin que nadie la programe.

Un entorno gestionado suele querer controlar la versión. Desactiva la actualización automática y deja activada la comprobación, para que una máquina siga indicando que hay una versión más reciente mientras espera tu ventana de mantenimiento. Después entrega la nueva versión como se entregó el cliente la primera vez, con las herramientas que ya gestionan la máquina.

Variable	Valor
`OPENLATCH_AUTO_UPDATE`	`false` impide que el cliente se actualice solo. Defínela donde quieras fijar la versión
`OPENLATCH_UPDATE_CHECK`	Déjala en `true`, para que `openlatch status` siga indicando que hay una versión más reciente

Registros locales

El cliente guarda su configuración y sus registros locales en un único directorio: ~/.openlatch en macOS y Linux, %APPDATA%\openlatch en Windows. OPENLATCH_DIR lo cambia de sitio. Un entorno que lo cambia de sitio debe apuntar sus propios scripts de recogida y eliminación al mismo valor.

Los registros se escriben con las credenciales enmascaradas, y las rutas de archivo se enmascaran de la misma forma. Tratamiento de datos y seguridad enumera lo que se captura, lo que se enmascara y cuánto tiempo se conserva cada tipo. Los registros que aún no han llegado a la consola se guardan en ese directorio y se envían cuando la consola vuelve a ser accesible. Esa reserva está acotada: por encima de su límite de tamaño, 100 MB por defecto, se descartan los registros no enviados más antiguos y el registro del daemon anota un aviso OL-1204. Consulta los ajustes del outbox y del registro de respaldo en Configuración.

Abrir un caso de soporte

Ejecuta primero openlatch doctor en la máquina afectada. Describe lo que encuentra en términos sencillos. Después crea el archivo depurado con openlatch doctor --rescue: contiene el diagnóstico, la configuración y una ventana reciente de los registros locales. Envía ese archivo, nunca el directorio en sí, con el sistema operativo y la hora del problema con su zona horaria.

Contacta con tu responsable técnico de OpenLatch por el canal acordado con tu organización. Envía los avisos de seguridad a security@openlatch.ai.

Desinstalar el cliente

Para retirar el cliente de una máquina:

openlatch uninstall

Para retirar el cliente y los registros que guardó localmente:

openlatch uninstall --purge

openlatch uninstall desconecta el cliente de cada agente que encuentra en la máquina y lo detiene. Cada agente queda como estaba antes de la instalación, y los ajustes que OpenLatch no escribió no se tocan. La configuración y los registros locales se quedan en disco salvo que pidas eliminarlos.

--purge elimina además ese directorio y la credencial guardada en el almacén de credenciales del sistema. Rechaza cualquier directorio que no sea el del cliente, y resuelve los enlaces simbólicos antes de eliminar, para que un enlace no pueda desviar la eliminación a otro sitio. Un entorno que cambia el directorio de sitio debe mantener la misma comprobación en su propio script de eliminación.

Ninguno de los dos comandos elimina los archivos del propio cliente. Se instalaron fuera del directorio de estado, así que una purga los deja en la máquina, junto con la línea PATH que añadió la instalación. Para retirar el cliente por completo, elimina los dos archivos que colocó la instalación, openlatch y openlatch-hook en ~/.local/bin en macOS y Linux, o openlatch.exe y openlatch-hook.exe en %LOCALAPPDATA%\openlatch\bin en Windows. Deja el directorio y todo lo demás que contenga: otro software puede usarlo. En Windows, el directorio pertenece al cliente, así que también puedes eliminarlo junto con la entrada PATH que añadió la instalación; en macOS y Linux, conserva la línea PATH si otras herramientas dependen de ~/.local/bin. No hay script de desinstalación: un entorno que quiera que se haga por él lo hace con las herramientas que instalaron el cliente.

La eliminación es máquina a máquina. No hay que deshacer nada en la consola para una máquina desinstalada, y una máquina que vuelve se instala igual que la primera vez.

En resumen

Deja activada la actualización automática en las instalaciones de los desarrolladores. Fíjala con OPENLATCH_AUTO_UPDATE=false en un entorno gestionado, y deja activada la comprobación para que una máquina siga indicando lo que le falta.
Una versión nueva entra en vigor cuando el cliente se reinicia: termina la ventana de mantenimiento con openlatch restart o con un cierre e inicio de sesión.
La configuración y los registros locales están en un único directorio. Un caso de soporte se abre con el archivo depurado que genera openlatch doctor --rescue.
openlatch uninstall deja cada agente como estaba. --purge elimina además el directorio y la credencial guardada, y deja los dos archivos instalados, que una eliminación completa quita por separado.