Archive:SEPsesam Extension for Open-Xchange 6
THE CONTENT OF THIS PAGE IS OUTDATED | |
SEP AG has discontinued support for obsolete SEP sesam versions. Instructions are still available for these SEP sesam products, however, SEP AG accepts no responsibility or liability for any errors or inaccuracies in the instructions or for the incorrect operation of obsolete SEP sesam software. It is strongly recommended that you update your SEP sesam software to the latest version. For the latest version of SEP sesam documentation, see documentation home. |
Backup for OX6 with SEP sesam
This document describes how to set up a SEP sesam server to backup an Open-Xchange 6 environment. Unlike previous Open-Xchange versions backups of version 6 are not executed via a so-called "Open-Xchange module" but through distributed backup tasks.
A backup of an Open-Xchange system has to include the following components:
- File-based backup of the system
- Backup of the partition information for a possible BSR restore
- Backup of the MySQL database
- Backup of the LDAP
- Backup of the IMAP Server, i.e. the e-mails.
Furthermore it is possible to restore individual e-mails of different users.
Requirements
- SEP sesam Server version 3.6.4.27 or higher; check Hardware requirements for SEP sesam Server or RDS.
- Service pack for 3.6.4.27 OX6 (https://download.sep.de/)
- SEP sesam Client version 3.6.4.24 or higher
Preparations on SEP sesam Client 3.6
In version 3.6 it is necessary to switch the SEP sesam executable "sbc_ox" with the SEP sesam executable "sbc_imap":
cp /opt/sesam/bin/sesam/sbc_imap /opt/sesam/bin/sesam/sbc_ox
Preparations on SEP sesam Server Version 3.6
To use the SEP sesam single mailbox backup, you have to install the above-described Service Pack recorded in 1.1.
Here you have to replace the file "sm_reformat_lis.exe" in the directory <SESAM_ROOT>/bin/sesam
!
Setting up the backup jobs
Backup "all"
In the first step the whole Open-Xchange system can be backed up on file level by setting up an "all" backup.
The task has to be created in SEP sesam like this:
Ensuring a consistent backup
Additionally it is recommended to use the post- and pre-script options for this so-called "offline backup" in order to shut down the Open-Xchange service for the time of the backup. This way the Open-Xchange database can be backed up consistently.
- pre script:
/etc/init.d/open-xchange-groupware stop
- post script:
/etc/init.d/open-xchange-groupware start
"disk_info" Backup
In addition to the previously described "all" backup we suggest creating a so-called "disk_info" backup. This backup task makes it possible to execute a SEP sesam BSR Linux Disaster Restore with the help of the backed up partition information (see: Disaster Recovery for Linux 2.0)
This task is to be created like this:
"OpenLDAP" Backup
The LDAP service associated with the Open-Xchange includes the information of all user accounts. The task has to look like this:
"MySQL" Backup
Backup of all MySQL databases
The following example shows the setup of the backup task for the MySQL database associated with Open-Xchange. In the first step you can do a full backup of the MySQL instance. This backs up all databases available on the MySQL server:
IMAP Backup
In order to also make separate e-mails restorable in case of emergency the backup of the IMAP server used in Open-Xchange (Cyrus, etc...) has to be done separately.
Later on, with the help of this backup you can restore separate e-mails comfortably into various user accounts and subfolders using the subject line.
The task has to look like this:
Backup of individual MySQL databases
Besides the option of backing up all databases of an instance you can also backup separate MySQL databases. In most cases an Open-Xchange instance consists of the so-called "configdb" and a database that resembles the according domain name of the installation.
"configdb" Backup
"localhost_6" Backup
Restore
Disaster Recovery with SEP sesam Linux BSR
Once the required backup tasks are created, Linux BSR restore can be performed. For details, see Disaster Recovery for Linux 3.0 en.
Restore of individual E-Mails
Setting up sm_ox.ini
In order to make individual e-mails restorable the SEP sesam Client has to have the according rights to activate IMAP synchronization. This file has to be created on the client:
<SESAM_ROOT>/var/ini/sm_ox.ini
with the following content:
[CYRUS] admin=uid=root password=<root_password>
Selecting the E-Mails
The restore is done over the SEP sesam Restore Agent. After selecting the according savesets a list of the users and their e-mails appears in the restore wizard:
Restore to a different target
It is possible to restore e-mails into different subfolders.
In the following example the selected file is restored into the subfolder "restore" for the user "mailuser":
After a finished restore
Afterwards the user can query the restored e-mail via his Open-Xchange Login:
Restore of the MySQL databases
A restore of the MySQL databases can be done as described in the respective MySQL documentation: