Référence de la CLI

Toutes les commandes et sous-commandes du client OpenLatch.

`openlatch init`

openlatch setup

Installe les hooks des agents trouvés sur cette machine, démarre le daemon et vérifie qu’il répond. Peut être relancée sans risque : elle libère d’abord les ports du client, puis confirme que le daemon qu’elle a démarré est bien celui qui répond.

`openlatch status`

Affiche l’état du daemon, sa durée de fonctionnement et le nombre d’événements, l’état de chaque partie du client et la ligne de licence : son état, les hôtes, l’usage raisonnable et la fin du contrat.

`openlatch start`

Démarre le daemon. Refuse avec OL-1501 quand un daemon tourne déjà sur cette machine.

`openlatch stop`

Arrête le daemon. Retire aussi la liaison des agents au relais de modèle, et le signale.

`openlatch restart`

Arrête le daemon et le redémarre, par exemple pour appliquer un changement de configuration.

`openlatch logs`

Affiche le journal des événements du client.

`openlatch doctor`

Diagnostique la configuration et la connectivité du client, et donne la cause et la solution de chaque problème trouvé. --fix applique les réparations possibles, --restore les annule, et --rescue écrit un fichier de diagnostic pour le support.

`openlatch uninstall`

Retire les hooks des agents et arrête le daemon. --agent la limite aux agents que vous nommez.

`openlatch docs`

Ouvre la documentation dans votre navigateur.

`openlatch system`

Regroupe les commandes qui inspectent ou pilotent une partie du client : aip, auth, hooks, model-relay, proxy, supervision, telemetry et inventory. Chaque solution que donne openlatch doctor nomme la commande system exacte à exécuter.

`openlatch system aip`

Récupère et inspecte le bundle de politiques présent sur cette machine, qui contient les règles de l’Autonomy Zone appliquées par le client.

`openlatch system aip refresh`

openlatch system aip update

Fait récupérer le bundle de politiques par le daemon en cours, tout de suite, et attend le résultat jusqu’à 15 secondes : modifié, inchangé, en attente, refusé ou hors ligne, avec les caractéristiques du bundle en service. Un résultat en attente sort avec le code 7 ; un refus ou un daemon hors ligne sort avec le code 1.

`openlatch system auth`

Regroupe les commandes qui connectent le client à la plateforme.

`openlatch system auth login`

Connecte le client à la plateforme via votre navigateur et enregistre l’identifiant dans le trousseau du système d’exploitation.

`openlatch system auth logout`

Déconnecte le client et supprime l’identifiant enregistré.

`openlatch system auth status`

Indique si le client est connecté, et d’où vient son identifiant.

`openlatch system auth switch`

Déplace cette machine vers une autre de vos organisations.

`openlatch system hooks`

Regroupe les commandes qui gèrent les hooks des agents. system hooks install équivaut à openlatch init.

`openlatch system hooks install`

Installe les hooks des agents ; équivaut à openlatch init.

`openlatch system hooks uninstall`

Retire les hooks des agents ; équivaut à openlatch uninstall.

`openlatch system hooks status`

Affiche en détail les hooks installés pour chaque agent.

`openlatch system model-relay`

Regroupe les commandes qui inspectent ou basculent le relais de modèle, l’écouteur local qui enregistre les appels de modèle de chaque agent.

`openlatch system model-relay status`

Indique si le relais de modèle fonctionne, son port, et si les appels de modèle de chaque agent passent par lui. Un agent dont les hooks fonctionnent mais dont les appels de modèle ne sont pas enregistrés apparaît comme appliqué, mais non mesuré.

`openlatch system model-relay enable`

Active le relais de modèle dans la configuration, puis propose de redémarrer le daemon pour l’appliquer.

`openlatch system model-relay disable`

Désactive le relais de modèle dans la configuration, puis propose de redémarrer le daemon pour l’appliquer.

`openlatch system model-relay explain`

