Referencia de la CLI

Todos los comandos y subcomandos del cliente OpenLatch.

`openlatch init`

openlatch setup

Instala los hooks de los agentes encontrados en esta máquina, inicia el daemon y comprueba que responde. Se puede ejecutar de nuevo sin riesgo: primero libera los puertos del cliente y después confirma que el daemon que inició es el que responde.

`openlatch status`

Muestra el estado del daemon, su tiempo de actividad y el número de eventos, el estado de cada parte del cliente y la línea de licencia: su estado, los hosts, el uso razonable y el fin del contrato.

`openlatch start`

Inicia el daemon. Se niega con OL-1501 cuando ya hay un daemon en marcha en esta máquina.

`openlatch stop`

Detiene el daemon. También quita la conexión de los agentes con el relé de modelo, y lo indica.

`openlatch restart`

Detiene el daemon y lo vuelve a iniciar, por ejemplo para aplicar un cambio de configuración.

`openlatch logs`

Muestra el registro de eventos del cliente.

`openlatch doctor`

Diagnostica la configuración y la conectividad del cliente, e indica la causa y la solución de cada problema que encuentra. --fix aplica las reparaciones posibles, --restore las deshace y --rescue genera un archivo de diagnóstico para el soporte.

`openlatch uninstall`

Quita los hooks de los agentes y detiene el daemon. --agent lo limita a los agentes que indiques.

`openlatch docs`

Abre la documentación en tu navegador.

`openlatch system`

Agrupa los comandos que inspeccionan o controlan una parte del cliente: aip, auth, hooks, model-relay, proxy, supervision, telemetry e inventory. Cada solución que da openlatch doctor indica el comando system exacto que hay que ejecutar.

`openlatch system aip`

Obtiene e inspecciona el paquete de políticas presente en esta máquina, que contiene las reglas de la Autonomy Zone que aplica el cliente.

`openlatch system aip refresh`

openlatch system aip update

Hace que el daemon en marcha obtenga el paquete de políticas ahora mismo, y espera el resultado hasta 15 segundos: cambiado, sin cambios, pendiente, rechazado o sin conexión, con los datos del paquete en uso. Un resultado pendiente termina con el código 7; un rechazo o un daemon sin conexión termina con el código 1.

`openlatch system auth`

Agrupa los comandos que conectan el cliente con la plataforma.

`openlatch system auth login`

Inicia sesión del cliente en la plataforma a través de tu navegador y guarda la credencial en el llavero del sistema operativo.

`openlatch system auth logout`

Cierra la sesión del cliente y elimina la credencial guardada.

`openlatch system auth status`

Indica si el cliente ha iniciado sesión y de dónde procede su credencial.

`openlatch system auth switch`

Mueve esta máquina a otra de tus organizaciones.

`openlatch system hooks`

Agrupa los comandos que gestionan los hooks de los agentes. system hooks install equivale a openlatch init.

`openlatch system hooks install`

Instala los hooks de los agentes; equivale a openlatch init.

`openlatch system hooks uninstall`

Quita los hooks de los agentes; equivale a openlatch uninstall.

`openlatch system hooks status`

Muestra en detalle los hooks instalados para cada agente.

`openlatch system model-relay`

Agrupa los comandos que inspeccionan o activan y desactivan el relé de modelo, el receptor local que registra las llamadas al modelo de cada agente.

`openlatch system model-relay status`

Indica si el relé de modelo está en marcha, su puerto y si las llamadas al modelo de cada agente pasan por él. Un agente cuyos hooks funcionan pero cuyas llamadas al modelo no se registran aparece como aplicado, pero no medido.

`openlatch system model-relay enable`

Activa el relé de modelo en la configuración y ofrece reiniciar el daemon para aplicarlo.

`openlatch system model-relay disable`

Desactiva el relé de modelo en la configuración y ofrece reiniciar el daemon para aplicarlo.

