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.

Systemanforderungen

Der Agent muss mit Root-Rechten laufen.

Hier erhalten Sie eine Übersicht über die aktuell unterstützten Betriebssysteme.

Installation (einen neuen Host anlegen)

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.

Linux

Geben Sie bitte den curl Befehl, den Sie nun sehen, in Ihr Terminal ein. Sie benötigen root Zugriff, um den Client zu installieren.

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.

Windows

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.

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.

Pulsar-Agent per Windows Gruppenrichtlinie ausrollen

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.msc

5. 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.

Pulsar-Agent in VDI-Umgebungen installieren

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.

Proxy

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

proxy: URL des Proxys, über den die Verbindungen geleitet werden sollen

Windows Umgebungen: -proxy <scheme>://<host>:<port>
Linux Umgebungen: proxy=<scheme>://<host>:<port>

Noproxy

noProxy: URL(s), für die der Proxy nicht genutzt werden soll

Windows Umgebungen: -noProxy "<scheme>://<host>:<port>,<scheme>://<host>:<port>"
Linux Umgebungen: noProxy="<scheme>://<host>:<port>,<scheme>://<host>:<port>"

Beispiel: Interaktive Installation

Folgend zwei Beispiele für die interaktive Installation des Pulsar-Agent mit proxy und optionalem noProxy Parameter.

Windows

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"

Linux

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"

Beispiel: Automatische Installation

Für die automatische Installation muss der Proxy Parameter bei Bedarf dem Installationsskript mitgegeben werden. Ansonsten versucht Enginsight, den Proxy automatisch zu ermitteln.

Windows

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"

Linux

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"

Nachträgliche Änderung des Proxy Parameters

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.json

Linux: opt/enginsight/pulsar

Agent aktualisieren

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.

Deinstallation

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.

Manuelle Deinstallation

Sollte die normale Deinstallation nicht möglich sein, können Sie den Agent auch manuell direkt auf dem Host deinstallieren.

Windows

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.

Advanced Hardening

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.

Linux

Ö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

Windows

Öffnen Sie die Konfigurationsdatei des Pulsar-Agents.

C:\Programme\Enginsight\Pulsar\config.json

"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

PreviousHosts (Pulsar-Agent)NextHostdetails

Last updated 1 year ago