Archive:SEP sesam Extension für Informix

From SEPsesam

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.

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.


Einleitung

Die SEP sesam Online Sicherung für Informix (sib) bietet eine XBSA Schnittstelle zwischen Informix und SEP sesam zur Sicherung von Informix Datenbanken auf SEP sesam Server. XBSA API bestimmt den Zugang von der Informix Onbar Utility zu einer Sicherungsanwendung. SEP sesam verwaltet die gesamte Verwendung von Backup Medien wie das Laden der korrekten Bänder, während ONBAR entscheidet welche Daten gesichert oder rückgesichert werden sollen. Dieses Dokument behandelt die SEP sesam-spezifischen Teile von Informix Sicherungen. Es handelt sich hierbei nicht um ein Informix/ONBAR Administrationshandbuch. Bitte lesen Sie die Informix Dokumentation zu ONBAR um sich mit den Sicherungs- und Rücksicherungskonzepten und -tools vertraut zu machen.

Systemvoraussetzungen

Installation

Installation auf Linux oder Unix

Das SIB Paket beinhaltet nur eine Shared Library welche der Informix Server während der Sicherung bzw. der Rücksicherung dynamisch lädt. Die Library muss auf den Informix Server kopiert und der volle Pfad unter BAR_BSALIB_PATH in die ONBAR Konfigurationsdatei eintragen werden.

Für die Installation gehen wir von der folgenden Umgebung aus. Bitte passen Sie die Pfade und Variablen Ihren Bedürfnissen entsprechend an.

  • INFORMIXDIR=/opt/informix
  • ONCONFIG=/opt/informix/etc/onconfig

Installation unter Linux oder Unix

  • Verifizieren Sie als erstes, dass der standard- SEP sesam Sicherungsclient bereits installiert ist
  • Dateisystem Sicherungen sollten mit diesem SEP sesam Client funktionieren
  • Als Benutzer informix einloggen
  • Erstellen Sie ein neues Verzeichnis namens sib in $INFORMIXDIR
  • Entpacken Sie die Datei <OS>_ssib_x.x.x.x.tgz dorthin
  • Erstellen Sie einen symbolischen Link zu der entpackten Library Datei ibsad001.so in \$INFORMIXDIR/lib. Fall die Datei bereits existiert muss diese vorher umbenannt werden.
 informix@linux:~> cd $INFORMIXDIR
 informix@linux:/opt/informix> mkdir sib
 informix@linux:/opt/informix> cd sib
 informix@linux:/opt/informix/sib> tar xzf /tmp/linux_sib.2.3.1.1.tgz
 informix@linux:/opt/informix> cd ../lib
 informix@linux:/opt/informix/lib> ln -s ../sib/ibsad001.so
  • PATH Umgebungsvariable sollte $INFORMIXDIR/bin beinhalten
  • Überprüfen Sie die Sicherungs-/Rücksicherungsspezifischen Einträge in der Datei ONCONFIG:

BAR_BSALIB_PATH Pfad zur installierten SEP sesam Library

BAR_BSALIB_PATH Path to installed SEP sesam library

Beispiel (Linux): 

 ...
 # Backup/Restore variables
 BAR_ACT_LOG             /opt/informix/log/bar_act.log
 #BAR_MAX_BACKUP         0
 BAR_MAX_BACKUP          4
 #BAR_RETRY              3
 BAR_RETRY               2
 BAR_NB_XPORT_COUNT      10
 BAR_XFER_BUF_SIZE       31
 BAR_BSALIB_PATH /opt/informix/lib/ibsad001.so
 BAR_DEBUG       3
 BAR_DEBUG_LOG   /opt/informix/log/xbsa.log
 ....

Installation auf Windows

Installations Schritte:

  • Verifizieren Sie als erstes, dass der standard- SEP sesam Sicherungsclient bereits installiert ist
  • Dateisystem Sicherungen sollten mit diesem SEP sesam Client funktionieren
  • Als Benutzer informix einloggen
  • Extrahieren des geeigneten libbsa.dll aus dem SEP Download https://www.sep.de/downloadportal/extensions/databases/informix/windows/ (ZIP Archiv) - entweder x64 oder x86 und einkopieren nach sesam_install_dir\bin\sesam.
  • Überprüfen Sie die Sicherungs-/Rücksicherungsspezifischen Einträge in der Datei ONCONFIG. Setzen Sie BAR_BSALIB_PATH auf den Pfad für libbsa.dll.