`openlatch system model-relay explain`

Muestra un registro del relé de modelo por su identificador, leído del almacenamiento local. Su contenido nunca sale de la máquina.

`openlatch system proxy`

Agrupa los comandos que inspeccionan, descubren, definen o prueban el proxy por el que pasa cada solicitud saliente.

`openlatch system proxy status`

Muestra la ruta que siguen las solicitudes salientes, para la CLI y, si es distinta, para el daemon.

`openlatch system proxy discover`

Vuelve a ejecutar la detección de proxy del sistema operativo, prueba cada candidato y conserva el que funciona.

`openlatch system proxy set`

Define el proxy a mano. Un proxy definido así nunca lo sustituyen la detección ni la reparación automática.

`openlatch system proxy clear`

Quita el proxy y su credencial, para que las solicitudes vayan directamente a su destino.

`openlatch system proxy test`

Prueba la ruta paso a paso: la conexión al proxy, TLS, HTTP y una respuesta en streaming.

`openlatch system supervision`

Agrupa los comandos que gestionan el supervisor del sistema operativo (launchd, systemd o el Programador de tareas) que inicia el daemon al iniciar sesión y lo reinicia. Todo queda en el ámbito del usuario.

`openlatch system supervision install`

Instala el supervisor del sistema operativo, para que el daemon se inicie al iniciar sesión y tras un reinicio.

`openlatch system supervision uninstall`

Quita el supervisor del sistema operativo. El daemon sigue en marcha, pero ya no se inicia solo.

`openlatch system supervision status`

Indica si el supervisor está instalado y en marcha, y cuál usa este sistema.

`openlatch system supervision enable`

Vuelve a activar la supervisión después de disable, e instala de nuevo el supervisor.

`openlatch system supervision disable`

Quita el supervisor y registra que la supervisión está desactivada en esta máquina.

`openlatch system telemetry`

Agrupa los comandos que gestionan la telemetría de uso, que puedes desactivar.

`openlatch system telemetry status`

Indica si la telemetría de uso está activada, qué ajuste lo decide y si esta versión la incluye.

`openlatch system telemetry enable`

Activa la telemetría de uso.

`openlatch system telemetry disable`

Desactiva la telemetría de uso.

`openlatch system telemetry purge`

Desactiva la telemetría de uso y vacía la cola de eventos no enviados de un daemon en marcha.

`openlatch system telemetry debug`

Muestra cómo ejecutar cualquier comando para que imprima los eventos de telemetría que enviaría.

`openlatch system inventory`

Agrupa los comandos que inspeccionan el plano de configuración: las fuentes de configuración de los agentes que sigue el cliente, sus eventos de cambio, los nuevos análisis y el estado del observador.

`openlatch system inventory list`

Enumera las fuentes de configuración que sigue el cliente, a partir del registro de auditoría local.

`openlatch system inventory log`

Muestra los eventos de cambio de configuración del registro de auditoría local.

`openlatch system inventory rescan`

Vuelve a analizar ahora cada fuente de configuración seguida.

`openlatch system inventory status`

Indica el estado del observador de configuración: si está activado, si su lista de fuentes se cargó y cuántas fuentes contiene.

`openlatch system inventory inspect`

Muestra una fuente de configuración en detalle: su huella actual y sus alertas pendientes.

`openlatch system inventory projects`

Enumera las carpetas de proyecto que el cliente conoce por los archivos de configuración que sigue.

`openlatch system inventory ack`

Confirma una alerta de configuración pendiente, para que el agente deje de recibir el recordatorio.

`openlatch update`

Busca una nueva versión del cliente. En una terminal, pregunta después si instalarla, y la instala si aceptas. Sin terminal (un script, una tubería, una herramienta de gestión), solo informa de la versión. --yes instala sin preguntar; --check solo comprueba.

Códigos de error

Cada código que el cliente puede mostrar, con lo que ha pasado y qué hacer.