Quelltext der Seite Jarss ausführen

__TOC__
== 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<syntaxhighlight lang="shell">
chmod +x jarss.sh
</syntaxhighlight>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.<blockquote>'''Hinweis:''' Text in Großbuchstaben innerhalb eckiger Klammern dient als Platzhalter und muss einschließlich der eckigen Klammern durch eigene Angaben ersetzt werden.</blockquote>'''Syntax:'''<syntaxhighlight lang="shell">bash /[ABSOLUTER-PFAD]/jarss.sh --job-name="[DATEINAME]" [--info=progress2] [--dry-run] [-v] [-vv] [-vvv]</syntaxhighlight>'''Optionen:'''
{| class="wikitable"
|+
|'''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:''' <syntaxhighlight lang="shell">
bash /volume1/backups/jarss.sh --job-name="jarss_Backup_Homes-Verzeichnis" --dry-run
</syntaxhighlight>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 <code>--dry-run</code> 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 <code>--dry-run</code> 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<blockquote>[[Datei:01 jarss ausfuehren.png]]</blockquote>

== 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 <code>Aktiviert</code> angehakt ist.
* Füge im Register '''Aufgabeneinstellungen > Befehl ausführen > Benutzerdefiniertes Script''' den Befehl in das Textfeld ein, wie im Abschnitt "[[Jarss ausführen#Ausführung über das Terminal|'''Ausführung über das Terminal''']]" davor bereits beschrieben wurde.

* Bestätige deine Eingaben mit die Schaltfläche <code>OK</code> und akzeptiere die anschließende Warnmeldung ebenfalls mit <code>OK</code>.
* 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 <code>Senden</code> 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 <code>Ausführen</code> 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