Lywand-Agent installieren

Wie du den Lywand-Agent per Automatisierung auf deine Windows-Geräte verteilst, was die Aktion voraussetzt und wann der Schritt fehlschlägt.

Mit dieser Aktion stellst du sicher, dass der Lywand-Sicherheitsagent auf einem Windows-Gerät installiert ist. Fehlt er, installiert octoja ihn mit dem Lizenzschlüssel des Lywand-Partners, dem der Kunde des Geräts zugeordnet ist. Um Installer und Schlüssel musst du dich nicht kümmern. Das Gerät muss dafür online sein.

Voraussetzungen

lywand software ist unter Integrationen verbunden — siehe lywand software einrichten.
Der Kunde des Geräts ist unter Kunden zuordnen einem Lywand-Partner zugeordnet, und Lywand hat für diesen Partner einen Agent-Lizenzschlüssel. Eine fehlende Zuordnung ist die häufigste Ursache dafür, dass der Schritt fehlschlägt.
Das Gerät kann den Installer per HTTPS von agent.lywand.com herunterladen.

Konfigurationsfelder

Die Aktion hat keine eigenen Felder. Du stellst nur die allgemeinen Schritteinstellungen ein, etwa Bedingung, Bei Fehler und Wenn Gerät offline. Ist lywand software nicht verbunden, zeigt das Eigenschaften-Panel Lywand ist nicht verbunden. Zuerst unter Integrationen verbinden.

Plattformunterstützung

Plattform	Unterstützt
Windows	Ja
Linux	Nein
macOS	Nein

Ausgaben

Ausgabe	Beschreibung
`installed`	Installiert: `true`, wenn der Lywand-Agent nach dem Schritt auf dem Gerät vorhanden ist.
`action`	Aktion: `installed` nach einer Neuinstallation, `alreadyInstalled`, wenn der Agent schon da war, `none`, wenn die Installation auf dem Gerät fehlgeschlagen ist.

Mit action kannst du in der Bedingung eines späteren Schritts prüfen, ob tatsächlich installiert wurde — etwa, um nur dann mit Ticket erstellen ein Ticket anzulegen.

Scheitert der Schritt, bevor er das Gerät erreicht, etwa weil der Kunde nicht zugeordnet ist, gibt es keine Ausgaben. Die Meldungen des Installers siehst du im Ausführungsverlauf in der Standard- und Fehlerausgabe des Schritts.

Ergebnisverhalten

Integration, Kundenzuordnung und Lizenzschlüssel prüft octoja bei jedem Lauf, bevor der Schritt das Gerät erreicht. Diese Prüfungen können also auch dann fehlschlagen, wenn der Lywand-Agent schon installiert ist.

Situation	Ergebnis
Der Lywand-Agent ist bereits installiert	Erfolgreich, `action` = `alreadyInstalled`. Am Gerät ändert sich nichts.
Der Agent fehlt und die Installation klappt	Erfolgreich, `action` = `installed`. Das gilt auch, wenn der Installer einen Neustart verlangt.
Der Installer meldet einen Fehler	Fehlgeschlagen. Die Fehlerausgabe zeigt den Exit-Code und die letzten 40 Zeilen des Installer-Protokolls.
Der Installer ist fertig, aber der Agent fehlt trotzdem	Fehlgeschlagen.
Die Installation dauert länger als vier Minuten	Die Installation wird abgebrochen, der Schritt ist nicht erfolgreich.
Das Gerät ist kein Windows-Gerät	Fehlgeschlagen: Der Lywand-Agent unterstützt nur Windows-Geräte. Nimm Nicht-Windows-Geräte aus den Zielgeräten der Automatisierung.
lywand software ist nicht verbunden	Fehlgeschlagen: Die Lywand-Integration ist nicht verbunden.
Das Gerät hat keinen Kunden, oder der Kunde ist nicht zugeordnet	Fehlgeschlagen: Der Kunde des Geräts ist keinem Lywand-Kunden zugeordnet. Ordne den Kunden in der lywand software-Integration über Kunden zuordnen zu.
Lywand hat keinen Lizenzschlüssel für den zugeordneten Partner	Fehlgeschlagen: Für den zugeordneten Lywand-Kunden ist kein Agent-Lizenzschlüssel verfügbar. Prüfe die Lizenzierung dieses Kunden in Lywand.
Die Lywand-API ist nicht erreichbar	Fehlgeschlagen: Die Lywand-API war nicht erreichbar. Meist ist das vorübergehend – führe die Automatisierung einfach erneut aus. Bleibt der Fehler bestehen, prüfe den Servicestatus von Lywand.
Das Gerät ist beim Start des Schritts offline	Gerät offline. Je nach Wenn Gerät offline endet der Lauf mit diesem Status oder der Schritt wird übersprungen.

Ob der Agent installiert ist, erkennt octoja am Registry-Schlüssel HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Lywand. Einen Neustart löst der Schritt nie selbst aus.

Den Agent auf deine Windows-Geräte ausrollen

Lege unter Automatisierungen eine Automatisierung an oder öffne eine bestehende und füge die Aktion Lywand-Agent installieren hinzu.
Wähle den Auslöser: Mit Gerät hinzugefügt bekommt jedes neu registrierte Gerät den Agent. Mit Zeitplan erfasst du auch vorhandene Geräte.
Grenze die Zielgeräte auf die Windows-Geräte der Kunden ein, die einem Lywand-Partner zugeordnet sind.
Probiere die Automatisierung mit einem Testlauf an einem einzelnen Gerät aus, bevor du sie aktivierst.

Du kannst den Schritt gefahrlos wiederholen: Ist der Agent schon da, meldet octoja das nur und installiert nichts neu. Eine Automatisierung mit Zeitplan bringt den Agent so auch wieder auf Geräte, von denen er entfernt wurde.

Sobald der Agent Daten an Lywand liefert, zeigt octoja für das Gerät den Lywand-Score. Wann das so weit ist, beschreibt lywand software einrichten.

Siehe auch: Eine Automatisierung erstellen · lywand software einrichten

War dies hilfreich?

Brauchen Sie noch Hilfe? Team fragen