Diese Anleitung beschreibt, wie Sie die venabo-Software auf einem Linux-Server aktualisieren, eine Datensicherung erstellen und den Reparaturmodus ausführen.
⚠️ Hinweis: Erstellen Sie vor jedem Update immer zuerst eine Datensicherung. Nur so können Sie Ihre Daten im Fehlerfall wiederherstellen.
Datensicherung erstellen
Führen Sie vor dem Update eine vollständige Datensicherung durch. venabo komprimiert die Datenbank dabei mit 7-Zip und verschlüsselt sie passwortgeschützt.
Geben Sie die folgenden Befehle in der Reihenfolge in Ihr Terminal ein:
- Wechseln Sie zum venabo-Benutzer:
sudo su venabo - Wechseln Sie in das Wurzelverzeichnis:
cd / - Starten Sie das Backup-Skript:
/opt/venabo/tools/backup/backup.sh
Nach Abschluss finden Sie die Sicherungsdatei und das Verschlüsselungspasswort an folgenden Speicherorten:
| Inhalt | Pfad auf dem Server |
|---|---|
| Datensicherung | /opt/venabo/backups |
| Verschlüsselungspasswort | /opt/venabo/shared/.env |
💡 Tipp: Kopieren Sie die Datensicherung zusätzlich auf ein externes Speichermedium oder einen anderen Server, damit sie im Notfall sicher verfügbar ist.
Software-Update durchführen
Sobald die Datensicherung abgeschlossen ist, starten Sie das Update. Das Skript bringt venabo auf den neuesten Stand und spielt alle aktuellen Verbesserungen und Sicherheitsupdates ein.
- Wechseln Sie zum venabo-Benutzer:
sudo su venabo - Wechseln Sie in das Wurzelverzeichnis:
cd / - Starten Sie das Update-Skript:
/opt/venabo/tools/venabo/master-update.sh
✅ Hinweis: Überprüfen Sie nach Abschluss des Updates die Funktionalität Ihres Systems, um sicherzustellen, dass alles ordnungsgemäß läuft.
Reparaturmodus ausführen
Wenn venabo nach einem Update oder bei einem Fehler nicht korrekt startet, können Sie den Reparaturmodus nutzen. Gehen Sie dazu wie folgt vor:
- Wechseln Sie zum venabo-Benutzer:
sudo su venabo - Wechseln Sie in das Wurzelverzeichnis:
cd / - Starten Sie das Update-Skript:
/opt/venabo/tools/update/update.sh - Wählen Sie im angezeigten Menü die Option Reparatur aus.
⚠️ Hinweis: Der Reparaturmodus verändert keine Ihrer Daten, greift jedoch in die Systemkonfiguration ein. Erstellen Sie auch vor einer Reparatur sicherheitshalber eine aktuelle Datensicherung.
Praxisbeispiel
Szenario: Sie möchten venabo auf die neueste Version aktualisieren und führen dazu eine gesicherte, vollständige Aktualisierung durch.
| Schritt | Befehl / Aktion | Ergebnis |
|---|---|---|
| 1. Benutzer wechseln | sudo su venabo | Terminal läuft als venabo-Benutzer |
| 2. Datensicherung starten | /opt/venabo/tools/backup/backup.sh | Verschlüsselte Sicherung in /opt/venabo/backups |
| 3. Update starten | /opt/venabo/tools/venabo/master-update.sh | venabo ist auf dem neuesten Stand |
| 4. Funktionalität prüfen | venabo im Browser öffnen | System läuft fehlerfrei |
Häufige Fragen
Wie oft sollte ich eine Datensicherung erstellen?
Erstellen Sie mindestens vor jedem Update eine Datensicherung. Für den laufenden Betrieb empfiehlt venabo zusätzlich regelmäßige automatisierte Sicherungen, zum Beispiel täglich oder wöchentlich – je nach Häufigkeit der Datenänderungen in Ihrem System.
Wo finde ich das Passwort für die verschlüsselte Datensicherung?
Das Verschlüsselungspasswort liegt in der Datei /opt/venabo/shared/.env auf Ihrem Server. Bewahren Sie diese Datei sorgfältig auf – ohne das Passwort lässt sich die Sicherung nicht entschlüsseln.
Was passiert, wenn das Update fehlschlägt?
Wenn das Update nicht erfolgreich abgeschlossen wird, können Sie zunächst den Reparaturmodus über /opt/venabo/tools/update/update.sh ausführen und dort die Option Reparatur wählen. Besteht das Problem weiterhin, stellen Sie die zuvor erstellte Datensicherung wieder her und wenden Sie sich an den venabo-Support.
Kann ich Update und Reparatur auch ohne Root-Rechte ausführen?
Die Befehle erfordern den Wechsel zum venabo-Benutzer via sudo su venabo. Dafür benötigen Sie sudo-Berechtigungen auf dem Server. Ohne diese Berechtigung können die Skripte nicht ausgeführt werden.
Zusammenfassung
| Aufgabe | Skript | Besonderheit |
|---|---|---|
| Datensicherung | /opt/venabo/tools/backup/backup.sh | 7-Zip, passwortgeschützt |
| Software-Update | /opt/venabo/tools/venabo/master-update.sh | Immer nach Datensicherung ausführen |
| Reparaturmodus | /opt/venabo/tools/update/update.sh | Option „Reparatur“ im Menü wählen |