3,249
edits
Changes
From SME Server
Jump to navigationJump to search→Version
{{Languages|Zarafa on SME 9}}
{{Languages|Zarafa on SME 9}}
{{Level|Advanced}}
{{Level|Advanced}}
{{Note box|This is a tested contrib and currently works on SME9alpha1. It should be ready for production servers when SME9 reaches RC stage.}}
{{Note box|
'''This wiki page is specific to SME9 only.'''
'''There is a separate wiki page on how to install Zarafa 7.x on SME7 [[Zarafa|Zarafa on SME 7]].'''
'''There is a separate wiki page on how to manually install Zarafa 7.x on SME8 [[Zarafa_on_SME8|Zarafa on SME 8]].'''
}}
{{Note box|This is a tested contrib and currently works on SME9beta2. It should be ready for production servers when SME9 reaches RC stage.
This contrib will NOT work on SME 7 or SME8, there are unresolved dependencies.}}
{{Warning box|This contrib does not use the standard mail locations of SME. The mail delivery is changed to a new service that uses MySQL to store mail messages and /home/e-smith/files/zarafa/ to store attachments. By default, MySQL and /home/e-smith/files/zarafa/ are included in the standard SME backup schema. Make sure you include these if you have a custom backup schema}}
{{Warning box|This contrib does not use the standard mail locations of SME. The mail delivery is changed to a new service that uses MySQL to store mail messages and /home/e-smith/files/zarafa/ to store attachments. By default, MySQL and /home/e-smith/files/zarafa/ are included in the standard SME backup schema. Make sure you include these if you have a custom backup schema}}
===Version===
===Version===
{{#smeversion:smeserver-zarafa-unix}}
{{#smeversion:smeserver-zarafa-unix}}
===Description===
===Description===
{{Note box| This contrib uses the unix plugin and automatically and properly enables all valid users as Zarafa users and all valid groups as Zarafa groups. Everything is initially done automatically for you by the post-install event so you do not need to do anything further. In addition, when you add or delete a user or group from the server manager, the user or group is automatically added or deleted in Zarafa. Also, any password change will automatically change the zarafa login password to match.
{{Note box| This contrib uses the unix plugin and automatically and properly enables all valid users as Zarafa users and all valid groups as Zarafa groups. Everything is initially done automatically for you by the post-install event so you do not need to do anything further. In addition, when you add or delete a user or group from the server manager, the user or group is automatically added or deleted in Zarafa. Also, any password change will automatically change the zarafa login password to match.
By default, Zarafa is enabled for all users except admin. You can change this to 'per user' via db entries. <br /><br />
If Zarafa was used with the db-plugin before, the InnoDB engine has to be enabled. To enable the InnoDB engine, run the following commands:
db configuration setprop mysqld InnoDB enabled<br />
expand-template /etc/my.cnf<br />
sv t /service/mysqld<br /><br />
Users accounts have to match the existing zarafa-users.}}
Now install smeserver-zarafa-unix by performing the following:
Now install smeserver-zarafa-unix by performing the following:
yum install smeserver-zarafa-unix --enablerepo=smecontribs
yum install smeserver-zarafa-unix --enablerepo=smedev (NOTE: This will not work until the mirrors are updated.)
NOTE: On the GPL version you must disable zarafa-licensed...
NOTE: If you installed the GPL version of Zarafa, you must disable zarafa-licensed...
config setprop zarafa-licensed status disabled
config setprop zarafa-licensed status disabled
After rpm install execute the following:
After rpm install execute the following:
signal-event zarafa-post-install
signal-event zarafa-post-install
signal-event post-upgrade; signal-event reboot
signal-event post-upgrade; signal-event reboot
=====MySQL=====
The default MySQL database created is named 'zarafa' and the default user is named 'zarafa'
The MySQL password is a strong random string and automatically set. See:
config show zarafa-server
To reset the existing database password you can use:
/etc/e-smith/events/actions/zarafa-reset-db-password
=====Controlling Zarafa Services=====
To control the zarafa services (start/stop etc.) the following command can be used:
signal-event zarafa-services [option]
Where the [option] can be on of the following:
start|stop|restart|update|enabled|disabled
The update option will rebuild the zarafa config files based on the current db settings.
To disable global Zarafa for all users...
=====To disable global Zarafa for all users=====
config setprop zarafa-server GlobalForward disabled
config setprop zarafa-server GlobalForward disabled
signal-event user-modify
signal-event user-modify
To enable an individual user if Global is disabled...
=====To enable an individual user if Global is disabled=====
db accounts setprop $USERNAME zarafa enabled
db accounts setprop $USERNAME Zarafa enabled
signal-event user-modify $USERNAME
signal-event user-modify $USERNAME
To enable the admin account...
=====To enable the admin account=====
db accounts setprop admin zarafa enabled
db accounts setprop admin Zarafa enabled
signal-event user-modify-admin
signal-event user-modify-admin
To use MS Outlook install the zarafaclient-*.msi add-on contained in the win32 directory of zarafa-*.tar.gz
To use MS Outlook install the zarafaclient-*.msi add-on contained in the win32 directory of zarafa-*.tar.gz
====Mobile synchronisation====
=====Known working hardware=====
Tested and working with Android 4.1.1 on a Samsung Galaxy 3S over a SSL connection / mail-push is working.
Tested and working with Android 4.1.1 on a Samsung Galaxy 3S over a SSL connection / mail-push is working.
Port 8089 is used for secure SSL connections, port 8088 for unsecured connections.
Port 8089 is used for secure SSL connections, port 8088 for unsecured connections.
====Additional Mobile Synchronization Information====
====Mobile synchronisation====
To enable synchronization of your mobile phone through ActiveSync with Zarafa, Z-push needs to be installed.
z-push now has RPM's built for RHEL6 making the install simple...
For i386 go here http://download1.rpmfusion.org/free/el/updates/6/i386/repoview/letter_z.group.html
For X86_64 go here http://download1.rpmfusion.org/free/el/updates/6/x86_64/repoview/letter_z.group.html
You will need 2 packages, <b>z-push</b> and <b>z-push-zarafa</b>. Download the latest packages, as of this writing, 2.0.7-1 works without any issue.
yum localinstall z-push*
*save resulting .cer certificates on local machine
=====Know working hardware=====
=====Know working hardware=====
Tested and working with Nokia 6120 Classic. Push mail not tested.
Tested and working with Nokia 6120 Classic. Push mail not tested.
=====Additional Mobile Synchronization Information=====
'''SSL Synchronization with Windows Mobile devices'''
Synchronization over a secured connection is possible if you can add your site as a trusted one with corresponding certificate on your mobile.
This is the case for Windows mobile 6 (WM6) devices. Problems should occurs on several WM5 devices, because of a bug that limits addition of certificates with that OS.
Here are the steps to add your server as a trusted platform on your WM6 mobile :
1. to convert your server's certificate into a (Binary coded DER X.509) .cer file you can either run the following command and skip to step 4 or just start at the next step.
openssl x509 -in /home/e-smith/ssl.pem/<certificate name>.pem -inform PEM -out /root/<certificate name>.cer -outform DER
2. copy your server's certificates located in /home/e-smith/ssl.crt/ on a Windows XP/Vista computer
3. we need to transform those .crt certificates to .cer certificate ( same type of certificate but .crt are text-encoded ). To do so :
*in microsoft windows open a certificate by double clicking on it
*in "Detail" Tab pane choose "Copy to file"
*Choose Binary coded DER X.509 (.cer) format
*save resulting .cer certificates on local machine
4. transfer .cer certificates on your mobile using windows explorer
5. When done, on your WM6 mobile use file explorer to open those certificates. When opening one, the certificate is automatically added to trusted sites.
6. You can then change your Exchange server parameters to use SSL. It will be asked to reenter your password.
====Command line admin====
====Command line admin====
tail /var/log/messages
tail /var/log/messages
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-unix component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-zarafa-unix|title=this link}}.
[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
[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-unix&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-unix|noresultsmessage="No open bugs found."}}
