From d9480d8e910f6924e5e0e124ead3b9203274eba1 Mon Sep 17 00:00:00 2001
From: Marc Berg <99531337+Marc-Berg@users.noreply.github.com>
Date: Thu, 7 Sep 2023 22:08:48 +0200
Subject: [PATCH 1/5] Updated docs
- Elimination of some spelling and formatting errors.
- Additions to the chapter "Docker"
- Synchronisation of German and English content
---
docs/de/backitup.md | 293 ++++++++++++++++++++++----------------------
docs/en/backitup.md | 245 ++++++++++++++++++------------------
2 files changed, 266 insertions(+), 272 deletions(-)
diff --git a/docs/de/backitup.md b/docs/de/backitup.md
index 6f8c90dc..01cf7858 100644
--- a/docs/de/backitup.md
+++ b/docs/de/backitup.md
@@ -1,5 +1,5 @@
-# ioBroker.backitup
+# ioBroker.backitup
@@ -19,7 +19,7 @@
**************************************************************************************************************
-## Haftungsausschluss
+## Haftungsausschluss
**ioBroker.backitup ist ein Backup-Plugin nur für die Smart Home Software ioBroker.**
**Es steht in keiner Verbindung zu [Nero BackItUp](https://www.nero.com/deu/products/nero-backitup/?vlang=de) (ein Tool zur Datensicherung unter Windows-Systemen) und wird auch nicht von diesem unterstützt.**
@@ -27,59 +27,64 @@
**************************************************************************************************************
-# Inhalt
-* [Grundlegendes](#grundlegendes)
-* [Abhängigkeiten](#Abhängigkeiten)
-* [Benutzung und Bedienung](#Benutzung-und-Bedienung)
-* [Backuptypen](#Backuptypen)
- * [ioBroker Backup](#ioBroker-Backup)
- * [CCU Backup (Homematic)](#CCU-Backup-(Homematic))
- * [Mysql-Backup](#Mysql-Backup)
- * [Redis-Backup](#Redis-Backup)
- * [InfluxDB-Backup](#InfluxDB-Backup)
- * [PostgreSQL-Backup](#PostgreSQL-Backup)
- * [Javascript-Backup](#Javascript-Backup)
- * [Jarvis-Backup](#Jarvis-Backup)
- * [Zigbee-Backup](#Zigbee-Backup)
- * [Grafana-Backup](#Grafana-Backup)
- * [Yahka-Backup](#Yahka-Backup)
-* [Speicher-Optionen](#Speicher-Optionen)
- * [CIFS](#CIFS)
- * [NFS](#NFS)
- * [FTP](#FTP)
- * [Copy](#Copy)
- * [Dropbox](#Dropbox)
- * [Google Drive](#Google-Drive)
- * [WebDAV](#WebDAV)
-* [Multihost Unterstützung](#Multihost-Unterstützung)
-* [Docker Unterstützung](#Docker-Unterstützung)
-* [Verwendung](#Verwendung)
-* [Benachichtigungen](#Benachichtigungen)
-* [Restore](#Restore)
-* [Fehlersuche](#Fehlersuche)
-* [Aufgetretene Fehler / Lösungen](#Aufgetretene-Fehler-/-Lösungen)
+# Inhalt
+- [Grundlegendes](#grundlegendes)
+- [Abhängigkeiten](#abhängigkeiten)
+- [Benutzung und Bedienung](#benutzung-und-bedienung)
+- [Backuptypen](#backuptypen)
+ - [ioBroker Backup](#iobroker-backup)
+ - [CCU Backup (Homematic)](#ccu-backup-homematic)
+ - [Mysql-Backup](#mysql-backup)
+ - [Sqlite3-Backup](#sqlite3-backup)
+ - [Redis-Backup](#redis-backup)
+ - [History Daten Backup](#history-daten-backup)
+ - [InfluxDB-Backup](#influxdb-backup)
+ - [PostgreSQL-Backup](#postgresql-backup)
+ - [Javascript-Backup](#javascript-backup)
+ - [Jarvis-Backup](#jarvis-backup)
+ - [Zigbee-Backup](#zigbee-backup)
+ - [Zigbee2MQTT-Backup](#zigbee2mqtt-backup)
+ - [Node-Red-Backup](#node-red-backup)
+ - [Grafana-Backup](#grafana-backup)
+ - [Yahka-Backup](#yahka-backup)
+- [Speicher-Optionen](#speicher-optionen)
+ - [CIFS](#cifs)
+ - [NFS](#nfs)
+ - [FTP](#ftp)
+ - [Copy](#copy)
+ - [Dropbox](#dropbox)
+ - [Google Drive](#google-drive)
+ - [Onedrive](#onedrive)
+ - [WebDAV](#webdav)
+- [Multihost Unterstützung](#multihost-unterstützung)
+- [Docker Unterstützung](#docker-unterstützung)
+- [Verwendung](#verwendung)
+- [Benachichtigungen](#benachichtigungen)
+- [Restore](#restore)
+- [Fehlersuche](#fehlersuche)
+- [Aufgetretene Fehler / Lösungen](#aufgetretene-fehler--lösungen)
---
# Grundlegendes
-ioBroker.backitup ist eine Backuplösung, mit der das zyklische Sichern einer IoBroker-Installation sowie einer Homematic CCU möglich ist.
+ioBroker.backitup ist eine Backuplösung, mit der das zyklische Sichern einer ioBroker-Installation sowie einer Homematic CCU möglich ist.
-Der Adapter ist für Multiplattformen geeignet und kann neben Linux-Installationen auch auf Windows und Mac Installationen verwendet werden.
+Der Adapter ist für Multiplattformen geeignet und kann neben Linux-Installationen auch auf Windows und Mac Installationen verwendet werden.
-Des Weiteren besteht die Möglichkeit verschiedene optionale Backups wie z.B. SQL-Datenbanken, Influx-Datenbanken und einige Adapter- und Geräte Einstellungen zu sichern.
+Des Weiteren besteht die Möglichkeit, verschiedene optionale Backups wie z.B. SQL-Datenbanken, Influx-Datenbanken und einige Adapter- und Geräteeinstellungen zu sichern.
-ioBroker.backitup arbeitet sehr eng mit dem js-controller zusammen und erstellt ein iobroker Backup identisch dem CLI Befehl `iobroker backup`.
+ioBroker.backitup arbeitet sehr eng mit dem js-controller zusammen und erstellt ein ioBroker Backup identisch dem CLI Befehl `iobroker backup`.
Es werden hier identisch dem Standard Backup des js-controllers alle States und Objects, sowie die Nutzerdateien wie z.B. VIS gesichert.
Auch der Restore ist komplett identisch dem CLI Befehl `iobroker restore ` des js-controllers.
Bei einem Restore werden alle States, Objects und Nutzerdaten von ioBroker.backitup wiederhergestellt.
-Nach dem Restore startet euer iobroker neu und ab da übernimmt die Installation fehlender Adapter dann wieder der js-controller.
+Nach dem Restore startet euer ioBroker neu und ab da übernimmt die Installation fehlender Adapter dann wieder der js-controller.
-ioBroker.backitup hat nach dem Start des iobrokers keinerlei Einfluss auf die Wiederherstellung. Dies passiert alles im Hintergrund und übernimmt der js-controller anhand der wiederhergestellten Informationen in den States und Objects.
+ioBroker.backitup hat nach dem Start des ioBroker keinerlei Einfluss auf die Wiederherstellung. Dies übernimmt der js-controller anhand der wiederhergestellten Informationen in den States und Objects im Hintergrund.
-### [zurück](#Inhalt)
+### [zurück](#Inhalt)
---
# Abhängigkeiten
@@ -98,7 +103,7 @@ ioBroker.backitup hat nach dem Start des iobrokers keinerlei Einfluss auf die Wi
* Für die Verwendung des Sqlite3-Backups muss sqlite3 auf dem System installiert sein
- `sudo apt install sqlite3`
-* Für die verwendung des PostgreSQL-Backups muss mysqldump auf dem System installiert sein
+* Für die Verwendung des PostgreSQL-Backups muss mysqldump auf dem System installiert sein
- [Installationsanleitung PostgreSQL](https://www.postgresql.org/download/linux/debian/)
* Für die Verwendung des InfluxDB Backups muss influxd installiert sein
@@ -106,51 +111,50 @@ ioBroker.backitup hat nach dem Start des iobrokers keinerlei Einfluss auf die Wi
- [Installationsanleitung InfluxDB 2.x](https://docs.influxdata.com/influxdb/v2.1/install/)
- [Installationsanleitung Influx-CLI für 2.x](https://docs.influxdata.com/influxdb/v2.1/tools/influx-cli/?t=Linux)
-### [zurück](#Inhalt)
+### [zurück](#Inhalt)
---
# Benutzung und Bedienung
ioBroker.backitup kann in den Adapter-Instanzen konfiguriert werden. Dort stehen alle folgenden Einstellungsmöglichkeiten zur Verfügung.
Für die tägliche Arbeit und Bedienung von ioBroker.backitup steht im Admin-Tab ein Reiter zur Verfügung.
-Ist dieser Reiter im Tab-Menü der Admin-Oberfläche aktiv, kann ioBroker.backitup direkt über den Reiter in der linken Tab-Leiste des iobrokers bedient werden.
-Dort stehen Informationen zu den erstellten Backups zur Verfügung, es können Backups erstellt werden und es besteht die Möglichkeit einen Restore des Backups auszuführen.
+Ist dieser Reiter im Tab-Menü der Admin-Oberfläche aktiv, kann ioBroker.backitup direkt über den Reiter in der linken Tab-Leiste des ioBrokers bedient werden.
+Dort stehen Informationen zu den erstellten Backups zur Verfügung, es können Backups erstellt werden und es besteht die Möglichkeit, einen Restore des Backups auszuführen.
-### [zurück](#Inhalt)
+### [zurück](#Inhalt)
---
# Backuptypen
-ioBroker.backitup bietet sehr viele Möglichkeiten verschiedene Backuptypen zyklisch oder auf Knopfdruck durch zu führen. Jedes Backup wird standardmäßig im Verzeichnis /opt/iobroker/backups/ abgelegt. Optional kann ein FTP-Upload eingerichtet oder alternativ ein CIFS/NFS-Mount genutzt werden.
+ioBroker.backitup bietet sehr viele Möglichkeiten, verschiedene Backuptypen zyklisch oder auf Knopfdruck durchzuführen. Jedes Backup wird standardmäßig im Verzeichnis /opt/iobroker/backups/ abgelegt. Optional kann ein FTP-Upload eingerichtet oder alternativ ein CIFS/NFS-Mount genutzt werden.
## ioBroker Backup
-Dieses Backup entspricht dem in IoBroker enthaltenen Backup welches man in der Konsole über den Aufruf `iobroker backup` starten kann. Nur wird es hier durch die festgelegten Einstellungen in der Adapterkonfiguration oder dem Widget OneClick-Backup durchgeführt ohne die Konsole verwenden zu müssen.
+Dieses Backup entspricht dem in ioBroker enthaltenen Backup, welches man in der Konsole über den Aufruf `iobroker backup` starten kann. Nur wird es hier durch die festgelegten Einstellungen in der Adapterkonfiguration oder dem Widget OneClick-Backup durchgeführt, ohne die Konsole verwenden zu müssen.
## CCU Backup (Homematic)
-Dieses Backup bietet die Möglichkeit 3 verschiedene Varianten einer Homematic Installations (CCU-Original / pivCCU / Raspberrymatic) zu sichern. Auch die Ausführung dieses Backups kann durch die festgelegten Einstellungen in der Adapterkonfiguration oder dem Widget OneClick-Backup durchgeführt werden.
-
+Dieses Backup bietet die Möglichkeit, drei verschiedene Varianten einer Homematic Installation (CCU-Original / pivCCU / Raspberrymatic) zu sichern. Auch die Ausführung dieses Backups kann durch die festgelegten Einstellungen in der Adapterkonfiguration oder dem Widget OneClick-Backup durchgeführt werden.
Wer nicht nur eine CCU sichern will, kann die Option "Sicherung mehrerer Systeme" aktivieren und im Anschluss seine Homematic Zentralen in der Tabelle definieren.
## Mysql-Backup
-Dieses separat einstellbare Backup wird sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig sofern bei den anderen IoBroker-Backup-Typen eingestellt.
-Wichig hierbei ist, dass auch wenn der Mysql-Server auf einem entferten System läuft, die mysqldump auf dem ioBroker System laufen muss.
Für Linuxsysteme wäre der Installationsbefehl wie folgt: `sudo apt install mysql-client` oder unter Debian `sudo apt install default-mysql-client` bzw. für MariaDB Systeme `sudo apt install mariadb-client`.
+Dieses separat einstellbare Backup wird, sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig, sofern bei den anderen ioBroker-Backup-Typen eingestellt.
+Wichig hierbei ist, dass auch wenn der Mysql-Server auf einem entfernten System läuft, die mysqldump auf dem ioBroker System laufen muss.
Für Linuxsysteme wäre der Installationsbefehl wie folgt: `sudo apt install mysql-client` oder unter Debian `sudo apt install default-mysql-client` bzw. für MariaDB Systeme `sudo apt install mariadb-client`.
Wer nicht nur eine Datenbank sichern will, kann die Option "Sicherung mehrerer Systeme" aktivieren und im Anschluss seine Datenbanken in der Tabelle definieren.
## Sqlite3-Backup
-Dieses separat einstellbare Backup wird sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig sofern bei den anderen IoBroker-Backup-Typen eingestellt.
-Auf dem Host-System muss Sqlite3 (`sudo apt install msqlite3`) installiert sein.
+Dieses separat einstellbare Backup wird, sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig, sofern bei den anderen ioBroker-Backup-Typen eingestellt.
+Auf dem Host-System muss Sqlite3 (`sudo apt install sqlite3`) installiert sein.
## Redis-Backup
-Dieses separat einstellbare Backup wird sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig sofern bei den anderen IoBroker-Backup-Typen eingestellt.
+Dieses separat einstellbare Backup wird, sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig, sofern bei den anderen ioBroker-Backup-Typen eingestellt.
Zur Verwendung von Redis mit ioBroker.backitup sollten die Rechte für den iobroker-User angepasst werden:
```
sudo usermod -a -G redis iobroker
sudo reboot
```
-Für ein Remote-Backup wird auf dem loaklen iobroker System redis-cli benötigt.
+Für ein Remote-Backup wird auf dem lokalen ioBroker System redis-cli benötigt.
`sudo apt install redis-tools`
@@ -159,11 +163,8 @@ Hier müsst ihr euren Host und Port des entfernten Redis Servers angeben und die
Dies ist gerade für Docker User ein wichtiges Feature.
-Bitte beachtet, dass ein Redis Restore für Remote Systeme nicht über die ioBroker.backitup GUI möglich ist.
-Redis unterstützt dies nicht.
-Hier muss die im tar.gz Archiv enthaltene dump.rdb händisch wiederhergestellt werden.
-
-Dafür muss das Backup-Archiv entpackt werden, die Datei in das Redis Verzeichnis kopiert werden und die Rechte für die dump.rdb angepasst werden.
+Bitte beachtet, dass ein Redis Restore für Remote Systeme nicht über die ioBroker.backitup GUI möglich ist, da Redis dies nicht unterstützt.
+Hier muss die im tar.gz Archiv enthaltene dump.rdb händisch wiederhergestellt werden, indem das Backup-Archiv entpackt und die Datei in das Redis Verzeichnis kopiert wird, sowie die Rechte für die dump.rdb angepasst werden.
Hier ein Beispiel:
```
@@ -173,11 +174,11 @@ redis-cli shutdown nosave
```
## History Daten Backup
-Dieses separat einstellbare Backup wird sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig sofern bei den anderen IoBroker-Backup-Typen eingestellt.
+Dieses separat einstellbare Backup wird, sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig, sofern bei den anderen ioBroker-Backup-Typen eingestellt.
## InfluxDB-Backup
-Dieses separat einstellbare Backup wird sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig sofern bei den anderen IoBroker-Backup-Typen eingestellt.
-**Vorraussetzungen für ein Remote Backup mit InfluxDB v1.x:**
+Dieses separat einstellbare Backup wird, sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig, sofern bei den anderen ioBroker-Backup-Typen eingestellt.
+**Voraussetzungen für ein Remote Backup mit InfluxDB v1.x:**
Für das Remote Backup unter InfluxDB 1.x sind einige Anpassungen nötig.
@@ -197,12 +198,12 @@ bind-address = "0.0.0.0:8088"
Weitere Informationen zur Datensicherung der InfluxDB sind [hier](https://docs.influxdata.com/influxdb/v1.8/administration/backup_and_restore/#online-backup-and-restore-for-influxdb-oss) zu finden.
-**Vorraussetzungen für ein Backup mit InfluxDB v2.x:**
+**Voraussetzungen für ein Backup mit InfluxDB v2.x:**
Um ein Backup einer InfluxDB 2.x erstellen zu können, muss Influx-CLI auf eurem System installiert sein.
Dies ist sowohl bei einem lokalen als auch bei einem Remote Backup erforderlich.
-Bei einem Remote Backup muss Influx-CLI auf dem System installiert sein, auf dem auch euer iobroker läuft.
+Bei einem Remote Backup muss Influx-CLI auf dem System installiert sein, auf dem auch euer ioBroker läuft.
Auf dem entfernten System, in dem eure Datenbank arbeitet, ist die Installation für ein Backup nicht erforderlich.
Hier findet Ihr die offizielle Anleitung, wie Ihr Influx-CLI auf eurem System installieren könnt.
@@ -212,24 +213,24 @@ Hier findet Ihr die offizielle Anleitung, wie Ihr Influx-CLI auf eurem System in
Wer nicht nur eine Datenbank sichern will, kann die Option "Sicherung mehrerer Systeme" aktivieren und im Anschluss seine Datenbanken in der Tabelle definieren.
## PostgreSQL-Backup
-Dieses separat einstellbare Backup wird sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig sofern bei den anderen IoBroker-Backup-Typen eingestellt.
-Wichig hierbei ist, dass auch wenn der PostgreSQL-Server auf einem entferten System läuft, die PostgreSQL auf dem ioBroker System laufen muss.
Für Linuxsysteme gibt es [hier](https://www.postgresql.org/download/linux/debian/) eine Installationsanleitung.
+Dieses separat einstellbare Backup wird, sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig, sofern bei den anderen ioBroker-Backup-Typen eingestellt.
+Wichig hierbei ist, dass auch wenn der PostgreSQL-Server auf einem entfernten System läuft, die PostgreSQL auf dem ioBroker System laufen muss.
Für Linuxsysteme gibt es [hier](https://www.postgresql.org/download/linux/debian/) eine Installationsanleitung.
Wer nicht nur eine Datenbank sichern will, kann die Option "Sicherung mehrerer Systeme" aktivieren und im Anschluss seine Datenbanken in der Tabelle definieren.
## Javascript-Backup
-Dieses separat einstellbare Backup wird sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig sofern bei den anderen IoBroker-Backup-Typen eingestellt.
+Dieses separat einstellbare Backup wird, sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig, sofern bei den anderen ioBroker-Backup-Typen eingestellt.
Ab ioBroker.backitup-Version 2.2.0 werden Skripte direkt aus den Objekten gesichert. Javascript-Backups aus älteren ioBroker.backitup-Version sind für einen Restore nicht kompatibel!!
-Um mit ioBroker.backitup-Versionen < 2.2.0 Javascript Sicherungen durchführen zu können, muss im Vorfeld in der Javascript-Adapter Konfiguration die Menüpunkte "Spiegeln von Skripten in den Dateipfad" und "Instanz, die Spiegelung macht" festgelegt werden.
-ioBroker.backitup kann dann im Konfiguartionsmenü die Einstellungen übernehmen.
+Um mit ioBroker.backitup-Versionen < 2.2.0 Javascript Sicherungen durchführen zu können, müssen im Vorfeld in der Javascript-Adapter Konfiguration die Menüpunkte "Spiegeln von Skripten in den Dateipfad" und "Instanz, die Spiegelung macht" festgelegt werden.
+ioBroker.backitup kann dann im Konfigurationsmenü die Einstellungen übernehmen.
## Jarvis-Backup
-Dieses separat einstellbare Backup wird sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig sofern bei den anderen IoBroker-Backup-Typen eingestellt.
+Dieses separat einstellbare Backup wird, sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig, sofern bei den anderen ioBroker-Backup-Typen eingestellt.
## Zigbee-Backup
-Dieses separat einstellbare Backup wird sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig sofern bei den anderen IoBroker-Backup-Typen eingestellt.
+Dieses separat einstellbare Backup wird, sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig, sofern bei den anderen ioBroker-Backup-Typen eingestellt.
## Zigbee2MQTT-Backup
-Dieses separat einstellbare Backup wird sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig sofern bei den anderen IoBroker-Backup-Typen eingestellt.
+Dieses separat einstellbare Backup wird, sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig, sofern bei den anderen ioBroker-Backup-Typen eingestellt.
Der Pfad im ioBroker.backitup Adapter sollte immer direkt auf den "data" Pfad von zigbee2mqtt angelegt werden.
Beispiel: `/opt/zigbee2mqtt/data` oder direkt in das Volume bei einer Docker Installation von zigbee2mqtt
@@ -239,95 +240,93 @@ Wichtig ist hier auch, dass der User "iobroker" Rechte für den data-Ordner beko
Gruppenrechte können wie folgt gesetzt werden:
```
-sudo usermod -a -G iobroker
+sudo usermod -a -G iobroker
sudo reboot
```
## Node-Red-Backup
-Dieses separat einstellbare Backup wird sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig sofern bei den anderen IoBroker-Backup-Typen eingestellt.
+Dieses separat einstellbare Backup wird, sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig, sofern bei den anderen ioBroker-Backup-Typen eingestellt.
## Grafana-Backup
-Dieses separat einstellbare Backup wird sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig sofern bei den anderen IoBroker-Backup-Typen eingestellt.
+Dieses separat einstellbare Backup wird, sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig, sofern bei den anderen ioBroker-Backup-Typen eingestellt.
**Um ein Grafana-Backup erstellen zu können, wird der Benutzername (Admin) und das Passwort von Grafana benötigt.**
**Des Weiteren muss in der Grafana-Weboberfläche ein API-Key bzw. Service Token erzeugt werden, um Zugriff auf die Dashboards zu bekommen.**
Der Api-Key kann unter ***"Configuration → API Keys bzw. Service Token"*** erstellt werden und muss die vollen Admin-Rechte besitzen.
## Yahka-Backup
-Dieses separat einstellbare Backup wird sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig sofern bei den anderen IoBroker-Backup-Typen eingestellt.
-Es werden alle Systemeinstellungen und Geräteeinstellungen von Homkit gesichert.
+Dieses separat einstellbare Backup wird, sofern es aktiviert ist, bei jedem Backup ioBroker erstellt und nach Ablauf der angegebenen Vorhaltezeit auch gelöscht. FTP oder CIFS sind für dieses Backup ebenfalls gültig, sofern bei den anderen ioBroker-Backup-Typen eingestellt.
+Es werden alle Systemeinstellungen und Geräteeinstellungen von Homekit gesichert.
-### [zurück](#Inhalt)
+### [zurück](#Inhalt)
---
# Speicher-Optionen
## CIFS
CIFS-Mount ist unter Linux kein Problem.
-Es sollte beachtet werden, dass cifs-utils installiert ist
+Es sollte beachtet werden, dass cifs-utils installiert ist.
Die Pfadangabe sollte wie folgt aussehen (Bsp: "/Freigabename/Pfadangabe")
-Optional kann man aktivieren/deaktivieren, ob die Backups vom NAS gelöscht werden sollen
+Optional kann man aktivieren/deaktivieren, ob die Backups vom NAS gelöscht werden sollen.
## NFS
NFS-Mount ist unter Linux kein Problem.
-Es sollte beachtet werden, dass nfs-common installiert ist
+Es sollte beachtet werden, dass nfs-common installiert ist.
Die Pfadangabe sollte wie folgt aussehen (Bsp: "/Freigabename/Pfadangabe").
-Optional kann man aktivieren/deaktivieren, ob die Backups vom NAS gelöscht werden sollen
+Optional kann man aktivieren/deaktivieren, ob die Backups vom NAS gelöscht werden sollen.
## FTP
-FTP ist auf allen OS möglich und dient als eine Alternative zum CIFS Mount
+FTP ist auf allen OS möglich und dient als eine Alternative zum CIFS Mount.
Die Pfadangabe unter FTP muss immer mit "/" beginnen (Bsp: "/Pfadangabe")
-Optional kann man aktivieren/deaktivieren, ob die Backups vom NAS gelöscht werden sollen
+Optional kann man aktivieren/deaktivieren, ob die Backups vom NAS gelöscht werden sollen.
## Copy
-Sollte kein CIFS-Mount möglich sein, besteht eine weitere Möglichkeit der Copy-Funktion
+Sollte kein CIFS-Mount möglich sein, besteht eine weitere Möglichkeit der Copy-Funktion.
Hier muss in den CIFS-Einstellungen die Pfadangabe eingetragen werden, wo hin kopiert werden soll.
Die Angabe der IP Adresse muss für die Copy-Funktion leer bleiben.
## Dropbox
Um die Sicherung in der Dropbox zu nutzen, muss man einen Access Token holen. Das kann man auf der Konfigurationsseite von ioBroker.backitup machen.
-ioBroker greift nur auf die definierte Bereiche.
-Keine Tokens oder Anwenderdaten werden in der Cloud gespeichert.
-
+ioBroker greift nur auf die definierte Bereiche zu, es werden keine Tokens oder Anwenderdaten in der Cloud gespeichert.
Wer seine eigene Dropbox API App erzeugen möchte, kann dies in den Einstellungen von ioBroker.backitup auswählen und muss im Anschluss folgende Schritte durchführen.
> Hinweis: Eigene Apps haben nur noch einen "short_live" Token, welcher lediglich 4 Stunden Gültigkeit hat. Wir empfehlen, die iobroker Standard App zu verwenden.
-Um die Sicherung in der Dropbox zu nutzen, muss ein Access Token und eine APP unter https://www.dropbox.com/developers/apps erstellt werden
+Um die Sicherung in der Dropbox zu nutzen, muss ein Access Token und eine APP unter https://www.dropbox.com/developers/apps erstellt werden:
* Schritt 1: Den Button "Create App" nutzen
* Schritt 2: "Scoped access" auswählen
* Schritt 3: "App folder" auswählen
* Schritt 4: "Name your app" vergeben und "Create App" Button wählen
-* Schritt 5: Im Tab-Reiter "Permissions" alle 4 Häckchen im Bereich "Files and folders" setzen
+* Schritt 5: Im Tab-Reiter "Permissions" alle 4 Häkchen im Bereich "Files and folders" setzen
* Schritt 6: Im Tab-Reiter "Settings" die "Access token expiration" auf "No expiration" stellen
-* Schritt 7: "Generated access token" Button drücken (Dieser erzeugte Token wird in den Einstellungen von ioBroker.backitup eingetragen)
-In deiner Dropbox gibt es nun einen neuen Ordner mit dem Namen "Apps"
+* Schritt 7: "Generated access token" Button drücken (Dieser erzeugte Token wird in den Einstellungen von ioBroker.backitup eingetragen)
+
+In deiner Dropbox gibt es nun einen neuen Ordner mit dem Namen "Apps".
## Google Drive
-Um die Sicherung in der Google Drive zu nutzen, muss man sich Access einen Token holen. Das kann man auf der Konfigurationsseite machen.
-ioBroker greift nur auf die definierten Bereiche. Den Code für oAuth kann man [hier](https://github.com/simatec/ioBroker.backitup/blob/master/docs/oAuthService.js) ansehen.
-Keine Tokens oder Anwenderdaten werden in der Cloud gespeichert.
+Um die Sicherung in der Google Drive zu nutzen, muss man sich einen Access-Token holen. Das kann man auf der Konfigurationsseite machen.
+ioBroker greift nur auf die definierten Bereiche zu. Den Code für oAuth kann man [hier](https://github.com/simatec/ioBroker.backitup/blob/master/docs/oAuthService.js) ansehen.
+Es werden keine Tokens oder Anwenderdaten in der Cloud gespeichert.
## Onedrive
Um die Sicherung in der Onedrive zu nutzen, muss man einen Access Token holen. Das kann man auf der Konfigurationsseite von ioBroker.backitup machen.
-ioBroker greift nur auf die definierte Bereiche.
-Keine Tokens oder Anwenderdaten werden in der Cloud gespeichert.
+ioBroker greift nur auf die definierte Bereiche zu, es werden keine Tokens oder Anwenderdaten in der Cloud gespeichert.
## WebDAV
-Mit WebDAV bietet ioBroker.backitup die Möglichkeit mehrere Cloudsysteme anzusprechen.
Die bekannteste ist hier NextCloud.
-Um eine WebDAV-Verbindung herzustellen, weren der Username und das Passwort des Cloud Accounts benötigt.
+Mit WebDAV bietet ioBroker.backitup die Möglichkeit, mehrere Cloudsysteme anzusprechen Die bekannteste ist hier NextCloud.
+Um eine WebDAV-Verbindung herzustellen, werden der Username und das Passwort des Cloud Accounts benötigt.
Die Verbindung zur Cloud erfolgt über eine verschlüsselte Verbindung.
Um eine Verbindung aufbauen zu können, muss der Hostname der Cloud alle Sicherheitszertifikate erfüllen.
> Beispiel URL: "https://example.com/remote.php/dav/files/username/"
Eine Verbindung mit lokaler IP-Adresse ist nur möglich, wenn die Option "Nur signierte Zertifikate zulassen" deaktiviert ist.
-### [zurück](#Inhalt)
+### [zurück](#Inhalt)
---
# Multihost Unterstützung
Multihost für ioBroker.backitup kann mit mehreren Instanzen von ioBroker.backitup auf verschiedenen Hosts arbeiten.
-Ein Instanz von ioBroker.backitup muss zur Unterstützung als Master konfiguriert. Alle weiteren Instanzen, die sich auf entfernten Hosts befinden, werden als Slave konfiguriert.
+Eine Instanz von ioBroker.backitup muss zur Unterstützung als Master konfiguriert werden. Alle weiteren Instanzen, die sich auf entfernten Hosts befinden, werden als Slave konfiguriert.
Das Management der automatischen Backups übernimmt der Master. Alle Slave Instanzen können im Master über das Menü ausgewählt werden.
Für die Slave Instanzen können folgende Backup-Optionen aktiviert werden:
* Redis
@@ -344,20 +343,24 @@ Für die Slave Instanzen können folgende Backup-Optionen aktiviert werden:
* Zigbee2MQTT
Da in einer Slave Instanz die automatischen Backups durch den Master geregelt werden, sind iobroker-Backups, Javascript-Backups und CCU-Backups nicht auswählbar.
-Die Speicherorte für die einzelnen Backups können auf jedem Slave frei konfiguriert werden. So kann jeder sein Dateiablagesystem unabhängig vom Master gestallten.
+Die Speicherorte für die einzelnen Backups können auf jedem Slave frei konfiguriert werden. So kann jeder sein Dateiablagesystem unabhängig vom Master gestalten.
-Bei Systemen mit begrenzten RAM kann der ioBroker.backitup Master die Slave Instanzen für den Backupprozess automatisch starten und im Anschluss wieder stoppen.
+Bei Systemen mit begrenztem RAM kann der ioBroker.backitup Master die Slave Instanzen für den Backupprozess automatisch starten und im Anschluss wieder stoppen.
Diese Option ist im Menü konfigurierbar.
-### [zurück](#Inhalt)
+### [zurück](#Inhalt)
---
# Docker Unterstützung
-Ab Version 2.2.0 wird das Backup und der Restore im offizielen Docker-Container unterstützt.
-Da im Docker keine Datenbanksysteme installiert werden sollten, werden Backups sämtlicher Datenbanken nicht unterstützt und sind bei einem erkannten Docker-Container nicht auswählbar.
-Die Unterstützung für ioBroker.backitup wird im offizielen iobroker Docker Container ab Version v5.2.0-beta4 unterstützt.
+Ab Version 2.2.0 wird das Backup und der Restore im offiziellen Docker-Container unterstützt.
+
+Da im Docker-Container keine Datenbanksysteme installiert werden sollten, werden Backups sämtlicher Datenbanken nicht unterstützt und sind bei einem erkannten Docker-Container im Standard nicht auswählbar. Um externe Datenbanken trotzdem sichern zu können, sind zwei Container-Umgebungsvariablen zu setzen:
+* IOB_BACKITUP_EXTDB=true
+* PACKAGES
-### [zurück](#Inhalt)
+Der Inhalt der Umgebungsvariable "PACKAGES" orientiert sich dabei an den zu installierenden Paketen, die für den Zugriff auf die jeweilige Datenbank notwendig sind. Beispiele wären "mysql-client" oder "redis-tools". Weitere Einzelheiten dazu sind [hier](https://docs.buanet.de/iobroker-docker-image/docs_backitup/) zu finden.
+
+### [zurück](#Inhalt)
---
# Verwendung
@@ -377,13 +380,12 @@ Die Unterstützung für ioBroker.backitup wird im offizielen iobroker Docker Con
* info.latestBackup -> zeigt als json das letzte beim Start ermittelte Backup
2. History-Log in Vis anzeigen
- - Es ist möglich den History-Log bspw. in einem Html-Widget durch eintragen folgender Zeile in HTML darzustellen:
+ - Es ist möglich, den History-Log bspw. in einem Html-Widget durch eintragen folgender Zeile in HTML darzustellen:
```
{backitup.0.history.html}
```
Syntax: {BackitupInstanz.history.html}
-
3. CCS-Formatierung des History-Logs:
```
.html{
@@ -405,21 +407,19 @@ Syntax: {BackitupInstanz.history.html}
}
```
4. OneClick-Button mit Status-Text
- - Wenn ein OneClick-Datenpunkt auf true gesetzt wird startet das entsprechende Backup und nach einer vordefinierten Zeit wird dieser Datenpunkt wieder auf false gesetzt somit ist es möglich einen Button mit Status zu erstellen, hierzu folgende Zeile anpassen und in Vis als Knopftext eintragen:
-
+ - Wenn ein OneClick-Datenpunkt auf true gesetzt wird, startet das entsprechende Backup und nach einer vordefinierten Zeit wird dieser Datenpunkt wieder auf false gesetzt. Somit ist es möglich, einen Button mit Status zu erstellen. Hierzu folgende Zeile anpassen und in Vis als Knopftext eintragen:
```
{wert: backitup.0.oneClick.iobroker; wert === "true" || wert === true ? "Minimal Backup wird erstellt" : "Minimal Backup starten"}
-
```
Syntax: {wert: .oneClick.; wert === "true" || wert === true ? "Text während der Backuperstellung" : "Standard-Text"}
-### [zurück](#Inhalt)
+### [zurück](#Inhalt)
---
# Benachichtigungen
ioBroker.backitup unterstützt für die Benachrichtigung nach einem erfolgreichen Backup folgende Messenger.
- Zur Verwendung müssen die jeweiligen Adapter installiert und eigerichtet sein.
+ Zur Verwendung müssen die jeweiligen Adapter installiert und eingerichtet sein.
* Telegram
* Pushover
@@ -429,12 +429,12 @@ Syntax: {wert: .oneClick.; wert === "true" ||
* Matrix
* Discord
-### [zurück](#Inhalt)
+### [zurück](#Inhalt)
---
# Restore
-Mit ioBroker.backitup ist es möglich, alle erzeugten Backup-Typen über das Konfiguartionsmenü im ioBroker auch wiederherzustellen.
+Mit ioBroker.backitup ist es möglich, alle erzeugten Backup-Typen über das Konfigurationsmenü im ioBroker auch wiederherzustellen.
ioBroker.backitup arbeitet sehr eng mit dem js-controller zusammen und erstellt ein iobroker Backup identisch dem CLI Befehl "iobroker backup".
Es werden hier identisch dem Standard Backup des js-controllers alle States und Objects, sowie die Nutzerdateien wie z.B. VIS gesichert.
@@ -442,82 +442,81 @@ Es werden hier identisch dem Standard Backup des js-controllers alle States und
Auch der Restore ist komplett identisch dem CLI Befehl des js-controllers.
Bei einem Restore werden alle States, Objects und Nutzerdaten von ioBroker.backitup wiederhergestellt.
-Nach dem Restore startet euer iobroker neu und ab da übernimmt die Installation fehlender Adapter dann wieder der js-controller.
+Nach dem Restore startet euer ioBroker neu und ab da übernimmt die Installation fehlender Adapter dann wieder der js-controller.
-ioBroker.backitup hat nach dem Start des iobrokers keinerlei Einfluss auf die Wiederherstellung. Dies passiert alles im Hintergrund und übernimmt der js-controller anhand der wiederhergestellten Informationen in den States und Objects.
+ioBroker.backitup hat nach dem Start des iobrokers keinerlei Einfluss auf die Wiederherstellung. Dies übernimmt der js-controller im Hintergrund anhand der wiederhergestellten Informationen in den States und Objects.
Es kann aus allen Speichermedien ein Restore ausgeführt werden.
**Grundsätzlich ist aber der sicherste Weg, den Restore lokal auszuführen.**
-Wer den sichersten Weg wählt und den Restore lokal ausführen möchte, muss die Backupdatei im iobroker Backup-Ordner ablegen.
+Wer den sichersten Weg wählt und den Restore lokal ausführen möchte, muss die Backupdatei im ioBroker Backup-Ordner ablegen.
Auf Linuxsystemen befindet sich dieser Ordner unter folgenden Pfad: `/opt/iobroker/backups`
-Bei den Backuptypen "iobroker" und "redis" wird beim Restore der iobroker gestoppt und im Anschluss automatisch wieder gestartet.
+Bei den Backuptypen "ioBroker" und "redis" wird beim Restore der ioBroker gestoppt und im Anschluss automatisch wieder gestartet.
Nach dem Stop des iobrokers öffnet sich ein neuer Browser-Tab, in dem der Verlauf des Restores zu sehen ist.
***Falls dieser Tab nicht öffnet, müssen die Browser-Einstellungen für Popups blockieren kontrolliert werden.***
-**Bei allen anderen Backuptypen wird iobroker nicht gestoppt. Hier werden lediglich die betroffnenen Adapter kurzzeitig gestoppt.**
+**Bei allen anderen Backuptypen wird ioBroker nicht gestoppt. Hier werden lediglich die betroffnenen Adapter kurzzeitig gestoppt.**
Wer seine Backups lieber manuell wiederherstellen möchte, sollte folgende Punkte durchführen:
-***Restore eines IoBroker Backups:***
+***Restore eines ioBroker Backups:***
- Das Backup muss wie gewohnt im Verzeichnis `opt/iobroker/backups` liegen
- Es kann über die Konsole mit Hilfe des Befehls: `iobroker restore ` wieder hergestellt werden.
- Nach dem Restore ist ein `iobroker upload all` nötig
-
Eine detailierte Anleitung zum Restore mit ioBroker.backitup und auch zum manuellen Restore ist [hier](https://forum.iobroker.net/topic/27271/howto-iobroker-restore-unter-linux-durchf%C3%BChren) zu finden.
**Das CCU-Backup muss weiterhin über das Webinterface der CCU wiederhergestellt werden.**
***Restore eines Raspberrymatic / CCU Backups:***
- - *.sbk Datei via SCP in das Verzeichnis „ /usr/local/tmp directory“ auf die Raspberrymatic kopieren
- - Über die Konsole als Root-User auf der Raspberrymatic einloggen
+ - *.sbk Datei via SCP in das Verzeichnis „/usr/local/tmp directory“ auf die Raspberrymatic kopieren
+ - Über die Konsole als Root-User auf der Raspberrymatic einloggen
- Den Befehl: „/bin/restoreBackup.sh /user/local/tmp/EuerBackupDateiname“ auf der Raspberrymatic ausführen.
- - Den Befehl:“reboot“ auf der Raspberrymatic ausführen um den PI neu zu starten
+ - Den Befehl: “reboot“ auf der Raspberrymatic ausführen um den PI neu zu starten
- Alternativ kann das Backup natürlich auch wie gewohnt über das Webinterface wieder hergestellt werden.
-### [zurück](#Inhalt)
+### [zurück](#Inhalt)
---
# Fehlersuche
- Um Fehler zu loggen, muss ioBroker.backitup in unter dem IoBroker Reiter Instanzen auf Log-Stufe "debug" gestellt werden.
-### [zurück](#Inhalt)
+ Um Fehler zu loggen, muss ioBroker.backitup in unter dem ioBroker Reiter "Instanzen" auf Log-Stufe "debug" gestellt werden.
+
+### [zurück](#Inhalt)
---
-# Aufgetretene Fehler / Lösungen:
-Hier eine Liste der bisher aufgetretenen Probleme und deren Lösungen sofern vorhanden.
+# Aufgetretene Fehler / Lösungen
-1. Olifall (aus dem Forum) hatte das Problem dass nach dem Restore das Webinterface des IoBrokers nicht mehr erreichbar war, durch folgende Schritte über die Konsole konnte er dies beheben:
+Hier eine Liste der bisher aufgetretenen Probleme und deren Lösungen (sofern vorhanden).
+
+1. Olifall (aus dem Forum) hatte das Problem, dass nach dem Restore das Webinterface des ioBrokers nicht mehr erreichbar war. Durch folgende Schritte über die Konsole konnte er dies beheben:
- sudo iobroker status
- Meldung = "No connection to states 127.0.0.0:6379[redis]"
- sudo apt install redis-server
2. Sollte der CIFS-Mount mit IP-Adresse nicht möglich sein, sollte der Hostname des NAS verwendet werden
-3. Wenn ihr beim cifs-mount ein Passwort mit Sonderzeichen verwendet, haben User festgestellt, dass dann das Passwort mit Anführungszeichen in der Config hinterlegt werden muss.
-4. cifs-mount kann laut einigen Usern mit sehr langen Passwörtern nicht umgehen. Falls der mount nicht klappen sollte, kürz das Passwort etwas ein (12 Zeichen sind funktionieren bei mir).
-5. Sollte der Adapter sich nicht installieren lassen, prüft eure Versionen von node und nodejs. Der Adapter unterstützt Versionen < Node 8 nicht.
-6. Wenn euer iobroker System mit dem neuen Installer Script installiert wurde, kann es vorkommen, dass ihr nicht alle Rechte für den neuen User iobroker habt.
+3. Wenn ihr beim CIFS-Mount ein Passwort mit Sonderzeichen verwendet, haben User festgestellt, dass dann das Passwort mit Anführungszeichen in der Config hinterlegt werden muss.
+4. CIFS-Mount kann laut einigen Usern nicht mit sehr langen Passwörtern umgehen. Falls der Mount nicht klappen sollte, kürzt das Passwort etwas ein (12 Zeichen funktionieren bei mir).
+5. Sollte sich der Adapter nicht installieren lassen, prüft eure Versionen von node und nodejs. Der Adapter unterstützt Versionen < Node 8 nicht.
+6. Wenn euer ioBroker System mit dem neuen Installer Script installiert wurde, kann es vorkommen, dass ihr nicht alle Rechte für den neuen User iobroker habt.
Dies betrifft dann leider auch backitup, da backitup einige systemrelevante Befehle benutzt.
- Um das Problem mit fehlenden Rechten zu beheben, gibt es inzwischen einen Fix für den Installerscript von iobroker.
- Führt bitte folgende Befehle auf eure Iobrokerumgebung in der Konsole aus:
-
+ Um das Problem mit fehlenden Rechten zu beheben, gibt es einen Fix für den Installerscript von ioBroker.
+ Führt bitte folgende Befehle auf eurer ioBroker-Umgebung in der Konsole aus:
```
iobroker stop
iobroker fix
sudo reboot
```
-7. Solltet Ihr eine Fehlermeldung beim erstellen der Redis Datenbank bekommen, prüft bitte, ob euer User iobroker die Rechte hat und ob er in der User-Gruppe Redis vorhanden ist.
- Wenn dies nicht der Fall ist, könnt ihr das mit folgenden Befehl in der Konsole beheben.
-
+7. Solltet Ihr eine Fehlermeldung beim Erstellen der Redis Datenbank bekommen, prüft bitte, ob euer User iobroker die Rechte hat und ob er in der User-Gruppe Redis vorhanden ist.
+ Wenn dies nicht der Fall ist, könnt ihr das mit folgendem Befehl in der Konsole beheben.
```
sudo usermod -a -G redis iobroker
sudo reboot
```
- Wenn ihr nicht mit dem Installerscript eure Iobroker Installation aufgesetzt habt und euer User einen anderen Namen hat, bitte in dem Befehl "iobroker" durch euren User ersetzen.
+ Wenn ihr eure ioBroker Installation nicht mit dem Installerscript aufgesetzt habt und euer User einen anderen Namen hat, bitte in dem Befehl "iobroker" durch euren User ersetzen.
8. Wenn eine Fritzbox als NAS mit einer Firmware >= 7.21 verwendet wird, sollten in ioBroker.backitup die SMB-Einstellungen auf "3.1.1" eingestellt und die Option "noserverino" aktiviert werden.
-### [zurück](#Inhalt)
----
+### [zurück](#Inhalt)
+---
\ No newline at end of file
diff --git a/docs/en/backitup.md b/docs/en/backitup.md
index 62ca83d9..7ef452cf 100644
--- a/docs/en/backitup.md
+++ b/docs/en/backitup.md
@@ -1,5 +1,5 @@
-# ioBroker.backitup
+# ioBroker.backitup
@@ -13,63 +13,67 @@
[](https://github.com/sponsors/simatec)
-
**If you like ioBroker.backitup, please consider making a donation:**
[](https://paypal.me/mk1676)
**************************************************************************************************************
-## Disclaimer
+## Disclaimer
**ioBroker.backitup is backup plugin only for the smart home software ioBroker.**
**Is it not affiliated with or endorsed by [Nero BackItUp](https://www.nero.com/deu/products/nero-backitup/?vlang=en) (a Tool backup under Windows-Systems).**
-**This personal project ioBroker.backitup is maintained in spare time and has no business goal.**
+**This personal project ioBroker.backitup is maintained in spare time and has no business goals.**
**************************************************************************************************************
-# Content
-* [Basic](#basic)
-* [Dependencies](#Dependencies)
-* [Use and operation](#Use-and-operation)
-* [Backup types](#Backup-types)
- * [ioBroker Backup](#ioBroker-Backup)
- * [CCU Backup (Homematic)](#CCU-Backup-(Homematic))
- * [Mysql-Backup](#Mysql-backup)
- * [Redis-Backup](#Redis-backup)
- * [InfluxDB-Backup](#InfluxDB-backup)
- * [PostgreSQL backup](#PostgreSQL-backup)
- * [Javascript-Backup](#Javascript-backup)
- * [Jarvis backup](#Jarvis-backup)
- * [Zigbee backup](#Zigbee-backup)
- * [Grafana backup](#Grafana-backup)
- * [Grafana backup](#Yahka-backup)
-* [Storage options](#Storage-options)
- * [CIFS](#CIFS)
- * [NFS](#NFS)
- * [FTP](#FTP)
- * [Copy](#Copy)
- * [Dropbox](#Dropbox)
- * [Google Drive](#Google-Drive)
- * [WebDAV](#WebDAV)
-* [Multihost support](#Multihost-support)
-* [Docker support](#Docker-support)
-* [Usage](#usage)
-* [Notifications](#notifications)
-* [Restore](#Restore)
-* [Troubleshooting](#troubleshooting)
-* [Errors / solutions encountered](#Errors-/-solutions-encountered)
+# Content
+- [Basics](#basics)
+- [Dependencies](#dependencies)
+- [Use and operation](#use-and-operation)
+- [Backup types](#backup-types)
+ - [ioBroker backup](#iobroker-backup)
+ - [CCU backup (Homematic)](#ccu-backup-homematic)
+ - [Mysql backup](#mysql-backup)
+ - [Sqlite3 backup](#sqlite3-backup)
+ - [Redis backup](#redis-backup)
+ - [History data backup](#history-data-backup)
+ - [InfluxDB backup](#influxdb-backup)
+ - [PostgreSQL backup](#postgresql-backup)
+ - [Javascript backup](#javascript-backup)
+ - [Jarvis backup](#jarvis-backup)
+ - [Zigbee backup](#zigbee-backup)
+ - [Zigbee2MQTT backup](#zigbee2mqtt-backup)
+ - [Node-Red-Backup](#node-red-backup)
+ - [Grafana backup](#grafana-backup)
+ - [Yahka backup](#yahka-backup)
+- [Storage options](#storage-options)
+ - [CIFS](#cifs)
+ - [NFS](#nfs)
+ - [FTP](#ftp)
+ - [Copy](#copy)
+ - [Dropbox](#dropbox)
+ - [Google Drive](#google-drive)
+ - [Onedrive](#onedrive)
+ - [WebDAV](#webdav)
+- [Multihost support](#multihost-support)
+- [Docker support](#docker-support)
+- [Use](#use)
+- [Notifications](#notifications)
+- [Restore](#restore)
+- [Troubleshooting](#troubleshooting)
+- [Errors / solutions encountered](#errors--solutions-encountered)
---
# Basics
-ioBroker.backitup is a backup solution with which the cyclical backup of an IoBroker installation and a Homematic CCU is possible.
+ioBroker.backitup is a backup solution with which the cyclical backup of an ioBroker installation and a Homematic CCU is possible.
The adapter is suitable for multi-platforms and can be used on Windows and Mac installations in addition to Linux installations.
Furthermore, there is the possibility to save various optional backups such as SQL databases, Influx databases and some adapter and device settings.
-ioBroker.backitup works very closely with the js-controller and creates an iobroker backup identical to the CLI command `iobroker backup`.
+ioBroker.backitup works very closely with the js-controller and creates an ioBroker backup identical to the CLI command `iobroker backup`.
All states and objects as well as the user files such as VIS are backed up here identically to the standard backup of the js-controller.
@@ -78,9 +82,9 @@ The restore is also completely identical to the CLI command `iobroker restore
---
# Dependencies
@@ -107,7 +111,7 @@ ioBroker.backitup has no effect whatsoever on the recovery after the iobroker ha
- [Installation instructions InfluxDB 2.x](https://docs.influxdata.com/influxdb/v2.1/install/)
- [Installation instructions Influx-CLI für 2.x](https://docs.influxdata.com/influxdb/v2.1/tools/influx-cli/?t=Linux)
-### [back](#Content)
+### [back](#Content)
---
# Use and operation
@@ -120,38 +124,37 @@ Information on the backups made is available there, backups can be made and the
-### [back](#Content)
+### [back](#Content)
---
# Backup types
-ioBroker.backitup offers a lot of possibilities to carry out different backup types cyclically or at the push of a button. By default, every backup is stored in the / opt / iobroker / backups / directory. Optionally, an FTP upload can be set up or, alternatively, a CIFS / NFS mount can be used.
+ioBroker.backitup offers a lot of possibilities to carry out different backup types cyclically or at the push of a button. By default, every backup is stored in the /opt/iobroker/backups/ directory. Optionally, an FTP upload can be set up or, alternatively, a CIFS / NFS mount can be used.
## ioBroker backup
-This backup corresponds to the backup contained in IoBroker which can be started in the console by calling `iobroker backup`. Only here it is carried out through the specified settings in the adapter configuration or the OneClick Backup widget without having to use the console.
+This backup corresponds to the backup contained in ioBroker which can be started in the console by calling `iobroker backup`. Only here it is carried out through the specified settings in the adapter configuration or the OneClick Backup widget without having to use the console.
## CCU backup (Homematic)
This backup offers the possibility to save 3 different variants of a Homematic installation (CCU-Original / pivCCU / Raspberrymatic). This backup can also be performed using the settings specified in the adapter configuration or the OneClick backup widget.
If you don't want to secure just one CCU, you can activate the "Securing multiple systems" option and then define your Homematic central units in the table.
## Mysql backup
-If activated, this separately adjustable backup is created with every ioBroker backup and is also deleted after the specified retention time has expired. FTP or CIFS are also valid for this backup if the other IoBroker backup types are set.
+If activated, this separately adjustable backup is created with every ioBroker backup and is also deleted after the specified retention time has expired. FTP or CIFS are also valid for this backup if the other ioBroker backup types are set.
It is important that even if the mysql server is running on a remote system, the mysqldump must run on the ioBroker system.
For Linux systems, the installation command would be as follows: `sudo apt install mysql-client` or under Debian `sudo apt install default-mysql-client` or for MariaDB-Systems `sudo apt install mariadb-client`.
If you don't want to back up just one database, you can activate the "Back up multiple systems" option and then define your databases in the table.
## Sqlite3 backup
-If it is activated, this separately adjustable backup is created with every backup ioBroker and also deleted after the specified retention time has expired. FTP or CIFS are also valid for this backup if set for the other IoBroker backup types.
+If it is activated, this separately adjustable backup is created with every backup ioBroker and also deleted after the specified retention time has expired. FTP or CIFS are also valid for this backup if set for the other ioBroker backup types.
Sqlite3 (`sudo apt install msqlite3`) must be installed on the host system.
## Redis backup
-If activated, this separately adjustable backup is created with every ioBroker backup and deleted after the specified retention period has expired. FTP or CIFS are also valid for this backup provided the other IoBroker backup types are set.
+If activated, this separately adjustable backup is created with every ioBroker backup and deleted after the specified retention period has expired. FTP or CIFS are also valid for this backup provided the other ioBroker backup types are set.
To use Redis with ioBroker.backitup, the rights for the iobroker user should be adjusted:
```
sudo usermod -a -G redis iobroker
sudo reboot
```
-
-For a remote backup, redis-cli is required on the local iobroker system.
+For a remote backup, redis-cli is required on the local ioBroker system.
`sudo apt install redis-tools`
@@ -160,11 +163,8 @@ Here you have to enter your host and port of the remote Redis server and the log
This is an important feature, especially for Docker users.
-Please note that a Redis restore for remote systems is not possible via the backup GUI.
-Redis does not support this.
-Here the dump.rdb contained in the tar.gz archive must be restored manually.
-
-To do this, the backup archive must be unpacked, the file copied to the Redis directory and the rights for the dump.rdb adjusted.
+Please note that a Redis restore for remote systems is not possible via the backup GUI.Redis does not support this.
+Here the dump.rdb contained in the tar.gz archive must be restored manually. To do this, the backup archive must be unpacked, the file copied to the Redis directory and the rights for the dump.rdb adjusted.
Here's an example:
```
@@ -173,12 +173,11 @@ sudo chown redis:redis /var/lib/redis/dump.rdb
redis-cli shutdown nosave
```
-
## History data backup
-If activated, this separately adjustable backup is created with every ioBroker backup and deleted after the specified retention period has expired. FTP or CIFS are also valid for this backup, provided that the other IoBroker backup types are set.
+If activated, this separately adjustable backup is created with every ioBroker backup and deleted after the specified retention period has expired. FTP or CIFS are also valid for this backup, provided that the other ioBroker backup types are set.
## InfluxDB backup
-If activated, this separately adjustable backup is created with every ioBroker backup and deleted after the specified retention period has expired. FTP or CIFS are also valid for this backup if the other IoBroker backup types are set.
+If activated, this separately adjustable backup is created with every ioBroker backup and deleted after the specified retention period has expired. FTP or CIFS are also valid for this backup if the other ioBroker backup types are set.
**Requirements for a remote backup with InfluxDB v1.x:**
Some adjustments are necessary for the remote backup under InfluxDB 1.x.
@@ -198,12 +197,13 @@ bind-address = "0.0.0.0:8088"
**After changing the configuration, the InfluxDB service must be restarted.**
Further information on the data backup of the InfluxDB can be found [here] (https://docs.influxdata.com/influxdb/v1.8/administration/backup_and_restore/#online-backup-and-restore-for-influxdb-oss).
+
**Requirements for a backup with InfluxDB v2.x:**
In order to be able to create a backup of an InfluxDB 2.x, Influx-CLI must be installed on your system.
This is required for both a local and remote backup.
-For a remote backup, Influx-CLI must be installed on the system on which your iobroker is also running.
+For a remote backup, Influx-CLI must be installed on the system on which your ioBroker is also running.
On the remote system where your database is working, installation for backup is not required.
Here you will find the official instructions on how to install Influx-CLI on your system.
@@ -213,28 +213,25 @@ Here you will find the official instructions on how to install Influx-CLI on you
If you don't just want to back up one database, you can activate the "Backup of multiple systems" option and then define your databases in the table.
## PostgreSQL backup
-If activated, this separately adjustable backup is created with every ioBroker backup and deleted after the specified retention period has expired. FTP or CIFS are also valid for this backup if the other IoBroker backup types are set.
+If activated, this separately adjustable backup is created with every ioBroker backup and deleted after the specified retention period has expired. FTP or CIFS are also valid for this backup if the other ioBroker backup types are set.
What is important here is that even if the PostgreSQL server is running on a remote system, PostgreSQL must run on the ioBroker system / debian /) an installation guide.
If you don't want to back up just one database, you can activate the "Back up multiple systems" option and then define your databases in the table.
## Javascript backup
-If activated, this separately adjustable backup is created with every ioBroker backup and is also deleted after the specified retention period has expired. FTP or CIFS are also valid for this backup if the other IoBroker backup types are set.
-As of ioBroker.backitup version 2.2.0, scripts are saved directly from the objects. Javascript backups from older backup versions are not compatible for a restore !!
+If activated, this separately adjustable backup is created with every ioBroker backup and is also deleted after the specified retention period has expired. FTP or CIFS are also valid for this backup if the other ioBroker backup types are set.
+As of ioBroker.backitup version 2.2.0, scripts are saved directly from the objects. Javascript backups from older backup versions are not compatible for a restore!!
In order to be able to carry out JavaScript backups with ioBroker.backitup versions <2.2.0, the menu items "Mirroring scripts in the file path" and "Instance that makes the mirroring" must be specified in advance in the Javascript adapter configuration.
ioBroker.backitup can then take over the settings in the configuration menu.
## Jarvis backup
-If activated, this separately adjustable backup is created with every ioBroker backup and deleted after the specified retention period has expired. FTP or CIFS are also valid for this backup if the other IoBroker backup types are set.
+If activated, this separately adjustable backup is created with every ioBroker backup and deleted after the specified retention period has expired. FTP or CIFS are also valid for this backup if the other ioBroker backup types are set.
## Zigbee backup
-If activated, this separately adjustable backup is created with every ioBroker backup and deleted after the specified retention period has expired. FTP or CIFS are also valid for this backup, provided that the other IoBroker backup types are set.
+If activated, this separately adjustable backup is created with every ioBroker backup and deleted after the specified retention period has expired. FTP or CIFS are also valid for this backup, provided that the other ioBroker backup types are set.
## Zigbee2MQTT backup
This backup, which can be set separately, is created with every backup ioBroker if it is activated and is also deleted after the specified retention time has expired. FTP or CIFS are also valid for this backup if set for the other IoBroker backup types.
-## Node-Red-Backup
-This backup, which can be set separately, is created with every backup ioBroker if it is activated and is also deleted after the specified retention time has expired. FTP or CIFS are also valid for this backup if set for the other IoBroker backup types.
-
The path in the ioBroker.backitup adapter should always be created directly to the `data` path of zigbee2mqtt.
Example: `/opt/zigbee2mqtt/data` or directly into the volume of a Docker installation of zigbee2mqtt.
@@ -247,6 +244,9 @@ sudo usermod -a -G iobroker
sudo reboot
```
+## Node-Red-Backup
+This backup, which can be set separately, is created with every backup ioBroker if it is activated and is also deleted after the specified retention time has expired. FTP or CIFS are also valid for this backup if set for the other ioBroker backup types.
+
## Grafana backup
If activated, this separately adjustable backup is created with every ioBroker backup and deleted after the specified retention period has expired. FTP or CIFS are also valid for this backup if the other IoBroker backup types are set.
**In order to be able to create a Grafana backup, the Grafana username (Admin) and password are required.**
@@ -254,46 +254,44 @@ If activated, this separately adjustable backup is created with every ioBroker b
The API key can be created under ***"Configuration → API Keys or Service Token"*** and must have full admin permissions.
## Yahka backup
-If activated, this separately adjustable backup is created with every ioBroker backup and is also deleted after the specified retention period has expired. FTP or CIFS are also valid for this backup if the other IoBroker backup types are set.
-All system settings and device settings from Homkit are saved.
+If activated, this separately adjustable backup is created with every ioBroker backup and is also deleted after the specified retention period has expired. FTP or CIFS are also valid for this backup if the other ioBroker backup types are set.
+All system settings and device settings from Homekit are saved.
-### [back](#Content)
+### [back](#Content)
---
# Storage options
## CIFS
CIFS mount is no problem under Linux.
-It should be noted that cifs-utils is installed
+It should be noted that cifs-utils is installed.
-The path specification should look like this (example: "/ share name / path specification")
+The path specification should look like this (example: "/share name/path specification")
You can optionally activate / deactivate whether the backups should be deleted from the NAS
## NFS
NFS mount is no problem under Linux.
-It should be noted that nfs-common is installed
-The path specification should look like this (example: "/ share name / path specification").
+It should be noted that nfs-common is installed.
+The path specification should look like this (example: "/share name/path specification").
You can optionally activate / deactivate whether the backups should be deleted from the NAS
## FTP
-FTP is possible on all OS and serves as an alternative to the CIFS Mount
-The path specification under FTP must always begin with "/" (example: "/ path specification")
+FTP is possible on all OS and serves as an alternative to the CIFS Mount.
+The path specification under FTP must always begin with "/" (example: "/path specification")
You can optionally activate / deactivate whether the backups should be deleted from the NAS
## Copy
-If a CIFS mount is not possible, there is another possibility of the copy function
+If a CIFS mount is not possible, there is another possibility of the copy function.
Here in the CIFS settings the path must be entered where the copy is to be made.
The specification of the IP address must remain empty for the copy function.
## Dropbox
In order to use the backup in Dropbox, you have to get an access token. This can be done on the ioBroker.backitup configuration page.
-ioBroker only accesses the defined areas.
-No tokens or user data are stored in the cloud.
-
+ioBroker only accesses the defined areas. No tokens or user data are stored in the cloud.
If you want to create your own Dropbox API app, you can select this in the ioBroker.backitup settings and then have to carry out the following steps.
-> Note: Own apps only have a "short_live" token, which is only valid for 4 hours. We recommend using the iobroker standard app.
+> Note: Own apps only have a "short_live" token, which is only valid for 4 hours. We recommend using the ioBroker standard app.
To use the backup in Dropbox, an access token and an APP must be created at https://www.dropbox.com/developers/apps
* Step 1: Use the "Create App" button
@@ -302,29 +300,28 @@ To use the backup in Dropbox, an access token and an APP must be created at http
* Step 4: Enter "Name your app" and select "Create App" button
* Step 5: In the "Permissions" tab, check all 4 boxes in the "Files and folders" area
* Step 6: In the "Settings" tab, set the "Access token expiration" to "No expiration".
-* Step 7: Press "Generated access token" button (This generated token is entered in the settings of ioBroker.backitup)
-In your Dropbox there is now a new folder called "Apps"
+* Step 7: Press "Generated access token" button (This generated token is entered in the settings of ioBroker.backitup)
+
+In your Dropbox there is now a new folder called "Apps".
-## GoogleDrive
+## Google Drive
In order to use the backup in the Google Drive, you have to get an Access token. You can do that on the configuration page.
ioBroker only accesses the defined areas. The code for oAuth can be viewed [here](https://github.com/simatec/ioBroker.backitup/blob/master/docs/oAuthService.js).
No tokens or user data are stored in the cloud.
## Onedrive
In order to use the backup in the Onedrive, you have to get an access token. This can be done on the configuration page of ioBroker.backitup.
-ioBroker only accesses the defined areas.
-No tokens or user data are stored in the cloud.
+ioBroker only accesses the defined areas. No tokens or user data are stored in the cloud.
## WebDAV
-With WebDAV, ioBroker.backitup offers the possibility to address several cloud systems.
The best known is NextCloud.
+With WebDAV, ioBroker.backitup offers the possibility to address several cloud systems. The best known is NextCloud.
To establish a WebDAV connection, the username and password of the cloud account are required.
The connection to the cloud is made via an encrypted connection.
In order to be able to establish a connection, the host name of the cloud must meet all security certificates.
-A connection with a local IP address is not possible because it does not contain any Lets Encrypt certificates.
> Example URL: "https://example.com/remote.php/dav/files/username/"
A connection with a local IP address is only possible if the option "Only allow signed certificates" is deactivated.
-### [back](#Content)
+### [back](#Content)
---
# Multihost support
@@ -351,15 +348,19 @@ The storage locations for the individual backups can be freely configured on eac
In systems with limited RAM, the backup master can automatically start the slave instances for the backup process and then stop them again.
This option can be configured in the menu.
-### [back](#Content)
+### [back](#Content)
---
# Docker support
-As of version 2.2.0, backup and restore are supported in the official Docker container.
-Since no database systems should be installed in Docker, backups of all databases are not supported and cannot be selected when a Docker container is detected.
-The support for ioBroker.backitup is supported in the official iobroker Docker Container from version v5.2.0-beta4.
+As of version 2.2.0, backup and restore are supported in the official Docker container.
+
+Since no database systems should be installed in the Docker container, backups of all databases are not supported and cannot be selected in a recognised Docker container by default. To be able to back up external databases anyway, two container environment variables must be set:
+* IOB_BACKITUP_EXTDB=true
+* PACKAGES
+
+The content of the environment variable "PACKAGES" is based on the packages to be installed, which are necessary for access to the respective database. Examples would be "mysql-client" or "redis-tools". Further details can be found [here](https://docs.buanet.de/iobroker-docker-image/docs_backitup/).
-### [back](#Content)
+### [back](#Content)
---
# Use
@@ -380,13 +381,11 @@ The support for ioBroker.backitup is supported in the official iobroker Docker C
2. Show history log in Vis
- It is possible to display the history log e.g. in an HTML widget by entering the following line in HTML:
-
```
{backitup.0.history.html}
```
Syntax: {BackitupInstance.history.html}
-
3. CCS formatting of the history log
```
.html{
@@ -411,11 +410,11 @@ Syntax: {BackitupInstance.history.html}
- If a OneClick data point is set to true the corresponding backup starts and after a predefined time this data point is set to false again so it is possible to create a button with status, adjust the following line and enter it in Vis as button text:
```
{value: backitup.0.oneClick.iobroker; value === "true" || value === true ? "iobroker Backup will be created" : "iobroker Backup starten"}
-
```
+
Syntax: {value: .oneClick.; value ==="true" || value === true ? "Text during backup creation" : "Standard text"}
-### [back](#Content)
+### [back](#Content)
---
# Notifications
@@ -430,7 +429,7 @@ Syntax: {value: .oneClick.; value ==="true" || value
* Matrix
* Discord
-### [back](#Content)
+### [back](#Content)
---
# Restore
@@ -447,81 +446,77 @@ After the restore, your iobroker restarts and from there the js-controller takes
ioBroker.backitup has no effect whatsoever on the recovery after the iobroker has started. This all happens in the background and the js-controller takes over based on the restored information in the States and Objects.
-
A restore can be carried out from all storage media.
-** Basically, however, the safest way is to execute the restore locally. **
-If you choose the safest way and want to do the restore locally, you have to store the backup file in the iobroker backup folder.
+**Basically, however, the safest way is to execute the restore locally.**
+If you choose the safest way and want to do the restore locally, you have to store the backup file in the ioBroker backup folder.
On Linux systems this folder is located under the following path: `/opt/iobroker/backups`
-With the backup types "iobroker" and "redis", the iobroker is stopped during the restore and then restarted automatically.
-After stopping the iobroker, a new browser tab opens showing the progress of the restore.
+With the backup types "ioBroker" and "redis", the ioBroker is stopped during the restore and then restarted automatically.
+After stopping the ioBroker, a new browser tab opens showing the progress of the restore.
***If this tab does not open, the browser settings for block popups must be checked.***
-**iobroker is not stopped with all other backup types. Here only the affected adapters are temporarily stopped.**
+**ioBroker is not stopped with all other backup types. Here only the affected adapters are temporarily stopped.**
If you prefer to restore your backups manually, you should do the following:
-***Restore an IoBroker backup:***
+***Restore an ioBroker backup:***
- As usual, the backup must be in the directory `opt/iobroker/backups`
- It can be restored via the console using the command: `iobroker restore `.
- After the restore an `iobroker upload all` is necessary
-
Detailed instructions for restoring with Backup and also for manual restoring can be found [here] (https://forum.iobroker.net/topic/27271/howto-iobroker-restore-unter-linux-durchf%C3%BChren).
**The CCU backup must still be restored via the CCU's web interface.**
***Restore a Raspberrymatic / CCU backup:***
- - Copy the * .sbk file via SCP into the directory "/usr/local/tmp directory" on the Raspberrymatic
+ - Copy the * .sbk file via SCP into the directory "/usr/local/tmp" directory on the Raspberrymatic
- Log in to the Raspberrymatic as a root user via the console
- - Execute the command: “/bin/restoreBackup.sh /user/local/tmp / EuerBackupDateiname” on the Raspberrymatic.
+ - Execute the command: “/bin/restoreBackup.sh /user/local/tmp/BackupFileName” on the Raspberrymatic.
- Execute the command: “reboot“ on the Raspberrymatic to restart the PI
- Alternatively, the backup can of course also be restored as usual via the web interface.
-### [back](#Content)
+### [back](#Content)
---
-# Troubleshooting:
+# Troubleshooting
-In order to make mistakes, ioBroker.backitup must be set to log level "debug" in the IoBroker rider instances
+To log errors, ioBroker.backitup must be set to log level "debug" under the ioBroker tab "Instances".
-### [back](#Content)
+### [back](#Content)
---
# Errors / solutions encountered
Here is a list of the problems that have occurred so far and their solutions, if any.
-1.Olifall (from the forum) had the problem that the web interface of the IoBroker was no longer accessible after the restore, he was able to fix this by taking the following steps on the console:
+1.Olifall (from the forum) had the problem that the web interface of the ioBroker was no longer accessible after the restore, he was able to fix this by taking the following steps on the console:
- sudo iobroker status
- Message = "No connection to states 127.0.0.0:6379[redis]"
- sudo apt install redis-server
2. If the CIFS mount with IP address is not possible, the host name of the NAS should be used
-3. If you use a password with special characters for the cifs-mount, users have found that the password must then be stored in the config with quotation marks.
-4. According to some users, cifs-mount cannot handle very long passwords. If the mount doesn't work, shorten the password a little (12 characters work for me).
+3. If you use a password with special characters for the CIFS mount, users have found that the password must then be stored in the config with quotation marks.
+4. According to some users, CIFS mount cannot handle very long passwords. If the mount doesn't work, shorten the password a little (12 characters work for me).
5. If the adapter cannot be installed, check your versions of node and nodejs. The adapter does not support versions = 7.21, the SMB settings should be set to "3.1.1" in ioBroker.backitup and the "noserverino" option should be activated.
-### [back](#Content)
+### [back](#Content)
---
\ No newline at end of file
From 1a09a69f1b047a7b1731af5873997177ab381488 Mon Sep 17 00:00:00 2001
From: Marc Berg <99531337+Marc-Berg@users.noreply.github.com>
Date: Fri, 8 Sep 2023 14:13:23 +0200
Subject: [PATCH 2/5] Create publish_docs_to_wiki.yml
---
.github/workflows/publish_docs_to_wiki.yml | 45 ++++++++++++++++++++++
1 file changed, 45 insertions(+)
create mode 100644 .github/workflows/publish_docs_to_wiki.yml
diff --git a/.github/workflows/publish_docs_to_wiki.yml b/.github/workflows/publish_docs_to_wiki.yml
new file mode 100644
index 00000000..45a89801
--- /dev/null
+++ b/.github/workflows/publish_docs_to_wiki.yml
@@ -0,0 +1,45 @@
+name: Publish docs to Wiki
+
+# Trigger this action only if there are changes pushed to the docs/** directory under the main branch
+on:
+ push:
+ paths:
+ - docs/** # This includes all sub folders
+ branches:
+ - main # This can be changed to any branch of your preference
+
+env:
+ USER_TOKEN: ${{ secrets.WIKI_ACTION_TOKEN }} # This is the repository secret
+ USER_NAME: # Enter the username of your (bot) account
+ USER_EMAIL: # Enter the e-mail of your (bot) account
+ OWNER: ${{ github.event.repository.owner.name }} # This is the repository owner
+ REPOSITORY_NAME: ${{ github.event.repository.name }} # This is the repository name
+
+jobs:
+ publish_docs_to_wiki:
+ name: Publish docs to Wiki
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout repository
+ - uses: actions/checkout@v2
+
+ # 1. Create folder named `tmp_wiki`
+ # 2. Initialize Git
+ # 3. Pull old Wiki content
+ - name: Pull content from wiki
+ run: |
+ mkdir tmp_wiki
+ cd tmp_wiki
+ git init
+ git config user.name $USER_NAME
+ git config user.email $USER_EMAIL
+ git pull https://$USER_TOKEN@github.com/$OWNER/$REPOSITORY_NAME.wiki.git
+ # 4. Synchronize differences between `docs` & `tmp_wiki`
+ # 5. Push new Wiki content
+ - name: Push content to wiki
+ run: |
+ rsync -av --delete docs/ tmp_wiki/ --exclude .git
+ cd tmp_wiki
+ git add .
+ git commit -m "Update Wiki content"
+ git push -f --set-upstream https://$USER_TOKEN@github.com/$OWNER/$REPOSITORY_NAME.wiki.git master
From 5fd9864de9b4bd74c26c8226562bc89dc702d92b Mon Sep 17 00:00:00 2001
From: Marc Berg <99531337+Marc-Berg@users.noreply.github.com>
Date: Fri, 8 Sep 2023 14:15:19 +0200
Subject: [PATCH 3/5] Update backitup.md
---
docs/de/backitup.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/de/backitup.md b/docs/de/backitup.md
index 01cf7858..73f31fca 100644
--- a/docs/de/backitup.md
+++ b/docs/de/backitup.md
@@ -519,4 +519,4 @@ Hier eine Liste der bisher aufgetretenen Probleme und deren Lösungen (sofern vo
8. Wenn eine Fritzbox als NAS mit einer Firmware >= 7.21 verwendet wird, sollten in ioBroker.backitup die SMB-Einstellungen auf "3.1.1" eingestellt und die Option "noserverino" aktiviert werden.
### [zurück](#Inhalt)
----
\ No newline at end of file
+---
From f8c7797caa5013e36039b92d04aba7696cf5fa67 Mon Sep 17 00:00:00 2001
From: Marc Berg <99531337+Marc-Berg@users.noreply.github.com>
Date: Fri, 8 Sep 2023 14:31:04 +0200
Subject: [PATCH 4/5] Delete .github/workflows/publish_docs_to_wiki.yml
---
.github/workflows/publish_docs_to_wiki.yml | 45 ----------------------
1 file changed, 45 deletions(-)
delete mode 100644 .github/workflows/publish_docs_to_wiki.yml
diff --git a/.github/workflows/publish_docs_to_wiki.yml b/.github/workflows/publish_docs_to_wiki.yml
deleted file mode 100644
index 45a89801..00000000
--- a/.github/workflows/publish_docs_to_wiki.yml
+++ /dev/null
@@ -1,45 +0,0 @@
-name: Publish docs to Wiki
-
-# Trigger this action only if there are changes pushed to the docs/** directory under the main branch
-on:
- push:
- paths:
- - docs/** # This includes all sub folders
- branches:
- - main # This can be changed to any branch of your preference
-
-env:
- USER_TOKEN: ${{ secrets.WIKI_ACTION_TOKEN }} # This is the repository secret
- USER_NAME: # Enter the username of your (bot) account
- USER_EMAIL: # Enter the e-mail of your (bot) account
- OWNER: ${{ github.event.repository.owner.name }} # This is the repository owner
- REPOSITORY_NAME: ${{ github.event.repository.name }} # This is the repository name
-
-jobs:
- publish_docs_to_wiki:
- name: Publish docs to Wiki
- runs-on: ubuntu-latest
- steps:
- - name: Checkout repository
- - uses: actions/checkout@v2
-
- # 1. Create folder named `tmp_wiki`
- # 2. Initialize Git
- # 3. Pull old Wiki content
- - name: Pull content from wiki
- run: |
- mkdir tmp_wiki
- cd tmp_wiki
- git init
- git config user.name $USER_NAME
- git config user.email $USER_EMAIL
- git pull https://$USER_TOKEN@github.com/$OWNER/$REPOSITORY_NAME.wiki.git
- # 4. Synchronize differences between `docs` & `tmp_wiki`
- # 5. Push new Wiki content
- - name: Push content to wiki
- run: |
- rsync -av --delete docs/ tmp_wiki/ --exclude .git
- cd tmp_wiki
- git add .
- git commit -m "Update Wiki content"
- git push -f --set-upstream https://$USER_TOKEN@github.com/$OWNER/$REPOSITORY_NAME.wiki.git master
From f84a91d313952b84965d62242b99fb7ac5a11d97 Mon Sep 17 00:00:00 2001
From: Marc Berg <99531337+Marc-Berg@users.noreply.github.com>
Date: Sat, 9 Sep 2023 14:46:54 +0200
Subject: [PATCH 5/5] Revert "Update backitup.md"
This reverts commit 5fd9864de9b4bd74c26c8226562bc89dc702d92b.
---
docs/de/backitup.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/de/backitup.md b/docs/de/backitup.md
index 73f31fca..01cf7858 100644
--- a/docs/de/backitup.md
+++ b/docs/de/backitup.md
@@ -519,4 +519,4 @@ Hier eine Liste der bisher aufgetretenen Probleme und deren Lösungen (sofern vo
8. Wenn eine Fritzbox als NAS mit einer Firmware >= 7.21 verwendet wird, sollten in ioBroker.backitup die SMB-Einstellungen auf "3.1.1" eingestellt und die Option "noserverino" aktiviert werden.
### [zurück](#Inhalt)
----
+---
\ No newline at end of file