# Proxmox Backup Server

# System Anforderungen

<section id="bkmrk-we-recommend-using-h">We recommend using high quality server hardware when running Proxmox Backup in production. To further decrease the impact of a failed host, you can set up periodic, efficient, incremental [<span class="std std-ref">datastore synchronization</span>](https://pbs.proxmox.com/docs/managing-remotes.html#syncjobs) from other Proxmox Backup Server instances.

<section id="bkmrk-minimum-server-requi">### Minimum Server Requirements, for Evaluation

These minimum requirements are for evaluation purposes only and should not be used in production.

- CPU: 64bit (*x86-64* or *AMD64*), 2+ Cores
- Memory (RAM): 2 GB RAM
- Hard drive: more than 8GB of space.
- Network card (NIC)

</section><section id="bkmrk-recommended-server-s">### Recommended Server System Requirements

- CPU: Modern AMD or Intel 64-bit based CPU, with at least 4 cores
- Memory: minimum 4 GiB for the OS, filesystem cache and Proxmox Backup Server daemons. Add at least another GiB per TiB storage space.
- OS storage:
    
    
    - 32 GiB, or more, free storage space
    - Use a hardware RAID with battery protected write cache (*BBU*) or a redundant ZFS setup (ZFS is not compatible with a hardware RAID controller).
- Backup storage:
    
    
    - Prefer fast storage that delivers high IOPS for random IO workloads; use only enterprise SSDs for best results.
    - If HDDs are used: Using a metadata cache is highly recommended, for example, add a ZFS [<span class="std std-ref">special device mirror</span>](https://pbs.proxmox.com/docs/sysadmin.html#local-zfs-special-device).
- Redundant Multi-GBit/s network interface cards (NICs)

</section></section>

# 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)