# Unbeaufsichtigte Installation vorbereiten ## Stand `03-Prepare-Unattended.ps1` liest das KIS-Workbook und bereitet die Antwortdateien vor: - Proxmox VE: `answer.toml` - VMware ESXi: `ks.cfg` System und Version kommen aus dem Blatt **Virtualisierer**. Die Windows-Server-Version, ISO-Namen und ISO-Ablage kommen aus **Staging**. Der Generator installiert selbst noch keine Server. Für Netzwerk und DHCP zuerst [Schritt 01](WINDOWS-SETUP.md), danach [Schritt 02: DNS und Reservierungen](DNS-RESERVIERUNGEN.md). PXE- und Webdienst sind noch nicht implementiert. ## 1. Excel ausfüllen Verwende `outputs/01a07d3f/ConfigWorkbook_KIS.xlsx`. Im Blatt **Staging** Windows-Version per Dropdown wählen und die Netzwerkwerte ergänzen. `Medienordner` bleibt der lokale Arbeitsordner. Für Schritt 03 die Felder `ISO-Name Proxmox` bzw. `ISO-Name ESXi` sowie `ISO-Ablage` ausfüllen. Im Blatt **Virtualisierer** die vorgesehenen Geräte auf `Installieren = JA` setzen und ihre Angaben vervollständigen. Excel speichern, bevor du das Programm startest. **Version auswählen:** Im Blatt Virtualisierer zuerst `System`, dann `Version` wählen. Das Versions-Dropdown zeigt die passende Plattformliste. Bei einem Systemwechsel die Version neu wählen. Die editierbaren Startlisten stehen im Blatt Staging in A37:C44. Eine genaue zusätzliche Medienversion dort ergänzen und danach im Dropdown auswählen; eine Erweiterung der Liste erweitert nicht automatisch die Generatorprofile. **ISO-Name und Ablage getrennt eintragen:** | Feld | Beispiel | | --- | --- | | ISO-Name Proxmox | `proxmox-ve_9.2-1.iso` – nur der tatsächliche Dateiname | | ISO-Name ESXi | Tatsächlicher Name der ESXi- oder Hersteller-ISO mit `.iso` | | ISO-Ablage lokal | `C:\ISOs` | | ISO-Ablage extern | `\\Dateiserver\ISOs` | Nur einen gemeinsamen Ablageordner in `ISO-Ablage` eintragen. Die Skripte kombinieren ihn mit dem jeweiligen Dateinamen. Das Feld darf zunächst leer bleiben; Windows/DHCP/DNS lassen sich trotzdem vorbereiten. Schritt 03 benötigt es für ausgewählte Server. Der Ordner muss beim Erzeugen der Antwortdateien erreichbar und mit dem ausführenden Windows-Konto lesbar sein. Es werden keine Freigabe-Passwörter in Excel gespeichert und keine Freigaben angelegt oder automatisch verbunden. Die reine Vorschau greift nicht auf die ISO-Freigabe zu. Ältere Workbooks ohne das neue Feld verwenden weiterhin den bisherigen Medienordner. Für diesen ersten Installer-Durchlauf gelten: - Eine Version und ein Installationsmedium je Plattform. Die Version wird niemals automatisch ersetzt. Für einen anderen Versionssatz einen getrennten Lauf vorbereiten. - Ziel-IP im gleichen Netz wie das GETAC, außerhalb des DHCP-Bereichs und ungleich der GETAC-IP. - Gateway und DNS müssen eingetragen sein. Anders als im ursprünglichen isolierten Workbook-Beispiel lässt dieser Generator diese Felder nicht leer. Nur vorhandene Dienste verwenden; DHCP allein macht das GETAC nicht zum Router oder DNS-Server. - Benutzername `root`. Zusätzliche Benutzer folgen nach der Installation. - PVE-Datenträger: vorzugsweise `ID_SERIAL=ECHTE_SERIENNUMMER`; alternativ ein bestätigter Installer-Gerätename wie `sda` oder `nvme0n1`. Keine Wildcards, kein `/dev/`-Präfix. ESXi: die bestätigte Kennung mit `naa.`, `eui.`, `t10.` oder `mpx.`. - Normale PXE-Netzwerkkarte verwenden, nicht die BMC-Schnittstelle. Im ersten Profil ist dies zugleich die spätere Management-Netzwerkkarte. Die ISO muss tatsächlich zur Version passen. Der Generator prüft beim Erzeugen ihre Existenz und protokolliert SHA-256, identifiziert aber noch nicht die Produktversion im ISO-Inhalt. Ein Dateiname ist kein Versionsnachweis. ## 2. Angaben prüfen Auf dem GETAC PowerShell im Ordner `Stagging` öffnen: ```powershell .\03-Prepare-Unattended.ps1 ``` Das Programm zeigt die ausgewählten Systeme, Versionen, MAC-Adressen, Zielplatten und Medien. Es schreibt dabei keine Antwortdateien und fragt keine Passwörter ab. Ein anderer Speicherort der Excel-Datei kann mit `-Workbook 'C:\Pfad\ConfigWorkbook_KIS.xlsx'` angegeben werden. Benötigt wird Windows PowerShell 5.1 oder PowerShell 7. Excel, ein Excel-Zusatzmodul, Python und ein Vault sind für das Programm nicht erforderlich. Die vorhandene Ausführungsrichtlinie des GETAC wird nicht verändert; falls die Organisation signierte Skripte verlangt, sind die Dateien nach dem dortigen Verfahren zu signieren. ## 3. Antwortdateien erzeugen ```powershell .\03-Prepare-Unattended.ps1 -Generate ``` Nach der Zielübersicht mit `VORBEREITEN` bestätigen. Das erzeugt nur Dateien, startet aber noch keinen Installer. Beim späteren Einsatz löschen diese Dateien die ausgewählten Datenträger; ESXi-Kickstart enthält außerdem `vmaccepteula` und damit die Lizenzzustimmung. Vor Veröffentlichung für PXE müssen die konkreten Ziele, Medien und Lizenzbedingungen geprüft sein. Für PVE wird die Administrator-E-Mail abgefragt. Optional kann sie bereits als zusätzliche Einstellung `Admin-E-Mail` in Spalte A und der Wert in Spalte B des Blatts Staging stehen, außerhalb belegter Zellen. Pro Server wird das neue root-Passwort verdeckt abgefragt. Das gemeinsame Passwortprofil verlangt 12–64 druckbare ASCII-Zeichen mit Groß-/Kleinbuchstaben, Zahl und Sonderzeichen ohne Leerzeichen. Damit wird keine Garantie gegeben, dass jede spätere Zielversion jede Passphrase akzeptiert. Das Ergebnis liegt in einem neuen Ordner unter `runs`: ```text run-.../ manifest.json NICHT-AUTOMATISCH-STARTEN.txt 02-00-00-00-00-11/answer.toml 02-00-00-00-00-12/ks.cfg ``` Nur ausgewählte Server bekommen eine Datei. Die MAC-Adressen bestimmen die Unterordner. Das Manifest enthält die angeforderten Versionen, Datenträger, Medienpfade und Medien-Prüfsummen, keine Passwörter oder Passwort-Hashes. Die Antwortdateien enthalten gesalzene SHA-512-crypt-Passwort-Hashes, keine Klartext-Passwörter. Der Laufordner wird unter Windows auf den ausführenden Benutzer beschränkt und ist aus Git ausgeschlossen. Hashes bleiben vertraulich. Der Klartext wird während der Hash-Erzeugung kurz im Prozess benötigt; vollständige Löschung aller verwalteten Speicher-Kopien ist nicht zugesichert. Nach Verwendung den betreffenden Laufordner entfernen. Er wird nicht automatisch publiziert oder gelöscht. ## Noch erforderlicher PXE-Schritt Auf dem GETAC müssen die richtigen Bootdateien und das Installationsmedium passend zur Excel-Version bereitgestellt werden. Das liegt außerhalb des bisherigen Generators: 1. PVE-Medium mit dem passenden `proxmox-auto-install-assistant` vorbereiten; jede erzeugte Antwortdatei mit dessen `validate-answer` prüfen. Dieses Proxmox-Werkzeug ist kein natives Windows-PowerShell-Modul. Der Vorbereitungsweg für Windows beziehungsweise eine separate Linux-Vorbereitung ist noch festzulegen. 2. ESXi-Medium entpacken und dessen Bootkonfiguration samt hostbezogenem `ks=`-Verweis vorbereiten. 3. DHCP/PXE und einen Dateidienst ausschließlich im Installationsnetz einrichten. Die Bootauswahl darf nur freigegebene MAC-Adressen bedienen. Unbekannte Geräte stoppen. 4. Antwortdateien nur für den bestätigten Durchlauf bereitstellen. Die abgeschlossene Installation muss ihre Freigabe verlieren, damit ein erneuter PXE-Start keine Neuinstallation auslöst. 5. Einen echten Testserver pro gewünschter Plattform installieren und Ergebnis, Anmeldung, Netzkonfiguration und Datenträgerzuordnung prüfen. Ein MAC-Unterordner allein ist keine Zugangskontrolle. Die spätere Auslieferung muss gesondert implementiert und geprüft werden. Es werden keine generischen Bootdateien erzeugt, die eine beliebige ISO automatisch als kompatibel behandeln. ## Vorbereitete Profile und Grenzen - PVE 8.4 sowie 9.x: TOML mit `root-password-hashed`, statischem IPv4-Netz und Auswahl der NIC über ihre MAC-Eigenschaft. Festes erstes KIS-Profil: ext4, Land/Tastatur `de`, Zeitzone `Europe/Berlin`. Kein ZFS/RAID-Layout in dieser Etappe. - ESXi 7.x/8.x: Kickstart mit `rootpw --iscrypted`, expliziter Disk-Kennung, statischem IPv4 und Neustart. Keine zusätzliche Shell-/SSH-Aktivierung. - Andere Versionen werden mit einer Meldung abgewiesen, statt ein ungeprüftes Format zu erzeugen. Diese Bereiche sind Generatorprofile, keine Aussage über Hersteller-Support oder erfolgreich getestete Hardware. - 55 automatisierte Prüfungen unter PowerShell 7.4.1 auf macOS bestanden: XLSX-Lesen, Auswahl, Netzwerk-/Datenträgervalidierung, veröffentlichte SHA-512-crypt-Testvektoren und ein vollständiger Dateierzeugungslauf mit zwei Testservern. Die Testmedien sind absichtlich keine bootfähigen ISOs. Ein echter PVE-/ESXi-Installertest, Windows-PowerShell-5.1-Test und Windows-ACL-Test stehen aus. Die lokalen Prüfungen lassen sich mit `./Tests/03-Unattended.Tests.ps1` wiederholen. Sie starten keine Netzwerkdienste und installieren keine Systeme. ## Technische Quellen - [Proxmox Automated Installation](https://pve.proxmox.com/wiki/Automated_Installation) - [Proxmox: offizielles TOML-Beispiel mit NIC-Auswahl](https://github.com/proxmox/pve-installer/blob/master/proxmox-auto-installer/tests/resources/parse_answer/nic_matching.toml) - [Proxmox: offizielles Beispiel mit Passwort-Hash](https://github.com/proxmox/pve-installer/blob/master/proxmox-auto-installer/tests/resources/parse_answer/hashed_root_password.toml) - [Broadcom: ESXi und hostbezogene Kickstart-Auslieferung](https://knowledge.broadcom.com/external/article/440457/esxi-scripted-installation-fails-to-dyna.html) - [VMware: Default Accounts und gesalzene SHA512-Hashes](https://www.vmware.com/docs/default-accounts-in-vmware-vsphere) - [SHA-crypt: Algorithmus und Testvektoren](https://www.akkadia.org/drepper/SHA-crypt.txt) Die Quellen beschreiben das Dateiformat und Verfahren. Maßgeblich für den Abnahmetest ist der konkrete Installer aus dem Workbook. Die Startauswahl basiert auf den bestehenden Generatorprofilen. Versionsangaben lassen sich anhand der [Proxmox-ISO-Seite](https://www.proxmox.com/en/downloads/proxmox-virtual-environment) und der [Broadcom-Versionsübersicht](https://knowledge.broadcom.com/external/article/316595/build-numbers-and-versions-of-vmware-esx.html) dem tatsächlich vorhandenen Medium zuordnen. Die Dropdowns sind keine vollständige oder automatisch aktualisierte Release-Liste.