# Wie kann ich den Enginsight Pulsar manuell auf mehreren Windows-VMs gleichzeitig ausrollen?

Es ist möglich, den Enginsight Agenten Pulsar **manuell** auf mehreren virtuellen Maschinen (VM) mit Windows-Betriebssystem basierend auf einem Master-Image gleichzeitig auszurollen.

Die nachfolgend beschriebenen Schritte gelten für *persistente* virtuelle Umgebungen, in denen bspw. ein Benutzer eine dedizierte VM verwendet.

***

{% stepper %}
{% step %}

### Pulsar auf einem Master-Host installieren

1. Starte das Windows-System, von dem ein Master-Image mit vorbereitetem Pulsar erstellt werden soll.
2. Navigiere zur Enginsight Plattform und folge den [Installationsanweisungen zum Pulsar](https://docs.enginsight.com/docs/manual/installation-und-konfiguration/installation-und-konfiguration/enginsight-komponenten/pulsar) für die **automatische Installation** *auf* *Windows-Clients* wie im Enginsight Handbuch beschrieben.
3. Speichere dir dabei das Installationsskript aus Schritt 4 der Pulsar-Installationsanleitung ab, da du es später wieder benötigst.
   {% endstep %}

{% step %}

### Pulsar-Dienste stoppen und Starttyp anpassen

1. Stoppe nach erfolgreicher Installation die Pulsar-Dienste **Enginsight Pulsar** und **Enginsight Supervisor** in einer Administrator-PowerShell mit folgenden Befehlen:

```
Stop-Service "Enginsight Pulsar"
Stop-Service "Enginsight Supervisor"
```

2. Stelle den Starttyp der Pulsar-Dienste mit folgenden Befehlen auf manuell um, damit sie beim Erstellen des Images nicht automatisch starten:

```
Set-Service -Name "Enginsight Pulsar" -StartupType Manual
Set-Service -Name "Enginsight Supervisor" -StartupType Manual
```

{% endstep %}

{% step %}

### Master-Host in der Plattform löschen

Navigiere in der Enginsight Plattform zu **Hosts** → **Übersicht** und lösche den bei der Installation des Pulsars automatisch angelegten Windows-Client für das Master-Image.&#x20;

{% hint style="warning" %}
**Bitte beachte**: Das Löschen von Hosts aus der Host-Übersicht hat *nicht* die direkte Deinstallation des zugehörigen Pulsars zur Folge.
{% endhint %}
{% endstep %}

{% step %}

### Master-Image speichern

Speichere das Master-Image mit vorbereitetem Pulsar ab.
{% endstep %}

{% step %}

### Pulsar-Konfiguration für jede VM erstellen

Auf dem Master-Image kannst du nun für jede benötigte VM eine eigene Pulsar-Konfigurationsdatei erstellen. Nimm dazu folgende Schritte vor:

1. Navigiere zu dem Verzeichnis, in dem die Konfigurationsdatei `config.json` des Pulsars liegt:

```
C:\Program Files\Enginsight\Pulsar\
```

2. Lege für jede VM eine eigene Pulsar-Konfigurationsdatei an. Benenne dafür jeweils die bestehende Konfigurationsdatei um. Die Benennung sollte idealerweise so erfolgen, dass du die erzeugten Konfigurationsdateien später eindeutig den entsprechenden Host-VMs zuordnen kannst.
3. Erzeuge dann jeweils mittels folgendem Aufruf über die Windows-Konsole oder PowerShell eine neue Konfigurationsdatei:

```
ngs-pulsar-amd64.exe -install=true -accessKeyId <AccessKeyID> -accessKeySecret <AccessKeySecret> -api <URL_API> -license client -proxy <OptionalerProxyParameter> -noProxy <OptionalerNoProxyParameter> -tags <OptionaleTags>
```

{% hint style="info" %}
Vergiss dabei nicht, die folgenden Parameter in `<>` mit den Werten aus dem in [Schritt 1.3](#pulsar-auf-einem-master-host-installieren) gespeicherten Installationsskript zu ersetzen:

* `<AccessKeyID>`
* `<AccessKeySecret>`&#x20;
* `<URL_API>`

Die Parameter `<OptionalerProxyParameter>` und `<OptionalerNoProxyParameter>` sind nur notwendig, wenn du den [Pulsar mit Proxy installiert](https://docs.enginsight.com/docs/manual/installation-und-konfiguration/installation-und-konfiguration/enginsight-komponenten/pulsar#pulsar-mit-proxy-installieren) hast.

Der Parameter `<OptionaleTags>` ist nur notwendig, wenn du dem [Pulsar bei der Installation Tags mitgeben](/docs/knowledge-base/pulsar/wie-gebe-ich-dem-enginsight-pulsar-bereits-bei-der-installation-tags-mit.md) möchtest.
{% endhint %}

Mit jedem dieser Aufrufe wird ein neuer Host in der Plattform angelegt und die entsprechende Konfigurationsdatei im Programmverzeichnis `C:\Program Files\Enginsight\Pulsar\` gespeichert.

Du hast ebenso die Möglichkeit, diesen Prozess durch die Erstellung eines Skripts zu automatisieren.

{% hint style="success" icon="lightbulb" %}
Mehr Informationen, wie du den Pulsar automatisch auf mehreren Systemen per Skript ausrollen kannst, findest du in der Knowledge Base: [Wie kann ich den Enginsight Pulsar automatisch auf mehreren Windows-Systemen gleichzeitig ausrollen?](/docs/knowledge-base/pulsar/wie-kann-ich-den-enginsight-pulsar-automatisch-auf-mehreren-windows-systemen-gleichzeitig-ausrollen.md)
{% endhint %}
{% endstep %}

{% step %}

### Erzeugte Konfigurationsdateien auf die Host-VMs verteilen

Nun müssen die neu erzeugten Pulsar-Konfigurationsdateien auf die entsprechenden Host-VMs verteilt werden.

Dies ist abhängig von deinem Setup und kann auf unterschiedliche Weise durchgeführt werden (z.B. mittels eines FTP-Servers oder manuell).

Prüfe, welche Verteilungsmöglichkeit sich für dein Setup am besten eignet.
{% endstep %}

{% step %}

### Auf jeder VM Pulsar-Dienste starten und Starttyp anpassen

Nun müssen auf jeder VM, auf der ein Pulsar installiert wurde, die Pulsar-Dienste wieder gestartet und der Starttyp auf automatisch umgestellt werden:

1. Starte die Pulsar-Dienste **Enginsight Pulsar** und **Enginsight Supervisor** mit folgenden Befehlen wieder:

```
Start-Service "Enginsight Pulsar"
Start-Service "Enginsight Supervisor"
```

2. Stelle den Starttyp der Pulsar-Dienste mit folgenden Befehlen wieder auf automatisch um:

```
Set-Service -Name "Enginsight Pulsar" -StartupType Automatic
Set-Service -Name "Enginsight Supervisor" -StartupType Automatic
```

{% endstep %}
{% endstepper %}

***

## Weitere Ressourcen

* [Wie kann ich den Enginsight Pulsar automatisch auf mehreren Windows-Systemen gleichzeitig ausrollen?](/docs/knowledge-base/pulsar/wie-kann-ich-den-enginsight-pulsar-automatisch-auf-mehreren-windows-systemen-gleichzeitig-ausrollen.md)
* [Wie kann ich den Enginsight Pulsar automatisiert in flüchtigen Windows-VDI-Umgebungen ausrollen?](/docs/knowledge-base/pulsar/wie-kann-ich-den-enginsight-pulsar-automatisiert-in-fluchtigen-windows-vdi-umgebungen-ausrollen.md)
* [Wie kann ich den Enginsight Pulsar per Windows-Gruppenrichtlinie ausrollen?](/docs/knowledge-base/pulsar/wie-kann-ich-den-enginsight-pulsar-per-windows-gruppenrichtlinie-ausrollen.md)


---

# 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/knowledge-base/pulsar/wie-kann-ich-den-enginsight-pulsar-manuell-auf-mehreren-windows-vms-gleichzeitig-ausrollen.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.
