Troubleshooting Options: Difference between revisions

No edit summary
 
No edit summary
Line 1: Line 1:
If the Outlook client is not synchronizing with the Zimbra server or if Outlook is not working correctly, several options are available to troubleshoot the problem.


<div class="Bulleted1">
<span class="BulletSymbol">• </span>Review the user’s Sync Issues mail folder for errors.
</div><div class="Bulleted1">
<span class="BulletSymbol">• </span>If the initial sync did not work, run the .msi file again and select '''Repair''' to see if reinstalling the ZCS Connector to Outlook resolves the problem.
</div><div class="Bulleted1">
<span class="BulletSymbol">• </span>If Outlook closes unexpectedly, i.e. with the warning “Outlook ...needs to close,” generate core dumps for Outlook. Go to the Zimbra Wiki <span class="XRef">[http://wiki.zimbra.com/index.php?title=CoreDump  CoreDump ]</span>page for directions. The core dump shows what Outlook was doing at the time of the crash. This file should be sent to Zimbra support.
</div><div class="Bulleted1">
<span class="BulletSymbol">• </span>If Outlook is hanging, or behaving strangely, run the Logging Control tool that is installed when the Connector for Outlook was installed. See [#1062829 “Using ][#1062829 Logging Control for Troubleshooting” on page 78]. This file should be sent to Zimbra support.
</div><div class="Bulleted1">
<span class="BulletSymbol">• </span>Remove the Zimbra Connector for Outlook .msi file, delete the zdb file and the profile, and reinstall.
</div><div class="a_0033Heading">
===Reviewing Sync Issues Folders===
</div><div class="BodyAfterHead">
When ZCS Connector for Outlook is installed, a <span class="attribute">Sync Issues</span> mail folder with subfolders is created in their mailbox. If errors are found when Outlook syncs with the Zimbra server, message with attachments are automatically added to these folders. Users can tell when messages are in these folders if the folder is bold and the number of unread messages is displayed.
</div><div class="Body">
If users are having problems using Outlook and continuously receiving errors, the messages in these folders should be forwarded to sync_issues@ zimbra.com. These messages are created to help Zimbra technical support and engineering debug and fix errors.
</div><div class="a_0032Heading">
===Using Logging Control for Troubleshooting===
</div><div class="BodyAfterHead">
If users encounter problems when logged on to Outlook, you can have them enable the logging control tool to log errors and events that occur while they are using Outlook. This log then can be sent to Zimbra for analysis.
</div><div class="Body">
<span class="attribute">ZCOLogCtl.exe</span> is installed when ZCS Connector for Outlook is installed. This logging control tool is in the \<span class="attribute">Program files\common files\system\msmapi\1033</span> directory. When users encounter problems with synchronization, not receiving their mail, system crashes, or other unusual behavior, you should direct users to open this file and enable logging in order to log internal API calls and communication between Outlook and the Zimbra Server. The default log file size is 10 megabytes, but you can increase this when necessary. When the size of the log reaches the limit, the current log is set aside and a second log is created, therefore two logs of up to the maximum log size can be generated.
</div><div class="Body">
'''Important:''' After enabling logging from the ZCS Outlook Logging Control dialog, users must restart Outlook before errors and event can be logged.
</div><div class="Anchor">[[Image:ZCS Connector for Outlook.12.1.2.jpg]]</div><div class="BodyAfterHead">
When users restart Outlook, all their activities are logged. Users should attempt to recreate activities that are causing the problems. When the problem has been recreated, send the log files to Zimbra. Open the ZCS Connector for Outlook Logging Control .exe again and click <span class="attribute">Send Log to Zimbra</span>.
</div><div class="Notice">
<span class="Bold">Note: </span>The <span class="attribute">Enable Logging</span> should be unchecked to disable logging when not being used for troubleshooting. If logging is on continuously, performance may be affected. Outlook must be restarted when you make changes with the ZCOLogCtl.exe file.
</div>

Revision as of 23:29, 30 July 2006

Jump to: navigation, search