Open main menu

Linux and Unix Users Group at Virginia Teck Wiki β

Difference between revisions of "Zarafa"

imported>Cov
(Created page with ''''Zarafa''' is a Free Software groupware server. The for-pay enterprise version provides Microsoft Exchange server functionality. For non-enterprise users, Zarafa's ability to f…')
 
 
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
'''Zarafa''' is a Free Software groupware server. The for-pay enterprise version provides Microsoft Exchange server functionality. For non-enterprise users, Zarafa's ability to function as a back-end for [[Z-Push]], allowing full-fledged, locally served [[Android]] synchronization may be its most attractive feature.
+
'''Zarafa''' is a software libre groupware server. The for-pay enterprise version provides Microsoft Exchange server functionality. The gratis and libre community version of Zarafa supports, [[w:POP3|POP3]], [[w:IMAP|IMAP]], [[w:CalDAV|CalDAV]] and a web application interface out-of-the-box, allowing Mac, Mozilla and Novell PIM applications (i.e. Mac Mail, [[Thunderbird]], [[w:Lightning_(software)|Lightning]] and [[Evolution]]) to easily connect to its information stores. Additionally, Zarafa is a useful back-end for [[Z-Push]] and these packages setup together enable full-fledged, locally served [[Android]] synchronization. With additional configuration and integration, using [[LDAP]] for contact storage and access in Zarafa is also possible.
  
=Setup Guide=
+
== Setup Guide ==
 
{{Version|CentOS 5}}
 
{{Version|CentOS 5}}
  
==Prerequisites==
+
=== Prerequisites ===
Zarafa requires a [[MySQL]] database server be accessible. If you don't already have one, setup and run MySQL on your local machine.
+
Zarafa requires a [[w:MySQL|MySQL]] database server be accessible. If you don't already have one, setup and run MySQL on your local machine.
  
==Installation==
+
=== Installation ===
Download the non-Outlook, open source, binary package from the community section of the company's website. If you want to give it a proper extension, it's a gzipped tarball so you can name it <code>zarafa.tar.gz</code> if you like. Unpack the tarball and run the installation script. If you have RPM errors, check to see if you have older versions of the dependencies it ships with already installed. If this is the case, removing them should lead to successful execution of the installation script.
+
Download the non-Outlook, software libre, binary package from the community section of the company's website. If you want to give it a proper extension, it's a gzipped tarball so you can name it <code>zarafa.tar.gz</code> if you like. Unpack the tarball and run the installation script. If you have RPM errors, check to see if you have older versions of the dependencies it ships with already installed. If this is the case, removing them should lead to successful execution of the installation script.
  
 
<pre>
 
<pre>
 
# wget 'http://url.com' -O zarafa.tar.gz
 
# wget 'http://url.com' -O zarafa.tar.gz
# tar -xzf zarafa.tar.gz
+
# tar -xf zarafa.tar.gz
 
# zarafa-*/install.sh
 
# zarafa-*/install.sh
 
</pre>
 
</pre>
Line 18: Line 18:
 
Give the installation script the login information to your MySQL database when asked.
 
Give the installation script the login information to your MySQL database when asked.
  
==Configuration==
+
=== Configuration ===
Zarafa has a flexible, pluggable user system. If you have a fully functional LDAP or Active Directory server, go ahead and use it. Otherwise, the Unix backend is recommended. To configure it, edit <code>/etc/zarafa/unix.cfg</code> and change the domain to your own.
+
Zarafa has a flexible, pluggable user system. If you have a fully functional LDAP or Active Directory server, go ahead and use it. The default MySQL database backend works fine out-of-the-box, but a Unix backend is also available. If you don't know what to choose, just don't change anything to use the database backend.
 +
 
 +
If you want to use the Unix backend, edit <code>/etc/zarafa/unix.cfg</code> and change the domain to your own.
  
 
<pre>
 
<pre>
 
# Default email domain for constructing new users
 
# Default email domain for constructing new users
 
# Required, no default
 
# Required, no default
default_domain = vtluug.org
+
default_domain = domain.com
 +
</pre>
 +
 
 +
