Archive:Admin Handbuch 4.0

From SEPsesam
Jump to: navigation, search
Icon archived docs.png 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-2020. 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.


Contents

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
  1. Buchstabe der Eventart:
    S = Backup
    R = Restore oder der Restore einer Migration
    X = Remote Command
  2. Buchstabe der Sicherungsart:
    F = Full Backup
    D = Differentielles Backup
    I = Inkrementelles Backup
  3. Datum des Ereignisbeginns
  4. Zeit des Ereignisbeginns
  5. bis zur Tausendstel Sekunde
  6. Ein @ als Trennzeichen
  7. 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:

  1. Sicherung wurde beendet
  2. Rücksicherung wurde beendet
  3. 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:

  1. Modulname
  2. 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

Lis komprimieren.png

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.

Main de.JPG

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

  1. der GUI-Klient verbindet sich auf einen SEP sesam Server
  2. über die Datenbank werden die Namen der übrigen Server ermittelt.
  3. 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