# Pulsar

Für die Aktualisierung des Enginsight Agenten Pulsar hast du zwei Möglichkeiten: eine [automatische Aktualisierung](#automatische-aktualisierung) über die Benutzeroberfläche oder eine [manuelle Aktualisierung](#manuelle-aktualisierung).

***

## Automatische Aktualisierung

<i class="fa-compass">:compass:</i> Navigiere zu **Hosts** → **Übersicht**, um eine Auflistung aller angelegten Hosts anzuzeigen.&#x20;

Wenn für einen Host ein Pulsar-Update verfügbar ist, wird dir dies unterhalb des Host-Namens angezeigt:

<div align="left"><figure><img src="/files/QvCbhypRCh7XNtURJxky" alt=""><figcaption></figcaption></figure></div>

Du hast zwei Möglichkeiten, um Pulsare aus der Enginsight Plattform heraus zu aktualisieren:

* <i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf einen Host, für den ein Pulsar-Update angezeigt wird, um in die entsprechenden Host-Details zu navigieren. Klicke anschließend auf <i class="fa-clock-rotate-left">:clock-rotate-left:</i> **Agent aktualisieren** in der rechten oberen Ecke der Ansicht.
* <i class="fa-computer-mouse">:computer-mouse:</i> Klicke in der Host-Übersicht auf <i class="fa-clock-rotate-left">:clock-rotate-left:</i> **Agenten aktualisieren** in der rechten oberen Ecke, um alle Pulsare zu aktualisieren, für die ein Update vorliegt.

Es öffnet sich ein neues Fenster, in dem du weitere Einstellungen vornehmen kannst. Zudem wird dir die Anzahl der betroffenen Hosts sowie die aktuelle Version des Pulsars angezeigt.

<div align="left"><figure><img src="/files/5YHAfUiDWIhYJQejrPBp" alt=""><figcaption></figcaption></figure></div>

Es stehen folgende Optionen zur Verfügung:

<table><thead><tr><th width="232.25390625">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Tags</td><td><p>Nutze Host-Tags, um ausschließlich diejenigen Pulsare zu aktualisieren, die auf Hosts mit den entsprechenden Tags installiert sind.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Der standardmäßig angegebene Tag ist <strong>Host</strong>.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke dazu in das Feld <strong>Tags</strong>, um eine Liste aller verfügbaren Host-Tags auszuklappen, und wähle einen oder mehrere Tags aus. Oder nutze die Freitexteingabe, um Tags in der Liste schneller zu finden.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das <strong>Entfernen</strong>-Symbol <i class="fa-circle-xmark">:circle-xmark:</i> neben einem Tag, um ihn aus dem Feld zu entfernen.</p></td></tr><tr><td>Inaktive Hosts aktualisieren</td><td><p>Aktiviere diese Option, um die Aktualisierung inaktiver Hosts vorzunehmen, sobald diese wieder aktiv werden.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Diese Option ist standardmäßig aktiviert.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Setze einen Haken in die Checkbox <i class="fa-square">:square:</i> neben <strong>Inaktive Hosts aktualisieren</strong>, um die Option zu aktivieren. Entferne den Haken aus der Checkbox <i class="fa-square-check">:square-check:</i>, um die Option zu deaktivieren.</p></td></tr><tr><td>Zeitlich verteilte Aktualisierungen</td><td><p>Aktiviere diese Option, um die ausstehende Aktualisierung aller Pulsare zeitlich versetzt durchzuführen und so Netzüberlastungen zu vermeiden.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Diese Option ist nicht standardmäßig aktiviert.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Setze einen Haken in die Checkbox <i class="fa-square">:square:</i> neben <strong>Zeitlich verteilte Aktualisierungen</strong>, um die Option zu aktivieren. Entferne den Haken aus der Checkbox <i class="fa-square-check">:square-check:</i>, um die Option zu deaktivieren.</p></td></tr></tbody></table>

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Agenten aktualisieren**, um das Update aller ausgewählten Pulsare durchzuführen.

***

## Manuelle Aktualisierung

Nimm folgende Schritte vor, um den Pulsar manuell zu aktualisieren:

{% stepper %}
{% step %}

### Pulsar-Update-Skript herunterladen

1. Logge dich auf dem Enginsight Applikationsserver ein.
2. Navigiere mit folgendem Befehl ins Enginsight Installationsverzeichnis:

```
cd /opt/enginsight/enterprise
```

3. Lade mit folgendem Befehl das aktuelle Pulsar-Update-Skript aus dem offiziellen Repository herunter:

```
sudo wget https://raw.githubusercontent.com/enginsight/enterprise/master/scripts/fixed/pulsar.sh
```

{% endstep %}

{% step %}

### Update-Skript ausführen

1. Erteile dem Update-Skript mit folgendem Befehl die nötigen Ausführungsrechte:

```
sudo chmod +x pulsar.sh
```

2. Führe das Update-Skript mit folgendem Befahl aus:

```
sudo ./pulsar.sh
```

{% endstep %}

{% step %}

### Anpassungen auf dem Applikationsserver übernehmen

Nun musst du das Setup-Skript für den Applikationsserver noch einmal ausführen, um deine Anpassungen zu übernehmen.

Führe dazu folgenden Befehl aus und bestätige alle Abfragen mit der **Enter**-Taste:

```
sudo ./setup.sh
```

{% endstep %}

{% step %}

### Docker-Konfigurationsdatei anpassen

1. Öffne mit folgendem Befehl die Docker-Konfigurationsdatei:

```
sudo nano docker-compose.yml
```

2. Navigiere zum Docker-Container `server-m2`.
3. Ergänze den Parameter `volumes` um folgende Zeile:

<pre><code>server-m2:
    ... 
    volumes:
<strong>    - "./pulsar:/opt/enginsight/server-m2/pulsar"
</strong></code></pre>

4. Speichere die Änderungen in der Konfigurationsdatei (Strg+o) und bestätige den Speicherprozess. Schließe die Datei (Strg+x).
   {% endstep %}

{% step %}

### Dienst neu starten

Starte den Docker-Dienst mit folgendem Befehl neu, um die Änderungen anzuwenden:

```
sudo docker-compose up -d server-m2
```

{% endstep %}

{% step %}

### Aktualisierungen überprüfen

Navigiere in der Enginsight Benutzeroberfläche zu **Hosts** → **Übersicht** und überprüfe, ob alle Hosts die neueste Version des Pulsars installiert haben.
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.enginsight.com/docs/manual/installation-und-konfiguration/updates/enginsight-komponenten/pulsar.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.