Pulsar-Agent
Der Agent überträgt die Daten über eine verschlüsselte Verbindung zur Enginsight Cloud bzw. On-Premises-Installation. Dabei erfolgt die Verbindung ausschließlich einseitig, ausgehend vom Agent. Eine direkte Kommunikation von der Plattform zum Agent ist ausgeschlossen.
Der Agent muss mit Root-Rechten laufen.
In diesem Abschnitt erfahren Sie, wie Sie unseren Pulsar-Agent auf Ihrem System installieren können.
Wie das geht, erklären wir auch in unserem Video: "Deine 5 ersten Schritte":
Um einen neuen Host hinzuzufügen, gehen Sie im Top-Menü auf den Reiter “Hosts”. Entweder installieren Sie einen "Server Host" oder einen "Client Host".
Beachten Sie, dass für Server und Clients unterschiedliche Lizenzen nötig sind.
Anschließend wählen Sie bitte Ihr Betriebssystem aus.
Klicken Sie auf das Bild, um es zu vergrößern
Geben Sie bitte den curl Befehl, den Sie nun sehen, in Ihr Terminal ein. Sie benötigen root Zugriff, um den Client zu installieren.
Klicken Sie auf das Bild, um es zu vergrößern
Sie werden nun aufgefordert unser End User License Agreement (EULA) zu akzeptieren. Dieses Dokument finden Sie hier. Mit dem Download unseres Agents erklären Sie sich mit den Geschäftsbedingungen aus dem EULA einverstanden.
Zum Schluss sollten Sie eine Meldung erhalten, dass der Pulsar-Agent erfolgreich installiert wurde.
Führen Sie das Installationsskript als root aus. Drücken Sie dazu: Windows-Taste + R und geben Sie “cmd” ein. Kopieren Sie sich den angegebenen Befehl und fügen Sie diesen im cmd ein und drücken Sie auf Enter.
Klicken Sie auf das Bild, um es zu vergrößern
Sie werden nun aufgefordert unser End User License Agreement (EULA) zu akzeptieren. Dieses Dokument finden Sie hier. Mit dem Download unseres Agents erklären Sie sich mit den Geschäftsbedingungen aus dem EULA einverstanden.
Zum Schluss sollten Sie eine Meldung erhalten, dass der Pulsar-Agent erfolgreich installiert wurde.
Das Enginsight nun korrekt mit Ihrem Gerät kommuniziert, erkennen Sie an folgendem Bildschirm innerhalb der Plattform:
Hier können Sie nun einen technischen und fachlichen Verantwortlichen bestimmen und Tags für den Host vergeben.
Sie können den Pulsar-Agent mit Hilfe eines Startskripts auf mehreren Rechnern einer Domäne ausrollen. Um die Installation per Gruppenrichtlinie einzurichten, erstellen Sie ein Skript, das bei jedem Systemstart überprüft, ob der Agent installiert ist, und falls nicht die Installation ausführt.
1. Kopieren Sie sich das automatische Installationsskript für Windows mit ihrem individuellen Identifier und AccessKey in die Zwischenablage. Verzichten Sie dabei auf die oberste Zeile
powershell:
Gehen Sie dazu in der Enginsight Plattform auf Hosts → Server Host erstellen bzw. Client Host erstellen, wählen das Betriebssystem "Windows Server 2008+, Windows 7+" und den Reiter "Automatische Installation".
2. Fügen Sie das kopierte Skript an der markierten Stelle in diese Vorlage ein:
If (Get-Service "Enginsight Pulsar" -ErrorAction SilentlyContinue) {
break
} Else {
# Fügen Sie unterhalb dieser Zeile den kopierten Installationsbefehl ein.
}
Erstellen Sie für Server- und Clientlizenzen jeweils ein eigenes Skript.
Ihr fertiges Skript mit Ihrem individuellen Identifier und AccessKey (bei On-Premises mit angepasster API) sieht folgendermaßen aus:
If (Get-Service "Enginsight Pulsar" -ErrorAction SilentlyContinue) {
break
} Else {
$dl='https://api.enginsight.com/v1/_/pulsar/latest/ngs-pulsar-amd64-setup.exe'
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
(New-Object System.Net.WebClient).DownloadFile($dl,"$env:TEMP\ngs-pulsar-setup.exe");
& "$env:TEMP\ngs-pulsar-setup.exe" `
-acceptEula=true -interactive=false -license server `
-accessKeyId xxxxxxxxxxxxxxxxxxxxxxxx `
-accessKeySecret xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx `
-api https://api.enginsight.com
}
3. Speichern Sie das fertige Skript als PowerShell-Skriptdatei mit der Endung
.ps1.4. Öffnen Sie den Gruppenrichtlinien-Editor:
gpedit.msc5. Navigieren Sie für die entsprechende Domäne zu Computerkonfiguration → Windows-Einstellungen → Skripts (Start/Herunterfahren) → Starten.
6. Klicken Sie im Reiter "Skripts" auf "Hinzufügen".
7. Geben Sie als Skriptname
powershell.exe ein.8. Für Skriptparameter nutzen Sie die folgende Vorlage:
-ExecutionPolicy Bypass -File "\\<netzwerkpfad>\Policies\{guid}\Machine\Scripts\Startup\Enginsight-Installations-Script.ps1"
Ersetzen Sie den
<netzwerkpfad> und die {guid} durch Ihre individuellen Parameter.Achten Sie darauf, dass der Speicherort des Skripts für alle Rechner in der Domäne zugänglich ist und alle Rechner die Berechtigung besitzen, das Skript auszuführen.
1. Starten Sie Ihr Master Image System.
2. Installieren Sie einen Pulsar-Agent über die Enginsight Plattform: Hosts → Client Host erstellen → Betriebssystem "Windows Server 2008+, Windows 7+" wählen → Skript ausführen (Windows-Taste + R + “cmd”).
3. Öffnen Sie die Konfigurationsdatei des Pulsar-Agent unter folgendem Pfad:
C:\Program Files\Enginsight\Pulsar\config.json
4. Entfernen Sie den
_id-Wert und passen Sie die Parameter "environment": "vdi" und "license": "client" an.Ihre Konfigurations-Datei sieht nun in etwa folgendermaßen aus:
{
"channel": "master",
"environment": "vdi",
"license": "client"
"host": {
"_id": ""
},
"api": {
"url": "https://api.enginsight.com",
"proxy": "",
"noProxy": "",
"accessKey": {
"id": "XXXXXXXXXXXXXXXXXXXXXXXXXX",
"secret": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
}
}
5. Speichern Sie die Konfigurationsdatei ab.
6. Löschen Sie den Host aus der Plattform.
7. Speichern Sie das Master Image ab.
Bei einem erstmaligen Start fügen sich die Benutzer der VDI automatisch als Host hinzu. Die Hosts sind nach den Accountnamen benannt.
Achten Sie darauf ausreichend Client-Lizenzen für alle überwachten virtuellen Desktops zu buchen.
Falls im Unternehmen ein Proxy zum Einsatz kommt, muss dieser angegeben werden. Während der interaktiven Installation wird Enginsight versuchen, den verwendeten Proxy zu erkennen und Sie fragen, ob dieser verwendet werden soll.
Alternativ kann der Proxy auch im Installationsskript direkt angegeben und optional URLs ausgeschlossen werden. Dazu die folgenden Parameter verwenden:
proxy: URL des Proxys, über den die Verbindungen geleitet werden sollenWindows Umgebungen: -proxy <scheme>://<host>:<port>
Linux Umgebungen: proxy=<scheme>://<host>:<port>
noProxy: URL(s), für die der Proxy nicht genutzt werden sollWindows Umgebungen: -noProxy "<scheme>://<host>:<port>,<scheme>://<host>:<port>"
Linux Umgebungen: noProxy="<scheme>://<host>:<port>,<scheme>://<host>:<port>"
Folgend zwei Beispiele für die interaktive Installation des Pulsar-Agent mit
proxy und optionalem noProxy Parameter.powershell
$dl='https://api.enginsight.com/v1/_/pulsar/latest/ngs-pulsar-amd64-setup.exe'
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
(New-Object System.Net.WebClient).DownloadFile($dl,"$env:TEMP\setup.exe");
& "$env:TEMP\setup.exe" `
-identifier jClWfzsPdJ9J3RZaIc2YVsmvKbxaR1JO -license server `
-accessKeyId **** `
-accessKeySecret **** `
-api https://api.enginsight.com `
-proxy http://1.1.1.1:8080 `
-noProxy "http://10.0.0.1:80,http://10.0.0.2:8080"
curl -sSL https://api.enginsight.com/v1/_/pulsar/setup.sh | sudo -E bash -s \
identifier=jClWfzsPdJ9J3RZaIc2YVsmvKbxaR1JO license=server \
accessKeyId=**** \
accessKeySecret=**** \
api=https://api.enginsight.com \
proxy=http://1.1.1.1:8080 \
noProxy="http://10.0.0.1:80,http://10.0.0.2:8080"
Für die automatische Installation muss der Proxy Parameter bei Bedarf dem Installationsskript mitgegeben werden. Ansonsten versucht Enginsight, den Proxy automatisch zu ermitteln.
powershell
$dl='https://api.enginsight.com/v1/_/pulsar/latest/ngs-pulsar-amd64-setup.exe'
(New-Object System.Net.WebClient).DownloadFile($dl,"$env:TEMP\setup.exe");
& "$env:TEMP\setup.exe" `
-acceptEula=true -interactive=false -license server `
-accessKeyId **** `
-accessKeySecret **** `
-api https://api.enginsight.com `
-proxy http://1.1.1.1:8080 `
-noProxy "http://10.0.0.1:80,http://10.0.0.2:8080"
curl -sSL https://api.enginsight.com/v1/_/pulsar/setup.sh | sudo -E bash -s \
acceptEula=true license=server \
accessKeyId=**** \
accessKeySecret=**** \
api=https://api.enginsight.com \
proxy=http://1.1.1.1:8080 \
noProxy="http://10.0.0.1:80,http://10.0.0.2:8080"
Möchten Sie nachträglich die Proxy Parameter des Pulsar-Agent ändern, können Sie dies über die config.json erledigen. Diese finden Sie hier:
Windows:
C:\Program Files\Enginsight\Pulsar\config.jsonLinux:
opt/enginsight/pulsarSie können gewünschte Tags gleich bei der Installation mitgeben. Fügen Sie dazu den Parameter
tags dem Installationsskript hinzu. Sie können Tags auch jederzeit über die Benutzeroberfläche hinzufügen und anpassen.Tags sind in der Enginsight-Plattform sehr wichtig und steigern die Effektivität enorm. Sie können mit Tags beispielsweise Alarme gruppieren oder im Policy Manager Einstellungen für mehrere Hosts vornehmen.
Windows Umgebungen: -tags "ids,important"
Linux Umgebungen: tags="ids,important"
powershell
$dl='https://api.enginsight.com/v1/_/pulsar/latest/ngs-pulsar-amd64-setup.exe'
(New-Object System.Net.WebClient).DownloadFile($dl,"$env:TEMP\setup.exe");
& "$env:TEMP\setup.exe" `
-acceptEula=true -interactive=false -license server `
-accessKeyId **** `
-accessKeySecret **** `
-api https://api.enginsight.com `
-tags "ids,important"
curl -sSL https://api.enginsight.com/v1/_/pulsar/setup.sh | sudo -E bash -s \
acceptEula=true license=server \
accessKeyId=**** \
accessKeySecret=**** \
api=https://api.enginsight.com \
tags="ids,important"
Der Enginsight Pulsar-Agent wird von uns laufend aktualisiert. Damit alle (neuen) Funktionen wie gewünscht funktionieren, ist es nötig, dass Sie den Agent stets auf dem aktuellen Stand halten.
In der Host-Übersicht erhalten Sie eine Warnung, sollte der Pulsar-Agent nicht der aktuellen Version entsprechen.
Um den Agent zu aktualisieren haben Sie zwei Möglichkeiten:
- Sie können den Agent auf einem einzelnen Host aktualisieren. Klicken Sie dazu den Host an und klicken Sie auf "Agent aktualisieren".
- Wollen Sie den Agent auf allen Hosts gleichzeitig auf den aktuellen Stand bringen, klicken Sie in der Hostübersicht auf "Agents aktualisieren". Sie erhalten eine Auflistung, auf welchen Hosts nicht die neuste Version läuft. Klicken Sie auf "Aktualisieren", um die neuste Version des Agents auf allen Hosts auszurollen.
Falls Sie den Agent von einem Ihrer Hosts deinstallieren wollen, können Sie das ganz bequem innerhalb der Enginsight Plattform erledigen. Gehen Sie zunächst auf die Hostübersicht, indem Sie in der Navigationsbar auf Hosts drücken. Suchen Sie den gewünschten Host und klicken Sie erst auf die 3 Punkte innerhalb der Übersichtskachel und dann auf löschen.
Danach müssen Sie die Löschung nochmals bestätigen.
Beachten Sie, dass damit alle Daten des Hosts unwiederbringlich gelöscht werden.
Klicken Sie auf das Bild, um es zu vergrößern
Sollte die normale Deinstallation nicht möglich sein, können Sie den Agent auch manuell direkt auf dem Host deinstallieren.
1. Navigieren Sie in den Installationsordner des Pulsar-Agents.
C:\Program Files\Enginsight\Pulsar
Dort finden Sie das Powershell-Skript
uninstall.ps1.2. Führen Sie das Skript
uninstall.ps1 mit Administratorrechten auf dem Host aus, um den Pulsar-Agent manuell zu deinstallieren.3. Löschen Sie den Host über den gewöhnlichen Weg, um ihn aus der Enginsight Plattform zu entfernen.
Linux
1. Navigieren Sie in den Installationsordner des Pulsar-Agents.
cd /opt/enginsight/pulsar
2. Führen Sie die Bash-Skript
uninstall.sh auf dem Host aus aus.sudo ./uninstall.sh
Die Warnung
/sbin/init: Unbekannte Option »--version« ist irrelevant und kann daher ignoriert werden.3. Löschen Sie den Host über den gewöhnlichen Weg, um ihn aus der Enginsight Plattform zu entfernen.
Sie können die Ausführung von Plugins in der lokalen Konfigurationsdatei des Pulsar-Agents grundsätzlich deaktivieren, sodass Sie sich über die UI der Enginsight Applikation nicht mehr aktivieren lässt.
Seien Sie vorsichtig mit dieser Einstellung. Wir empfehlen ein solches Vorgehen nur in seltenen Ausnahmefällen.
- 1.Öffnen Sie die Konfigurationsdatei des Pulsar-Agents.
nano /opt/enginsight/pulsar/config.json
2. Fügen Sie die Überschreibung der Plugin-Konfiguration hinzu, sofern die Konfiguration noch nicht angelegt ist. (Ob die Funktion bereits vorhanden ist, hängt davon ab, wann Sie den Pulsar-Agent installiert haben.)
"override": {
"plugins": {
"disabled": true
}
}
Sollte die Override-Option bereits existieren, setzen Sie einfach den Parameter auf
true.Achten Sie darauf, dass Sie hinter die geschweiften Klammer, welche die API-Konfiguration umschließt, ein Komma hinzufügen. Sonst wird die Override-Konfiguration ignoriert.
3. Starten Sie den Pulsar-Agent neu.
service ngs-pulsar restart
- 1.Öffnen Sie die Konfigurationsdatei des Pulsar-Agents.
C:\Programme\Enginsight\Pulsar\config.json
2. Fügen Sie die Überschreibung der Plugin-Konfiguration hinzu, sofern die Konfiguration noch nicht angelegt ist. (Ob die Funktion bereits vorhanden ist, hängt davon ab, wann Sie den Pulsar-Agent installiert haben.)
"override": {
"plugins": {
"disabled": true
}
}
Sollte die Override-Option bereits existieren, setzen Sie einfach den Parameter auf
true.Achten Sie darauf, dass Sie hinter die geschweiften Klammer, welche die API-Konfiguration umschließt, ein Komma hinzufügen. Sonst wird die Override-Konfiguration ignoriert.
3. Starten Sie den Pulsar-Agent neu.
Windows-Taste + R → services.msc → Enginsight Pulsar → Rechtsklick → Alle Aufgaben → Neustart
Last modified 1yr ago