Files

T

spektr 53c5970c60 Projektrestrukturierung und Aufräumen.

2026-09-22 15:07:16 +02:00

8.0 KiB

Raw Blame History

Standard Operating Procedure

Dokumenten-ID: GNAI-002-INFRA Titel: Initialisierung und OS-Installation: LLM-Server (Phase 1)
Status: Installationsanleitung mit lesendem Teilabgleich; vollständige Abnahme offen
Referenzen: -

Änderungsverlauf

Datum	Version	Autor	Beschreibung der Änderung
2026-08-24	1.0	spektr	Erstellung des Initial-Dokuments (Hardware & OS)
2026-08-24	1.1	spektr	Detaillierung der BIOS-ReBAR-Settings, Netinst-CLI-Schritte, Post-Installation & Abnahmekriterien hinzugefügt.
2026-09-16	1.2	spektr	Benutzer- und Netzwerkaufgaben nach GNAI-003 verlagert; ungesicherte Downloadpfade und Domainvorgabe entfernt.
2026-09-18	1.3	spektr	GPU-Abnahme auf nachweisbare Geräteerkennung begrenzt; Firmwarepaket präzisiert.
2026-09-19	1.4	spektr	Getrennte SSH-Zugänge für `ghost` und `ghost-agent` als erfolgreich getestet übernommen.

1. Zweck und Geltungsbereich

Dieses Dokument beschreibt Hardware, BIOS und Debian-Installation des KI-Servers. Benutzer, statische Netzkonfiguration und SSH-Härtung werden in GNAI-003 eingerichtet. Die Schritte sind eine Anleitung, kein Nachweis ihrer Ausführung auf dem bestehenden Host.

2. Spezifikationen (Hardware-Konfiguration)

Komponente	Spezifikation	Bemerkung
Gehäuse	Silverstone SST-RM42-502	Rackmount / Server-Chassis
Mainboard	ASRock Z790 PG Lightning	Socket LGA1700
CPU	Intel Core i5-13600K	14 Kerne (6P + 8E)
CPU-Kühler	Thermalright Peerless Assassin 120 Mini	-
RAM	Crucial Pro DDR5 RAM 64GB Kit (2x32GB)	Dimm Slot A2 & B2
PSU	Corsair RM1200e	1200W ATX 3.0
SSD	2 TB Samsung 970 EVO Plus	Primäre NVMe (Slot M2_1)
GPU 1	Sapphire Nitro+ AMD Radeon RX 6900 XT OC 16GB	PCIe Slot 1 (x16)
GPU 2	Sapphire Nitro+ AMD Radeon RX 6900 XT OC 16GB	PCIe Slot 2 (x8/x4 via PCH)

2.1 BIOS-Konfiguration

Vor der Betriebssystem-Installation sind folgende Schritte im BIOS (Aufrufen via DEL oder F2 beim Booten) durchzuführen:

Firmware-Update (Instant Flash):

BIOS-Datei auf einen FAT32-formatierten USB-Stick entpacken.
Im BIOS navigieren zu: Tool -> Instant Flash.
BIOS-Version auf 19.02 (oder neuer) aktualisieren.

RAM-Performance:

Navigieren zu: OC Tweaker -> DRAM Configuration.
Load XMP Setting: auf XMP Profile 1 stellen.

Virtualisierung & PCI-Einstellungen (Wichtig für GPU/ROCm):

Navigieren zu: Advanced -> CPU Configuration -> Intel Virtualization Technology -> Enabled.
Navigieren zu: Advanced -> PCI Configuration:
- Above 4G Decoding: Enabled
- Re-Size BAR Support: Enabled; tatsächliche GPU-Zuordnung nach der Installation prüfen. Aus der BIOS-Option allein folgt noch kein nachgewiesener ROCm-Leistungsgewinn.

3. Installation des Betriebssystems

3.1 Vorbereitung des Installationsmediums (am Admin-PC)

Debian ISO herunterladen: Die gewünschte Debian-Version und die passende amd64-Netinst-ISO auf Debian CD Images auswählen. ISO und SHA512SUMS aus demselben Release-Verzeichnis herunterladen; Dateinamen nicht aus dieser Anleitung ableiten.
Checksum verifizieren:
```
sha512sum --ignore-missing -c SHA512SUMS
```
Erwartet wird eine OK-Zeile für die tatsächlich heruntergeladene ISO. Bei einem Fehler Download und Prüfsummenquelle kontrollieren.
Bootfähigen USB-Stick erstellen:

Ventoy auf dem USB-Stick installieren.
Die heruntergeladene ISO-Datei direkt per Dateimanager auf die Ventoy-Partition kopieren.

3.2 Schritt-für-Schritt Installationsanleitung (Debian Netinst)

Booten:

USB-Stick einstecken, System starten und per F11 das Boot-Menü öffnen.
USB-Stick auswählen -> Im Ventoy-Menü debian-netinst.iso wählen -> Graphical Install auswählen.

