Talk:Zarafa

Rough Guide to get Zarafa running. Lots more to do...

http://forums.contribs.org/index.php?topic=42118.0

Download & Install

http://www.zarafa.com/download-community

Distribution = Rhel 4

tar -zxvf zarafa-6.20-rhel4-i386.tar.gz

yum localinstall libvmime*.rpm libical*.rpm zarafa-6*.rpm zarafa-webaccess-6*.rpm

Create the Database

mysqladmin create zarafa
mysql -e "grant all privileges on zarafa.* to zarafa@localhost identified by 'yourpassword'"
mysql -e "flush privileges"

Zarafa config files

nano /etc/zarafa/server.cfg
 mysql_user = zarafa
 mysql_password = 'yourpassword'
 mysql_database = zarafa

 user_plugin        = unix
 user_plugin_config = /etc/zarafa/unix.cfg

nano /etc/zarafa/unix.cfg
 default_domain = yourserver.net
 min_user_uid = 5000
 min_group_gid = 5000

SME templates

httpd.conf

mkdir -p /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf

nano /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/86ZarafaAlias
 Alias /zarafa /var/www/html/webaccess/
 <Directory /var/www/html/webaccess/>
  Options -Indexes
  AllowOverride None
  order allow,deny
  allow from all
  AddType application/x-httpd-php .php
  php_flag magic_quotes_gpc off
  php_flag track_vars on
 </Directory>

expand-template /etc/httpd/conf/httpd.conf

php.ini

mkdir -p /etc/e-smith/templates-custom/etc/php.ini

nano /etc/e-smith/templates-custom/etc/php.ini/99Zarafa
 extension = mapi.so

expand-template /etc/php.ini

Restart httpd

signal-event ibay-modify

.qmail

enable zarafa for a user

db accounts setprop xxxx zarafa enabled

nano -w /etc/e-smith/templates-user/.qmail/80Zarafa

{
   my $zarafa = $user->prop('zarafa') || 'disabled';

   return "| /usr/bin/zarafa-dagent -q $USERNAME"
           if ($zarafa eq 'enabled');
}

/etc/e-smith/events/actions/qmail-update-user

Other tasks

Change webaccess apache rights

chown -R www:www /var/www/html/webaccess/tmp

Configure Zarafa services and add links for auto start

config set zarafa-server service status enabled
config set zarafa-spooler service status enabled
ln -s /etc/rc.d/init.d/e-smith-service /etc/rc.d/rc7.d/S99zarafa-server
ln -s /etc/rc.d/init.d/e-smith-service /etc/rc.d/rc7.d/S99zarafa-spooler

Start Zarafa services

/etc/init.d/zarafa-server start
/etc/init.d/zarafa-spooler start

Create Zarafa public store

/usr/bin/zarafa-admin -s

Assigning an administrator

When a user is an administrator, the user will be allowed to open all Zarafa stores of any user.

List users:

/usr/bin/zarafa-admin -l

Update a user to admin status:

/usr/bin/zarafa-admin -u <username> -a 1

Usage

After implementing the .qmail fragment mail is sent to zarafa, and NOT the users ~\Maildir

Webmail

Access with browser for a local user

• http://serverip/zarafa

Windows Clients

• MS Outlook

• zarafaclient-*.msi contained in the win32 directory of zarafa-*.tar.gz

Imap & POP

UNTESTED

Start the service

/etc/init.d/zarafa-gateway start

Configure the client (what address/port ?)

Mobiles

UNTESTED

Install rpm, start service, configure

Issues

Backup

• Either change the install location of the mail stores so they are backed up, requires using rpm -Uvh with a switch, not yum
• Or document what directories to add to backups

.qmail fragment

• fragment now called .qmail/80Zarafa to allow for SME forwarding

• mailsorting contrib sorts to Maildir folders, zarafa won't see this mail. Disable procmail/mailsorting and re-create internal zarafa rules

Address book

The Zarafa global address book finds users and groups from /etc/passwd etc/group

We don't want machine names, ibays, system, the group of a user, maybe others. I don't see how to hide them, changing shell to /bin/false may break things

Migrating users and data to Zarafa

Zarafa migration whitepaper describes various ways of migrating your users and your data to a Zarafa server.

http://download.zarafa.com/zarafa/release/docs/zarafa_migration.en.pdf