Archive:Admin Handbuch 4.0
DER INHALT DIESER SEITE IST VERALTET | |
Die SEP AG hat die Unterstützung für veraltete SEP sesam Versionen eingestellt. Anleitungen stehen nach wie vor für diese SEP sesam Produkte zur Verfügung, jedoch übernimmt SEP AG keine Verantwortung oder Haftung für Fehler oder Ungenauigkeiten in den Anleitungen oder für die falsche Bedienung veralteter SEP sesam Software. Es wird dringend empfohlen Ihre SEP sesam Software auf die neueste Version zu aktualisieren. Die neueste Dokumentation für SEP sesam finden Sie unter Dokumentation. |
Copyright © SEP AG 1999-2024. Alle Rechte vorbehalten.
Jede Form der Reproduktion der Inhalte dieses Benutzerhandbuches, ganz oder in Teilen, ist nur mit der ausdrücklichen schriftlichen Erlaubnis der SEP AG gestattet. Bei der Erstellung dieses Benutzerhandbuches wurde mit größtmöglicher Sorgfalt gearbeitet, um korrekte und fehlerfreie Informationen bereit stellen zu können. Trotzdem kann die SEP AG keine Gewähr für die Richtigkeit der Inhalte dieses Benutzerhandbuches übernehmen.
Systemvoraussetzungen für die Installation
Namensauflösungs-Beispiele
Installation
Linux
Windows
Es ist erforderlich x86 Systeme, welche mehr als 3.25 GB RAM in Verwendung haben, auf unter 3.25 GB RAM zu reduzieren oder auf ein x64 OS zu migrieren. Dies ist notwendig, da SEP sesam bei LTO (Linear Tape Open) 64 KB Blöcke benötigt, bei genannten Systemen können durch die automatisch aktivierte PAE (Physical Address Extension) jedoch nicht mehr als 32 KB Blöcke auf ein Band geschrieben werden. Des weiteren treten Probleme von SEP sesam beim Zugriff auf Lader auf.
Lizenzierung
Nach der Installation von SEP sesam stehen 30 Tage lang alle Funktionen uneingeschränkt zur Verfügung. Sieben Tage vor Ablauf der Zeitlizenz wird auf auf die anstehende Lizenzverlängerung hingewiesen. Nach Ablauf der 30 Tage Frist ist die Software für Sicherungen gesperrt. Eine Rücksicherung der bis zu diesem Zeitpunkt gesicherten Daten ist jedoch möglich.
Lizenzanforderung
Für die Erstellung der anwendungsspezifischen Lizenz werden folgende Angaben des SEP sesam-Sicherungs-Servers benötigt:
- Servername
- IP Adresse
Die Informationen zu SEP sesam Servername und IP Adresse findet man in der SEP sesam GUI unter dem Menüpunkt: Hilfe -> Lizenz Info oder mit der Tastenkombination ALT + L
- Lieferscheinnummer
- Hardware Plattform (i386, x86, ppc, ia64, ...)
Diese Information erhält man auf der
- Linux Konsole mit uname -i
- Windows Eingabeaufforderung mit set (bei Windows 2003 auch mit systeminfo)
Diese Angaben anschließend an sales@sep.de senden oder anrufen unter +49 8020 180-0.
Bei Rückfragen während des 30-tägigen Installations-Supports wendet man sich an support@sep.de oder an +49 700 737 787 7678 ( 49 700 SEPSUPPORT)
Lizenz- und Servicepapiere
Neben der Lizenzdatei, die in digitaler Form (meist per e-Mail) versendet wird, werden noch Lizenzzertifikate für die erworbenen Module sowie, bei Abschluss eines Upgrade- und/oder Supportvertrages, eine Upgrade-/Support-Card verschickt. Auf diesen Papieren sind alle relevanten Informationen (IP-Adresse, Servername, Lizenzdetails, Laufzeit und Reaktionszeiten) übersichtlich zusammengefasst. Diese Dokumente in Papierform werden auf dem Postweg oder auf Wunsch als PDF per e-Mail zugesandt.
Änderung einer bestehenden Lizenz
Ändert sich die IP-Adresse oder der Servername des Backupservers, ist ein SEP sesam Server Lizenz Transfer notwendig.
Dieser beinhaltet die Umstellung der vorhandenen Server Lizenz auf einen veränderten Servernamen und/oder neue IP Adresse. Die entsprechenden Daten der bestehenden und neuen Lizenzierung sind schriftlich (per e-Mail an sales@sep.de) einzureichen um Fehler bei der Übermittlung auszuschließen und den Ansprechpartner verifizieren zu können.
Die transferierte Lizenz wird innerhalb der garantierten Reaktionszeit per e-Mail zugesendet. Alle bestehenden Lizenz- und Servicepapiere werden neu erstellt, sowie das Kundencenter upgedated.
Bei bestehendem SEP Upgrade Vertrag ist der Lizenz Transfer kostenfrei.
Lizenz einspielen
Die Lizenz wird normalerweise per e-Mail verschickt. Im Anhang befindet sich das Lizenzfile, das auf dem SEP sesam Server eingespielt werden muss.
- entpacken der Datei sm_lic.zip auf dem Zielrechner
- kopieren der Datei
sm_lic.ini
nach<SESAM_ROOT>/var/ini
Nach dem Einspielen kann die Lizenz entweder in der SEP sesam-GUI (Aufruf vom Menüpunkt HILFE-LIZENZ INFO) oder auf der Kommandozeile übergeprüft werden.
- UNIX
#> source <SESAM_ROOT>/var/ini/sesam2000.profile #> sm_info c
- Windows
> <SESAM_ROOT>\var\ini\sm_prof > sm_info c
Dadurch wird auf der Konsole ausgeben, ob die Lizenz richtig erstellt wurde.
Achtung |
Von einer bereits vorhandenen Lizenz sollte vor dem Einspielen eine Sicherungskopie gemacht werden. Bei Unstimmigkeiten mit der neuen Lizenz kann so immer der lauffähige Zustand wiederhergestellt werden. |
SEP sesam Prozesse
SEP sesam Verzeichnis Struktur
Während der Installation legt SEP sesam prinzipiell 2 Verzeichnisstrukturen an. Eine für die statischen und eine für die variablen Daten. Beide Strukturen können unter dem gleichen Hauptverzeichnis liegen, müssen aber nicht.
Unter Unix findet man die Installationsverzeichnisse in der Datei /etc/sesam2000.ini
.
SESAM_BIN Verzeichnis
Unter diesem Verzeichnis befinden sich alle unveränderbaren Dateien, wie Programme, Templates usw. Bei der Installation des Softwarekits wird folgende Verzeichnisstruktur aufgebaut:
Template-Dateien inkl. Rohdatenbank für die Erstinstallation | SESAM_BIN /skel
|
Vorlagen für benutzerprogrammierbare Schnittstellen | SESAM_BIN /skel/templates
|
SEP sesam Server-Komponenten | SESAM_BIN /bin/sesam
|
sms- und stpd-Komponenten | SESAM_BIN /bin/sms
|
SEP sesam Server Gui-Komponenten | SESAM_BIN /bin/gui
|
SEP sesam Server Datenbank-Komponenten | SESAM_BIN /bin/db
|
SESAM_VAR Verzeichnis
Hier findet man alle veränderlichen Daten, wie die SEP sesam Datenbank, Protokolle und Log-Files Beim Setup wird folgende Verzeichnisstruktur aufgebaut:
Initialisierungsdateien | SESAM_VAR /var/ini
|
Datenbank | SESAM_VAR /var/db
|
Log-Hauptverzeichnis | SESAM_VAR /var/log
|
Kurzlebige temporäre Dateien | SESAM_VAR /var/tmp
|
Mittellebige temporäre Dateien | SESAM_VAR /var/work
|
Beispiel
C:\Programme\SEPsesam
Beispiel
Typische SEP sesam Verzeichnisstruktur nach einer RPM Installation auf Linux. Die Programme befinden sich unter /opt/sesam
, die Daten unter /var/opt/sesam
,
barometrix:~ # find /opt/sesam/ /var/opt/sesam/ -type d /opt/sesam/ /opt/sesam/bin /opt/sesam/bin/db /opt/sesam/bin/gui /opt/sesam/bin/gui/html /opt/sesam/bin/sesam /opt/sesam/bin/sms /opt/sesam/skel /opt/sesam/skel/db /opt/sesam/skel/templates ### /var/opt/sesam/ /var/opt/sesam/var /var/opt/sesam/var/ini /var/opt/sesam/var/ini/root /var/opt/sesam/var/log /var/opt/sesam/var/log/db /var/opt/sesam/var/log/lgc /var/opt/sesam/var/log/sms /var/opt/sesam/var/tmp /var/opt/sesam/var/work /var/opt/sesam/var/work/smslis /var/opt/sesam/var/work/info /var/opt/sesam/var/work/ctl /var/opt/sesam/var/work/sem /var/opt/sesam/var/times /var/opt/sesam/var/lis /var/opt/sesam/var/not /var/opt/sesam/var/qm /var/opt/sesam/var/glbv /var/opt/sesam/var/prepost /var/opt/sesam/var/prot /var/opt/sesam/var/sel /var/opt/sesam/var/db barometrix:~ #
/opt/sesam/bin /var/opt/sesam
In /var/ini werden folgende Initialisierungsdateien abgelegt:
sm.ini sm_java.policy sms.ini odbc.ini debug.ini sm_lic.ini stpd.ini
Nutzung von Storage Hardware
Erkennung der Sicherungs-Hardware
- Beispiele
Lader-spezifische Einstellungen
Initialisierung des Elementstatus
Manche Lader benötigen einen zusätzlichen Initialize element status Befehl nach dem manuellen Entladen der Medien. Aktivierung in SEP sesam:
sm_glbv w gv_initialize_loader_1 yes
Erlaubnis zum Entladen von Medien
Manchmal wird das Entladen eines Mediums vom Laufwerk blockiert mit prevent medium removal. Um das Entladen des Mediums wieder zu erlauben:
sm_glbv w gv_scsi_<drive_num>
Damit wird folgender Befehl ausgeführt:
slu {SCSI_ID-von-gv_scsi_{drive_num}} -a
SCSI Id des Laufwerks vorher setzen mit:
sm_glbv w gv_scsi_2 4050
Laufwerksnummer 2 mit SCSI Id 4050
Client side configuration
Standard Ausschlussliste
Eine Standard Ausschlussliste kann im SEP sesam Client wie folgt spezifiziert werden
<SESAM_VAR>/var/ini/sm.ini
[SBC_EXCLUDE] ExcludePattern1=\./var/opt/sesam/var/db_pg/base ExcludePattern2=\.log ExcludePattern3=\./var/opt/sesam/var/tmp ExcludePattern4=\./tmp
Ignorieren von Größenveränderung
Falls sich die Größe einer Datei während eines Backups verändert wird vom sbc eine Warnung ausgegeben. Um diese Warnung zu vermeiden kann eine Liste (in Form regulärer Ausdrücke) spezifiziert werden, wodurch der sbc Größenänderungen akzeptiert.
<SESAM_VAR>/var/ini/sm.ini
[SBC_IGNORE_SIZE_CHANGE] IgnorePattern1=.*\.lgx IgnorePattern2=.*\.lgc$ IgnorePattern3=.*\.log IgnorePattern4=.*gv.*\.sgv
Diese Funktion is auf Windows Betriebssystemen nicht verfügbar, da während des Backups über VSS keine Datei die Größe ändern sollte.
Administration
SEP sesam Server starten und beenden
SEP sesam bietet eine einfache Schnittstelle zum Starten und Beenden des Servers. Mit sm_startup wird das System gestartet. Es wird nach dem Starten aller Daemons bzw. Services zunächst die allgemeine SEP sesam-Bearbeitungsqueue qu_all initialisiert und dann in dieser das Programm 'sm_startup gestartet. sm_startup prüft die SEP sesam Umgebung und startet sm_config_drives zur Initialisierung der Laufwerke. Wird der SEP sesam Server mit sm_startup gestartet, so wird mit sm_main status geprüft, ob die Daemons bzw. Services aktiv sind. Sind die Prozesse nicht aktiv, so wird "'sm_main start"' aufgerufen und sm_startup beendet sich vorzeitig. Für das Beenden des SEP sesam Servers dient sm_shutdown der sm_os_startup stop aufruft, welcher u.a. sm_main stop zum Beenden der Services/Daemons verwendet.
Reboot Konfiguration (Autostart nach Reboot)
SEP sesam ist so aufgebaut, dass es sich nach dem Booten des Rechners automatisch startet. Um diese Funktion zu unterbinden, geht man wie folgt vor:
Unix-Systeme
Eingabe von sm_setup unset_reboot. Um den Dienst wieder zu starten, wird sm_setup set_reboot eingeben.
Windows-Systeme
In der Computerverwaltung unter Dienste und Anwendungen den Dienst SEPsesam Server deaktivieren.
SEP sesam Client
Client Zugriff von SEP sesam Server
Client Zugriff prüfen
Client-Zugriff über SSH
Um eine Verbindung vom SEP sesam Server zum Client anstatt mit der unverschlüsselten ctrl-Verbindung über SSH aufzubauen, muss sich SEP sesam Server ohne Passwortabfrage, d.h. über public/private Key, auf den Client einloggen können. Die Einrichtung ist in den man Pages von ssh und sshd erklärt.
Um dies für einen neuen Client zu verwenden, muss man den Zugriffsmode auf SSH umstellen. Ein Browsen des Filesystems ist derzeit jedoch nicht möglich wenn SSH als Verbindungstyp gewählt wird.
sm.ini client Einstellungen
Eine <SESAM_VAR>/var/ini/sm.ini ist die zentrale Konfigurationsdatei nicht nur auf dem SEP sesam Server, sondern auch auf den Clients.
Default Exclude-Liste
Neben den Möglicheiten eine Exclude-Liste in einem Auftrag zu definieren, gibt es über den Abschnitt [SBC_EXCLUDE] Exclude-Muster zu definieren, die bei jedem Backup auf diesem Client angewendet werden. Dazu müssen keine weiteren Einstellungen im Sicherungsauftrag gemacht werden. Im Sicherungsprotokoll wird diese Liste mit ausgegeben, damit der Administrator weiß, welche Bereiche nicht mitgesichert wurden. Diese Muster arbeiten mit Regular Expressions (RegEx), d.h. es lassen sich mit wenig Aufwand komplexe Muster zum exkludieren abbilden.
Die Default-Liste nach der Installation des SEP sesam Clients unter Linux sieht wie folgt aus.
[SBC_EXCLUDE] ExcludePattern5=\./opt/novell/nss/mnt/\.pools$ ExcludePattern4=/lost+found$ ExcludePattern3=\./dev$ ExcludePattern2=\./media$ ExcludePattern1=\./mnt$
Sollen nun z.B. die Pfade /u01, /u02 und /u03 nicht mitgesichert werden, dann kann das über folgenden zusätzlichen Eintrag in die Liste erfolgen:
ExcludePattern6=\./u0[1-3]$
Diese Exclude-Muster gelten in der Regel bei der Gesamtsicherung eines Clients oder wenn einer der aufgeführten Pfade oder Dateien sich in einem Unterverzeichnis der Sicherungsquelle befinden. Werden allerdings einer oder mehrere dieser Pfade explizit als Sicherungsquelle definiert, dann kann darüber dieser Bereich trotzdem gesichert werden.
Ignore size change
Derzeit gibt der sbc eine Warnung aus, wenn sich die Größe einer Datei bei der Sicherung ändert, oder während der Sicherung eine Datei gelöscht wird. Um diese Warnungen zu vermeiden, kann eine Liste von Daten (als reguläre Ausdrücke) bestimmt werden, bei denen der sbc die Änderung der Größe oder das Löschen akzeptiert. Der Sicherungsstatus wird dann als erfolgreich gemeldet. Die erkannten Unregelmäßigkeiten werden allerdings trotzdem im Protokoll aufgeführt.
In der <SESAM_VAR>/var/ini/sm.ini existiert dieser Bereich nicht standardmäßig und muss explizit erzeugt werden.
[SBC_IGNORE_SIZE_CHANGE] IgnorePattern1=/var/opt/sesam/.*\.l[go][cgx]$ IgnorePattern2=.*\.lgc$ IgnorePattern3=.*\.err IgnorePattern4=.*/gv.*\.sgv$
Die o.g. Beispiele sind wie folgt zu interpretieren:
- IgnorePattern1
- Alle Dateien unter /var/opt/sesam/ die die Dateiendungen .log, .lgc und .lgx werden ignoriert.
- IgnorePattern2
- Ignoriert werden alle Dateien mit der Endung .lgc.
- IgnorePattern3
- Ignoriert werden alle Dateien die den String .err im Namen haben.
- IgnorePattern4
- Ignoriert alle globalen Variablen des SEP sesam Servers.
Diese Funktion ist in Windows nicht notwendig, da bei einer Sicherung per VSS eine Datei ihre Größe im Snapshot während einer Sicherung sowieso nicht ändert.
Nach dem Backup
Die Saveset-ID
Jede Sicherung wird in einem sogenannten Sicherungssatz (Saveset) gespeichert. Dieses Saveset bekommt einen Unique Identifier, welcher sicherstellt, dass es keine 2 Savesets mit derselben UID geben kann. Im Laufe der Entwicklung wurde die Saveset-ID schrittweise erweitert. Aktuell hat Sie folgenden Aufbau:
S|F|20110725|200004|418|@|LvVEIsu6lLd 1 2 3 4 5 6 7
- Buchstabe der Eventart:
S = Backup
R = Restore oder der Restore einer Migration
X = Remote Command - Buchstabe der Sicherungsart:
F = Full Backup
D = Differentielles Backup
I = Inkrementelles Backup - Datum des Ereignisbeginns
- Zeit des Ereignisbeginns
- bis zur Tausendstel Sekunde
- Ein @ als Trennzeichen
- Eine 11-stellige Zufallszeichenfolge. Diese wird über eine Betriebssystem eigene API zur Generierung von Zufallszeichenketten erzeugt (base64url).
Verwaltungsdaten zu den Sicherungssätzen
Die Namen der Sicherungssätze werden von SEP sesam eindeutig aus der Sicherungszeit berechnet. Für die Rücksicherung wird zu jedem Sicherungssatz ein Inhaltsverzeichnis, das die gesicherten Dateien auflistet, erstellt und unter dem zugehörigen Sicherungsnamen und Datum verwaltet ( Listing ). Dazu kommt das Sicherungsprotokoll, das Meldungen über den Verlauf des Backups sowie eine Liste von Dateien, die systembedingt nicht gesichert werden konnten, beinhaltet.
In der SEP sesam Datenbank werden zu jeder gelaufenen Sicherung folgende Verwaltungsdaten gehalten:
- Name aus Zeitstempel als eindeutige Identifikation des Sicherungssatzes
- Auftragsname
- Datum des Sicherungstages
- Ausführungszähler des Auftrags je Sicherungstag
- CFDI-Typ Copy,Full,Diff,Inc
- Medienzähler - Verteilung des Sicherungssatzes auf Medien
- Label der Medien, die benutzt wurden
- Laufwerksnummer
- Client, von welchem die Daten gesichert wurden
- Sicherungsquelle
- Start-, Endzeit
- Erfolgsstatus
- gesicherte Datenmenge
- Schlüsselwort falls verschlüsselt gesichert wurde
Der Erfolgsstatus einer Sicherung ist in der Spalte Zustand von Sicherungen nach Status sichtbar.
In der Oberfläche von SEP sesam können diese Informationen mit verschiedensten Filtern zur Analyse dargestellt werden ( Sicherungen nach Status, Kalenderblatt, etc. ) .
Job Status
Mögliche Job Stati sind
- 'w'
- 'working' SM_NEWDAY - spezieller Status für den Sesam Tageswechsel, 'w' wird anstelle von 'a'ctive verwendet damit ein gleichzeitig laufender SM_BREAK diesen nicht bemerkt.
- 'q'
- 'queued': Auftrag wurde in eine Resource Queue des SM_QM_MAIN eingestellt (submitted) aber noch nicht gestartet.
- 'c'
- 'cancelled': SM_BACKUP wurde vor Beginn des Datentransfers abgebrochen.
- 'a'
- 'active': Auftrag ist aktiv.
- 'X'
- 'error': Auftrag wurde mit erkanntem Fehler beendet.
- '3'
- 'cancelled': SM_BACKUP wurde nach Beginn des Datentransfers abgebrochen.
- '2'
- 'empty LIS': SM_BACKUP endete ohne Daten zu sichern, typisch für DIFF oder INCR Sicherungen.
- '1'
- 'with warnings': mit Warnungen
- '0'
- 'successful': erfolgreich
SEP Sesam Log Dateien und ihre Bedeutung
SEP Sesam Server Komponente | SESAM_VAR /var/log/lgc mit Extension .lgc für aktuelle und _{date}.lgx für ältere Log Dateien.
|
SMS und STPD Komponenten | SESAM_VAR /var/log/sms, Extension .log.
|
SEP Sesam Server GUI Komponente | SESAM_VAR /var/log/lgc/sm_gui_server.lgc für aktuelles Log und sm_gui_server_{date}.lgx für ältere Log Dateien.
|
SEP sesam im Netzwerk
mehrere Netzwerk-Schnittstellen
Probleme in Umgebungen mit Firewalls
SEP sesam Schnittstellen
SEP sesam bietet mehrere vom Benutzer konfigurierbare Schnittstellen an. Diese können frei programmiert werden. Die Templates der Programme befinden sich unter <sesamroot>/skel/templates. Um sie zu aktivieren, müssen die Dateien erst nach <sesamroot>/bin/sesam kopiert werden. Dort können sie dann mit einem beliebigen Texteditor angepasst werden.
Folgende Schnittstellen stehen zu Verfügung:
Name | Kommando | wird ausgeführt auf |
PRE | sbc_pre | Klient |
POST | sbc_post | Klient |
DISASTER | sm_disaster | Server |
NOTIFY | sm_notify | Server |
ALARM | sm_alarm | Server |
- Auf Windows Rechnern haben alle Kommandos die Endung .cmd oder .ps1 bei Powershell-Benutzung.
- Da der SEP sesam Server implizit auch ein Sicherungs-Client ist, wird auch dort die PRE/POST Schnittstelle ausgeführt.
PRE-Schnittstelle
Vor dem Start einer Sicherung können am zu sichernden Client spezielle Maßnahmen durchgeführt werden.
- Mitteilungen,
- Beenden von Programmen, z.B. Datenbanken
- Bestimmte Aktionen, z.B. Export einer Datenbank
Diese Aktionen können mit Hilfe der Pre-Schnittstelle frei programmiert werden. Es kann alles eingesetzt werden, was auf dem entsprechenden Betriebssystem lauffähig ist.
Der Aufruf erfolgt mit 10 Argumenten vom aktuellen SEP sesam Sicherungsauftrag:
Arg.Nr | Bedeutung |
1 | Sicherungsquelle |
2 | Name des sichernden Rechners (Tape server interface) |
3 | SESAM Auftragsname |
4 | Laufwerksnummer |
5 | Sicherungstyp: Copy, Full, Differential, Incremental |
6 | Ausführungszähler des Auftrages im Sicherungstag (= Nummer der LIS-Datei) |
7 | Savesetname |
8 | Label des benutzten Mediums |
9 | Medienpool des benutzten Mediums |
10 | Zeitplan der die Sicherung gestartet hat (Schedule) |
Rückgabewerte: Vor dem Ende der Prozedur muss auf Standard Output entweder STATUS:OK oder STATUS:ERROR {text} geschrieben werden.
Ändern der backup source
Wenn STATUS: Nachrichten das Schlüsselwort BACKUP_SRC= enthalten, wird dies als Backupquelle verwendet.
STATUS:OK BACKUP_SRC=C:,F:/DATA
SEP sesam prüft diese Ausgabe der PRE-Prozedur und verfährt gemäß der Einstellung 'Backup trotz Pre-Fehler starten' mit dem Sicherungsauftrag.
POST-Schnittstelle
Nach Beendigung einer Sicherung können am Client ebenfalls spezielle Maßnahmen, z.B.
- Starten einer Datenbank
- Mitteilungen, dass die Sicherung beendet wurde
- Löschen der Export Datei
durchgeführt werden
Diese Aktionen können mit Hilfe der Post-Schnittstelle frei programmiert werden.
SEP sesam wertet den Status der Sicherung aus, bevor die Post-Bearbeitung gestartet wird. Ist der Status fehlerhaft, wird die Post-Bearbeitung nur gestartet, wenn die Einstellung trotz Backup-Fehler starten für den Auftrag gesetzt ist.
Der Aufruf erfolgt mit 12 Argumenten:
Arg.Nr | Bedeutung |
1 | Sicherungsquelle |
2 | Name des sichernden Rechners (Tape server interface) |
3 | Auftragsname |
4 | Laufwerksnummer |
5 | Sicherungstyp: C_opy, F_ull, D_ifferential, I_ncremental |
6 | Status der Sicherung ( 1 = ok, 0 = error ) |
7 | Meldungstext zur Sicherung |
8 | Ausführungszähler des Auftrages im Sicherungstag (= Nummer der LIS-Datei) |
9 | Savesetname |
10 | Label des benutzten Mediums |
11 | Medienpool des benutzten Mediums |
12 | Zeitplan der die Sicherung gestartet hat (Schedule) |
Vor dem Ende der Prozedur muss auf Standard Output entweder
STATUS:OK
oder
STATUS:ERROR {text}
geschrieben werden.
Endet die POST-Prozedur mit Fehler, so wird die Sicherung mit Status Warnung bewertet.
Notify
sm_notify wird z.B. in folgenden Fällen aufgerufen:
- Sicherung wurde beendet
- Rücksicherung wurde beendet
- Medium wird angefordert
Im Gegensatz zum sm_alarm erfolgt der Aufruf auch bei erfolgreicher Ausführung der Aktion. Der Aufruf erfolgt immer mit zwei Parametern:
- Modulname
- Meldung
Folgende Modulnamen werden verwendet
BACKUP
Wird am Ende einer Sicherung aufgerufen.
- Meldung
- Auftragsnamen und Status der Sicherung.
Beispiel:
sm_notify BACKUP "kbx11_etc: erfolgreich ohne Warnungen"
BACKUP_GROUP:
Sobald die letzte Sicherung einer Sicherungsgruppe beendet ist, wird die Schnittstelle mit einem Gesamtstatus für die Sicherungsgruppe aufgerufen.
- Meldung
- Gruppenname und Status der Sicherungsgruppe.
Beispiel:
sm_notify BACKUP_GROUP: "haus: 9, Error: 1, Cancelled: 0, Warning: 3, Success: 5"
ALL_JOBS_DONE
Wird ausgeführt sobald alle geplanten Sicherungen für einen Sesam_Tag beendet sind. Hiermit kann man dann z.B. eine Mail mit dem Sicherungsstatus versenden oder ein Bandlaufwerk entladen.
- Meldung
- Überblick über den Sicherungsstatus an diesem Sesam-Tag
Beispiel:
sm_notify ALL_JOBS_DONE "102 Sicherungen beendet mit 23 fehlerhaften, \ 17 mit Warnungen und 62 erfolgreichen."
Beispiel einer sm_notify:
- Versenden einer e-Mail mit dem Sicherungsstatus
- Entladen des Bandlaufwerks mit der LW-Nummer 2
read_sm_ini() { . `grep -i '^sm_ini=' /etc/sesam2000.ini|cut -d"=" -f2` 2>/dev/null } read_sm_ini source ${gv_rw_ini}/sesam2000.profile # echo $0 $* myjob=$1 mymessage="$*" # # send mail: # echo "$mymessage" >> ${gv_rw_lgc}/sm_notify.lgc # if [ "$myjob" = "ALL_JOBS_DONE" ] then sm_smtp -A sesam -s "Sesam backup status: $1 $2" -M gv_dayfile: -a gv_prot: sm_drive dismount 2 unload fi # exit
GET_VOLUME
Wird ausgelöst, sobald SEP sesam ein anderes Medium benötigt und dieses nicht selber laden kann, also vor allem bei einem Einzelbandlaufwerk.
- Meldung
- Label des Mediums das angefordert wird
INIT
Wird ausgelöst, wenn ein Medium initialisiert wurde.
- Meldung
- Label des initialisierten Mediums und das verwendete Laufwerk
sm_notify INIT "I001-MEDIA INIT_1 erfolgreiche Initialisierung des Medium in Laufwerk 1 \ mit Label DISK00004 (Selecting media according to GETOLDEST)"
COPY_SAVESET
Wird nach jeder einzelnen Migration ausgelöst.
- Meldung
- Status der einzelnen Migration
sm_notify COPY_SAVESET "SESAM_BACKUP: 20130521082128777: I006-COPY Migrieren der Sicherung SF20130521082008703@bjytdJVZz4h erfolgreich beendet"
COPY
Wird nach der letzten Migration des Migrationsauftrages ausgeführt.
- Meldung
- Status aller Migrationen eines Migrationsauftrages
sm_notify COPY "I008-COPY Migrationsauftrag MIG-20130521_12260396 (20130521122612784) erfolgreich beendet: 5 Sicherungen: 5 erfolgreich und 0 fehlerhaft"
Alarm
sm_alarm wird immer aufgerufen, wenn eine SEP sesam Aktion fehlschlägt. Die Modulnamen sind die gleichen, wie beim sm_notify.
Z.B. wird bei einem Einzelbandlaufwerk beim Bandwechsel nach 15 min der sm_alarm SM_GET_VOLUME gestartet. Dadurch hat man genügend Zeit um z.B. bei einer Rücksicherung das angeforderte Medium einzulegen, ohne einen Alarm auszulösen.
Die Log-Dateien der Sesam Schnittstellen befinden sich in <SESAM_VAR>/prot/notification.
Disaster
sm_disaster wird immer nach Beendigung des Auftrages SESAM_BACKUP aufgerufen. Dem Programm werden alle Informationen zur letzten SEP sesam Selbstsicherung übergeben. Damit ist die Wiederherstellung von SEP sesam im Falle eines Totalausfalles möglich.
Achtung |
Diese Schnittstelle sollte immer konfiguriert werden ! - Das SESAM_BACKUP muß immer als FULL oder COPY ausgeführt werden ! |
SEP sesam CLI
Das SEP sesam Command Line Interface (SEP sesam CLI) wird zum automatischen Konfigurieren der SEP sesam Umgebung benutzt ohne dazu die SEP sesam GUI nutzen zu müssen. Darüber hinaus lassen sich damit bereits eingerichtete Aufträge starten. Damit können skriptgesteuerte Vorgänge in der SEP sesam Umgebung umgesetzt werden.
Beispiele
Start eines Backups
Der Backupauftrag TEST_BACKUP soll sofort auf den Medienpool DISK als Full backup gestartet werden.
sm_cmd backup -j TEST_BACKUP -m DISK -l F
Tipps & Tricks
SEP sesam Listing Dateien komprimieren
Um Platz zu sparen können alle LIS Dateien die älter als n Tage (hier 3) komprimiert werden:
LIS Komprimierung über die GUI einschalten: Konfiguration --> Vorbelegung --> Extras --> LIS Dateien komprimieren
Wichtig: nach Aktivierung der Option werden die LIS Dateien erst nach erneutem Durchlauf des Sesam Tageswechsels komprimiert! Die Aktivierung führt nicht zur sofortigen Komprimiertung der LIS Dateien. Um die Kompression der .lis Dateien sofort auszuführen, ist es notwendig einen Tageswechsel mit sm_newday zu starten.
GUI ohne Icon starten
Ist aktuell kein Icon auf dem Linux Desktop verfügbar, kann die GUI auch über die Kommandozeile gestartet werden.
sesam_gui -S <SEP sesam Server>[<:port>] -M [0|1|2]
- -M N
- Master GUI abschalten (N=0), mit mehreren SEP sesam Servern direkt verbinden (N=2)
Master GUI
Die Master GUI wird verwendet um mehrere SEP sesam Server einfach zu verwalten. Bei den Servern handelt es sich um eigenständige SEP sesam Server. Die sesam Master Oberfläche verfügt über einige zusätzliche Schalter und Einstellmöglichkeiten, sodass in die Bedienungsoberflächen der anderen SEP sesam Server eingegriffen werden kann. Alle lokalen GUI´s der verteilten SEP sesam Server sind parallel und autark weiterhin nutzbar.
Voraussetzungen
- alle SEP sesam Server müssen die gleiche Hauptversion haben (z.B. 4.0.x)
Danach können Server über GUI->Konfiguration->Remoteserver hinzugefügt werden.
Beschreibung
- der GUI-Klient verbindet sich auf einen SEP sesam Server
- über die Datenbank werden die Namen der übrigen Server ermittelt.
- die Verbindung zu diesen Servern wird aufgebaut
Dies hat zur Folge, dass:
- wenn die Verbindung zum Master-GUI Server abreißt, auch die anderen Verbindungen geschlossen werden.
- der Zugang vom GUI-Klient direkt auf jeden Server möglich sein muss (Routing, Firewall..).
Problembehebung
Falls es beim Aktivieren der Verbindung zu einem Remote Server zu Problemen kommt, sollte zuerst immer versucht werden eine direkte Verbindung herzustellen.
/opt/sesam/bin/gui/sesam_gui -S remotesesam1
Einstellungen ohne GUI
Einige besondere Einstellungen können im Augenblick noch nicht mit der GUI durchgeführt werden.
Backup ohne Verwendung des Archive Bits auf Windows
Windows Betriebssysteme verwenden in den Dateieigenschaften zur Verwaltung von Dateiänderungen das Archivbit (A-Bit), das bei verändernden Zugriffen auf die Datei auf den Wert 1 gesetzt wird. Standardmäßig wird das Archivbit von SEP sesam nicht verwendet, kann jedoch bei Bedarf in den Optionen mit -o clear_archive erzwungen werden. Normalerweise werden die Zeitinformationen für eine FULL, DIFF oder INC Sicherung in der SEP sesam Datenbank gespeichert, da das Archivbit auch von anderen Programmen verändert werden kann.
Einfluss der Sicherungsarten auf das A-Bit:
- Full sichert alle Dateien und setzt das A-Bit auf 0;
- Diff sichert nur Dateien mit A-Bit = 1 und lässt das A-Bit unverändert;
- Inc sichert nur Dateien mit A-Bit = 1 und setzt das A-Bit auf 0
- Copy sichert alle Dateien und lässt das A-Bit unverändert;
Anstatt das Archive Bit kann SEP sesam auch einen in der internen DB gepeicherten Zeitstempel verwenden. Dies ist vor allem dann interessant, wenn andere Programme ebenfalls das Archive Bit verwenden.
sm_db "insert into defaults (key,user_name,value) values ('with_archive_bit','sesam','no')"
Für UNIX Systeme
Deaktivieren der von UNIX benutzten Zeitstempel-Datei für ein UNIX backup. Stattdessen wird der Zeitstempel der sesam DB benutzt.
sm_db "insert into defaults (key,user_name,value) values ('with_timestamp_file','sesam','no')"
Environment für SEP sesam Prozesse
Speziell bei Datenbank Sicherungen ist es nötig, dass bestimte Environment Variablen gesetzt sind. Dies kann über Einträge in der sm.ini unter der Sektion [ENVIRONMENT] erreicht werden.
... [ENVIRONMENT] LD_LIBRARY_PATH=/opt/sesam/bin/sesam:/opt/lotus/notes/latest/linux ORACLE_HOME=/opt/oracle
Diese Einträge werden beim Startup von SEP sesam gelesen und gesetzt. Alle von SEP sesam gestarteten Prozesse erben dann diese Einstellungen.
Abschalten des Alive-Tests
Der SEP sesam Alivetest, der während einer Sicherung periodisch überprüft, ob der Sicherungsclient noch erreichbar ist, kann mit folgendem Befehl abgeschaltet werden:
sm_glbv w gv_ctrlc_no_alive on
Wieder aktiviert wird er mit:
sm_glbv R gv_ctrlc_no_alive
Problembehebung
Siehe: Problembehebung