SEP sesam Extension für Informix

From SEPsesam

SEP sesam Extension for Informix

(C)SEP AG, R. Seyerlein

Copyright 1999-2009 by SEP AG. All Rights reserved.

Any form of reproduction of the contents or parts of this manual is allowed only with the express written permission from SEP AG. When compiling and designing user documentation SEP AG uses great diligence and attempts to deliver accurate and correct information. However, SEP AG cannot issue a guarantee for the contents of this manual.

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 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 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 Rpcksicherungskonzepten und -tools vertraut zu machen.

Systemvoraussetzungen

• Informix Dynamic Server 7/9/2000 on Linux, Unix oder Windows
• SEP sesam v3.2
• SEP sesam Extension für Informix
• Der standard Sesam Sicherungsclient ist bereits installiert
• Funktionierende SEP sesam Dateisystem Sicherungen für diesen Clienten

Installation

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 werden und der volle Pfad dazu muss unter BAR_BSALIB_PATH in die ONBAR Konfigurationsdatei eintragen werden.

Fpr 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 Sesam Sicherungsclient bereits installiert ist
• Dateisystem Sicherungen sollten mit diesem Sesam Clienten 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<tt>:

<tt>BAR_BSALIB_PATH Pfad zur installierten SEP sesam Library

BAR_MAX_BACKUP Anzahl paralleler Sicherungs-sessions

Beispiel:

 ...
 # 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
 ....

Um die Version der XBST Spezifizierung, die SEP sesam unterstützt, einzustellen muss der folgende Eintrag in die Tabelle bar_version in der sysysutils Datenbank eingefüt werden.

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>

Konfiguration auf dem 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 Sesam Server
• mit Auftragstyp Informix
• SESAM_POOL=<Medienpool Name>
• Name eines bereits konfigurierten Medienpools am Sesam Server

Optionale Parameters

• XBSA_TRACE=<Trace level> ( 0|1|2 )
• 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.

• 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 -l -c

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 -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 -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), standart 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 -l     - Sicherung von allen vollständigen logischen Logfiles
onbar -l -c  - Sicherung der aktuellen logischen Logfiles und Wechsel zur nächsten logischen Logfile.
onbar -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> </li>

Rücksicherung der logischen Logs (für dbspaces, die physisch rückgesichert wurden)

onbar -r -l</li>

onbar -r ... -O

onmode -O

Troubleshooting

• Vergewissern Sie sich, dass die folgenden Umgebungsvariablen INFORMIXDIR, INFORMIXSERVER, ONCONFIG, ROOTPATH korrekt gesetzt sind.
• Überprüfen Sie die Nachrichten auf dem SEP sesam Server.
• Weitere Informationen können in den Logfiles auf ONBAR und SIB gefunden werden.
• SEP empfiehlt nur eine einzelne log file für ONBAR und XBSA Meldungen zu verwenden.
• Dadurch können Sie sämtliche Aufrufe der Datenbank und des sesams in der korrekten Reihenfolge sehen.
• Hierfür setzen Sie die Umgebungsvariable XBSA_LOGFILE=<complete path to bar_act.log> und XBSA_TRACE=1.
• Alle SIB (sesam) Meldungen haben das Präfix SIB.
• Um weitere Informationen zu bekommen kann XBSA_TRACE auf 2 gesetzt werden wodurch allerdings die Logfiles recht groß werden können.
• Um das ONBAR Log zu aktivieren fügen Sie die folgende Zeile in the onconfig Datei ein:

BAR_DEBUG       2    \# where 'num' = 0-9; 9 producing heaps output defaults to /tmp/bar_dbug.log

Weiterführende Links/Literatur

• SEP sesam Extension für Informix
• 'Informix Backup and Restore Guide'
• 'Backup Services Application Programmer's Interface'
• 'INFORMIX-OnLine Dynamic Server, Backup and Restore Guide'
• 'System Management: Backup Services API (XBSA)'