$Id: LIESMICH.notes,v 1.7 2008/08/27 10:43:50 miraculix Exp $ Installationsanleitung SBCLN - SEPsesam Datensicherungsklient fuer Lotus Notes Beschreibung: Der SEPsesam Klient SBCLN ist eine Programmbibliothek zur Sicherung der Lotus Notes Datenbanken. 1. Voraussetzungen 1.1 Sesam Server Sesam Server Version 2.4. oder hoeher Das Programm /bin/sesam/sm_restore in der Version 1.221.2.4 oder hoeher. Test mit Aufruf 'sm_restore'. 1.2 Klient Zur Online Sicherung der Notes Datenbanken (*.nsf Dateien) ist es erforderlich diese Dateien temporär zwischenzuspeichern. Die Ablage erfolgt im work Bereich des Sesam Klienten. Deshalb ist es notwendig, dass dieser Bereich über genügend Platz zur Aufnahme der größten Notes Datenbank bietet. Empfohlen wird eine Partition die mindestens einen 5-fachen Platz bietet. 1.2.1 Linux - Ein vollstaendig installierter SBC Linux Klient der sich vom Sesam Server sichern laesst. - Zusaetzlich die Programmbibliothek libsbcln.so im Verzeichnis /bin/sesam/. - Zum Arbeiten mit Notes und zum Laden der Library muessen LOTUS, NOTES_DATA_DIR, Notes_ExecDirectory und PATH entsprechend der Notes Umgebung gesetzt und der LD_LIBRARY_PATH auf die Verzeichnisse der Bibliotheken libsbcln.so und der libnotes.so zeigen. Der Eintrag muss in der /etc/init.d/sesam mit export LOTUS=/opt/lotus/domino6/lotus export NOTES_DATA_DIR=/srv5/notesdata export Notes_ExecDirectory=$LOTUS/notes/latest/linux export Notes_Resources=$Notes_ExecDirectory/res SESAM_LIB_PATH=/opt/sesam/bin/sesam NOTES_LIB_PATH=$NOTES_DATA_DIR:$Notes_ExecDirectory:$Notes_Resources export PATH=$PATH:$NOTES_DATA_DIR:$Notes_ExecDirectory:$Notes_Resources export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$SESAM_LIB_PATH:$NOTES_LIB_PATH erfolgen, der SEPsesam Daemon gestoppt und erneut gestartet werden. /etc/init.d/sesam stop /etc/init.d/sesam start 1.2.2 Windows - Ein vollstaendig installierter SBC Win32 Klient der sich vom Sesam Server sichern laesst. - Zusaetzlich die Programmbibliothek sbcln.dll im Verzeichnis \bin\sesam\. - Die Systemvariable PATH muss den Pfad zu der Bibliothek NNOTES.DLL enthalten. Ist dies nicht der Fall so muss die Variable unter System - Umgebungsvariablen entsprechend gesetzt, z.B. PATH=...;C:\Programme\Lotus\Domino und der SEPsesam Service gestoppt und erneut gestartet werden. 2. Konfiguration Die weitere Konfiguration wird ueber die SEPsesam GUI durchgefuehrt 2.1 Ggf. Neuaufnahme des Lotus Notes Linux bzw. Windows Rechners 2.2 Auftraege 2.2.1 Quellangabe Die Auftraege werden mit dem Typ 'Lotus Notes' festgelegt. Als Quellangabe koennen angegeben werden: 1. Komplettsicherung: all 2. Sicherung mit Muster: *.nsf 3. Sicherung einzelner Dateien: mit voller oder relativer Pfadangabe z.B. /local/notesdata/mail/user1.nsf oder mail/user1.nsf 2.2.2 Optionen fuer Lotus Notes auf Linux Falls der Notes Benutzer nicht 'notes' ist, so muss dieser in den Auftragseigenschaften im Register 'Optionen 1' unter Sicherungs- und Ruecksicherungsoptionen mit -a USER={ihr-notes-user} angegeben werden. Falls sich die notes.ini nicht unter '/local/notesdata/notes.ini' befindet, so muss diese ebenfalls in den Sicherungs- und Ruecksicherungs- optionen mit -a NOTESINI={Kompletter Pfad zu notes.ini File} Beispiel fuer Sicherungs- und Ruecksicherungsoptionen: -a USER=lnsrv -a NOTESINI=/lnsrv/notes.ini 2.3 FULL, DIFFERENTIELL und INCREMENTELL Die Sicherungen FULL, DIFF und INCR werden als Vollstaendige Sicherung, Sicherung mit Aenderung seit dem letzen FULL und Sicherung der Transaktionsloggings ausgefuehrt. HINWEIS: Die DIFF Sicherung arbeitet ueber Archiv Bits und steht deshalb z.Z. nicht fuer Linux zur Verfuegung. 3. Ruecksicherung Ruecksicherungen koennen selektiv oder vollstaendig ausgefuehrt werden. Nur wenn 'mit ueberschreiben' ausgewaehlt wird werden die Datenbanken ueberschrieben. Wird 'mit recover' ausgewaehlt so wird jede Datenbank automatisch auch nachgezogen und aktiviert. Ohne 'recover' werden die Datenbanken lediglich am Zielsystem abgelegt. Die Transaktionsloggings werden nicht restauriert um die evtl. aktuell vorhandenen Log Dateien nicht zu ueberschreiben. Mit der zusaetzlichen Option '-a logs' werden nur die Transaktionsloggings aus dem Saveset am Klienten abgelegt! Diese Option kann unter "Experten Optionen" ergaenzt werden. 4. Desaster Ruecksicherung Im Falle eines Desasters kann die Ruecksicherung des Lotus Notes Systems als Pfadsicherung - mit ueberschreiben - ausgefuehrt werden. Dann werden alle Datenbanken, Transaktions Loggings, ID-Dateien und notes.ini am Server abgelegt. Der Notes Server muss davor beendet werden und kann nach der Ruecksicherung gestartet werden. Vor dem Start muss die Datei nlogctrl.* im Log Verzeichnis geloescht werden. Beim Start ueberprueft der Notes Server die Konsistenz der Datenbanken und zieht die Staende ggf. nach. 5. Troubleshooting 5.1 Temporaerer Platz reicht nicht Problem: Da jede Datenbank zunaechst am Klienten kopiert werden muss, kann es dazu kommen, dass der temporaere Platz nicht ausreicht. Loesung: Aendern Sie in der /ini/sm.ini den Pfad gv_rw_work auf ein Verzeichnis mit ausreichendem Platz. 5.2 Transaktionslogging nicht aktiv Problem: Die INCR Sicherungen misslingen. Loesung: Das Transaktionslogging fuer Notes muss aktiviert werden. 5.3 Ruecksicherung meldet inkorrekte Transaktionsloggings Problem: Nach der Ruecksicherung von Transaktionsloggings meldet Notes inkorrekte Transaktionsloggings. Loesung: Loeschen der Datei nlogctrl.* im Log Verzeichnis. Restart des Notes Servers. 5.4 Restart des Servers nach Notes Server Absturz misslingt Problem: Nach Lotus Notes Server Absturz laesst sich der Server ohne Reboot nicht mehr starten. Loesung: Kommt es waehrend einer Log-Sicherung zum Server Absturz so koennen logasio Prozesse aktiv bleiben. Diese Prozesse muessen gestoppt werden. UNIX: killall -9 logasio WINDOWS: sm_kill logasio Danach kann der Server wieder gestartet werden. 5.5 Ruecksicherung mit fehlenden Optionen Problem: Notes Restore auf Linux Klient endet mit: "RESTORE STATUS: Ruecksicherung war nicht erfolgreich. 2007-05-02 08:52:32: sbc-1146: Error: DB Module: [Notes API NotesInitExtended() failure" Loesung: Die Ruecksicherungsoptionen muessen identisch zu den Sicherungsoptionen gesetzt werden. Bitte Ruecksicherungsoptionen im Auftrag entsprechend setzen. Im Restorewizard koennen die Optionen in den 'Experten Optionen' im Tab 'Optionen' zusaetzlich gesetzt werden. Beispiel: -v 3 -a USER=lnsrv -a NOTESINI=/lnsrv/notes.ini