Achtung

Der Pfad zur libbsa.dll muss in der Kurznotation angegeben werden wenn SEP sesam in einem Pfad mit Leerschritt installiert wurde, z.B. 'C:\Program Files\SEPsesam\bin\sesam'. dir /X C: kann zum Auffinden der Kurznotation verwendet werden!

Beispiel für Windows:

  • INFORMIXDIR=C:\PROGRA~1\IBM\Informix\11.70
  • ONCONFIG=%INFORMIXDIR%\etc\ONCONFIG.ol_myinst
 ...
 # Backup/Restore variables
 BAR_ACT_LOG		C:\PROGRA~1\IBM\Informix\11.70\bar_ol_myinst.log	#Path of log file for onbar.exe
 BAR_DEBUG_LOG		C:\PROGRA~1\IBM\Informix\11.70\bar_ol_myinst.log	#Path of the debug log for onbar.exe
 BAR_DEBUG 0
 #BAR_MAX_BACKUP         0
 BAR_MAX_BACKUP          2
 #BAR_RETRY              1
 BAR_RETRY               2
 BAR_NB_XPORT_COUNT 20
 BAR_XFER_BUF_SIZE 15
 RESTARTABLE_RESTORE ON
 BAR_PROGRESS_FREQ 0
 BAR_BSALIB_PATH	C:\PROGRA~1\SEPsesam\bin\sesam\libbsa.dll	# Location of SEP sesam LIBBSA DLL
 BACKUP_FILTER
 RESTORE_FILTER
 BAR_PERFORMANCE 0
 BAR_CKPTSEC_TIMEOUT 15
 ...

Common Installation Steps

BAR_MAX_BACKUP Anzahl paralleler Sicherungs-sessions

Wichtig

BAR_MAX_BACKUP muss mindestens '2' sein, ansonsten funktionieren keine Restores

Um die von SEP sesam unterstützte Version der XBSA Spezifizierung einzustellen muss folgender Eintrag in die Tabelle bar_version in der sysysutils Datenbank eingefügt werden.


bar_version
bsa_version
bar_sm
sm_version
1
1.0.1
sesam
1

Anstatt diesen Eintrag in die Datenbank einzufügen können Sie auch die INFORMIX Vorlagendatei übernehmen.

  • Kopieren Sie die Vorlagendatei $INFORMIDIR/etc/sm_versions.std nach $INFORMIXDIR/etc/sm_versions
  • Fügen Sie die folgende Zeile an 1|1.0.1|sesam|1|
informix@linux:/opt/informix/> cd $INFORMIDIR/etc>
informix@linux:/opt/informix/etc> cp sm_versions.std sm_versions
informix@linux:/opt/informix/etc> vi sm_versions
informix@linux:/opt/informix/etc> cat sm_versions
#1|1.0.1|ism|1|
1|1.0.1|sesam|1|
informix@linux:/opt/informix/etc>
Info

Für die Verwendung von SEP sesam Befehlsterminen sollten die Login-Skripte keine weiteren Eingaben benötigen!

Konfiguration auf dem SEP sesam Server

Erstellen Sie einen neuen Sicherungsauftrag auf dem Informix server mit dem Auftragstyp Informix. Die Eingabe der Sicherungsquelle ist nicht relevant, da ONBAR bestimmt, welche Daten gesichert werden.

Konfiguration auf dem Informix server

Um ONBAR mit den nötigen Informationen zu versorgen um ein Verbindung mit SEP sesam aufzubauen müssen die folgenden Umgebungsvariablen gesetzt werden.

