SEPsesam Extension for Open-Xchange 5

From SEPsesam
Jump to: navigation, search

Copyright © SEP AG 1999-2018. 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.

System Requirements

Installation

Installation with Sesam Client 3.4

1. Log in as user: 'root'

2. Install or update the SEP sesam Open-Xchange Extension with:

  > rpm -Uhv sesam-ox-3.4.1-XX.i386.rpm

Installation with Sesam Client 3.6

As with Sesam Client Versions greater 3.4, the Open-Xchange Extension is included in the client installer package.

Configuration

1. Go into directory <SESAM_ROOT>/var/ini, edit the file sm_ox.ini (or create it, if not existing) and change the admin user and password to match your environment:

  [CYRUS]
  admin=uid=mailadmin,ou=people,dc=sep,dc=de
  password=yourpassword

The configuration is only needed during a restore of e-mails to create the IMAP index files.

Offline Backup

To start a SuSE Linux OpenExchange Server Backup, you have to go through the following steps:

  • Create a new Backup task with task type SuSE Linux OpenExchange Server
  • If you chose all as source, all of the relevant data will be saved offline. To backup specific services you have to use the following keywords:
  • ldap, is used for the user access authorization
  • mail, to backup all mails (postfix, fetchd, cyrus, webmail)
  • postgresql bakups the groupware database of the SuSE OpenExchange Servers (Comfire)

During the offline backup of OpenExchange Servers the following services will be stopped:

ldap  
fetchd  
postfix  
cyrus  
groupware  
webmail  
postgresql  

Those Services will start right after the backup in the opposite order. The following directories will be backuped:

/etc/  
/var/lib/imap/  
/var/spool/imap/  
/var/spool/postfix/  
/var/lib/ldap/  
/var/lib/pgsql/  
/var/lib/sieve/  
/var/opt/comfire/filespool/

Online Backup

Before starting a SuSE Linux OpenExchange Online backup, you need to configure the file /etc/openldap/slapd.conf at the SuSE Linux OpenExchange Server. Insert those entries:

1. Access control access to *

      by peername="ip=127\.0\.0\.1" read stop

2. Private AddressBook access to dn="ou=addr,uid=(.*),dc=sep,dc=de" by dn="uid=<math>1,dc=sep,dc=de" write by * none

After modifying, restart the LDAP service with the command rcldap start


Select under GUI->Scheduling->Schedules->New Schedule a SuSE Linux OpenExchange Server task, that you have entered. Additionally, you can choose the options Online or Offline . If online is chosen, all services will run during the backup, with offline the services will stop.

Restore

Select your SLOX backup in the first Window of the Restore-Wizzard and press Next . In the next window choose your specific backupsaveset and mark the option completely restore selected task . During the restore all the services will stop and start right after the Restore.

  • Auto recover after restore Inserts the database
  • Auto online after restore Inserts the database and starts the services.
  • No recover after restore Puts the database in a file, for manual import.

Single Mailbox Restore

In order to restore a Single Mailbox please edit the /<sesam_root>/var/ini/sm_slox.ini . Insert the SLOX - Cyrus Password under cyrus_passwd= yourPassword To restore complete mailboxes or single mails of SLOX users, select your SuSE Linux OpenExchange Server saveset in the Restore Wizzard and continue with Next .

After this select the the mailboxes or mail you want to restore and continue with Next.

You can choose between four different restore-options.

1. overwrite existing files If you select this option, all existing mails in the mailbox will be overwrited resp. replaced.

2. other Mailuser If you select this option, the whole mailbox and/or the single mails will be restored in the chosen restore-user. It's possible to use the option "`overwrite existing files"', too.

Example The mailbox of the user will be created in a new mail-user (restore_user). restore_user/... restore_user/sent-mail/... restore_user/drafts/...

3. new restore folder With this option the whole mailbox and/or single mails of the user will be restored in its mailbox in a new subfolder. It's possible to use the option "`overwrite existing files"' too.

Example The mailbox of the user will create a new subfolder (restore_folder) in the same mailbox. Benutzer/restore_folder/... Benutzer/restore_folder/sent-mail/... Benutzer/restore_folder/drafts/...

4. other mailuser and new restore folder Option two and three linked. It's possible to use the option "`overwrite existing files"' too.

Example The mailbox of the user will be created in a new mailboxuser (restore_user) and in a subfolder (restore_folder) restore_user/restore_folder/... restore_user/restore_folder/sent-mail/... restore_user/restore_folder/drafts/...

Note

If your restored mailbox isn't shown in SuSE Linux OpenExchange Webinterface, you have to add it manually. You can do this by Setup>Folder>Subscribe, select the folders you have restored and continue with Save. Now you can see the Folder in your webinterface.

Changes:

2.4.1.14

- Support OpenExchange Server
- Shared folders can be restored by single mail restore
- ACLs of mailboxes are restored correctly
- IMAP spool directory is read from '/etc/imapd.conf'
- Use 'slapd' instead of 'ldapsearch' for LDAP backup
- Support all characters in password 

2.0.2.99

- 'import site' fixed error messaging
- symbolic link to '/var/spool/imap' is now followed

2.0.2.98

- Support of SuSE OpenExchange Server 4.1
- Online restore of mails
- Restart of the'ncsd' deamon after restore
- Support of linefeeds in mail subjects
- Dump of the mbox list during backup
- 'chmod 600' for the file 'sm_slox.ini' (contains the 'cyrus' password)
Note
  • symbolic links under '/var/spool/imap' are NOT backuped.
  • For the Single Mail Restore a Linux or Unix SEPsesam Server is needed (not Windows).
  • After the restore of the Postfix files, mails may be sent again.
  • Before a restore, it could be possible that a manual link must be made again to '/var/spool/imap'