Difference between revisions of "Zimbra Next Generation Modules/Zimbra NG Mobile/Admin Guide"

m (1 revision imported: Zimbra NG)
 
Line 1: Line 1:
<div class="col-md-12"><br></div>
+
#REDIRECT [[Zimbra_NG_Modules/Zimbra_NG_Mobile/Admin_Guide]]
<div class="col-md-12"><br></div>
 
<ol class="breadcrumb">
 
  <li>[[Main Page|Zimbra Wiki]]</li>
 
  <li>[[Zimbra_Next_Generation_Modules]]</li>
 
  <li>[[Zimbra_NG_Mobile]]</li>
 
  <li class="active">Admin Guide</li>
 
</ol>
 
__NOTOC__
 
<div class="col-md-12"><br /></div>
 
<div class="col-md-9">
 
    <h2 class="title-header" style="padding-bottom: 9px; border-bottom: 4px solid #0087c3;">Zimbra NG Mobile - Admin Guide</h2>
 
    <div class="col-md-12">
 
        <div class="ibox-content">
 
            <div class="post animated fadeInLeft animation-delay-8" style="padding-top:5px">
 
                <div class="panel panel-default">
 
                    <div class="panel-body">
 
                        <h5 class="post-title">Zimbra NG Mobile - Admin Guide</h5>
 
                        <div class="row">
 
== Prerequisites ==
 
To enable and use the Zimbra NG Mobile Module you'll need:
 
 
 
* An active Zimbra Next Generation Modules [[Zimbra_Next_Generation_Modules/License_Management|License]] with Zimbra NG Mobile Module enabled.
 
* Zimbra Next Generation Modules and the Zimbra Next Generation Modules Administration Zimlet [[Zimbra_Next_Generation_Modules/Installation_Guide|installed]] on a [[Zimbra_Next_Generation_Modules/Compatibility_List|supported version]] of Zimbra.
 
* Full user rights on the machine:
 
