SEP sesam Extension für DB2

From SEPsesam

Jump to: navigation, search

SEP sesam Extension for IBM DB2

(C)SEP AG

Copyright 1999-2011 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.


Contents

Einleitung

SEP sesam online Sicherungen für IBM DB2 bieten eine XBSA Schnittstelle zwischen DB2 und SEP sesam zum Sichern von DB2 Datenbanken auf Sesam Server. XBSA API bestimmt den Zugriff der DB2 Backup Utility auf eine Sicherungsanwendung. SEP sesam verwaltet dann das gesamte Handling von Backup-Medien wie das Laden der korrekten Bänder, während DB2 backup entscheidet welche Daten gesichert oder rückgesichert werden. Dieses Dokument bietet Informationen über die Sesam-spezifischen Teile von DB2 Sicherungen. Es handelt sich hierbei nicht um ein DB2 Administrationshandbuch. Bitte lesen Sie die DB2 Administrationsdokumentation um sich mit den DB2 Sicherungs- und Rücksicherungs- Konzepten und Tools vertraut zu machen.


Systemvoraussetzungen

  • IBM DB2 7/8 unter Linux
  • SEP sesam v2.4
  • Standard Sesam Backup Client installiert
  • Dateisystem-Sicherungen sollten mit diesem Sesam Clienten funktionieren

Installation

Das SEP sesam DB2 Paket beinhaltet nur eine shared Library welche der DB2 Server während einer Sicherung oder Rücksicherung dynamisch lädt. Bitte passen Sie die Pfade und Variablen entsprechend ihren Bedürfnissen an.

  • <SESAM ROOT>/opt/sesam/bin/sesam (Sesam Installationsverzeichnis)

Installation unter Linux oder Unix

  • Zuerst stellen Sie sicher, dass der standard Sesam Backup Client bereits installiert ist.
  • Dateisystem-Sicherungen sollten mit diesem Sesam Client funktionieren
  • Einloggen als root User
  • Entpacken Sie die tar Datei in ein temporäres Verzeichnis
  • Kopieren Sie db2xbsa.so in das Verzeichnis <SESAM ROOT>/bin/sesam 
root@linux:~# cd /tmp
root@linux:/tmp # tar xvzf sesam-db2-2.4.1-14_linux.i386.tgz
sesam-db2-2.4.1-14/
sesam-db2-2.4.1-14/db2xbsa.so
sesam-db2-2.4.1-14/sesam-db2.pdf
root@linux:/tmp # cd sesam-db2-2.4.1-14/
root@linux:/tmp/sesam-db2-2.4.1-14 # cp db2xbsa.so /opt/sesam/bin/sesam

Konfiguration

Konfiguration am sesam Server

Erstellen Sie einen neuen Sicherungsauftrag für den DB2 Server mit dem Auftragstyp DB2 UDB. Die Sicherungsquelle kann beliebig gewählt werden, da DB2 entscheidet, welche Daten gesichert werden.

Konfiguration am DB2 Server

Um DB2 die nötigen Informationen zu geben um sich zu SEP sesam zu verbinden können die folgenden Optionen gesetzt werden:

Obligatorische Parameter

  • SESAM_SERVER Name des SEP sesam Server
  • SESAM_JOB Jobname des DB2 Backup. Name eines zuvor konfigurierten Auftrags am Sesam Server mit Auftragstyp DB2 UDB
  • SESAM_POOL Name eines zuvor konfigurierten Medienpools am Sesam Server

Optionale Parameter

  • SESAM_TAPE_SERVER Name eines Sesam Bandservers der verwendet werden soll
  • SESAM_DRIVE Zu verwendende Laufwerksnummer
  • XBSA_TRACE=<Trace level> ( 0|1|2 )
  • XBSA LOGFILE=<Voller Pfadname der trace file sdb2.log>

Obwohl XBSA und XBSA LGOFILE keine Pflichtfelder sind, sollten sie trotzdem gesetzt werden um im Falle eines Problems während der Sicherung oder Rücksicherung Informationen zu bekommen. Für die Rücksicherung sind nur SESAM _SERVER und SESAM_JOB Pflichtfelder.

DB2 Backup und Restore Konfiguration

Die folgenden Beispiele zeigen, wie Sicherungen und Rücksicherungen am DB2 Server gestartet werden können. Sie umfassen nicht alle Funktionen von DB2, sollten jedoch einen Überblick darüber geben, wie DB2 und SEP sesam zusammen verwendet werden können.

Backup der vollständigen Datenbank

 db2inst@linux:~>db2 BACKUP DATABASE sample_db ONLINE \
                     LOAD /opt/sesam/bin/sesam/db2xbsa.so \
                     OPTIONS 'SESAM_SERVER=midrangix;SESAM_JOB=db2_sample_db; \
                     SESAM_POOL=DISK;XBSA_LOGFILE=/home/db2inst1/sdb2.log; \
                     XBSA_TRACE=1' INCLUDE LOGS WITHOUT PROMPTING;

Restore der vollständigen Datenbank

 db2inst@linux:~>db2 RESTORE DATABASE sample_db \
                     LOAD /opt/sesam/bin/sesam/db2xbsa.so \
                     OPTIONS 'SESAM_SERVER=midrangix;SESAM_JOB=abas_db2_2; \
                     XBSA_LOGFILE=/home/db2inst1/sdb2.log;XBSA_TRACE=1' \
                     TAKEN AT 20060113134350 TO "/tmp/db2restore" INTO sample_db2

Installation in das DB2 Standard Verzeichnis

Anstatt die shared Library in das Verzeichnis SESAM ROOT/bin/sesam zu kopieren und den Pfad mittels dem Befehl 'LOAD' zu bestimmen, können Sie sie auch in das DB2 Library Verzeichnis am DB2 Server legen. Bitte passen Sie die Pfade und Variablen entsprechend ihren Bedürfnissen an.

  • DB2DIR=/opt/IBM/db2/V8.1 (Das DB2 Produkt Verzeichnis) 
root@linux:~# cd /tmp/sesam-db2-2.4.1-14
root@linux:/tmp/sesam-db2-2.4.1-14 # cp db2xbsa.so /opt/IBM/db2/V8.1/lib

Dann muss der DB2 Backup Befehl etwas geändert werden. Der 'LOAD' Parameter wird ersetzt mit 'USE XBSA'. 

 db2inst@linux:~>db2 BACKUP DATABASE sample_db ONLINE USE XBSA \
                     OPTIONS 'SESAM_SERVER=midrangix;SESAM_JOB=db2_sample_db; \
                     SESAM_POOL=DISK;XBSA_LOGFILE=/home/db2inst1/sdb2.log; \
                     XBSA_TRACE=1' INCLUDE LOGS WITHOUT PROMPTING;

Troubleshooting

  • Überprüfen Sie den Inhalt der $HOME/sqllib/db2dump/db2diag.log Datei des DB2 Benutzers.
  • Überprüfen Sie die Nachrichten am SEP sesam Server.
  • Weitere Informationen können Sie in der sdb2 Logfile finden. Der Name der Logfile wird gesetzt durch XBSA_LOGFILE=<Voller Pfadname der sdb2.log>; analog die Loglevel mit XBSA_TRACE=1. Alle Sesam XBSA Nachrichten haben das Präfix XBSA. Für weitere Informationen kann XBSA TRACE auf 2 gesetzt werden, aber dann können die Logfiles sehr groß werden.

Weitere Links/Literatur

Retrieved from "http://wiki.sepsoftware.com/wiki/index.php/SEP_sesam_Extension_f%C3%BCr_DB2"
Personal tools