3,250
edits
Changes
Jump to navigation
Jump to search
Line 1:
Line 1: − + + + + + + + + + + + Line 13:
Line 23: + − Download & install ...+ + − + − + − + − + − + + + + − + Line 39:
Line 54: − + + + + + Line 46:
Line 65: − + + + + + + + + + Line 61:
Line 88: − + + Line 91:
Line 119: + + + + + + + + + + + + + Line 112:
Line 153: − + − To access the calendar functions with an iCal client eg, Thunderbird and Lighting+ − + − − − 8089 for SSL − Note, there were problems with reading events created with /webaccess, seems better with RC1+ + + − It's a know problem. Zarafa 6.30 will use CalDEV instead of iCal+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Line 130:
Line 212: − + − + Line 172:
Line 254: + + + + + + Line 191:
Line 279: − The labels are defined in /var/www/html/webaccess/client/layout/dialogs/standard/appointment.php beginning at line 225+ − + − The categories are in /var/www/html/webaccess/client/layout/dialogs/modal/categories.php beginning at line 51.+ + Line 199:
Line 288: − + + + + + + + + + + + + + + + + + + + + + + + Line 214:
Line 325: − + + + + + − + +
no edit summary
{{Languages}}
{{Languages|Zarafa}}
{{Level|advanced}}
{{Level|advanced}}
{{Note box|
'''This wiki page is specific to SME7 only.'''
'''There is a separate wiki page on how to manually install Zarafa 7.x on SME8 [[Zarafa on SME8]].'''
'''There is a separate wiki page with a ''fully automated'' install of Zarafa 7.1.x on SME9 that utilizes the unix plugin [[Zarafa on SME 9]].'''
}}
{{usefulnote}}
===Maintainers===
===Maintainers===
Darrell May
Darrell May
Stephen Noble http://dungog.net/wiki
Stephen Noble http://dungog.net/wiki
=== Version ===
{{#smeversion:smeserver-zarafa}}
===Description===
===Description===
Outlook, which enables the sharing of mail and appointments from Outlook and a
Outlook, which enables the sharing of mail and appointments from Outlook and a
web-based interface.
web-based interface.
===Installation===
===Installation===
==== Latest zarafa tested version ====
Information on previous versions of zarafa rpms can be found in the [http://download.zarafa.com/zarafa/release/docs/changelog.en.txt changelog document]
==== Zarafa rpms====
==== Zarafa rpms installation ====
http://www.zarafa.com/download-community
http://www.zarafa.com/download-community
Distribution = Rhel 4
Distribution: Rhel 4 = SME 7 :: Rhel 5 = SME 8
3 Outlook license version (or possibly just disable licensed service for the GPL version, check please)
Select a version, the 3 Outlook license version, or the GPL version. (which doesn't have the zarafa-licensed-*.rpm)
tar -zxvf zarafa-6.20-rhel4-i386.tar.gz
tar -zxvf zarafa-6.*.tar.gz
yum localinstall libvmime*.rpm libical*.rpm zarafa-6*.rpm zarafa-webaccess-6*.rpm zarafa-licensed-6*.rpm
yum localinstall libvmime-0*.rpm libical-0*.rpm zarafa-6*.rpm zarafa-webaccess-*.rpm zarafa-licensed-*.rpm
This will also install as a dependency: ''sysstat''
{{Note box| You have to enable InnoDB support in MySql in order to get zarafa-server running, for information on how to do so, see [[MySQL#Enable_InnoDB_engine]]}}
==== smeserver-zarafa ====
==== smeserver-zarafa ====
{{Note box| This is a beta release. Possibly for production servers after testing with per user settings first.
{{Note box| This is an alpha release. Possibly for production servers after testing with per user settings first.
You select 'per user' or 'globally' where you want mail delivered via db entries. Default leaves mail going to users ~/Maildir.
You select 'per user' or 'globally' where you want mail delivered via db entries. Default leaves mail going to users ~/Maildir.
Install a fresh SME 7.4 test server and perform the following:
Install a fresh SME 7.4 test server and perform the following:
yum install smeserver-zarafa --enablerepo=smetest
yum install smeserver-zarafa --enablerepo=smedev
config setprop zarafa-licensed status disabled #GPL version only
{{Note box|If you installed the GPL version only (without outlook support), you need to create the (empty) file '/var/log/zarafa/licensed.log'. This file is required in all cases. Without this file (and using the GPL non-Outlook version), the Zarafa configuration panel in server manager will not be displayed.}}
After rpm install execute the following:
After rpm install execute the following:
signal-event post-upgrade; signal-event reboot
signal-event post-upgrade; signal-event reboot
{{Note box| You will be prompted to select the user plugin you wish to test. Note the ldap plugin is currently not supported in the rpm. The unix plugin reads existing SME user details but also includes groups and machine names (messy). The db plugin is pristine however you need to enter all the user details. In both cases the user must exist in SME first as a standard user. A decision on which plugin we will choose for final deployment is still to be determined.}}
{{Note box| You will be prompted to select the user plugin you wish to test. We suggest the db method. Note the ldap plugin is currently not supported in the rpm. The unix plugin reads existing SME user details but also includes groups and machine names (messy). The db plugin is pristine however you need to enter all the user details. In both cases the user must exist in SME first as a standard user. A decision on which plugin we will choose for final deployment is still to be determined.}}
==== Updating ====
Download newer rpms, then
rpm -Uvh zarafa-6*.rpm zarafa-webaccess-*.rpm libvmime-0*.rpm libical-0*.rpm zarafa-licensed-*.rpm
/etc/e-smith/events/actions/zarafa-update
signal-event post-upgrade; signal-event reboot
===Usage===
====Managing Users====
Enable mail delivery to zarafa for users:
Enable mail delivery to zarafa for users:
/etc/e-smith/events/actions/zarafa-create-user
/etc/e-smith/events/actions/zarafa-create-user
===Usage===
or manage zarafa users with the panel ( smeserver-zarafa >= 0.29 )
====Webmail====
====Webmail====
=====Thunderbird=====
=====Thunderbird=====
It seems that in the latest Thunderbird versions security tightened and Thunderbird will simply reject Self Signed Certificates when you try to connect to a (remote) SME Server on secure ports.
You first must add all the secure services ports to the security exceptions of Thunderbird under:
* tools->options->advanced->certificates->view certificates->Add Exception
and add your server address INLCUDING the specific port number of the service for EACH of the service-ports!
The format must be:
https://yourserver.com:8993 (for IMAPS)
https://yourserver.com:465 (SMTP)
https://yourserver.com:8089 (Caldav)
etc. etc
After accepting the self signed certificate for each service-port, you then can add an new email account and the Self Signed Certificate will not be rejected and you normally accept or install it like any other certificate.
The Thunderbird client uses its own Trash folder, not the Zarafa "Deleted Items" folder,
The Thunderbird client uses its own Trash folder, not the Zarafa "Deleted Items" folder,
If junkmail exists just delete it.
If junkmail exists just delete it.
====Calendar====
==== Calendar CalDAV / iCal ====
Starting from Zarafa 6.30 there is decent CalDAV/iCal support for calendars (tasks not yet) that can be accessed with an CalDAV or iCal client eg, Thunderbird with Lighting, Sunbird, Evolution, MAC ical, ...
{{Note box|Currently there is a bug in smeserver-zarafa package (bug #5410) that might prevent you from accessing the calendar. If so, replicate the steps described in the bug report to correct this and issue the following command from the commandline and you should be good to go: <tt>/etc/init.d/zarafa-ical restart</tt>}}
in Thunderbird/Lightning > New Calendar > on network > ical > http://<domain>:8088/ical/<user>/calendar/
* In Thunderbird/Lightning: New Calendar > on network > CalDAV > Location: see table below
* In Evolution: New Calendar > Type: CalDAV > URL: see table below (remove the 'Use SSL' option)
* In Mac iCal client: iCal > Preferences > click '+' > Account URL: see table below
{| align="center" {{Prettytable}}
|-
|{{Hl3}}|'''URL'''
|{{Hl3}}|'''Calendar'''
|-
|<nowiki>https://server:8089/ical/</nowiki>
|user's own default calendar via ical (not recommended)
|-
|<nowiki>https://server:8089/caldav/</nowiki>
|user's own default calendar
|-
|<nowiki>https://server:8089/caldav/<other-user></nowiki>
|0ther-user's calendar
|-
|<nowiki>https://server:8089/caldav/<user>/<calendar></nowiki>
|user's self created calendar in user's (own) store
|-
|<nowiki>https://server:8089/caldav/<user>/<calendar>/<subcal></nowiki>
|user's self created subcalendar in a self created calendar
|-
|<nowiki>https://server:8089/caldav/public/<calendar>/</nowiki>
|calendar folder in the public folder
|-
|colspan="2" {{Hl3}}|'''URL For MAC OSX ical client'''
|-
|<nowiki>https://server:8089/caldav/</nowiki>
|User's calendar list
|-
|<nowiki>https://server:8089/caldav/<other-user></nowiki>
|Other-users calendar list
|-
|<nowiki>https://server:8089/caldav/public</nowiki>
|Public folders list
|-
|{{Hl3}}|'''URL'''
|{{Hl3}}|'''Tasks'''
|-
|-
|<nowiki>https://server:8089/caldav/<user>/tasks</nowiki>
|user's default tasks list. '''ONLY WITH Zarafa 6.40.2 or newer !!'''
|-
|}
Port 8089 is used for secure SSL connections, port 8088 for unsecured connections.
====Mobile synchronisation====
====Mobile synchronisation====
Download the latest Z-push version (see: http://z-push.sourceforge.net).
Download the latest Z-push version (see: http://z-push.sourceforge.net).
wget http://download2.berlios.de/z-push/z-push-1.2.1.tar.gz
wget http://download2.berlios.de/z-push/z-push-1.2.2.tar.gz
Extract the files:
Extract the files:
tar -zxvf z-push-1.2.1.tar.gz -C /var/www/html
tar -zxvf z-push-1.2.2.tar.gz -C /var/www/html
'State'-dir needs to be writable for apache:
'State'-dir needs to be writable for apache:
Tested and working with WinMobile 6.1 on an upgraded QTEK9100 over SSL connection. Push mail not tested.
Tested and working with WinMobile 6.1 on an upgraded QTEK9100 over SSL connection. Push mail not tested.
Tested and working with WinMobile 2003 on an QTEK9090 over SSL connection. Push mail not tested.
Tested and working with IPHONE. Push mail not tested.
Tested and working with Nokia 6120 Classic. Push mail not tested.
=== Extras ===
=== Extras ===
The labels and categories in the calendar can be altered to suit user requirements.
The labels and categories in the calendar can be altered to suit user requirements.
The labels are defined in
/usr/share/zarafa-webaccess/client/layout/dialogs/standard/appointment.php beginning at line 225
The categories are in
/usr/share/zarafa-webaccess/client/layout/dialogs/modal/categories.php beginning at line 51.
==== Zarafa Bayesian learning ====
==== Zarafa Bayesian learning ====
This howto enables SpamAssasin [[:Zarafa Bayesian Learning | Bayesian learning for Zarafa]]
This howto enables SpamAssasin [[:Zarafa Bayesian Learning | Bayesian learning for Zarafa]]
====Mail Sorting====
==== Mail Sorting ====
Maildrop as configured with
Maildrop as configured with
[http://www.dungog.net/wiki/Smeserver-mailsorting smeserver-mailsorting] will deliver to ~/Maildir rather than zarafa
[http://www.dungog.net/wiki/Smeserver-mailsorting smeserver-mailsorting] will deliver to ~/Maildir rather than zarafa
Procmail will sort to zarafa for enabled users from smeserver-mailsorting-1.2-29,
Procmail will sort to zarafa for enabled users from smeserver-mailsorting-1.2-29,
==== Backup and restore ====
===== Backup =====
Backup is done normally with [[SME_Server:Documentation:Administration_Manual:Chapter10|standard backup tool]] provided with SME, or with other backup contribs ([[affa]]). Be sure that those datas are correctly saved :
*zarafa database. All backup tools are saving all mysql database in standard mode, it should be Ok
*attachment files. Those one are stored in '/home/e-smith/files/zarafa' directory.
===== Restore =====
{{Warning box| Database restoring has been tested when facing an issue during upgrade of zarafa from 6.20 to 6.20.4. No problems were detected, meaning there is no compatibility issues between those 2 versions. It should not be the case with every version}}
Standard full restore function provided by SME or other backup tools will restore Zarafa datas.
In certain cases, it is interessant to restore only zarafa database backup (ie update issue). This is done following those steps :
*stopping zarafa server
/etc/rc.d/init.d/zarafa-server stop
*deleting all tables currently into zarafa database
mysql zarafa -e "show tables" | grep -v Tables_in | grep -v "+" | \
gawk '{print "drop table " $1 ";"}' | mysql zarafa
*import the backup of zarafa database
cd /directory/containing/your/backup
mysql < zarafa.dump
* restart zarafa server
/etc/rc.d/init.d/zarafa-server start
=== Bugs ===
=== Bugs ===
Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title=bugzilla}}and select the smeserver-zarafa component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-zarafa|title=this link}}.
Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title=bugzilla}}and select the smeserver-zarafa component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-zarafa|title=this link}}.
[http://bugs.contribs.org/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=SME+Contribs&component=smeserver-zarafa&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&bug_status=VERIFIED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailqa_contact2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=Open Search open bugs] for smeserver-zarafa at bugs.contribs.org
[http://bugs.contribs.org/buglist.cgi?query_format=advanced&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&value0-0-0=Open&component=smeserver-zarafa&product=SME%20Contribs Search open bugs] for smeserver-zarafa at bugs.contribs.org
Zarafa: use their forum for zarafa specific bug reporting, http://forums.zarafa.com/
Zarafa: use their forum for zarafa specific bug reporting, http://forums.zarafa.com/
{{#bugzilla:columns=id,product,version,status,summary |sort=id|order=desc |component=smeserver-zarafa|noresultsmessage="No open bugs found."}}
----
----
[[Category: Contrib]]
[[Category: Deprecated Contrib]]
[[Category: Groupware]]