Archive:SEP sesam extension für Ingres: Difference between revisions

From SEPsesam
m (Sta moved page SEP sesam extension für Ingres to Archive:SEP sesam extension für Ingres without leaving a redirect)
 
(10 intermediate revisions by 5 users not shown)
Line 1: Line 1:
== Introduction ==
{{Outdated de}}
{{Copyright SEP AG|de}}
== Einführung ==
SEPsesam extension für Ingres unterstützt die folgenden Funktionen:


SEPsesam extension for Ingres provides the following functions:
* Schnittstelle für ''chkdb'' und ''rollforward'' Befehle zur Benutzung von SEP sesam als Media Manager (anstatt der Nutzung von ''tar'')
* Komplettes Datenbank Backup über die SEP sesam GUI, eingeschlossen Daten, Journal und Dump Verzeichnisse
* Kompletter Desaster Restore der Datenbank


* Interface for ''chkdb'' and ''rollforward'' commands to use SEP sesam as media manager (instead of using ''tar'')
== Systemvoraussetzungen ==
* Complete database backup over Sesam GUI. This includes backup of data, journal and dump directories
* [http://wiki.sepsoftware.com/wiki/index.php/SEP_sesam_OS_and_database_support_matrix_4.0#Ingres Unterstützte Versionen]
* Complete disaster restore of database
* SEP sesam Server >= 3.6.4.5
 
* SEP Sesam extension für Ingres DB
== System requirements ==
* Erfolgreiche Installation des Standard Sesam Backup Klienten
 
* Eine Pfadsicherung von diesem Klienten muss funktionieren
* Ingres database 2006 or greater on Linux i386 or x86_64
* SEP Sesam Server >= 3.6.2.3
* SEP Sesam extension for Ingres DB
* Previous installation of the standard Sesam Backup Client
* working Sesam file system backup for this client


== Installation ==
== Installation ==
 
* Als erstes ist zu prüfen, ob ein Standard Sesam Backup Klient installiert ist
* First, verify that the standard Sesam Backup Client is already installed
* Als Benutzer '''root''' anmelden
* File system backup must be active for this Sesam client
* Die Datei <tt>sesam_ingres_x.x.x.x.tgz</tt> in ein temporäres Verzeichnis entpacken
* Login as '''root''' user
* Die Datei <tt>ingres/sbc_ingres</tt> in das Verzeichnis <tt><SESAM_BIN>/bin/sesam</tt> kopieren
* Unpack the file sesam_ingres_x.x.x.x.tgz in a temporary location
* Copy ingres/sbc_ingres into $<$SESAM_ROOT$>$/bin/sesam directory
 


   root@db:~> cd /tmp                                                     
   root@db:~> cd /tmp                                                     
Line 30: Line 27:
== Backup ==
== Backup ==


=== Complete database backup ===
=== Komplettes Datenbank Backup ===
In diesem Fall ruft Sesam den Befehl '''ckpdb''' auf und erzeigt damit einen Checkpoint. Nach dem Sichern aller Dateien des Checkpoints, wird eine Sicherung der Verzeichnisse ''dump'' und ''journal'' durchgeführt. Mit diesen Informationen ist es möglich einen kompletten Desaster Recovery Vorgang auszuführen.


In this case Sesam calls Ingres executable '''ckpdb''' to perform a checkpoint. After saving all files of checkpoint,
Die Sicherungsquelle hat folgendes Format:
a backup of the ''dump'' and ''journal'' directories is made.
With this information a complete disaster recovery of database is possible.
 
The backup source has the following format:


   <db name>@<path of config file>
   <db name>@<path of config file>
Line 42: Line 36:
   test2@/opt/Ingres/IngresII/ingres/data/default/test2/aaaaaaaa.cnf
   test2@/opt/Ingres/IngresII/ingres/data/default/test2/aaaaaaaa.cnf


{{Box Attention|Backup source has to be entered manually|
{{Box Attention|ACHTUNG|
In current version, it's not possible to use the GUI file system browser to choose the backup source}}
In der aktuellen Version ist es nicht möglich die Sicherungsquelle zu browsen und über die SEP sesam GUI auszuwählen. Die Sicherungsquelle muss manuell eingegeben werden!
}}




==== Additional backup options ====
==== Weitere Sicherungsoptionen ====
Es können weitere Optionen für den Auftrag im Feld '''Optionen 1->Sicherungsoptionen''' mittels des Schalters '''<tt>-a</tt>''' eingegeben werden:


You can enter additional options for the tasks in '''Options 1->Save options''' by '''-a''' switch:
;delete=last: Löscht den letzten Checkpoint nach dem Backup


;delete=last: Delete last checkpoint after backup
;delete=all: Löscht alle Checkpoints nach dem Backup


;delete=all: Delete all checkpoints after backup
;dbuser=<ingres OS user>: Benutzt diesen Betriebsystem-Benutzer anstatt des Standardbenutzers ''ingres''


;dbuser=<ingres os user>: Use this OS account instead of default user ''ingres''
'''Beispiel''':


'''Example''':
Benutze User ''ingres2'' zur Sicherung und Lösche alle Checkpoints nach dem erfolgreichen Backup
 
Use user ''ingres2'' for backup and deletes all checkpoints after successful backup 


   -a delete=all,dbuser=ingres2
   -a delete=all,dbuser=ingres2


=== Checkpoint backup ===
=== Checkpoint Backup ===
 
Hier agiert der Sesam als ''Media Manager'', d.h. anstatt des ''tar'' Befehls werden die Datenbank-Dateien direkt durch den SEP sesam Server gesichert. Um den Sesam als ''Media Manager zu nutzen, ist eine angepasste Checkpoint Template Datei zu erzeugen:
In this case Sesam acts as ''Media Manager''. Instead of the default '''tar''' command, database files are  directly saved by Sesam
Server.
To use Sesam as ''media manager'' an adopted check point template file has to be created:
 


* Create a copy of the  ''Default Template File'':
* Eine Kopie des ''Default Template File'' erstellen:
   cp /opt/Ingres/IngresII/ingres/files/cktmpl.def /opt/Ingres/IngresII/ingres/files/cktmpl_sm.def
   cp /opt/Ingres/IngresII/ingres/files/cktmpl.def /opt/Ingres/IngresII/ingres/files/cktmpl_sm.def


* Adopt the template file:
* Die Template Datei anpassen:


   old:  WSDD: cd %D; /bin/tar cf %A *
   old:  WSDD: cd %D; /bin/tar cf %A *
Line 80: Line 70:
   new: WRDD: cd %D; /opt/sesam/bin/sesam/sbc_ingres rollforward -r -j ingres -S barometrix %D %A
   new: WRDD: cd %D; /opt/sesam/bin/sesam/sbc_ingres rollforward -r -j ingres -S barometrix %D %A


The task (-j) has to be created in Sesam GUI as described before.
Der Auftrag (-j) muss vorher über die SEP sesam GUI erstellt worden sein.




* Set of environment variable '''II_CKTMPL_FILE''':
* Setzen der Umgebungsvarible '''II_CKTMPL_FILE''':


   export II_CKTMPL_FILE=/opt/Ingres/IngresII/ingres/files/cktmpl_sm.def
   export II_CKTMPL_FILE=/opt/Ingres/IngresII/ingres/files/cktmpl_sm.def


Certainly the ''Default Template'' can be adopted too, but then Sesam is always used for creating checkpoints.
Das ''Default Template'' kann natürlich auch benutzt und angepasst werden, aber dann wird immer der Sesam Dienst zur Erzeugnung von Checkpoint benutzt.


Der Dateiname ''cktmpl_seseam.def'' ist reserviert für die interne Benutzung durch den Sesam.


The filename ''cktmpl_seseam.def'' is reserved, because Sesam use it internally.
{{Box Attention|ACHTUNG|
 
Nur ein Checkpoint ist für ein Disaster Recovery nicht ausreichend! Wenn Sie NUR einen Checkpoint erzeugen, dann stellen Sie sicher, dass die verzeichnisse ''dump'' und ''journal'' über einen separaten Pfadbackup-Auftrag gesichert werden.
{{Box Attention|Checkpoint is not sufficient for disaster recovery|
}}
If you only create checkpoints, then make sure, that ''dump'' and ''journal'' directories are saved by
normal file system backups}}


== Recovery ==
== Recovery ==


=== Disaster Recovery ===
=== Disaster Recovery ===
 
* Die Datenbank muss existieren, bevor sie recovered werden kann
* The database must exist before it can be recovered
* Das SEP sesam Backup Log kann helfen den Datenort zu identifizieren
* SEP sesam backup log can help you to identify the data locations
 


=== Restore ===
=== Restore ===
Wenn ein komplettes Backup durchgeführt wurde, können über die SEP sesam GUI alle notwendigen Dateien zurückgesichert werden. Im Restore Wizard ist die Sicherung des Konfigurations-Files zu benutzen, nicht das externe Checkpoint Backup.


Die Option '''gewählten Auftrag komplett zurücksichern''' wählen.


If a complete backup has been done from Sesam all necessary files can be restored by Sesam GUI.
In restore wizzard the backup of configuration file has to be used, not the external checkpoint backup.
'''TODO''': Easier identify this backup in restore  wizzard
Select '''complete restore of selected task'''
==== Options ====
;Overwrite: Overwrite all exiting files
;Auto recover after restore: Starts ''rollforward'' command after data restore
;Auto recover adn online after restore: Starts ''rollforward'' command after data restore
'''Hint:''' There is no difference between the two ''Auto recover'' options in case of Ingres restore


==== Additional options ====
==== Ausführungsoptionen ====


;until=<timstamp>: Point in time recover
;Überschreiben: Überschreibt alle existierenden Dateien
;Auto Recover nach Restore: Startet den Befehl ''rollforward'' nach dem Rücksichern der Daten
;Auto Recover und Online nach Restore: Startet den Befehl ''rollforward'' nach dem Rücksichern der Daten


;checkpoint=<checkpoint number>: Using this checkpoint for recover
'''Hinweis:''' Es ist kein Unterschied zwischen den beiden ''Auto Recover'' Optionen beim Ingres Restore.


==== Weitere Optionen ====


;until=<timstamp>: Point in time recover (PITR)
   -a until=01-aug-2009:07:13:58
   -a until=01-aug-2009:07:13:58


=== File system restore ===
;checkpoint=<checkpoint number>: Das Recover wird bis zu diesem Checkpoint durchgeführt


As data is saved in files these files can be restored into the file system. To do this,
=== Dateisystem-Rücksicherung ===
select a '''new target''' in restore wizzard starting with '''/'''.
Wie Daten, die in Dateien gesichert werden, können diese ebenso wieder in das Dateisystem zurückgespielt werden. Hierzu ist die Option '''neues Rücksicherungsziel''' im Restore Wizard zu wählen mit '''<tt>/</tt>''' (root) als Ziel. Es wird dann kein Ingres spezifischer Prozess ausgeführt, sondern eine einfache Dateirücksicherung.  
There will be no Ingres specific processing in this case.


'''Example:'''
'''Beispiel:'''


Restore all files into '''/tmp/ingresrestore'''
Alle Dateien nach  <tt>/tmp/ingresrestore</tt> zurückspielen.


   /tmp/ingresrestore
   /tmp/ingresrestore

Latest revision as of 17:36, 10 January 2017

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

Einführung

SEPsesam extension für Ingres unterstützt die folgenden Funktionen:

  • Schnittstelle für chkdb und rollforward Befehle zur Benutzung von SEP sesam als Media Manager (anstatt der Nutzung von tar)
  • Komplettes Datenbank Backup über die SEP sesam GUI, eingeschlossen Daten, Journal und Dump Verzeichnisse
  • Kompletter Desaster Restore der Datenbank

Systemvoraussetzungen

  • Unterstützte Versionen
  • SEP sesam Server >= 3.6.4.5
  • SEP Sesam extension für Ingres DB
  • Erfolgreiche Installation des Standard Sesam Backup Klienten
  • Eine Pfadsicherung von diesem Klienten muss funktionieren

Installation

  • Als erstes ist zu prüfen, ob ein Standard Sesam Backup Klient installiert ist
  • Als Benutzer root anmelden
  • Die Datei sesam_ingres_x.x.x.x.tgz in ein temporäres Verzeichnis entpacken
  • Die Datei ingres/sbc_ingres in das Verzeichnis <SESAM_BIN>/bin/sesam kopieren
  root@db:~> cd /tmp                                                     
  root@db:/tmp> tar xvzf sesam_ingres.tgz                                
  root@db:/tmp> cp sesam_ingres_3.4.1.60/sbc_ingres /opt/sesam/bin/sesam

Backup

Komplettes Datenbank Backup

In diesem Fall ruft Sesam den Befehl ckpdb auf und erzeigt damit einen Checkpoint. Nach dem Sichern aller Dateien des Checkpoints, wird eine Sicherung der Verzeichnisse dump und journal durchgeführt. Mit diesen Informationen ist es möglich einen kompletten Desaster Recovery Vorgang auszuführen.

Die Sicherungsquelle hat folgendes Format:

 <db name>@<path of config file>
 .
 test2@/opt/Ingres/IngresII/ingres/data/default/test2/aaaaaaaa.cnf
ACHTUNG

In der aktuellen Version ist es nicht möglich die Sicherungsquelle zu browsen und über die SEP sesam GUI auszuwählen. Die Sicherungsquelle muss manuell eingegeben werden!


Weitere Sicherungsoptionen

Es können weitere Optionen für den Auftrag im Feld Optionen 1->Sicherungsoptionen mittels des Schalters -a eingegeben werden:

delete=last
Löscht den letzten Checkpoint nach dem Backup
delete=all
Löscht alle Checkpoints nach dem Backup
dbuser=<ingres OS user>
Benutzt diesen Betriebsystem-Benutzer anstatt des Standardbenutzers ingres

Beispiel:

Benutze User ingres2 zur Sicherung und Lösche alle Checkpoints nach dem erfolgreichen Backup

 -a delete=all,dbuser=ingres2

Checkpoint Backup

Hier agiert der Sesam als Media Manager, d.h. anstatt des tar Befehls werden die Datenbank-Dateien direkt durch den SEP sesam Server gesichert. Um den Sesam als Media Manager zu nutzen, ist eine angepasste Checkpoint Template Datei zu erzeugen:

  • Eine Kopie des Default Template File erstellen:
 cp /opt/Ingres/IngresII/ingres/files/cktmpl.def /opt/Ingres/IngresII/ingres/files/cktmpl_sm.def
  • Die Template Datei anpassen:
 old:  WSDD: cd %D; /bin/tar cf %A *
 new:  WSDD: cd %D; /opt/sesam/bin/sesam/sbc_ingres ckpdb -b -j ingres -S barometrix -m LARGE %D %A
 old: WRDD: cd %D; /bin/tar xf %A
 new: WRDD: cd %D; /opt/sesam/bin/sesam/sbc_ingres rollforward -r -j ingres -S barometrix %D %A

Der Auftrag (-j) muss vorher über die SEP sesam GUI erstellt worden sein.


  • Setzen der Umgebungsvarible II_CKTMPL_FILE:
 export II_CKTMPL_FILE=/opt/Ingres/IngresII/ingres/files/cktmpl_sm.def

Das Default Template kann natürlich auch benutzt und angepasst werden, aber dann wird immer der Sesam Dienst zur Erzeugnung von Checkpoint benutzt.

Der Dateiname cktmpl_seseam.def ist reserviert für die interne Benutzung durch den Sesam.

ACHTUNG

Nur ein Checkpoint ist für ein Disaster Recovery nicht ausreichend! Wenn Sie NUR einen Checkpoint erzeugen, dann stellen Sie sicher, dass die verzeichnisse dump und journal über einen separaten Pfadbackup-Auftrag gesichert werden.

Recovery

Disaster Recovery

  • Die Datenbank muss existieren, bevor sie recovered werden kann
  • Das SEP sesam Backup Log kann helfen den Datenort zu identifizieren

Restore

Wenn ein komplettes Backup durchgeführt wurde, können über die SEP sesam GUI alle notwendigen Dateien zurückgesichert werden. Im Restore Wizard ist die Sicherung des Konfigurations-Files zu benutzen, nicht das externe Checkpoint Backup.

Die Option gewählten Auftrag komplett zurücksichern wählen.


Ausführungsoptionen

Überschreiben
Überschreibt alle existierenden Dateien
Auto Recover nach Restore
Startet den Befehl rollforward nach dem Rücksichern der Daten
Auto Recover und Online nach Restore
Startet den Befehl rollforward nach dem Rücksichern der Daten

Hinweis: Es ist kein Unterschied zwischen den beiden Auto Recover Optionen beim Ingres Restore.

Weitere Optionen

until=<timstamp>
Point in time recover (PITR)
 -a until=01-aug-2009:07:13:58
checkpoint=<checkpoint number>
Das Recover wird bis zu diesem Checkpoint durchgeführt

Dateisystem-Rücksicherung

Wie Daten, die in Dateien gesichert werden, können diese ebenso wieder in das Dateisystem zurückgespielt werden. Hierzu ist die Option neues Rücksicherungsziel im Restore Wizard zu wählen mit / (root) als Ziel. Es wird dann kein Ingres spezifischer Prozess ausgeführt, sondern eine einfache Dateirücksicherung.

Beispiel:

Alle Dateien nach /tmp/ingresrestore zurückspielen.

 /tmp/ingresrestore

Links

http://downloads.ingres.com/online/media/pdf/Education-Series/EducationSeriesHowToBackupYourDataWithIngres.pdf