Exploiter

Utilisez cette page une fois les machines inscrites : pour garder le client à jour, travailler avec les enregistrements qu’il conserve sur chaque machine, et le désinstaller.

Mises à jour

Le client peut vérifier l’existence d’une nouvelle version et se mettre à jour. Le téléchargement est vérifié en intégrité avant que quoi que ce soit ne soit remplacé sur la machine : une empreinte SHA-512 est comparée à celle que le registre de paquets publie pour cette version, si bien qu’un téléchargement corrompu ou tronqué n’est jamais appliqué. Cette vérification détecte la corruption et la troncature ; elle ne protège pas contre un registre compromis. Laissez la mise à jour automatique active pour les installations qu’un développeur lance lui-même : elle garde la machine à jour sans que personne ne la planifie.

Un parc géré veut en général garder la main sur la version. Désactivez la mise à jour automatique et gardez la vérification active, pour qu’une machine continue de signaler qu’une version plus récente existe pendant qu’elle attend votre fenêtre de maintenance. Livrez ensuite la nouvelle version comme le client a été livré la première fois, par les outils qui gèrent déjà la machine.

Variable	Valeur
`OPENLATCH_AUTO_UPDATE`	`false` empêche le client de se mettre à jour lui-même. Définissez-la partout où vous voulez figer la version
`OPENLATCH_UPDATE_CHECK`	Laissez-la à `true`, pour que `openlatch status` signale toujours qu’une version plus récente existe

Enregistrements locaux

Le client conserve sa configuration et ses enregistrements locaux dans un seul répertoire : ~/.openlatch sur macOS et Linux, %APPDATA%\openlatch sur Windows. OPENLATCH_DIR le déplace. Un parc qui le déplace doit pointer ses propres scripts de collecte et de suppression vers la même valeur.

Les enregistrements sont écrits avec les identifiants masqués, et les chemins de fichiers sont masqués de la même façon. Traitement des données et sécurité liste ce qui est capturé, ce qui est masqué et combien de temps chaque type est conservé. Les enregistrements qui n’ont pas encore atteint la console restent dans ce répertoire et sont envoyés quand la console redevient joignable. Cette réserve est bornée : au-delà de sa limite de taille, 100 Mo par défaut, les enregistrements non envoyés les plus anciens sont abandonnés et le journal du daemon consigne un avertissement OL-1204. Voir les réglages de l’outbox et du journal de secours dans Configuration.

Ouvrir une demande de support

Lancez d’abord openlatch doctor sur la machine concernée. Il décrit ce qu’il trouve en termes simples. Constituez ensuite l’archive expurgée avec openlatch doctor --rescue : elle contient le diagnostic, la configuration et une fenêtre récente des enregistrements locaux. Envoyez cette archive, jamais le répertoire lui-même, avec le système d’exploitation et l’heure du problème avec son fuseau horaire.

Contactez votre référent technique OpenLatch par le canal convenu avec votre organisation. Envoyez les signalements de sécurité à security@openlatch.ai.

Désinstaller le client

Pour retirer le client d’une machine :

openlatch uninstall

Pour retirer le client et les enregistrements qu’il a conservés localement :

openlatch uninstall --purge

openlatch uninstall détache le client de chaque agent trouvé sur la machine et l’arrête. Chaque agent est laissé tel qu’il était avant l’installation, et les réglages qu’OpenLatch n’a pas écrits ne sont pas touchés. La configuration et les enregistrements locaux restent sur disque, sauf si vous demandez leur suppression.

--purge supprime aussi ce répertoire et l’identifiant conservé dans le magasin d’identifiants du système. Il refuse tout répertoire qui n’est pas celui du client, et il résout les liens symboliques avant de supprimer, pour qu’un lien ne puisse pas rediriger la suppression ailleurs. Un parc qui déplace le répertoire doit garder la même vérification dans son propre script de suppression.

Aucune des deux commandes ne supprime les fichiers du client lui-même. Ils ont été installés hors du répertoire d’état : une purge les laisse sur la machine, ainsi que la ligne PATH ajoutée par l’installation. Pour retirer complètement le client d’une machine, supprimez les deux fichiers placés par l’installation, openlatch et openlatch-hook dans ~/.local/bin sous macOS et Linux, ou openlatch.exe et openlatch-hook.exe dans %LOCALAPPDATA%\openlatch\bin sous Windows. Laissez le répertoire et tout ce qu’il contient d’autre : d’autres logiciels peuvent s’en servir. Sous Windows, le répertoire appartient au client : vous pouvez aussi le supprimer, ainsi que l’entrée PATH ajoutée par l’installation ; sous macOS et Linux, gardez la ligne PATH si d’autres outils dépendent de ~/.local/bin. Il n’existe pas de script de désinstallation : un parc qui veut que ce soit fait pour lui le fait par les outils qui ont installé le client.

La suppression se fait machine par machine. Rien n’est à défaire dans la console pour une machine désinstallée, et une machine qui revient est installée de la même façon que la première fois.

En bref

Laissez la mise à jour automatique active pour les installations des développeurs. Figez-la avec OPENLATCH_AUTO_UPDATE=false sur un parc géré, et gardez la vérification active pour qu’une machine signale toujours ce qui lui manque.
Une nouvelle version prend effet au redémarrage du client : terminez la fenêtre de maintenance par openlatch restart ou par une déconnexion et une reconnexion.
Configuration et enregistrements locaux se trouvent dans un seul répertoire. Une demande de support s’ouvre avec l’archive expurgée produite par openlatch doctor --rescue.
openlatch uninstall laisse chaque agent tel qu’il était. --purge supprime aussi le répertoire et l’identifiant conservé, et laisse les deux fichiers installés, qu’une suppression complète retire à part.