Lokalisierung:

Language: German - Deutsch
Land/Territorium: Deutschland
Tastaturlayout: Deutsch

Netzwerk & Hostname:

Hostname: ghostnet-ki (auf dem bestehenden KI-Server am 18.09.2026 per hostnamectl bestätigt).
Domain-Name: Nur eine tatsächlich konfigurierte lokale Domain eintragen; andernfalls leer lassen. ghostnet.ki ist in dieser Dokumentation lediglich ein optionaler SSH-Alias.
Netzwerk: Per DHCP konfigurieren lassen. (Feste IP wird nach der Installation vergeben).

Benutzerverwaltung:

Root-Passwort: Starkes Passwort aus dem Passwort-Manager eintragen.
Neuer Benutzer:
- Vollständiger Name: Admin
- Benutzername: vor der Installation festlegen. Der bestehende KI-Server verwendet ghost als initiales Administrationskonto; admin ist dort nicht vorhanden.
- Passwort: Sicheres Kennwort vergeben.

Partitionierung (Manuell / Geführt):

Methode: Geführt - gesamte Festplatte verwenden.
Disk auswählen: Samsung SSD 970 EVO Plus 2TB.
Schema: Alle Dateien auf eine Partition (für Anfänger empfohlen).
Wichtig: Änderungen auf die Festplatte schreiben -> Ja.

Paketmanager-Konfiguration:

Spiegelserver-Land: Deutschland
deb.debian.org wählen.
HTTP-Proxy: Leer lassen.

Software-Auswahl (Software selection):

[_] Debian desktop environment (ABWÄHLEN)
[_] GNOME / KDE / etc. (ABWÄHLEN)
SSH server (AUSWÄHLEN)
standard system utilities (AUSWÄHLEN)

Bootloader (GRUB):

GRUB-Bootloader in den primären Laufwerksbereich installieren: Ja
Gerät wählen: /dev/nvme0n1 (Samsung SSD).

Abschluss:

USB-Stick entfernen und auf Weiter klicken, um das System neu zu starten.

3.3 Grundlegende Werkzeuge und Firmware

Für die AMD-GPUs ist in Debian 13 das Paket firmware-amd-graphics aus non-free-firmware vorgesehen. Das breitere Metapaket firmware-linux-nonfree zieht dieses Paket bereits als Abhängigkeit nach sich und wird für diesen Schritt nicht zusätzlich benötigt. Die folgende Anweisung gehört zu einer Neuinstallation oder zum späteren Ansible-Sprint, nicht zu diesem Dokumentationsabgleich:

# Vorher prüfen, ob die Debian-Paketquellen die Komponente non-free-firmware enthalten.
apt update
apt install -y curl wget git htop tmux pciutils firmware-amd-graphics

Für Sudo, Netzwerk und SSH mit GNAI-003 fortfahren. Vor Änderungen auf einem laufenden Host die dort dokumentierte Netzverwaltung prüfen.

4. Abnahmekriterien

Vor der Übergabe an das KI-Team (Phase 2) muss das System folgende Punkte bestehen:

RAM-Check: free -h zeigt mindestens ~62 GB RAM an.
GPU-Erkennung: lspci -nn | grep -Ei 'vga|display|3d' listet zwei AMD-Grafikgeräte auf. Das genaue Kartenmodell anhand des Hardwareinventars oder der Geräte selbst prüfen; die PCI-Familienkennung allein genügt dafür nicht.
Netzwerk: Der Server ist nach GNAI-003 unter 10.0.0.90 erreichbar. Die getrennten SSH-Zugänge für ghost und ghost-agent wurden am 19.09.2026 erfolgreich getestet.
Storage: lsblk -f zeigt die vorgesehene Partitionierung der 2-TB-SSD; df -h / zeigt die nutzbare Dateisystemgröße (in binären Einheiten kleiner als 2 TB).
Re-Size BAR: BIOS-Einstellung und zugewiesene PCIe-BAR-Größen getrennt prüfen; ein bloßer dmesg | grep -i BAR-Treffer gilt nicht als Funktions- oder Leistungsnachweis.

5. Lesender Teilabgleich des bestehenden Hosts am 18.09.2026

Per SSH wurden Debian 13.6, Hostname ghostnet-ki, Intel Core i5-13600K, 62 GiB nutzbarer RAM und zwei AMD Navi-21-GPUs mit PCI-ID 1002:73bf beobachtet. lsblk zeigt eine 1,8-TiB-NVMe mit EFI-, ext4-Root- und Swap-Partition; df -h / zeigte 1,8 TiB Dateisystemgröße. lspci bestätigt die Gerätefamilie, aber weder das genaue Kartenmodell noch ROCm-Funktion und ReBAR-Leistung. BIOS-Version, XMP, Firmwarestand und Restore wurden nicht geprüft.

8.0 KiB Raw Blame History