Difference between revisions of "Z-Push v2 with Zimbra"

Jump to navigation Jump to search

Z-Push v2 with Zimbra (view source)

Revision as of 22:41, 24 January 2013

3,487 bytes added ,  22:41, 24 January 2013
→‎Z-Push Config: Added "Config Items"
m (→‎Set-up: Corrected SVN path)
(→‎Z-Push Config: Added "Config Items")
Line 63: Line 63:
</pre>
</pre>


=== Z-Push Config ===
== Z-Push Config ==
Note that starting from Z-Push version v2.0.6, there are now seperate config files for both Z-Push and the Zimbra Backend.  If you're installing an old version for some reason, see the [[#Pre Z-Push v2.0.6|Pre Z-Push v2.0.6]] section below.
Note that starting from Z-Push version v2.0.6, there are now seperate config files for both Z-Push and the Zimbra Backend.  If you're installing an old version for some reason, see the [[#Pre Z-Push v2.0.6|Pre Z-Push v2.0.6]] section below.


The following are excerpts from the config files that need to be edited or should be considered by you.  Update the existing files provided with the software as per your requirements.
The following are excerpts from the config files that need to be edited or should be considered by you.  Update the existing files provided with the software as per your requirements.


'''Z-Push Config''' (EG <code> /var/www/z-push/config.php</code>)
=== Z-Push Config Example ===
EG <code> /var/www/z-push/config.php</code>
<source lang="php">
<source lang="php">
// Update existing fields in config
// Update existing fields in config
Line 76: Line 77:
</source>
</source>


'''Zimbra Backend Config''' (EG <code> /var/www/z-push//backend/zimbra/config.php</code>)
=== Zimbra Backend Config ===
EG <code> /var/www/z-push//backend/zimbra/config.php</code>
The below is just an example, see the <code>INSTALL</code> file that comes with the Zimbra backend to work out the correct settings for your environment.
The below is just an example, see the <code>INSTALL</code> file that comes with the Zimbra backend to work out the correct settings for your environment.
<source lang="php">
<source lang="php">
Line 98: Line 100:
</source>
</source>


==== Pre Z-Push v2.0.6 ====
=== Pre Z-Push v2.0.6 Example ===
The below is just an example, see the <code>INSTALL</code> file that comes with the Zimbra backend to work out the correct settings for your environment.
The below is just an example, see the <code>INSTALL</code> file that comes with the Zimbra backend to work out the correct settings for your environment.


Line 121: Line 123:


See http://php.net/manual/en/timezones.php for the correct name for your local timezone
See http://php.net/manual/en/timezones.php for the correct name for your local timezone
=== Config Items ===
This section does not contain an exhaustive list of all configuration options, just the more common ones.
==== Z-Push ====
{| class="vwikitable"
|-
! Item !! Example Value !! Purpose / Comments
|-
| <code>TIMEZONE</code> || <code>Europe/London</code> || Default timezome of server - see http://php.net/manual/en/timezones.php
|-
| <code>STATE_DIR</code> || <code>/var/lib/z-push/</code> || Where sync state data gets stored
|-
| <code>LOGFILEDIR</code> || <code>/var/log/z-push/</code> || Where logs get written to
|-
| <code>LOGLEVEL</code> || <code>LOGLEVEL_INFO</code> || Logging level - see config file for available options
|-
| <code>LOGAUTHFAIL</code> || <code>false</code> || Whether to log user authentication failures or not
|-
| <code>LOGUSERLEVEL</code> || <code>LOGLEVEL_DEVICEID</code> || Logging level for per user logging (off by default, add users to log for to array, eg <code>$specialLogUsers = array("user@domain.com");</code>)
|-
| <code>PROVISIONING</code> || <code>false</code> || Whether to enforce provisioning (ActiveSync security policies) over devices
|-
| <code>LOOSE_PROVISIONING</code> || <code>false</code> || Allows legacy devices that don't support provisioning to still be able to sync
|-
| <code>SYNC_FILTERTIME_MAX</code> || <code>SYNC_FILTERTYPE_ALL</code> || Allows you to limit the time period obver which devices can sync (see config file for available time periods).  Useful for when time-outs are causing device syncs to fail. See also <code>SYNC_MAX_ITEMS</code>
|-
| <code>FILEAS_ORDER</code> || <code>SYNC_FILEAS_LASTFIRST</code> || Sets FileAs/SaveAs for contacts
|-
| <code>SYNC_MAX_ITEMS</code> || <code>100</code> || Limits the number of items sync'ed in one device request. Useful for when time-outs are causing device syncs to fail. See also <code>SYNC_FILTERTIME_MAX</code>
|-
| <code>BACKEND_PROVIDER</code> || <code>BackendZimbra</code> || Backend interconnect provider which alows Z-Push to interact Zimbra (or other) email/collaboration server
|}
==== Zimbra Backend ====
{| class="vwikitable"
|-
! Item !! Examplqe Value !! Purpose / Comments
|-
| <code>ZIMBRA_URL</code> || <code>https://mail.domain.com</code> || URL to Zimbra server (can be http or https)
|-
| <code>ZIMBRA_USER_DIR</code> || <code>zimbra</code> ||
|-
| <code>ZIMBRA_SYNC_CONTACT_PICTURES</code> || <code>true</code> || Sync contact pictures to devices.
|-
| <code>ZIMBRA_VIRTUAL_CONTACTS</code> || <code>true</code> ||
|-
| <code>ZIMBRA_VIRTUAL_APPOINTMENTS</code> || <code>true</code> ||
|-
| <code>ZIMBRA_VIRTUAL_TASKS</code> || <code>true</code> ||
|-
| <code>ZIMBRA_IGNORE_EMAILED_CONTACTS</code> || <code>true</code> ||
|-
| <code>ZIMBRA_HTML</code> || <code>true</code> || Whether to sync email etc content as HTML, or raw/basic text
|-
| <code>ZIMBRA_ENFORCE_VALID_EMAIL</code> || <code>true</code> ||
|-
| <code>ZIMBRA_SMART_FOLDERS</code> || <code>true</code> || Whether to enable Smart Folders or not (a Backend feature that allows end user control of what gets synced to their devices). Cannot be changed on the fly, all sync state data needs to be manually cleared.
|-
| <code>ZIMBRA_RETRIES_ON_HOST_CONNECT_ERROR</code> || <code>5</code> || How many times the backend should attempt to reconnect to Zimbra should connect fail (because services are down for backup, for example)
|-
| <code>ZIMBRA_LOCAL_CACHE</code> || <code>true</code> ||
|-
| <code>ZIMBRA_DEBUG</code> || <code>false</code> ||
|}


== Mobile Device Setup ==
== Mobile Device Setup ==
Retrieved from ‘https://vwiki.co.uk/index.php?title=Special:MobileDiff/2254’

Navigation menu