Installation

PVS Forge wird auf einem Citrix-Provisioning-Server Ihrer Farm installiert. Von dort verwaltet es Ihre Master Targets und PVS-Stores.

Download

Der aktuelle Installer ist immer unter download.pvs-forge.com/current verfügbar — der Link lädt PVSForge-Setup.exe herunter. Führen Sie ihn auf dem PVS-Server aus, um PVS Forge zu installieren oder zu aktualisieren.

Systemvoraussetzungen

Komponente	Voraussetzung
Host	Ein Citrix-Provisioning-Server (PVS Forge läuft auf dem Server, nicht auf einem Client)
Citrix Provisioning	Getestet mit 2402 LTSR, 2507 LTSR und 2603
PVS-PowerShell-Snap-in	Citrix.PVS.Snapin auf dem Host verfügbar (wird mit der PVS-Konsole installiert)
.NET (PVS-Server)	.NET 8 Desktop Runtime (x64) — der Installer bringt sie mit und installiert sie automatisch, falls nicht vorhanden
Master Targets	WinRM (Port 5985) aktiviert und vom PVS-Server erreichbar.
Imaging-Konto	Auf dem Master Target: benötigt das Benutzerrecht Anmelden als Stapelverarbeitungsauftrag (siehe Hinweis unten)
Store-Zugriff	vDisk-Store-Pfad vom PVS-Server erreichbar, mit schreibberechtigten Anmeldedaten
Sync-Ziele	SMB (Port 445) auf jedem PVS-Server erreichbar, auf den synchronisiert wird
Antivirus	vDisk-Store auf jedem PVS-Server vom Echtzeit-Scan ausgeschlossen (siehe Antivirus-Ausnahmen)

Gehärtete Master Targets brauchen das Recht Anmelden als Stapelverarbeitungsauftrag

PVS Forge registriert die Imaging-Aufgabe auf dem Master Target, ohne ein Passwort zu speichern — die Härtungsrichtlinie „Speicherung von Kennwörtern für die Netzwerkauthentifizierung nicht zulassen" ist voll kompatibel.

Die Imaging-Aufgabe läuft jedoch als Stapelverarbeitungs-Anmeldung (batch), daher muss das Imaging-Konto auf dem Master Target das Recht „Anmelden als Stapelverarbeitungsauftrag" besitzen. Entzieht oder verweigert eine Härtungsrichtlinie (z. B. Tier-Härtung) dieses Recht, kann die Imaging-Aufgabe nicht starten und das Imaging beginnt gar nicht. Erteilen Sie dem Imaging-Konto „Anmelden als Stapelverarbeitungsauftrag" und stellen Sie sicher, dass keine Richtlinie „Anmelden als Stapelverarbeitungsauftrag verweigern" es einschließt.

Antivirus-Ausnahmen

Nehmen Sie den vDisk-Store auf jedem PVS-Server vom Echtzeit-Virenschutz aus, bevor Sie mit dem Imaging beginnen — das ist Citrix-Provisioning-Best-Practice, und vorab eingerichtet vermeidet es sporadische „Datei in Verwendung"-Fehler, wenn PVS Forge eine frisch erstellte vDisk finalisiert.

Schließen Sie sowohl den Store-Speicherort als auch die vDisk-Dateitypen aus:

• den vollständigen Pfad jedes Stores und
• *.vhdx, *.avhdx, *.pvp

Ist der Echtzeitschutz aktiv und der Store nicht ausgeschlossen, weist PVS Forge Sie im Live-Log darauf hin.

Protokolle und Ports

PVS Forge (PVS1) steuert das Master Target (MT) und synchronisiert auf weitere PVS-Server (PVS2) über diese Verbindungen:

Der Kanal MT → PVS auf TCP 8745 ist TLS-gesichert und tauscht Informationen wie Live-Status, Cancel-Signal und weiteres aus (das Master Target prüft ein per-Job- Zertifikat). Die Store-Verbindung (SMB 445) dient nur dem Schreiben der VHDX und der Inventar-/Layout-Daten — es werden keine Steuer-/Status-Dateien ausgetauscht.

Die vollständige Aufschlüsselung — inklusive der je Verbindung verwendeten Anmeldedaten und des optionalen ICMP-Pings — finden Sie unter Einstellungen → Netzwerk-Ports.

Demo-Modus ohne PVS

Ist das Citrix-PVS-Snap-in nicht vorhanden (z. B. auf einem Notebook ohne PVS), startet PVS Forge in einem eingeschränkten Demo-Modus, in dem Sie die Oberfläche erkunden können. Imaging ist nur auf einem echten PVS-Server möglich.

Installation

