Difference between revisions of "BES Installation Issues"

Latest revision as of 18:26, 24 March 2015

BES Installation Issues

BES Installation Issues Home Page

Please see BES_Installation_Issues

Troubleshoot Zimbra Mobile Connector for BlackBerry Installation Failures

Troubleshoot Zimbra Mobile Connector for BlackBerry Installation Failures Homepage

Please See Troubleshoot_Zimbra_Mobile_Connector_for_BlackBerry_Installation_Failures

Introduction

The most common installation problems are due to the deviation from the step by step installation instructions outlined by the ZimbraBESConnector PDF Guide or from deviation from the installation prerequisites.

References:

• Has our official documentation on Zimbra Connector for BlackBerry Enterprise Server
  • http://www.zimbra.com/support/documentation_additional.html
• For the older ZCS Connector for BlackBerry Guide
  • ZCS Connector for BlackBerry Guide.

Resolution Steps

1. First, please verify that the installation process is started with none of the prerequisite software installed and that all user applications are closed before starting the installation process for ZCB. Then verify that the steps are followed in the order they are given.
2. If there are still problems with the installation, the installer can be run in verbose mode to generate debug logs. These logs can be sent to Zimbra support for analysis. To run the installer in verbose mode, run the following command in the folder where the installer file (this has an .msi extension) is located.
   • To run the installer in verbose mode, run the following command in the folder where the installer file (this has an .msi extension) is located.

     • msiexec /i [msi-filename] /lv''' [output log file path name]

     • For example, the following command will launch the zcb_beta3.msi installer in verbose mode, and will output the verbose logs to out.txt in the current directory.

       • msiexec /i zcb_beta3.msi /lv out.txt

Blackberry Enterprise Server (ZCB/BES) in a Zimbra Proxy Environment

Blackberry Enterprise Server (ZCB/BES) in a Zimbra Proxy Environment Homepage

Please see Installing_Blackberry_Enterprise_Server_(ZCB/BES)_in_a_Zimbra_Proxy_Environment

Requirements

Currently the Zimbra Proxy server does not proxy requests on Port 7071. The Zimbra Proxy documentations suggests to turn off HTTP SSL on the mailbox servers and offloads it to the Zimbra Proxies, but the proxy servers do not handle 7071 like the mailbox servers do.

ZCB/BES needs Ports 443/8443 and 7071 to work. Until Bug 31053 is resolved to proxy port 7071 you will need to apply the below steps for ZCB/BES to function properly.

Configure BlackBerry Profiles in BES

When creating both BlackberryServer and BlackberryManager profiles, you need to point these to one of the Zimbra Mailstores directly. Also the Mailstore must not be running the Proxy service.

Enable HTTPS on all Mailstores

All Zimbra mailstores need to have HTTPS enabled. We recommend setting the mailstore to use 'BOTH' for mail mode.

To enable https please follow below wiki.

• CLI_zmtlsctl_to_set_Web_Server_Mode

Note: The proxy documentation says that the mailbox server only supports http for zimbraMailMode when used with a proxy server. In this case, you can set the zimbraMailMode to both so the proxy server connects to the mailbox server on port 8080 and the BES server connects on 8443.

The BES server must be able to access *all mailstores* directly on ports 7071 and 443/8443. This is because ZCB uses the Zimbra "waitset()" command, and must be able to directly connect to the mailstore on which each user resides. After retrieving the user location on port 7071, BES/ZCB will connect to port 443 or 8443 on the proper mailstore for each user it syncs.

Related Bugs

• http://bugzilla.zimbra.com/show_bug.cgi?id=33179
• http://bugzilla.zimbra.com/show_bug.cgi?id=31053