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

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

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

Die nachfolgend beschriebenen Schritte gelten für folgende Umgebungen:

* *Persistente* virtuelle Umgebungen (feste VMs mit dedizierten Hostnamen)

{% hint style="success" icon="lightbulb" %}
Mehr Informationen, wie du den Enginsight Pulsar *automatisiert* in persistenten (virtuellen) Windows-Umgebungen oder auf *flüchtigen* Windows-VDIs ausrollst, findest du in der Knowledge Base: [Wie kann ich den Enginsight Pulsar automatisch auf mehreren persistenten Windows-Systemen ausrollen?](/docs/knowledge-base/pulsar/wie-kann-ich-den-enginsight-pulsar-automatisch-auf-mehreren-persistenten-windows-systemen-ausrollen.md) und [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)
{% endhint %}

***

{% 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** über eine 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.&#x20;

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 unter **Hosts** → **Übersicht** angelegt und die entsprechende Konfigurationsdatei im Programmverzeichnis `C:\Program Files\Enginsight\Pulsar\` gespeichert.

{% hint style="danger" %}
**Bitte beachte**: Jeder Host, der auf diese Weise erstellt wird, verbraucht eine Asset-Lizenz aus deinem Lizenzpaket! Wenn du lizenzierte Assets wieder freigeben möchtest, musst du die entsprechenden Hosts aus der Host-Übersicht in der Enginsight Plattform löschen.&#x20;
{% endhint %}

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 Enginsight Pulsar *automatisch* auf mehreren persistenten Windows-Systemen per Skript ausrollen kannst, findest du in der Knowledge Base: [Wie kann ich den Enginsight Pulsar automatisch auf mehreren persistenten Windows-Systemen ausrollen?](/docs/knowledge-base/pulsar/wie-kann-ich-den-enginsight-pulsar-automatisch-auf-mehreren-persistenten-windows-systemen-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 persistenten Windows-Systemen ausrollen?](/docs/knowledge-base/pulsar/wie-kann-ich-den-enginsight-pulsar-automatisch-auf-mehreren-persistenten-windows-systemen-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)

***
