Jarss ausführen

jarss Backup-Auftrag ausführen

Nachdem alle notwendigen Einträge in der Konfigurationsdatei vorgenommen wurden, kann der Backup-Auftrag ausgeführt werden. Hierzu gibt es zwei Möglichkeiten. Zum einen kann der Auftrag direkt über eine Terminalsitzung auf dem Synology NAS ausgeführt werden, zum anderen steht der Weg über den DSM Taskplaner zur Verfügung.

Ausführung über das Terminal

Stelle mit einem Terminalprogramm deiner Wahl eine SSH-Verbindung zu deinem Synology NAS her. Obwohl jarss vorzugsweise vom Systembenutzer root ausgeführt werden sollte, ist die Ausführung als Benutzer der Administratorengruppe (administrators) möglich, wenn auch mit einigen Einschränkungen. Im Zweifelsfall sollte immer der Systembenutzer root verwendet werden.

Bevor du mit der Ausführung beginnst, musst du dem Script jarss.sh noch Ausführungsrechte geben. Wechsel dazu in das Verzeichnis, in dem sich das Skript jarss.sh befindet und führe folgenden Befehl aus

chmod +x jarss.sh

Der eigentliche Aufruf des Skripts erfolgt am besten, indem man den absoluten Pfad, also den Verzeichnispfad, in dem sich das Skript jarss.sh befindet, voranstellt, wobei auch der relative Pfad genügt, wenn man sich selbst im selben Verzeichnis wie das Skript und die Konfigurationsdatei(en) befindet. Es folgen weitere obligatorische und optionale Optionen, die weiter unten beschrieben werden.

Hinweis: Text in Großbuchstaben innerhalb eckiger Klammern dient als Platzhalter und muss einschließlich der eckigen Klammern durch eigene Angaben ersetzt werden.

Syntax:

bash /[ABSOLUTER-PFAD]/jarss.sh --job-name="[DATEINAME]" [--info=progress2] [--dry-run] [-v] [-vv] [-vvv]

Optionen:

Obligatorische Optionen
/[ABSOLUTER-PFAD]/jarss.sh	Hier muss anstelle des Platzhalters [ABSOLUTER-PFAD], der absolute Pfad zu dem Verzeichnis angegeben werden, indem sich das Script jarss.sh befindet. Beispiel: /volume1/backups/jarss.sh
--job-name="[DATEINAME]"	Hier muss anstelle der Platzhalters [DATEINAME] der Dateiname des auszuführenden Auftrages bzw. der auszuführenden Konfigurationsdatei eingetragen. Beispiel: --job-name="jarss_Konfiguration_GER"
Optionale Optionen
--info=progress2	Zeigt Informationen über den Gesamtfortschritt der Dateiübertragung an.
--dry-run	Rsync simuliert nur was passieren würde, ohne das dabei Daten kopiert
-v	Kurzes rsync Protokoll, welche Dateien übertragen werden.
-vv	Erweitertes rsync Protokoll, welche Dateien übersprungen werden.
-vvv	Sehr umfangreiches rsync Protokoll zum debuggen

Beispiel:

bash /volume1/backups/jarss.sh --job-name="jarss_Backup_Homes-Verzeichnis" --dry-run

Es wird empfohlen, vor der ersten Ausführung des Auftrags einen Testlauf durchzuführen, um sicherzustellen, dass alles korrekt abläuft. Dies wird durch die Option --dry-run erreicht. Es wird also nur simuliert, was passieren würde, ohne dass Daten kopiert werden. Erst wenn die Simulation erfolgreich und zufriedenstellend verlaufen ist, kann die Option --dry-run wieder entfernt werden. Während der Ausführung werden alle relevanten Informationen zum einen im Terminalfenster angezeigt, zum anderen wird ein Protokoll geschrieben, das am gleichen Speicherort abgelegt wird, an dem sich auch das Skript jarss.sh und die ausgeführte Konfigurationsdatei befinden. Du erkennst das Protokoll an am Namen des Auftrages und der Dateiendung .log

Ausführung über den DSM Aufgabenplaner

• Öffne im DSM unter Hauptmenü > Systemsteuerung den Aufgabenplaner.
• Wähle im Aufgabenplaner über die Schaltfläche Erstellen > Geplante Aufgabe > Benutzerdefiniertes Script aus.
• In dem sich öffnenden Popup-Fenster gibst du der Aufgabe im Register Allgemein > Allgemeine Einstellungen einen individuellen Namen und wählst als Benutzer root aus. Wenn die Aufgabe später automatisch gestartet werden soll, stelle sicher, dass das Kontrollkästchen Aktiviert angehakt ist.
• Füge im Register Aufgabeneinstellungen > Befehl ausführen > Benutzerdefiniertes Script den Befehl in das Textfeld ein, wie im Abschnitt "Ausführung über das Terminal" davor bereits beschrieben wurde.

• Bestätige deine Eingaben mit die Schaltfläche OK und akzeptiere die anschließende Warnmeldung ebenfalls mit OK.
• Damit die Aufgabe dem Aufgabenplaner hinzugefügt wird, musst du abschließend das Passwort deines aktuell am DSM angemeldeten Benutzers eingeben und den Vorgang über die Schaltfläche Senden bestätigen.
• In der Übersicht des Aufgabenplaners musst du nun die grade erstellte Aufgabe mit der Maus markieren, die Zeile sollte nach dem Markieren blau hinterlegt sein).
• Führe die Aufgabe nun durch Betätigen der Schaltfläche Ausführen einmalig aus, um zu sehen, ob alles erfolgreich und zufriedenstellend ausgeführt wurde. Schau dir das Ergebnis im Protokoll an, das am gleichen Speicherort abgelegt wurde, an dem sich auch das Skript jarss.sh und die ausgeführte Konfigurationsdatei befinden. Du erkennst das Protokoll an am Namen des Auftrages und der Dateiendung .log