Affiche un enregistrement du relais de modèle par son identifiant, lu depuis le stockage local. Son contenu ne quitte jamais la machine.

`openlatch system proxy`

Regroupe les commandes qui inspectent, découvrent, définissent ou testent le proxy emprunté par chaque requête sortante.

`openlatch system proxy status`

Affiche la route empruntée par les requêtes sortantes, pour la CLI et, si elle diffère, pour le daemon.

`openlatch system proxy discover`

Relance la découverte de proxy du système d’exploitation, teste chaque candidat et conserve celui qui fonctionne.

`openlatch system proxy set`

Définit le proxy à la main. Un proxy défini ainsi n’est jamais remplacé par la découverte ni par la réparation automatique.

`openlatch system proxy clear`

Supprime le proxy et son identifiant ; les requêtes vont alors directement à leur destination.

`openlatch system proxy test`

Teste la route étape par étape : la connexion au proxy, TLS, HTTP et une réponse en flux.

`openlatch system supervision`

Regroupe les commandes qui gèrent le superviseur du système d’exploitation (launchd, systemd ou le Planificateur de tâches) qui démarre le daemon à l’ouverture de session et le redémarre. Tout reste au niveau de l’utilisateur.

`openlatch system supervision install`

Installe le superviseur du système d’exploitation, pour que le daemon démarre à l’ouverture de session et après un redémarrage.

`openlatch system supervision uninstall`

Retire le superviseur du système d’exploitation. Le daemon continue de tourner mais ne démarre plus seul.

`openlatch system supervision status`

Indique si le superviseur est installé et en marche, et lequel ce système utilise.

`openlatch system supervision enable`

Réactive la supervision après disable, et réinstalle le superviseur.

`openlatch system supervision disable`

Retire le superviseur et enregistre que la supervision est désactivée sur cette machine.

`openlatch system telemetry`

Regroupe les commandes qui gèrent la télémétrie d’usage, que vous pouvez désactiver.

`openlatch system telemetry status`

Indique si la télémétrie d’usage est activée, quel réglage en décide, et si cette version l’inclut.

`openlatch system telemetry enable`

Active la télémétrie d’usage.

`openlatch system telemetry disable`

Désactive la télémétrie d’usage.

`openlatch system telemetry purge`

Désactive la télémétrie d’usage et vide la file des événements non envoyés d’un daemon en cours.

`openlatch system telemetry debug`

Montre comment exécuter n’importe quelle commande pour qu’elle affiche les événements de télémétrie qu’elle enverrait.

`openlatch system inventory`

Regroupe les commandes qui inspectent le plan de configuration : les sources de configuration des agents que suit le client, leurs événements de changement, les nouvelles analyses et l’état de l’observateur.

`openlatch system inventory list`

Liste les sources de configuration que suit le client, d’après le journal d’audit local.

`openlatch system inventory log`

Affiche les événements de changement de configuration du journal d’audit local.

`openlatch system inventory rescan`

Analyse à nouveau, tout de suite, chaque source de configuration suivie.

`openlatch system inventory status`

Indique l’état de l’observateur de configuration : s’il est activé, si sa liste de sources est chargée et combien de sources il contient.

`openlatch system inventory inspect`

Affiche une source de configuration en détail : son empreinte actuelle et ses alertes en attente.

`openlatch system inventory projects`

Liste les dossiers de projet que le client connaît d’après les fichiers de configuration qu’il suit.

`openlatch system inventory ack`

Accuse réception d’une alerte de configuration en attente, pour que l’agent ne la voie plus rappelée.

`openlatch update`

Recherche une nouvelle version du client. Dans un terminal, elle demande ensuite s’il faut l’installer, et l’installe si vous acceptez. Sans terminal (un script, un pipe, un outil de gestion), elle se contente de signaler la version. --yes installe sans demander ; --check ne fait que vérifier.

Codes d’erreur

Chaque code que le client peut afficher, avec ce qui s’est passé et ce qu’il faut faire.