Zimlet Developers Guide:Troubleshooting: Difference between revisions
Line 53: | Line 53: | ||
|} | |} | ||
== Cannot | == Cannot upgrade zimlet == | ||
{| cellpadding="20" cellspacing="0" border="1" | {| cellpadding="20" cellspacing="0" border="1" | ||
Line 73: | Line 73: | ||
|style="background-color:#ffffcc;" |'''Solution #4''' | |style="background-color:#ffffcc;" |'''Solution #4''' | ||
|Clear the browser cache. | |Clear the browser cache. | ||
|} | |||
== Zimlet not showing up == | |||
{| cellpadding="20" cellspacing="0" border="1" | |||
|style="background-color:#ffffcc;" width="15%" |'''Problem''' | |||
|Zimlet installed but not showing up in browser. | |||
|- | |||
|style="background-color:#ffffcc;" |'''Solution #1''' | |||
|Check the browser error console for JavaScript errors: | |||
<ul> | |||
<li>On Firefox, browse to "Tools > Error Console"</li> | |||
<li>On Internet Explorer, browse to "Tools > Internet Options" and choose "Advanced" tab. Check the "Display a notification for every script error". | |||
</ul> | |||
|- | |||
|style="background-color:#ffffcc;" |'''Solution #2''' | |||
|Make sure you do not have any <code>debugger</code> statements in your zimlet. | |||
See [[ZCS_6.0:Zimlet_Developers_Guide:Firefox and Firebug|Firefox and Firebug]] for more information. | |||
|} | |} |
Revision as of 22:23, 15 December 2009
Introduction | Getting Started | Dev Environment Setup |
|
API Specifications | Example Zimlets |
Zimlet fails to deploy
Problem | Zimlet fails to deploy and FileNotFoundException in {zcs-install-dir}/log/mailbox.log .
|
Summary | The Zimlet failed to deploy and the zimlet definition file {zimlet-name}.xml could not be found in the zimlet package.
|
Solution #1 | Check that your zimlet ZIP package has the zimlet content at the top-level (i.e. directly in the ZIP). |
Solution #2 | Check that your zimlet name matches in the following locations:
<zimlet name={zimlet-name}” ... >
|
Solution #3 | If you create your zimlet ZIP archive on a Mac and use the “Compress” feature from the Mac UI, additional Mac-specific files (e.g. directory __MACOSX/* ) are added to the ZIP. Either remove these files manually or use the “zip” command line instead of Compress.
|
Solution #4 | Check that your zimlet name is all lower case. For example "com_zimbra_helloworld" is valid. "COM_zimbra_HelloWorld" is not. |
Cannot upgrade zimlet
Problem | Cannot upgrade Zimlet or latest changes are not shown. |
Solution #1 | Uninstall (i.e. undeploy) old zimlet prior to installing new zimlet. |
Solution #2 | Be sure the zimlet version number as specified in the Zimlet Definition File and Zimlet Configuration File version attribute is higher than the older zimlet.
|
Solution #3 | Flush the zimlet cache using:
zmprov fc zimlet |
Solution #4 | Clear the browser cache. |
Zimlet not showing up
Problem | Zimlet installed but not showing up in browser. |
Solution #1 | Check the browser error console for JavaScript errors:
|
Solution #2 | Make sure you do not have any debugger statements in your zimlet.
See Firefox and Firebug for more information. |