** Admin access to Zimbra (usually <nowiki>https://myserver.mydomain.tld:7071/</nowiki>).
 
** Root access to the Operating System.
 
 
 
== Getting Started ==
 
 
 
== Important Informations ==
 
====  Ports and network configuration ====
 
Zimbra NG Mobile uses a handler within the mailboxd service - through Jetty - to accept incoming connections, and thus the ports used as the same as http/s webmail. The ports used by default (80 and 443) are the same default ports used by all Exchange ActiveSync clients, and thus no additional configuration is usually required. However, if your Zimbra server is set up to use different webmail http/s ports, you'll need to make sure that appropriate routing rules are applied for incoming mobile connections, as the vast majority of EAS client does not allow to specify a custom set of ports - trying to reach the aforementioned default ports instead.
 
 
 
If you're unsure, you can check the ports used by the Zimbra Webmail running:
 
  zmprov gcf zimbraMailPort
 
  zmprov gcf zimbraMailSSLPort
 
 
 
====  Zimbra NG Mobile and IMAP-deleted emails ====
 
By default Zimbra NG Mobile synchronizes IMAP-deleted emails which have not been yet purged. This can be changed by setting the module's "Zimbra NG Mobile_ImapDeletedFilterEnabled" property to "true". Due to the nature of the IMAP deletion process, enabling the filter might have an impact on system performances.
 
 
 
==== [[Zimbra_Next_Generation_Modules/Zimbra_NG_Mobile/UI|A brief introduction to the Zimbra NG Mobile module's UI]] ====
 
* The Zimbra NG Mobile section of the Zimbra Next Generation Modules Administration Zimlet, explained.
 
 
 
====  [[Zimbra_Next_Generation_Modules/CLI|Zimbra Next Generation Modules CLI Guide]] ====
 
* List of all commands in the Zimbra Next Generation Modules CLI
 
 
 
==== [[Zimbra_Next_Generation_Modules/Running_Zimbra_Next_Generation_Modules_on_Zimbra_Network_Edition#Zimbra_NG_Mobile|Zimbra NG Mobile on Zimbra Network Edition]] ====
 
* Tips on how to use Zimbra NG Mobile on Zimbra Network Edition.
 
 
 
==== [[Zimbra_Next_Generation_Modules/Zimbra_NG_Mobile/Shared_Folders|Zimbra NG Mobile and Shared Folders]]====
 
* '''New in Zimbra Next Generation Modules 2.0''': Synchronize your shared folders to any mobile device.
 
 
 
==== Zimbra NG Mobile on Multistore environments ====
 
The Zimbra NG Mobile module can be activated in Singlestore and Multistore environments alike.
 
Mind that Zimbra NG Mobile won't proxy requests between servers, so if you configure your client to connect directly to one of the Zimbra servers in a multistore enviroment, be sure that your account resides in that very server.
 
 
 
==== Zimbra NG Mobile and Samsung devices ====
 
Due to the amount of manufacturer customizations causing issues and out-of-spec behaviours of Samsung clients running the stock client on Android, Zimbra NG Mobile includes some specific server-side limitations to avoid as many synchronization issues as possible.
 
 
 
Since the vast majority of issues has been detecting when using versions of the Exchange ActiveSync protocol higher than the old 2.5, a dedicated module property, "''Zimbra NG Mobile_MaxSamsungVersion''", has been introduced to define the maximum protocol version usable by Samsung clients. This property is set to default to "2.5" and cannot be overridden by either EAS Filters or by the various "Zimbra NG Mobile_EAS''XX''" properties, meaning that this value is the ONLY reference for all Samsung clients.
 
 
 
Using version 2.5 of the Exchange ActiveSync protocol will make devices unable to benefit of the following features:
 
* Server-side mail search.
 
* Email flagging.
 
* Mobile Provisioning.
 
 
 
It's always possible to change the value of the "''Zimbra NG Mobile_MaxSamsungVersion''" property either via CLI or via the Zimbra Next Generation Modules Administration Zimlet to use a higher protocol version, but doing so will likely cause one or more of the following issues:
 
* Inability to download full emails if the default download size is set to a value lower than the email's size.
 
* Duplicated device notifications.
 
* Inability to properly accept or sync Meeting Requests.
 
* Synchronization loops.
 
 
 
We are eagerly working on fixing as many issues as possible due to server-side workarounds, but at the moment setting the Max Samsung Version limit to 2.5 is highly suggested.
 
 
 
== Configuration ==
 
====[[Zimbra_Next_Generation_Modules/Zimbra_NG_Mobile/EnableCOS|Enable the Zimbra NG Mobile Module for all users in a Class of Service]]====
 
* Decide who can synchronize their Zimbra mailbox through Zimbra NG Mobile with their devices and clients, by Class of Service.
 
 
 
====[[Zimbra_Next_Generation_Modules/Zimbra_NG_Mobile/EnableUser|Enable the Zimbra NG Mobile Module for a Single user]]====
 
* Decide who can synchronize their Zimbra mailbox through Zimbra NG Mobile with their devices and clients, user by user.
 
 
 
====[[Zimbra_Next_Generation_Modules/Zimbra_NG_Mobile/Autodiscover| Quick Account Configuration through Autodiscovery]] ====
 
* Set up Autodiscovery so that your users won't need to enter server informations while setting up a new device/client.
 
 
 
====[[Zimbra_Next_Generation_Modules/Zimbra_NG_Mobile/The_Mobile_Password_feature| The "Mobile Password" feature]]====
 
* One password to rule them all, and to avoid re-configuring all of your devices should you change your Zimbra password.
 
 
 
====[[Zimbra_Next_Generation_Modules/Zimbra_NG_Mobile/Mobile_Device_Management_(a.k.a_Provisioning)| Mobile Device Management (a.k.a. Provisioning)]]====
 
* Introduction to the provisioning features available through Exchange ActiveSync 14.
 
 
 
====[[Zimbra_Next_Generation_Modules/Zimbra_NG_Mobile/SyncStates|Managing the SyncState of your devices]]====
 
* See who is syncing what and manage your users' synchronization status.
 
 
 
====[[Zimbra_Next_Generation_Modules/Zimbra_NG_Mobile/Advanced_Settings|Advanced options for performance tuning]]====
 
* Fine tuning for very large deployments.
 
 
 
== Client Configuration ==
 
====[[Zimbra_Next_Generation_Modules/Zimbra_NG_Mobile/Android_devices|Android Exchange Activesync Configuration Guide]]====
 
* How to set up the sync between a Zimbra mailbox and an Android device.
 
 
 
====[[Zimbra_Next_Generation_Modules/Zimbra_NG_Mobile/Apple_iOS_devices|Apple iOS Exchange Activesync Configuration Guide]]====
 
* How to set up the sync between a Zimbra mailbox and an iOS device.
 
 
 
====[[Zimbra_Next_Generation_Modules/Zimbra_NG_Mobile/Outlook_2013_Configuration|Outlook 2013/2016 Exchange Activesync Configuration Guide]]====
 
* How to set up the sync between a Zimbra mailbox and Outlook 2013/2016.
 
 
 
====[[Zimbra_Next_Generation_Modules/Zimbra_NG_Mobile/Windows_Mail_8_Configuration|Windows Mail 8 Exchange Activesync Configuration Guide]]====
 
* How to set up the sync between a Zimbra mailbox and Windows Mail 8.
 
 
 
== Best Practices ==
 
 
 
=== Zimbra NG Mobile and Apache proxying ===
 
If your Zimbra server runs on non-standard ports an you are using an http/https proxy to redirect connection requests to Zimbra, note that you must manually specify proxy rules to redirect all traffic arriving at
 
''<nowiki>http://yourdomain.com/Microsoft-Server-ActiveSync</nowiki>''
 
to
 
''<nowiki>http://yourdomain.com:zimbraHTTPport/Microsoft-Server-ActiveSync</nowiki>'',
 
and all traffic arriving at
 
''<nowiki>https://yourdomain.com/Microsoft-Server-ActiveSync</nowiki>''
 
to
 
''<nowiki>https://yourdomain.com:zimbraHTTPSport/Microsoft-Server-ActiveSync</nowiki>''.
 
 
 
Mind that the "Microsoft-Server-ActiveSync" part is case sensitive.
 
 
 
== Known Issues ==
 
==== General Device-side issues====
 
Please note that some "issues" might actually be inherent limitations of the ActiveSync Protocol or limitations of the specific device used. Tests on all supported platforms are being carried on in order to verify if any additional feature (such as different file sizes and image types) are supported even if not strictly compliant to the protocol's specifications.
 
 
 
====Samsung Galaxy SII (G9100i) issues====
 
Multiple Samsung Galaxy SII users report synchronization issues after the update to Android 4.0.3.
 
Such issues are caused by several bugs on the ActiveSync implementation of this device's default client. Updating to Android 4.0.4 solves all reported synchronization issues.
 
 
 
====Samsung devices and EAS14/EAS14.1====
 
A large number of client issues has been found in Samsung devices using version 14 and 14.1 of the EAS protocol. Because of this, starting from Zimbra Next Generation Modules 1.8.11 any device registering as *samsung* is forced to EAS12 if EAS14 is enabled for the synchronized account.
 
 
 
Due to protocol limitations, it's not possible to change the protocol version 'on the fly', so accounts previously registered using EAS14 must be deleted from the device and re-created in order to be functional.
 
 
 
====Stuck on "Retrieving Server Information" when sending an email (only affects Samsung clients running Android 4.3)====
 
This is a know issue in Samsung's EAS implementation on Android 4.3. The issue was fixed in Android 4.4.2, but if you can't/don't want to update you can follow this steps:
 
 
 
* Send an Appointment Invitation to the account synchronized with the device.
 
* Let the invitation email sync to the device.
 
* Respond to the invitation using the default email client.
 
 
 
====iOS7+ "nested" attachments====
 
Because of an iOS bug, "nested" attachments (attachments of an email attached to another email) are not accessible. This is not limited to Exchange ActiveSync accounts but affects all accounts set up in the default Mail app.
 
 
 
                        </div>
 
                    </div>
 
                    <div class="col-md-9">
 
                        <div class="panel-footer">
 
                            <p><i class="fa fa-clock-o"></i> Aug 25, 2016 - [https://www.zimbra.com/email-server-software/ Know more »]</p>
 
                        </div>
 
                    </div>
 
                </div>
 
            </div>
 
        </div>
 
    </div>
 
</div>
 
<div class="col-md-3"><br /></div>
 
<div class="col-md-3">
 
    <div class="panel panel-zimbrared-light-border">
 
        <div class="panel-heading">
 
            <h3 class="panel-title"><i class="fa fa-gear pull-left"></i> Zimbra Next Generation Modules</h3>
 
        </div>
 
        <div class="panel-body">
 
            {{ZNG}}
 
        </div>
 
    </div>
 
</div>
 
<div class="col-md-3">
 
    <div class="panel panel-primary-light-border">
 
        <div class="panel-heading">
 
            <h3 class="panel-title"><i class="fa fa-info-circle pull-left"></i> Zimbra Next Generation Modules Resources</h3>
 
        </div>
 
        <div class="panel-body">
 
            {{ZNGL}}
 
        </div>
 
    </div>
 
</div>
 
<div class="clearfix"></div>
 
<div class="col-md-12"><br></div>
 
{{FH}}
 

Latest revision as of 13:27, 29 November 2017

Jump to: navigation, search