ghostnet.ai/infrastructure
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
infrastructure/docs/platform/llm-server/host/GNAI-002-INFRA_BaseSystem.md
T

8.1 KiB
Raw Permalink Blame History

Ghostnet.AI-Host – Basisinstallation

Dokumenten-ID: GNAI-002-INFRA Titel: Initialisierung und OS-Installation des KI-Hosts 10.0.0.90
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.
2026-09-22 1.5 Codex In die hostbezogene Struktur platform/ghostnet-ai/ verschoben und Geltungsbereich präzisiert.

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:

  1. 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.
  1. RAM-Performance:
  • Navigieren zu: OC Tweaker -> DRAM Configuration.
  • Load XMP Setting: auf XMP Profile 1 stellen.
  1. 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)

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

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

  3. 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)

  1. 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.
  1. Lokalisierung:
  • Language: German - Deutsch
  • Land/Territorium: Deutschland
  • Tastaturlayout: Deutsch
  1. 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).
  1. 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.
  1. 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.
  1. Paketmanager-Konfiguration:
  • Spiegelserver-Land: Deutschland
  • deb.debian.org wählen.
  • HTTP-Proxy: Leer lassen.
  1. Software-Auswahl (Software selection):
  • [_] Debian desktop environment (ABWÄHLEN)
  • [_] GNOME / KDE / etc. (ABWÄHLEN)
  • SSH server (AUSWÄHLEN)
  • standard system utilities (AUSWÄHLEN)
  1. Bootloader (GRUB):
  • GRUB-Bootloader in den primären Laufwerksbereich installieren: Ja
  • Gerät wählen: /dev/nvme0n1 (Samsung SSD).
  1. 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.

Reference in New Issue View Git Blame Copy Permalink