irb-backup(1)

NAME
irb-backup - (V2.5A) Zentrale Datensicherung

SYNTAX
irb-backup -command <cmd> [<operanden>]

Moegliche Angaben fuer <cmd> sind:

help            [-h]
    Ausgabe dieses Hilfetextes

restore-file    [-x]
    Restaurieren von Dateien

list-file       [-l]
    Liste der gesicherten Dateien

show-request    [-q]
    Ausgabe der wartenden Requests

remove-request  [-r]
    Loeschen von wartenden Requests

Alternativ kann fuer "-command <cmd>" die in Klammern genannte Kurzform angegeben werden. Operanden und Operandwerte muessen durch ein Leerzeichen getrennt werden.

BESCHREIBUNG
Mit dem Kommando irb-backup kann der Benutzer sich darueber informieren, wann und ob seine Dateien in dem IRB - Sicherungssystem gesichert wurden. Ebenso koennen Dateien restauriert werden oder der Status von Restore-Auftraegen erfragt werden.

Die Datensicherung von Platten-Filesystemen erfolgt in jeder Nacht. Dabei werden (wenn moeglich) nur die seit dem Zeitpunkt der letzten Sicherung modifizierten Datenbestaende gesichert. In regelmaessigen Abstaenden (kann vom Benutzer nicht beeinflusst werden) wird eine Gesamtsicherung eines Filesystems erstellt.

Gesamtsicherungen werden ca. 9 Monate gespeichert, partielle Sicherungen nur ca. 4 Monate.

Eine Gesamtsicherung mit den darauf aufsetzenden partiellen Sicherungen wird im folgenden als "Sicherungszyklus" bezeichnet.

Das Kommando schickt einen entsprechenden Request an den zentralen Restore-Server (fbi-restore.informatik.uni-dortmund.de), der die Auftraege entweder direkt ausfuehrt oder in eine Warteschlange einreiht, wenn zeitaufwendige Aktionen auszufuehren sind (z.B. Restaurierungen). Die Warteschlangen werden dann in der Reihenfolge des Eintreffens der Auftraege bearbeitet.

Das Ergebnis eines Requests wird entweder direkt ausgegeben oder dem Benutzer wird nach der Ausfuehrung eine Mail zugesendet.

Beschreibung der moeglichen Kommandos (Operand command):

KOMMANDO help
irb-backup -command help [<kommandoname>] Ausgabe von Hilfetexten.

Wenn ein <kommandoname> angegeben wird, werden spezielle Informationen zu diesem Kommandonamen ausgegeben. Andernfalls wird eine Uebersicht ueber die moeglichen Kommandos ausgegeben.

KOMMANDO list-file

irb-backup -command list-file [<option>]... <file> Es soll nach der angegebenen Datei in den gesicherten Datenbestaenden gesucht werden. Fuer <file> sind folgende Schreibweisen moeglich:

1.  kompletter Pfadname beginnend mit "/"

2.  relativ zum aktuellen Directory, z.B. "src/xx" oder "./xx"

3.  relativ zum eigenen Homedirectory mit "~", z.B. "~/src/xx",

4.  Dateiname mit Musterzeichen (siehe unten).

Folgende Optionen sind moeglich:

-t <datum>
    Es werden nur Sicherungszyklen beruecksichtigt, die vor dem genannten Datum erstellt wurden. Fehlt diese Angabe wird das aktuelle Datum angenommen. Die Eingabe des Datums erfolgt in der Form YYMMDD[.HHMM] (JahrMonatTag.StundeMinute).

-A  Beruecksichtigung aller Sicherungszyklen welche vor dem genannten Datum (Operand "-t") erstellt wurden. Wenn dieser Operand nicht angegeben wird, wird nur solange in aelteren Sicherungszyklen gesucht bis mindestens eine Datei gefunden wurde.

-a  Ausgabe aller Sicherungsversionen in den ausgewaehlten Sicherungszyklen (siehe Operand "-A"). Wenn dieser Operand nicht angegeben wird, wird nur die jeweils neueste Sicherungsversion in jedem ausgewaehlten Zyklus beruecksichtigt.

Die gefundenen Dateien werden pro Sicherungszyklus zu einem Paket zusammengefasst. Das erste Paket beginnt zum Zeitpunkt des Aufrufs bzw. des angegebenen Anfangszeitpunkts fuer Suchen und endet bei dem Sicherungszyklus in dem eine Datei gefunden wurde. Der Benutzer erhaelt nur Informationen ueber Dateien, die ihm gehoeren oder auf die er als Gruppenmitglied Schreibzugriff hat. Er kann auch nur solche Dateien restaurieren.

Der Benutzer 'root' kann auch Dateien anderer Benutzer des eigenen Rechners restaurieren.

Der Benutzer kann nur Dateien restaurieren, die ihm gehoeren oder auf die er als Gruppe schreibenden Zugriff hat. Der Benutzer 'root' kann auch Dateien anderer Benutzer des eigenen Rechners restaurieren.

ACHTUNG : irb-backup -command list-file "src/*" sucht alle Dateien und Directories (incl. Subdirectories) in dem Directory src. Diese Angabe ist aequivalent zu der Angabe "src".

Fuer den Auftrag wird eine Request-ID vergeben. Dem Benutzer wird per Mail nach dem Suchen ein Statusbericht zugesendet.

KOMMANDO restore-file

irb-backup -command restore-file [<option>]... <file> Es sollen die durch den Operanden <file> angegebene Dateien restauriert werden (siehe Kommando list-file).

Folgende Optionen sind moeglich:

