Files
syno-scripts/Stagging/ANLEITUNG.md
T

10 KiB
Raw Blame History

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 Server. 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, danach Schritt 02: DNS und Reservierungen. 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 Server 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 Server 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:

.\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

.\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:

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

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 und der Broadcom-Versionsübersicht dem tatsächlich vorhandenen Medium zuordnen. Die Dropdowns sind keine vollständige oder automatisch aktualisierte Release-Liste.