Der Installer ist ein einzelner, gebrandeter Setup-Assistent (eine Setup.exe, keine separate MSI). Er läuft mit Administratorrechten und ist in Deutsch und Englisch verfügbar — er folgt der Anzeigesprache des Servers und lässt sich oben rechts umschalten.

Führen Sie den Installer auf Ihrem PVS-Server aus und folgen Sie dem Assistenten:

1. Willkommen — Überblick, was installiert wird (die PVS-Forge-Anwendung, der Imaging-Agent und die .NET 8 Desktop Runtime, falls noch nicht vorhanden).
2. Lizenzvereinbarung — lesen und akzeptieren Sie die EULA, um fortzufahren.
3. Installationsverzeichnis — bestätigen Sie das Zielverzeichnis (Standard C:\Program Files\Koetzing IT\PVSForge) und wählen Sie, ob eine Desktop-Verknüpfung angelegt wird.
4. Bereit zur Installation — prüfen Sie die Zusammenfassung. Hier können Sie optional Port 8745 in der Windows-Firewall öffnen ankreuzen (standardmäßig aus) — siehe Firewall.
5. Installation — die Anwendung, der Agent und bei Bedarf die .NET 8 Desktop Runtime werden installiert. Die Runtime ist eingebettet, eine Internetverbindung ist nicht erforderlich.
6. Lizenzschlüssel (optional) — geben Sie hier direkt Ihren Lizenzschlüssel ein oder überspringen Sie den Schritt und aktivieren Sie ihn später in der App — siehe Lizenz aktivieren.
7. Fertigstellen — optional PVS Forge gleich starten.

Beim ersten Start unterstützt Sie ein kurzer Einrichtungsassistent in der App bei der Grundkonfiguration.

Firewall (Port 8745)

Der Imaging-Feedback-Kanal nutzt eingehend TCP 8745 auf dem PVS-Server. Standardmäßig ändert der Installer die Firewall nicht — PVS Forge legt die Regel beim ersten Imaging-Lauf selbst an. Möchten Sie sie schon bei der Installation öffnen, kreuzen Sie im Schritt Bereit zur Installation Port 8745 in der Windows-Firewall öffnen an; der Installer legt dann die eingehende Regel „PVSForge Exchange" für TCP 8745 an.

Upgrade

Für ein Upgrade führen Sie einfach den neuen Installer auf einem Server aus, auf dem PVS Forge bereits installiert ist. Er erkennt die installierte Version und bietet „Auf <Version> aktualisieren?" an — bestätigen, und die alte Version wird an Ort und Stelle ersetzt. Ihre Einstellungen und die Lizenz bleiben erhalten.

Deinstallation

Deinstallieren Sie über Apps & Features oder führen Sie den Installer erneut aus und wählen Sie Deinstallieren im Wartungs-Bildschirm. Standardmäßig bleiben Ihre Einstellungen und die Lizenz erhalten. Um sie ebenfalls zu entfernen, kreuzen Sie Lizenz entfernen und/oder Konfiguration und Einstellungen entfernen an (beide standardmäßig aus).

Lizenzierung und Testversion

Imaging erfordert eine gültige Lizenz. Alles Übrige (Dashboard, Vergleich, vDisk-Speicher, Verlauf) bleibt auch ohne Lizenz nutzbar.

• Testversion: Es steht eine 30‑Tage-Testversion zur Verfügung. Fordern Sie einen Testschlüssel mit Ihrer geschäftlichen E-Mail-Adresse an — Freemail- Adressen (gmail.com, gmx.de, …) sind nicht zugelassen. Der Testschlüssel ist an die Maschine gebunden, auf der er zuerst aktiviert wird.
• Kauf: Lizenzen gibt es in zwei Editionen, Standard und Growth. Eine gekaufte Lizenz ist nicht maschinengebunden.

Lizenz aktivieren

Sie können eine Lizenz bereits bei der Installation aktivieren — im optionalen Schritt Lizenzschlüssel den Schlüssel eingeben oder eine *.pvsilic-Datei laden — oder jederzeit später in der App:

1. Öffnen Sie in PVS Forge die Seite Lizenz.
2. Fügen Sie Ihren Lizenzschlüssel ein oder laden Sie die *.pvsilic- Lizenzdatei.
3. Der Schlüssel wird offline geprüft — für die Aktivierung ist keine Internetverbindung erforderlich.

Haben Sie den Schlüssel bei der Installation eingegeben, aktiviert PVS Forge ihn automatisch beim ersten Start.

Imaging ist lizenzgebunden

Ohne gültige Lizenz (oder bei abgelaufener Testversion) startet PVS Forge keinen Imaging-Auftrag. Aktivieren oder erneuern Sie Ihre Lizenz, um Imaging wieder freizuschalten.

Nächster Schritt

Weiter mit Erste vDisk erstellen.