-t <datum>
    Datum (siehe Kommando list-file).

Es werden nur Dateien aus einem Sicherungszyklus restauriert. Dabei wird solange in aeltern Sicherungszyklen gesucht, bis mindestens eine Datei gefunden wurde.

Die Datei wird an dem urspruenglichen Standort restauriert.

Fuer den Auftrag wird eine Request-ID vergeben. Dem Benutzer wird per Mail nach dem Restaurieren ein Statusbericht zugesendet. Wenn zum Restaurieren mehrerer Dateien aus verschieden Sicherungsversionen Daten eingespielt werden muessen, werden Zwischenberichte per Mail zugesendet.

Der Benutzer kann nur Dateien restaurieren, die ihm gehoeren oder auf die er als Gruppe schreibenden Zugriff hat. Der Benutzer 'root' kann auch Dateien anderer Benutzer des eigenen Rechners restaurieren.

ACHTUNG : irb-backup -command restore-file "src/*" restauriert alle Dateien und Directories (incl. Subdirectories) in dem Directory src. Diese Angabe ist aequivalent zu der Angabe "src".

KOMMANDO show-request

irb-backup -command show-request

Es wird die aktuelle Auftragswarteschlage auf dem Restore - Server ausgegeben.

Request-ID
    Auftragskennzeichen Ein "*" vor der Request-ID kennzeichnet aktive Auftraege.

Queue
    Bezeichnung der Warteschlage in der sich der Auftrag befindet. "Scan" bezeichnet die Warteschlange der List- und Restore - Auftraege, fuer die noch nach Informationen ueber betroffene Sicherungsversionen in der Datenbank gesucht wird. "Disc" bezeichnet die Warteschlange mit Restore-Auftraegen, die von einer Spool-Disc ohne Unterstuetzung durch einen Operator bearbeitet werden koennen. "Tape" bezeichnet die Warteschlage mit Restore-Auftraegen fuer die von einem Operator ein Band (Video-8, DAT) in ein entsprechendes Geraet eingelegt werden muss.

    Alle Restore- und List-Request werden zunaechst in die Scan-Queue eingereiht. Danach wechseln Restore-Requests in die Tape- oder Disc-Queue.

Restore-Host
    Angabe des Rechners an dem das betroffene Filesystem lokal gemountet ist.

User-Mail
    Mailadresse des Auftraggebers.

KOMMANDO remove-request

irb-backup -command remove-request <request-id>... Es werden die Auftraege mit den angegebenen Auftragskennzeichen aus den Auftragswarteschlangen geloescht. Jeder Benutzer kann nur eigene Auftraege loeschen.

MUSTERZEICHEN
Moegliche Musterzeichen sind:

*   eine beliebig lange (auch leere) Folge beliebiger Zeichen

?   genau ein beliebiges Zeichen

[SET]
    genau ein Zeichen aus dem SET. Ein SET besteht aus einer Folge von Zeichen oder Wertebereichen. Ein Wertebereich besteht aus einem Zeichen, einem Minuszeichen und einem weiteren Zeichen (z.B. 0-9 oder A-Z).

    Wenn das erste Zeichen im SET ein "!" oder ein "^" ist, wird die Bedeutung invertiert.

{STR,...}
    jede der angegebenen Zeichenfolgen.

Das Zeichen '/' kann nicht durch ein Musterzeichen ersetzt werden.

In einem SET oder einem STR erfolgt keine Auswertung der Musterzeichen. Werden Musterzeichen angegeben, muss der Dateiname in doppelte Hochkommata eingeschlossen werden, da die Musterzeichen sonst evtl. schon von der Shell expandiert werden. Die spezielle Bedeutung eines Musterzeichen kann durch einen vorangestellten Backslash aufgehoben werden. Weiterhin wird das Zeichen "~" am Anfang durch das Home-Directory des Benutzers ersetzt.

BEISPIELE
irb-backup -command list-file datei1 Information ueber die letzte gesicherte Version der Datei 'datei1'. irb-backup -command list-file -a datei1 Information ueber die im letzten Sicherungszyklus gesicherten Versionen der Datei 'datei1'. irb-backup -command list-file -a -A datei1 Information ueber alle gesicherten Versionen der Datei 'datei1' in allen bekannten Sicherungszyklen. irb-backup -command list-file -t 931231 datei1 Information ueber die juengste vor dem 31.12.93 gesicherte Version der Datei 'datei1'. irb-backup -command restore-file datei1 Restaurierung der Datei 'datei1' in der letzten gesicherten Version. irb-backup -command restore-file -t 931231 datei1 Restaurierung der Datei 'datei1' in der juengsten vor dem 31.12.93 gesicherten Version.

EINSCHRAENKUNGEN
List- und Restore-Auftraege werden in eine Queue eingereiht. Die Beantwortung kann je nach Auslastung des Restaurierungs-Servers auf sich warten lassen.

Werden Dateien/Directories restauriert, die es noch gibt, so werden diese durch die restaurierte Version ueberschrieben (Vorsicht beim Gebrauch von Musterzeichen!).

Von bereits auf Kassetten ausgelagerten Sicherungsversionen kann nur restauriert werden, solange ein Operator anwesend ist, der die entsprechenden Datentraeger einlegt (normalerweise an Werktagen von 7.00 Uhr bis 20.00 Uhr).

DATEIEN
- keine -

BEKANNTE FEHLER
-keine -

SONSTIGES
Bei Problemen senden Sie bitte eine Mail an:
 backup@irb.informatik.uni-dortmund.de