Lastly, you'll need to add a user. How you do this depends on the user backend you chose. If you went with the default database backend, an administration tool is provided. Read the man page or run <code>zarafa-admin --help</code> for the full documentation. A quick example is below.
 +
<pre>
 +
# zarafa-admin -c username -e username@domain.com -f 'Full Username' -P
 
</pre>
 
</pre>
 +
 +
=== Starting services ===
 +
The first time you run the installation script, it may start some services for you. Below is the list of services if you would like to start additional services or stop them.
 +
;<code>zarafa-server</code> : Main server
 +
;<code>zarafa-spooler</code> : Outgoing mail service
 +
;<code>zarafa-monitor</code> : Quota monitoring service
 +
;<code>zarafa-gateway</code> : POP and IMAP service
 +
;<code>zarafa-ical</code> : iCal/CalDAV service
 +
 +
== Accessing the PIM ==
 +
=== Calendar ===
 +
The calendar can be accessed through CalDAV from the url <code>http://domain.com:8080/caldav/username</code>. Public calendars can be accessed from <code>http://domain.com:8080/caldav/public/calendar</code>.
 +
 +
== External Links ==
 +
* [http://download.zarafa.com/zarafa/drupal/ondemand.php?version=6.30.7&document=Zarafa_Server_Manual&lang=en Zarafa server manual]
 +
* [http://ubuntuforums.org/archive/index.php/t-956654.html Zafara howto on Ubuntu forums]
 +
 +
[[Category:Howtos]]
 +
[[Category:Software]]
 +
[[Category:Scripts]]

Latest revision as of 07:39, 4 January 2019

Zarafa is a software libre groupware server. The for-pay enterprise version provides Microsoft Exchange server functionality. The gratis and libre community version of Zarafa supports, POP3, IMAP, CalDAV and a web application interface out-of-the-box, allowing Mac, Mozilla and Novell PIM applications (i.e. Mac Mail, Thunderbird, Lightning and Evolution) to easily connect to its information stores. Additionally, Zarafa is a useful back-end for Z-Push and these packages setup together enable full-fledged, locally served Android synchronization. With additional configuration and integration, using LDAP for contact storage and access in Zarafa is also possible.

Contents

Setup Guide

The following instructions were written for CentOS 5 and may not work on other platforms or versions. If you would like to see additional coverage, please add it yourself or make a request on the wiki's wanted page.

Prerequisites

Zarafa requires a MySQL database server be accessible. If you don't already have one, setup and run MySQL on your local machine.

Installation

Download the non-Outlook, software libre, binary package from the community section of the company's website. If you want to give it a proper extension, it's a gzipped tarball so you can name it zarafa.tar.gz if you like. Unpack the tarball and run the installation script. If you have RPM errors, check to see if you have older versions of the dependencies it ships with already installed. If this is the case, removing them should lead to successful execution of the installation script.

# wget 'http://url.com' -O zarafa.tar.gz
# tar -xf zarafa.tar.gz
# zarafa-*/install.sh

Give the installation script the login information to your MySQL database when asked.

Configuration

Zarafa has a flexible, pluggable user system. If you have a fully functional LDAP or Active Directory server, go ahead and use it. The default MySQL database backend works fine out-of-the-box, but a Unix backend is also available. If you don't know what to choose, just don't change anything to use the database backend.

If you want to use the Unix backend, edit /etc/zarafa/unix.cfg and change the domain to your own.

# Default email domain for constructing new users
# Required, no default
default_domain = domain.com

Lastly, you'll need to add a user. How you do this depends on the user backend you chose. If you went with the default database backend, an administration tool is provided. Read the man page or run zarafa-admin --help for the full documentation. A quick example is below.

# zarafa-admin -c username -e username@domain.com -f 'Full Username' -P

Starting services

The first time you run the installation script, it may start some services for you. Below is the list of services if you would like to start additional services or stop them.

zarafa-server 
Main server
zarafa-spooler 
Outgoing mail service
zarafa-monitor 
Quota monitoring service
zarafa-gateway 
POP and IMAP service
zarafa-ical 
iCal/CalDAV service

Accessing the PIM

Calendar

The calendar can be accessed through CalDAV from the url http://domain.com:8080/caldav/username. Public calendars can be accessed from http://domain.com:8080/caldav/public/calendar.

External Links