Outlook Troubleshooting Options: Difference between revisions

No edit summary
No edit summary
 
(15 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{BC|Community Sandbox}}
__FORCETOC__
<div class="col-md-12 ibox-content">
=Outlook Troubleshooting Options=
{{KB|{{Unsupported}}|{{ZCS 8.0}}|{{ZCS 7.0}}|}}{{WIP}}
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.
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.


Line 11: Line 17:
</div><div class="Bulleted1">
</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.
<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">[[Generating_Core_Dumps]] or [[Creating_a_Core_Dump_from_a_Running_Process_using_WinDbg]]</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">
</div><div class="Bulleted1">
Line 21: Line 27:
<span class="BulletSymbol">• </span>Remove the Zimbra Connector for Outlook .msi file, delete the zdb file and the profile, and reinstall.
<span class="BulletSymbol">• </span>Remove the Zimbra Connector for Outlook .msi file, delete the zdb file and the profile, and reinstall.


=== '''Viewing Existing Outlook Profiles after ZCO Installation''' ===
=== Viewing Existing Outlook Profiles after ZCO Installation ===


If you cannot find your existing email profile/accounts after your install Zimbra Connector for Outlook, navigate to '''Start>Control Panel>Mail>Show Profiles''' to see all existing mail profiles. Other profiles in Outlook were not changed. Selecting "Prompt for a profile to be used" will allow the user to continue using any previously existing mail profiles in additon to the zimbra profile.
If you cannot find your existing email profile/accounts after your install Zimbra Connector for Outlook, navigate to '''Start>Control Panel>Mail>Show Profiles''' to see all existing mail profiles. Other profiles in Outlook were not changed. Selecting "Prompt for a profile to be used" will allow the user to continue using any previously existing mail profiles in additon to the zimbra profile.
Line 27: Line 33:
</div><div class="a_0033Heading">
</div><div class="a_0033Heading">


===Reviewing Sync Issues Folders===
=== Reviewing Sync Issues Folders ===


</div><div class="BodyAfterHead">
</div><div class="BodyAfterHead">
Line 35: Line 41:
</div><div class="Body">
</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.
If users are having problems using Outlook and continuously receiving errors, submit a support case and include the messages in these folders. These messages are created to help Zimbra technical support and engineering debug and fix errors.


</div><div class="a_0032Heading">
</div><div class="a_0032Heading">


===Using Logging Control for Troubleshooting===
=== Using Logging Control for Troubleshooting ===


</div><div class="BodyAfterHead">
</div><div class="BodyAfterHead">
Line 47: Line 53:
</div><div class="Body">
</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.
<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 to enable ZCO logging and enable http 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">
</div><div class="Body">
Line 53: Line 59:
'''Important:''' After enabling logging from the ZCS Outlook Logging Control dialog, users must restart Outlook before errors and event can be logged.
'''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">
</div><div class="Anchor">[[Image:ZCOLogCtl.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>.
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>.
Line 62: Line 68:


</div>
</div>
{{Article Footer|Zimbra Collaboration 8.0, 7.0|04/16/2014}}
[[Category:Troubleshooting ZCO]]

Latest revision as of 11:42, 12 July 2015

Outlook Troubleshooting Options

   KB 1623        Last updated on 2015-07-12  




0.00
(0 votes)


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.

Review the user’s Sync Issues mail folder for errors.

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.

If Outlook closes unexpectedly, i.e. with the warning “Outlook ...needs to close,” generate core dumps for Outlook. Go to the Zimbra Wiki Generating_Core_Dumps or Creating_a_Core_Dump_from_a_Running_Process_using_WinDbg 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.

If Outlook is hanging, or behaving strangely, run the Logging Control tool that is installed when the Connector for Outlook was installed. See Logging Control for Troubleshooting below. This file should be sent to Zimbra support.

Remove the Zimbra Connector for Outlook .msi file, delete the zdb file and the profile, and reinstall.

Viewing Existing Outlook Profiles after ZCO Installation

If you cannot find your existing email profile/accounts after your install Zimbra Connector for Outlook, navigate to Start>Control Panel>Mail>Show Profiles to see all existing mail profiles. Other profiles in Outlook were not changed. Selecting "Prompt for a profile to be used" will allow the user to continue using any previously existing mail profiles in additon to the zimbra profile.

Reviewing Sync Issues Folders

When ZCS Connector for Outlook is installed, a Sync Issues 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.

If users are having problems using Outlook and continuously receiving errors, submit a support case and include the messages in these folders. These messages are created to help Zimbra technical support and engineering debug and fix errors.

Using Logging Control for Troubleshooting

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.

ZCOLogCtl.exe is installed when ZCS Connector for Outlook is installed. This logging control tool is in the \Program files\Common Files\System\MSMAPI\1033 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 to enable ZCO logging and enable http 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.

Important: After enabling logging from the ZCS Outlook Logging Control dialog, users must restart Outlook before errors and event can be logged.

ZCOLogCtl.jpg

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 Send Log to Zimbra.

Note: The Enable Logging 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.

Verified Against: Zimbra Collaboration 8.0, 7.0 Date Created: 04/16/2014
Article ID: https://wiki.zimbra.com/index.php?title=Outlook_Troubleshooting_Options Date Modified: 2015-07-12



Try Zimbra

Try Zimbra Collaboration with a 60-day free trial.
Get it now »

Want to get involved?

You can contribute in the Community, Wiki, Code, or development of Zimlets.
Find out more. »

Looking for a Video?

Visit our YouTube channel to get the latest webinars, technology news, product overviews, and so much more.
Go to the YouTube channel »

Jump to: navigation, search