PBS iSCSI LUN Setup Skript

tags: [corestream, pbs, proxmox-backup-server, iscsi, synology, backup, skript] project: proxmox-backup-server-iscsi created: 2026-10-26

PBS iSCSI LUN Setup Skript

[!summary] Interaktives Setup-Skript für eine dedizierte Synology-iSCSI-LUN in einer Debian-13-/PBS-QEMU-VM auf Proxmox. Discovery, Target-/LUN-Auswahl mit Vorschlägen oder manueller Eingabe, persistente iSCSI-Anmeldung, XFS, UUID-Mount mit _netdev und optionaler PBS-Datastore-Erstellung. Repo: OneDev-Projekt corestream/proxmox-backup-server-iscsi.

Einordnung

• ersetzt das manuelle Anbinden einer Synology-LUN per iscsiadm-Handkommandos in der PBS-VM
• folgt dem Muster von [[RustFS iSCSI Architektur und Migration]] (Storage-VLAN 10.1.0.x, dedizierte Storage-NIC, kein Gateway in der Storage-VLAN-NIC)
• Komplement zur NFS-Variante: [[Managed Backup - S3 RustFS Betriebsmodell]] und How-To «Synology NFS for PBS Datastore» im BookStack (Buch Proxmox Backup Server)

Funktionsumfang

1. Portal: Abfrage oder optionaler Port-3260-Scan im lokalen Subnetz, Auswahlmenü, manuelle Eingabe möglich
2. Target-IQN: automatische Discovery via iscsiadm -m discovery; ein Treffer wird als Vorschlag übernommen, sonst nummeriertes Menü plus m für manuell
3. LUN: by-path-Auflistung mit Grösse, Modell und Seriennummer; Auswahl oder manuell
4. Persistente iSCSI-Node-Konfiguration: node.startup=automatic, Timeouts, optional CHAP (Secret verdeckt)
5. Signaturprüfung: existierendes Dateisystem bleibt standardmässig erhalten; Formatieren nur nach Eingabe der erkannten Platten-Seriennummer
6. XFS mit -K (nicht trim-on-format), UUID-basierter fstab-Eintrag mit _netdev,nodev,nosuid,noexec
7. Falls PBS bereits installiert: Datastore optional direkt per proxmox-backup-manager datastore create; sonst exakter Befehl als Ausgabe
8. --dry-run: validierter Plan ohne Änderungen

Download

curl -fsSL 'https://git.corestream.ch/corestream/proxmox-backup-server-iscsi/~raw/master/pbs-iscsi-setup.sh' -o /root/pbs-iscsi-setup.sh
chmod 0700 /root/pbs-iscsi-setup.sh
bash /root/pbs-iscsi-setup.sh

Pin an Commit b912881 möglich: .../~raw/b912881/pbs-iscsi-setup.sh. Falls DNS im Storage-VLAN fehlt, vom LAN aus laden und in die VM kopieren.

Repository

• OneDev: corestream/proxmox-backup-server-iscsi (vorher provisorisch im scripts-Repo, dort entfernt)
• Stand: Commit b912881, Skript 361 Zeilen, bash -n geprüft, Dry-Run verifiziert
• Clone: ssh://git@git.corestream.ch:6611/corestream/proxmox-backup-server-iscsi

Betriebshinweise

• Ausführung als root in der PBS-VM
• Vor Rebuild/Neuformatierung: LUN-Seriennummer gegen Synology-Speichermanager prüfen; nie mehrere PBS-VMs auf dieselbe LUN mounten
• Boot-Pfad: iSCSI-Login muss vor dem Datastore-Dienst erfolgen (Skript setzt node.startup=automatic; fstab nutzt _netdev)
• Nach LUN-Wechsel: iscsiadm -m node -U all bzw. Rescan, bevor PBS gestartet wird

Verwandt

• [[RustFS iSCSI Architektur und Migration]]
• [[Backup Konzept Intern]]
• BookStack: Buch «Proxmox Backup Server» (id 31, Kapitel «Proxmox Backup Server» id 17)