ZCB and BlackBerry Enterprise Server (BES) Common Issues

Revision as of 04:07, 15 October 2008 by Abhullar (talk | contribs) (New page: The following are common issues encountered with ZCB and fully describe these common issues, troubleshooting tips, and possible resolutions. ''' == ZCB Installation Fails == ''' The m...)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

The following are common issues encountered with ZCB and fully describe these common issues, troubleshooting tips, and possible resolutions.

ZCB Installation Fails

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. 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.

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.

 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

Devices stop receiving email

There are a few common situations where successfully activated devices stop receiving new email, calendar events, and contacts: Some of the BES services are not running, the BlackBerry Agent is not responding, the user may not have initialized, or the device needs to be rebooted. The following sections discuss these scenarios in more detail.

Some of the BES services are not running

For BES to function properly, all BlackBerry services should be running. There is a known timing issue with BES where if the database service has not started in a timely fashion, other BES services will not start. If the timing issue preventing other BES services from starting consistently occurs, please contact Research in Motion technical support for information about starting the BES services through a start-up script. • BlackBerry Agent is not responding. ZCB interacts with one major component of BES called the BlackBerry Agent. This component is a process that is responsible for retrieving data from the mail server via ZCB. BlackBerry Agent processes are controlled by a Windows service called the BlackBerry Controller. The BlackBerry Controller is not only responsible for launching the Agent processes but it is also responsible for making sure that this process and its multiple threads of execution are functioning properly. Under normal situations there is a single BlackBerry Controller and a single BlackBerry Agent running in BES. Sometimes the following situations may arise: • BlackBerry Agent is hanging. In order to find out if the BlackBerry Agent is hanging, check the BlackBerry Agent Logs. The BlackBerry Agent Logs can be found in the daily logs folder for BES. The Agent Logs file contains_MAGT_ in its filename. If you search for the string *** No Response*** and find a section of the log that looks like the following, the BlackBerry Agent process is not responding. [30181] (07/02 11:24:56.625): {0x10E0} Performing system health check (BlackBerry Mailbox Agent 1 - BESX Version 4.1.4.39 [30038] (07/02 11:24:56.625): {0x10E0} Worker Thread: *** No Response *** Thread Id=0x514, Handle=0x2BB0, WaitCount=1, WorkingTime=14 min, Last Activity=14 min, Event: NEW_MB_PCKT_NOTIFY, User: any_user@zcs.mydomain.com, Server: zcs.mydomain.com, Activity: Starting If your BlackBerry agent is hanging, please refer to the known issues section of this document for more details. • BlackBerry Agent process has crashed. If the BlackBerry Agent process is not hung it is possible that it has crashed. There are two ways to detect this situation. The first method is to look in your %TEMP% directory to see if there is a subfolder called zco-cores. If this folder exists, there may be files with a .dmp extension. If the date that this file was created corresponds with when you believe devices stopped being able to send/receive data, then the BlackBerry Agent probably crashed. Another way to verify a crash is to look in the BlackBerry Agent Logs. If you search for the string ------------------Begin Stack Trace------------------ and you find a stack trace for a particular thread, then BlackBerry Agent has most likely crashed. We have an open support case with Microsoft regarding this issue. Please refer to the known issues section of the document for more details. In either of the above cases, the BlackBerry Controller will terminate the BlackBerry Agent and try to launch another Agent. Most of the time, this process will fail. To manually restart the Agent, use the following steps. a. Shut down the Black Berry Controller Windows service. b. In the Windows Task Manager, wait for BlackBerryAgent.exe and Outlook.exe to shut down. If this process takes more than a minute, you may need to manually shut down these tasks. c. Restart the BlackBerry Controller Windows service. Your BlackBerry Agent is now restarted. • User may not have initialized. If only a subset of users are not receiving data on their device, it is possible that some users were not initialized properly by the BlackBerry Agent. To verify if this is the case, open the Agent Logs and search for a particular user’s email address. If the user’s email address or display name is associated with log statements similar to those below, then the user may not have been initialized properly. MAPIMailbox::MAPIMailbox(2) - ResolveName[3] failed for DisplayName=’Joe Smith’, giving up MAPIMailbox::MAPIMailbox(2) - OpenMsgStore (0x8004011d) failed, MailboxDN=jsmith@zcs.myserver.com, ServerDN=/o=zcs.myserver.com/ou=First Administrative Group/cn=Configuration/cn=Servers/cn=zcs.myserver.com/ cn=Microsoft Private MDB Note: It is possible that a user was not properly initialized but the log statements are not similar to those above. If the user is not properly initializing, BlackBerry Agent needs to be restarted using the BlackBerry Controller, using the following steps. a. Shut down the Black Berry Controller Windows service. b. In the Windows Task Manager, wait for BlackBerryAgent.exe and Outlook.exe to shut down. If this process takes more than a minute, you may need to manually shut down these tasks. c. Restart the BlackBerry Controller Windows service. Your BlackBerry Agent is now restarted.

Jump to: navigation, search