# 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

```bash
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)