Files
syno-scripts/VEEAM-INSTALL/README.md
T
2026-08-12 10:22:55 +02:00

125 lines
3.9 KiB
Markdown

# Veeam Backup & Replication Enterprise Installer
PowerShell-basierter Installer zur automatisierten Installation und Grundkonfiguration von Veeam Backup & Replication auf Windows Server.
**Projektversion:** 2.0.1
> **Status:** Entwicklung und Test. Vor einem produktiven Einsatz vollständig in einer isolierten Testumgebung prüfen.
## Funktionen
- Installation von Veeam Backup & Replication
- Prüfung der System- und Administratorvoraussetzungen
- SQL-Prüfung und -Vorbereitung
- Einrichtung eines Backup Repositorys
- Definition und Zeitplanung von Backup-Jobs
- Application-Aware Processing und Verschlüsselungsoptionen
- zentrales Logging, Audit-Logging und Installationsreports
- Dry-Run-Modus ohne geplante Änderungen am Zielsystem
- modulare PowerShell-Architektur
## Voraussetzungen
- unterstütztes Windows-Server-Betriebssystem
- Windows PowerShell 5.1 oder neuer
- lokale Administratorrechte
- Veeam Backup & Replication Installationsmedium
- erreichbare SQL-Instanz, sofern keine lokale Instanz eingerichtet wird
- ausreichend Speicherplatz für Installation und Backup Repository
## Schnellstart
Repository klonen oder herunterladen und in einer PowerShell-Sitzung mit Administratorrechten öffnen.
Die Beispielkonfiguration als lokale Konfiguration kopieren:
```powershell
Copy-Item .\Config\VeeamConfig.example.json .\Config\VeeamConfig.json
```
`Config\VeeamConfig.json` an die Zielumgebung anpassen. Die lokale Datei wird von Git ignoriert.
Zuerst einen Dry Run ausführen:
```powershell
.\Install-VeeamEnterprise.ps1 -DryRun
```
Installation mit automatisch erkanntem Installationsmedium starten:
```powershell
.\Install-VeeamEnterprise.ps1
```
Ist Veeam bereits installiert, überspringt das Skript den Setup-Schritt und
setzt die Konfiguration von Repository und Backup-Jobs fort. Dadurch kann der
Lauf nach einem erforderlichen Neustart sicher wieder aufgenommen werden.
Installationsmedium und Antwortdatei können auch explizit angegeben werden:
```powershell
.\Install-VeeamEnterprise.ps1 `
-VeeamSourcePath 'D:\' `
-VeeamAnswerFile 'C:\Secure\VeeamAnswerFile.xml'
```
## Konfiguration
Die Vorlage [`Config/VeeamConfig.example.json`](Config/VeeamConfig.example.json) enthält ausschließlich unvertrauliche Beispielwerte. Unterstützte Bereiche sind:
- `Environment`: Name und Verantwortungsbereich
- `Veeam`: Version und Quelle des Installationsmediums
- `SQL`: Engine, Server, Instanz und Datenbank
- `Repository`: Name, Pfad und Aufbewahrungszeit
- `BackupJob`: Plattform, Objekte, Zeitplan und Aktivierungsstatus
- `Options`: Application-Aware Processing, Verschlüsselung und Kompression
`Auto` lässt den Installer einen geeigneten lokalen Wert ermitteln. Vor dem Produktivlauf sollten alle automatisch ermittelten Werte im Dry Run kontrolliert werden.
## Projektstruktur
```text
VEEAM-INSTTALL/
├── Install-VeeamEnterprise.ps1
├── Config/
│ └── VeeamConfig.example.json
├── Modules/
│ ├── Core/
│ ├── Platforms/
│ └── Veeam/
├── Scripts/
│ └── Test-VeeamModules.ps1
├── .gitignore
├── LICENSE
└── README.md
```
## Tests
Die Module lassen sich separat prüfen:
```powershell
.\Scripts\Test-VeeamModules.ps1
```
Der vollständige Installer benötigt Windows und muss für systemverändernde Schritte mit Administratorrechten ausgeführt werden.
## Sicherheit
- Keine Passwörter, Tokens, privaten Schlüssel, Zertifikate oder Lizenzdateien im Repository speichern.
- `Config\VeeamConfig.json` und `Config\VeeamAnswerFile.xml` bleiben lokal und werden ignoriert.
- Zugangsdaten über sichere, lokale Mechanismen bzw. Veeam Credential Manager referenzieren.
- Logs, Reports und exportierte Konfigurationen vor einer Weitergabe auf sensible Daten prüfen.
- Installationsmedien und generierte Laufzeitdateien nicht committen.
Vor jedem Commit prüfen:
```powershell
git status
git diff --cached
```
## Lizenz
Dieses Projekt steht unter der [MIT-Lizenz](LICENSE).