> For the complete documentation index, see [llms.txt](https://docs.enginsight.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enginsight.com/docs/manual/installation-und-konfiguration/installation-und-konfiguration/enginsight-komponenten/pulsar.md).

# Pulsar

Der Pulsar ist ein Agent, der auf einem Host (einem Server oder Client) installiert wird, um diesen von innen heraus im Detail überwachen und Netzwerkattacken erkennen und blockieren zu können.

Im Kontext des Enginsight SIEM kann der Pulsar zudem als Kollektor für Roh-Logs dienen, die dann an das SIEM weitergeleitet werden.

***

## Voraussetzungen

Damit die Installation des Pulsars funktioniert und er produktiv eingesetzt werden kann, beachte folgende Hinweise:

* Vor der Installation eines Pulsar-Agenten auf einem Host musst du sicherstellen, dass dessen [Betriebssystem unterstützt](/docs/manual/installation-und-konfiguration/systemanforderungen/pulsar.md#unterstutzte-betriebssysteme-pulsar) wird.
* Der Host, auf dem der Pulsar installiert ist, muss mit dem **Enginsight Updateserver** und dem **Applikationsserver** kommunizieren können. Überprüfe gegebenenfalls deine Firewall-Einstellungen.

***

## Wichtige Hinweise

* Die Installation des Pulsar-Agenten unterscheidet sich je nachdem, ob in deinem Unternehmen ein **Proxy zum Einsatz kommt oder nicht**:
  * [Pulsar ohne Proxy installieren](#pulsar-ohne-proxy-installieren)
  * [Pulsar mit Proxy installieren](#pulsar-mit-proxy-installieren)
* Der Pulsar **unterstützt keine automatische Proxy-Erkennung** über das Web Proxy Auto-Discovery Protocol (WPAD) oder vergleichbare Einstellungen. Der Proxy kann **ausschließlich statisch** konfiguriert werden und wird damit **immer** für Verbindungsanfragen (z.B. durch den Enginsight Agenten Pulsar oder andere Komponenten) verwendet, **auch wenn er nicht erreichbar ist**. Es gibt in einem solchen Fall kein Fallback auf eine Direktverbindung zu Enginsight. 
* Das Log des Pulsars (**ngs-pulsar.log**) wird je nach Betriebssystem des Hosts an unterschiedlichen Stellen gespeichert. Bei jedem Start des Pulsars wird das Log auf die **letzten 2 MB** an Log-Daten gekürzt.

{% hint style="success" icon="lightbulb" %}
Mehr Informationen, wo die Logs des Pulsars zu finden sind, findest du in unserer Knowledge Base: [Wo finde ich welche Enginsight Logs?](https://docs.enginsight.com/docs/knowledge-base/logging/wo-finde-ich-welche-enginsight-logs)
{% endhint %}

***

## Pulsar ohne Proxy installieren

Nimm folgende Schritte vor, um den Enginsight Pulsar auf einem Host zu installieren, wenn in deinem Unternehmen kein Proxy zum Einsatz kommt:

{% stepper %}
{% step %}

### Host-Übersicht öffnen

Navigiere in der Enginsight Plattform zu **Hosts** → **Übersicht**, um eine Übersicht aller Hosts anzuzeigen, auf denen bereits ein Pulsar installiert wurde.\
Wenn du noch keinen Host angelegt hast, ist diese Ansicht leer.

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <i class="fa-plus">:plus:</i> **Host erstellen** in der rechten oberen Ecke, um einen Host anzulegen und einen Pulsar zu installieren.
{% endstep %}

{% step %}

### Host-Typ auswählen

Wähle aus, ob es sich bei deinem Host um einen Server oder Client handelt.

{% hint style="info" %}
Diese Auswahl hat auf die Installation selbst keine Auswirkungen, wird jedoch relevant, wenn du Alarme für spezifische Host-Typen erstellen möchtest.
{% endhint %}

<div align="left"><figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FgPxp3zDePtN5dsxaSlmK%2FEnginsight-Installation-Pulsar-1.jpg?alt=media&amp;token=b371433a-65b8-45ec-972b-c2e124a5ac9d" alt="" width="380"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Betriebssystem und Installationsart auswählen

Wähle nun das Betriebssystem deines Hosts aus und welche Art der Installation du durchführen möchtest.

<div align="left"><figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2F750ZRioabICGxivPDp6m%2FEnginsight-Installation-Pulsar-2.jpg?alt=media&amp;token=30a32387-a065-4936-b3ba-580165ce7976" alt="" width="440"><figcaption></figcaption></figure></div>

Es stehen folgende Installationsarten zur Verfügung:

* **Automatische Installation**: Das von uns zur Verfügung gestellte Installationsskript wird ohne weitere Abfragen ausgeführt und die Installation abgeschlossen.

{% hint style="danger" %}
**Bitte beachte**: Mit der Ausführung der automatischen Installation bestätigst du, dass du die Endnutzer-Lizenzvereinbarung (End-User License Agreement; EULA) gelesen hast und ihr zustimmst.
{% endhint %}

* **Manuelle Installation (interaktiv)**: Das von uns zur Verfügung gestellte Installationsskript wird mit interaktiven Abfragen, z.B. zur Verwendung eines Proxy und zur Kenntnisnahme der Endnutzer-Lizenzvereinbarung (End-User License Agreement; EULA), ausgeführt, um die Installation abzuschließen.

{% hint style="info" %}
Im Folgenden beschreiben wir die **Automatische Installation**.
{% endhint %}
{% endstep %}

{% step %}

### Installationsskript ausführen

Das Installationsskript selbst und wie du es ausführst unterscheidet sich je nachdem, ob du den Pulsar auf einem Linux-Host oder einem Windows-Host installieren möchtest.

<div align="left"><figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FyakbgBXCmBWsnOHwllCs%2FEnginsight-Installation-Pulsar-3.jpg?alt=media&amp;token=0aab5e1f-8ac5-47cc-aa7b-ea5721c7c60b" alt="" width="456"><figcaption></figcaption></figure></div>

#### Installation auf Linux

1. Rufe das **Terminal** auf deinem Linux-System auf.
2. Für die Ausführung des Skripts benötigst du *root*-Rechte. Melde dich dazu einmalig auf deinem Linux-System mit folgendem Befehl als Superuser an:

```
su - root 
```

3. Kopiere das Skript, das dir in der Enginsight Plattform angezeigt wird, per Klick auf **In die Zwischenablage kopieren**.
4. Füge das Skript im Terminal ein und bestätige deine Eingabe mit der **Enter**-Taste.
5. Navigiere zurück zur Enginsight Plattform.

#### Installation auf Windows

1. Rufe die **Eingabeaufforderung** (CMD) auf deinem Windows-System auf, indem du die **Windows**-Taste + **R** drückst und *cmd* eintippst.
2. Für die Ausführung des Skripts benötigst du Administratorrechte. Mache dazu einen Rechtsklick auf **Eingabeaufforderung** und wähle **Als Administrator öffnen** aus.
3. Kopiere das Skript, das dir in der Enginsight Plattform angezeigt wird, per Klick auf **In die Zwischenablage kopieren**.
4. Füge das Skript im CMD ein und bestätige deine Eingabe mit der **Enter**-Taste.
5. Navigiere zurück zur Enginsight Plattform.
   {% endstep %}
   {% endstepper %}

***

## Pulsar mit Proxy installieren

Wenn in deinem Unternehmen ein Proxy eingesetzt wird, muss dieser bei der Installation des Pulsars mit angegeben werden.

{% hint style="danger" %}
**Bitte beachte**: Der Pulsar **unterstützt keine automatische Proxy-Erkennung** über das Web Proxy Auto-Discovery Protocol (WPAD) oder vergleichbare Einstellungen. Der Proxy kann **ausschließlich statisch** konfiguriert werden und wird damit **immer** für Verbindungsanfragen (z.B. durch den Enginsight Agenten Pulsar oder andere Komponenten) verwendet, **auch wenn er nicht erreichbar ist**. Es gibt in einem solchen Fall kein Fallback auf eine Direktverbindung zu Enginsight.&#x20;
{% endhint %}

{% hint style="success" icon="lightbulb" %}
Mehr Informationen, welche Konfigurationsanpassungen du vornehmen musst, um den Proxy in Enginsight zu hinterlegen, findest du in unserer Knowledge Base: [Welche Konfigurationsanpassungen muss ich in Enginsight vornehmen, wenn ich einen Proxy verwende?](https://docs.enginsight.com/docs/knowledge-base/konfiguration/welche-konfigurationsanpassungen-muss-ich-in-enginsight-vornehmen-wenn-ich-einen-proxy-verwende)&#x20;
{% endhint %}

Nimm folgende Schritte vor, um den Enginsight Pulsar auf einem Host zu installieren, wenn in deinem Unternehmen ein Proxy zum Einsatz kommt:

{% stepper %}
{% step %}

### Host-Übersicht öffnen

Navigiere in der Enginsight Plattform zu **Hosts** → **Übersicht**, um eine Übersicht aller Hosts anzuzeigen, auf denen bereits ein Pulsar installiert wurde. Wenn du noch keinen Host angelegt hast, ist diese Ansicht leer.

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <i class="fa-plus">:plus:</i> **Host erstellen** in der rechten oberen Ecke, um einen Host anzulegen und einen Pulsar zu installieren.
{% endstep %}

{% step %}

### Host-Typ auswählen

Wähle aus, ob es sich bei deinem Host um einen Server oder Client handelt.

{% hint style="info" %}
Diese Auswahl hat auf die Installation selbst keine Auswirkungen, wird jedoch relevant, wenn du Alarme für spezifische Host-Typen erstellen möchtest.
{% endhint %}

<div align="left"><figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FgPxp3zDePtN5dsxaSlmK%2FEnginsight-Installation-Pulsar-1.jpg?alt=media&amp;token=b371433a-65b8-45ec-972b-c2e124a5ac9d" alt="" width="380"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Betriebssystem und Installationsart auswählen

Wähle nun das Betriebssystem deines Hosts aus und welche Art der Installation du durchführen möchtest.

<div align="left"><figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2F750ZRioabICGxivPDp6m%2FEnginsight-Installation-Pulsar-2.jpg?alt=media&amp;token=30a32387-a065-4936-b3ba-580165ce7976" alt="" width="440"><figcaption></figcaption></figure></div>

Es stehen folgende Installationsarten zur Verfügung:

* **Automatische Installation**: Das von uns zur Verfügung gestellte Installationsskript wird ohne weitere Abfragen ausgeführt und die Installation abgeschlossen.

{% hint style="danger" %}
**Bitte beachte**: Mit der Ausführung der automatischen Installation bestätigst du, dass du die Endnutzer-Lizenzvereinbarung (End-User License Agreement; EULA) gelesen hast und ihr zustimmst.
{% endhint %}

* **Manuelle Installation (interaktiv)**: Das von uns zur Verfügung gestellte Installationsskript wird mit interaktiven Abfragen, z.B. zur Verwendung des Proxy und zur Kenntnisnahme der Endnutzer-Lizenzvereinbarung (End-User License Agreement; EULA), ausgeführt, um die Installation abzuschließen.

{% hint style="info" %}
Im Folgenden beschreiben wir die **Automatische Installation**.
{% endhint %}
{% endstep %}

{% step %}

### Installationsskript ausführen

Sowohl bei einer automatischen, als auch bei einer manuellen, interaktiven Installation muss die URL des Proxy sowie optional URLs, die ohne Proxy aufgerufen werden sollen, dem Installationsskript mitgegeben werden.

Der Unterschied der automatischen zur manuellen Installation besteht darin, dass bei der Ausführung des Skripts die Verwendung des Proxy nicht noch einmal explizit abgefragt wird.

Das Installationsskript selbst und wie du es ausführst unterscheidet sich je nachdem, ob du den Pulsar auf einem Linux-Host oder einem Windows-Host installieren möchtest.

<div align="left"><figure><img src="https://1720942473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1oAJCT6yz8fThAzdCQJt%2Fuploads%2FyakbgBXCmBWsnOHwllCs%2FEnginsight-Installation-Pulsar-3.jpg?alt=media&amp;token=0aab5e1f-8ac5-47cc-aa7b-ea5721c7c60b" alt="" width="456"><figcaption></figcaption></figure></div>

#### Installation auf Linux

1. Rufe das **Terminal** auf deinem Linux-System auf.
2. Für die Ausführung des Skripts benötigst du *root*-Rechte. Melde dich dazu einmalig auf deinem Linux-System mit folgendem Befehl als Superuser an:

```
su - root 
```

3. Kopiere das Skript, das dir in der Enginsight Plattform angezeigt wird, per Klick auf **In die Zwischenablage kopieren**.
4. Füge das Skript im Terminal ein und ergänze es um folgende Parameter:

```
    proxy=http://<IPAdresseHost>:<Port>
    noProxy="http://<IPAdresseHost>:<Port>,http://<IPAdresseHost>:<Port>"
```

{% hint style="info" %}
Die Angabe des `noproxy`-Parameters ist optional. Vergiss nicht, die Platzhalter `<IPAdresseHost>` und `<Port>` entsprechend zu ersetzen.
{% endhint %}

5. Bestätige deine Eingabe mit der **Enter**-Taste, um das Installationsskript auszuführen.
6. Navigiere zurück zur Enginsight Plattform.

#### Installation auf Windows

1. Rufe die **Eingabeaufforderung** (CMD) auf deinem Windows-System auf, indem du die **Windows**-Taste + R drückst und *cmd* eintippst.
2. Für die Ausführung des Skripts benötigst du Administratorrechte. Mache dazu einen Rechtsklick auf **Eingabeaufforderung** und wähle **Als Administrator öffnen** aus.
3. Kopiere das Skript, das dir in der Enginsight Plattform angezeigt wird, per Klick auf **In die Zwischenablage kopieren**.
4. Füge das Skript im CMD ein und ergänze es um folgende Parameter:

```
    -proxy http://<IPAdresseHost>:<Port>
    -noProxy "http://<IPAdresseHost>:<Port>,http://<IPAdresseHost>:<Port>"
```

{% hint style="info" %}
Die Angabe des `noproxy`-Parameters ist optional. Vergiss nicht, die Platzhalter `<IPAdresseHost>` und `<Port>` entsprechend zu ersetzen.
{% endhint %}

5. Bestätige deine Eingabe mit der **Enter**-Taste, um das Installationsskript auszuführen.
6. Navigiere zurück zur Enginsight Plattform.
   {% endstep %}
   {% endstepper %}

### Proxy-Parameter nachträglich ändern

Wenn du die bei der Installation angegebenen Proxy-Parameter nachträglich ändern möchtest, kannst du dies über die Pulsar-Konfiguration tun.

Logge dich dazu auf dem entsprechenden Windows- oder Linux-Host ein und navigiere in folgendes Verzeichnis:

* **Windows**: `C:\Program Files\Enginsight\Pulsar\config.json`
* **Linux**: `/opt/enginsight/pulsar/config.json`

***

## Weitere Ressourcen

**Knowledge Base**

* [Wo finde ich welche Enginsight Logs?](https://docs.enginsight.com/docs/knowledge-base/logging/wo-finde-ich-welche-enginsight-logs)
* [Welche Konfigurationsanpassungen muss ich in Enginsight vornehmen, wenn ich einen Proxy verwende?](https://docs.enginsight.com/docs/knowledge-base/konfiguration/welche-konfigurationsanpassungen-muss-ich-in-enginsight-vornehmen-wenn-ich-einen-proxy-verwende)
* [Wie gebe ich dem Enginsight Pulsar bereits bei der Installation Tags mit?](https://docs.enginsight.com/docs/knowledge-base/pulsar/wie-gebe-ich-dem-enginsight-pulsar-bereits-bei-der-installation-tags-mit)
* [Wie installiere ich auf Windows-Systemen einen Enginsight Pulsar ohne PowerShell?](https://docs.enginsight.com/docs/knowledge-base/pulsar/wie-installiere-ich-auf-windows-systemen-einen-enginsight-pulsar-ohne-powershell)
* [Wie kann ich den Enginsight Pulsar per Windows-Gruppenrichtlinie ausrollen?](https://docs.enginsight.com/docs/knowledge-base/pulsar/wie-kann-ich-den-enginsight-pulsar-per-windows-gruppenrichtlinie-ausrollen)
* [Wie kann ich den Enginsight Pulsar automatisiert in flüchtigen Windows-VDI-Umgebungen ausrollen?](https://docs.enginsight.com/docs/knowledge-base/pulsar/wie-kann-ich-den-enginsight-pulsar-automatisiert-in-fluchtigen-windows-vdi-umgebungen-ausrollen)
* [Wie kann ich den Enginsight Pulsar manuell auf mehreren persistenten Windows-VMs ausrollen?](https://docs.enginsight.com/docs/knowledge-base/pulsar/wie-kann-ich-den-enginsight-pulsar-manuell-auf-mehreren-persistenten-windows-vms-ausrollen)
* [Wie kann ich den Enginsight Pulsar automatisch auf mehreren persistenten Windows-Systemen ausrollen?](https://docs.enginsight.com/docs/knowledge-base/pulsar/wie-kann-ich-den-enginsight-pulsar-automatisch-auf-mehreren-persistenten-windows-systemen-ausrollen)
* [Wie konfiguriere ich in Enginsight die gestaffelte Zwischenspeicherung von Pulsar-Daten?](https://docs.enginsight.com/docs/knowledge-base/pulsar/wie-konfiguriere-ich-in-enginsight-die-gestaffelte-zwischenspeicherung-von-pulsar-daten)
* [Ich habe mit Enginsight Probleme mit Sysmon auf Windows-Hosts. Was kann ich tun?](https://docs.enginsight.com/docs/knowledge-base/troubleshooting/ich-habe-mit-enginsight-probleme-mit-sysmon-auf-windows-hosts-was-kann-ich-tun)
* [Ich kann einen gelöschten Host nicht erneut in Enginsight installieren. Was kann ich tun?](https://docs.enginsight.com/docs/knowledge-base/troubleshooting/ich-kann-einen-geloschten-host-nicht-erneut-in-enginsight-installieren-was-kann-ich-tun)

***