Obligatorische Parameter

  • INFORMIXDIR (gesetzt von der Informix Installation).
  • SESAM_SERVER=<Name des SEPsesam Servers>
  • SESAM_JOB=<Jobname der Informix Sicherung>
    Name eines bereits konfigurierten Auftrags am SEP sesam Server mit Auftragstyp Informix
  • SESAM_POOL=<Medienpool Name>
    Name eines bereits konfigurierten Medienpools am SEP sesam Server

Optionale Parameters

  • XBSA_TRACE=<Trace level> ( 0|1|2 ) (eine Ausgabe auf STDERR kann mit +10000000 erreicht werden, z.B. 'set XBSA_TRACE=10000002')
  • XBSA_LOGFILE=<Name of trace file>

Obwohl XBSA_TRACE und XBSA_LOGFILE nicht zwingend eingegeben werden müssen ist dies trotzdem ratsam um, im Falle eines Problems während der Sicherung/Rücksicherung, Informationen zu bekommen. Für Rücksicherungen ist nur SESAM_SERVER obligatorisch.

ONBAR Sicherung Konfiguration

Die folgenden Beispiele zeigen wie Sicherungen oder Rücksicherungen am Informix Server gestartet werden können. Es werden zwar nicht alle Funktionen von ONBAR erklärt, jedoch sollte daraus ersichtlich sein, wie ONBAR und SEP sesam zusammen genutzt werden können.

Hinweis

Der Rückgabecode von onbar muss immer überprüft werden, da onbar keine Fehlermeldungen auf STDERR schreibt! Die Bedeutungen der Rückgabecodes kann im Informix Sicherungs- und Rücksicherungsguide unter Anhang A: ON-Bar Meldungen und Rückgabecodes gefunden werden. Sie müssen als informix oder root angemeldet sein um onbar zu verwenden.


  • Sicherung des Tablespace dbspace01
informix@linux:/opt/informix/> export SESAM_SERVER=backupsrv
informix@linux:/opt/informix/> export SESAM_JOB=informix_ts
informix@linux:/opt/informix/> export SESAM_POOL=DISK
informix@linux:/opt/informix/> onbar -b -L 0 dbspace01
informix@linux:/opt/informix/> echo $?
0
informix@linux:/opt/informix/>


Die Befehle im folgenden Beispiel:

  • Führen eine level 0 Sicherung auf "'dbspace01"' durch auf einer Online Dynamic Server Instanz namens venus.
  • Sichern alle logischen Log Dateien die mit "'dbspace01"' zusammen hängen
  • Schließen und sichern das aktuelle logische Log
setenv SESAM_SERVER jupiter 
setenv INFORMIXDIR /usr/informix 
setenv INFORMIXSQLHOSTS \$INFORMIXDIR/etc/sqlhosts 
setenv ONCONFIG onconfig.std

