Slide 1

Zarafa Archiver handson Workshop

Introduction

During this handson lab we will discuss design choices, best pratices and important configuration options when deploying the Zarafa Archiver

The exercises will be done on the virtualbox applianceIP-address: 192.168.56.101

Login: zarafa/zarafa

Example configuration

How to get and use Zarafa Archiver?

Zarafa Archiver is an additionl Zarafa product.
Professional and Enterprise subscription include 20 free archive mailbox

Zarafa Archiver software is partly included in ZCP packages and as additional Zarafa Archiver packages. Both can be downloaded from the portal

To use Zarafa Archiver an additional subscription key has to be placed in /etc/zarafa/license

Requirements

To use the full features of Zarafa Archiver a central LDAP or ADS is required

Both ZCP and Zarafa Archiver servers will be configured in distributed setup (also used with multi-server)

Version 7.0.4+ is required

2 server nodes (in this handson session we use only one node)

Exercise 1: Installation

Install the Zarafa-archiver packages available in /home/zarafa/Desktop/packages

Place archiver subscription key from /home/zarafa/Desktop/packages in /etc/zarafa/license

Restart zarafa-licensed to active new keys

Server configuration

The following options should be changed in the server.cfguser_plugin = ldapms

enable_distributed_zarafa = true

server_name = zarafa

For the user plugin the ldapms.*.cfg template should be used

In this lab appliance, these settings are already done!

Available Archive policies

Exercise 2: Configure Archiver controller

Edit the following parameters in /etc/zarafa/archiver.cfg
archive_enable = yesarchive_after = 30stub_enable = yesstub_after= 30enable_auto_attach = yesauto_attach_writable = yessslkey_file = /etc/zarafa/ssl/client.pemsslkey_pass = zarafalog_level= 6mysql_password= zarafa

Exercise 3: Enable archive for user

Login to the phpldapadmin

Set on user demo1, demo2 the attribute zarafaUserArchiveServers and use servername zarafa

Exercise 4: Perform archive run

Execute the Zarafa-archiver for user demo1
zarafa-archive -u demo1 -A

Check the logfile for the different archive stages

Login to WebAccess to check archive mailbox and archived messages

Exercise 5: Enable archive on delivery

To archive directly every incoming email the option archive_on_delivery in dagent.cfg should be enabled

Archive on delivery only works when user has archive

When keeping a mail history for several years, don't forget to enable the purge option in Archive controller

Users can have read-only permissions on archive mailbox, so emails can be deleted in archive mailbox

With option cleanup_action = store in archiver.cfg can be used to keep all emails in archive mailbox which are no longer in primary mailbox

Automate archive runs

To run the Zarafa-Archiver every night or week, set a cronjob to perform this task

0 1 * * * /usr/bin/zarafa-archiver -A 0 2 * * * /usr/bin/zarafa-archiver -C

Archive mailboxes and delegate users

When adding delegate mailbox in Outlook or WebAccess, archive mailbox will be added as well

In order to access archive mailbox delegate needs permissions

Za-aclsync can be used to propagate permissions from primairy mailbox to archive mailbox
za-aclsync --sslkey-file=/etc/zarafa/ssl/client.pem \
--sslkey-pass=zarafa

Questions?