onbar -b -L 0 dbspace01 
onbar -b -l -c
Info
Die SEP sesam Extension für Informix - Windows (https://www.sep.de/downloadportal/extensions/databases/informix/windows/) ZIP Archive enthalten die sbc_onbar.cmd Command Datei welche zur Sicherung einer Informix Instanz mit Hilfe des SEP Sesam Befehlstermin durch Anpassung der INFORMIX_... und SESAM_... Variablen geeignet ist.
Die Argumente werden an das onbar Programm weitergereicht. Typische Aufrufe "sbc_onbar.cmd -b -L 0", or "sbc_onbar.cmd -v".

ONBAR Rücksicherungs-Konfiguration

ONBAR bestimmt die Rücksicherung der gesicherten Daten. Die shared XBSA Library übersetzt Informix Namen, die von ONBAR kommen, in SESAM server Savesets (Ein Datensatz) um diese später von der Datenbank des SESAM Servers holen und auf Informix zurücksichern zu können.


Physische Rücksicherung: 

setenv SESAM_SERVER jupiter 
setenv INFORMIXDIR /usr/informix 
setenv INFORMIXSQLHOSTS \$INFORMIXDIR/etc/sqlhosts 
setenv ONCONFIG onconfig.std

onbar -r -p

Physische Rücksicherungen ersetzen verlorene oder korrupte Speicherplätze aus SESAM Sicherungsmedien.

Falls ein kritischer Speicherplatz aufgrund eines Laufwerksfehlers beschädigt ist geht der dynamische server offline.

Sollte ein Laufwerksfehler oder Datenkorruption den Server nicht dazu veranlassen offline zu gehen, können Sie sämtliche nicht kritische Storage Spaces rücksichern.


Logische Rücksicherung: 

setenv SESAM_SERVER jupiter 
onbar -r -1

Logische Rücksicherungen stellen die Server-Transaktionen, die seit der letzten Speicherplatz Sicherung gemacht wurden, wieder her, gefolgt von einer Weiterleitung der logischen Logs, die für die Speicherplätze gesichert wurden. Wenn verschiedene Backups laufen, werden die Transaktionen während der Sicherung weiter in das aktuelle Log file der jeweiligen spaces geschrieben.


Kombinierte Rücksicherung: 

setenv SESAM_SERVER jupiter
onbar -r

Kombinierte Rücksicherungen ermöglichen es einen einzelnen Befehl zur Durchführung einer physischen Rücksicherung direkt gefolgt von einer logischen Rücksicherung. Zur feineren Kontrolle kann der Befehl onbar -b -l -s verwendet werden um die Logs zu verwerten, wonach mit dem Befehl onbar -r -l nur eine logische Rücksicherung durchgeführt wird.


Point-in-time Restore: 

setenv SESAM_SERVER jupiter
onbar -r -t time -w -p

Point-in-time restores involve performing a whole-system, physical restore of Informix data from a whole-system-backup to a specified time instead of the default, which is time of the last Informix backup.

There is two different kind of restore you can perform in dependence of Informix Dynamic Server current mode. If the server is in quiescent mode or is on-line, you can perform a warm restore (Use the -O option to restore an on-line storage space). Otherwise, if server resides in off-line mode, the restore operation is called a cold restore.

for example Logical Log: 

onbar -b -l -L 0 dbspace01

Sicherung und Rücksicherung - Übersicht

Hier finden Sie die Befehle für die folgenden Szenarien.


Sicherung der Datenbank

Vollständige Sicherung der Datenbank (falls nötig muss die Datenbank mit oninit -v gestartet werden) 

onbar -b -w  [-L n]
n - Backup Level (0, 1, 2), Standard ist 0.

Sicherung eines einzelnen dbspace 

onbar -b [-L n] 
n - Backup Level (0, 1, 2), default is 0.
dbspace_name - Name der Informix bdspace Instanz

Logisches Logfiles Backup 

onbar -b -l     - Sicherung von allen vollständigen logischen Logfiles
onbar -b -l -c  - Sicherung der aktuellen logischen Logfiles und Wechsel zur nächsten logischen Logfile.
onbar -b -l -s  - Sicherung aller logischen Logs die sich nach einem Crash der Datenbank auf der Festplatte befinden.


Datenbank Rücksicherung

Rücksicherung der vollständigen Datenbank (cold restore) 

onmode -ky   - Shutdown der Datenbank
onbar -r -w  - Rücksicherung aller Daten

Rücksicherung der down dbspaces und zugehörigen Logfiles (cold) 

onbar -r

Rücksicherung der down dbspaces ohne logische Logs (cold) 

onbar -r -p

Rücksicherung einzelner dbspaces

onbar -r <dbspace_name_1> <dbspace_name_2> Rücksicherung der logischen Logs (für dbspaces, die physisch rückgesichert wurden) onbar -r -l

Info

Wurden Teilbereiche gelöscht, sollte die Option -O verwendet werden, da damit eventuell die Teilbereiche wiederhergestellt werden können: 

onbar -r ... -O

Manchmal wird wegen des fehlenden Teilbereichs kein Checkpoint geschrieben. Diese Situation kann verhindert werden durch: 

onmode -O

oder indem die Datenbank heruntergefahren wird mit anschließender kalter Rücksicherung.

Bekannte Themen

Im Falle von Problemen mit Informix bitte hier schauen: Informix Troubleshooting.

Weiterführende Links/Literatur

Retrieved from "https://wiki.sep.de/wiki/index.php?title=Archive:SEP_sesam_Extension_für_Informix&oldid=221996"