Delta Controls FAQTroubleshootingExtensions Copyright Information No part of this document may be reproduced, transmitted, transcribed, stored in a retrieval system or translated into any language (natural or computer), in any form or by any means, without the prior written permission of Delta Controls Inc. Limited permission is granted to reproduce documents released in Adobe Portable Document Format (PDF) electronic format in paper format. Documents released in PDF electronic format may be printed by end users for their own use using a printer such as an inkjet or laser device. Authorized distributors of Delta Controls Inc. products (Delta Partners) may print PDF documents for their own internal use or for use by their customers. Authorized Delta Partners may produce copies of released PDF documents with the prior written permission of Delta Controls Inc. Information in this document is subject to change without notice and does not represent a commitment to past versions of this document on the part of Delta Controls Inc. Copyright © 2021 Delta Controls Inc. All rights reserved Table of Contents Question: A plugin I installed is not working. How can I troubleshoot it?....................................1 of 2 Answer......................................................................................................................................1 of 2 Other resources.........................................................................................................................2 of 2 Getting Help..............................................................................................................................2 of 2 i Question: A plugin I installed is not working. How can I troubleshoot it? Answer Some questions to answer: • Perhaps the plugin is installed, but did you remember to enable it in configure? • Did the installer mention any missing dependencies? Examine the Dependencies section of the plugin's System topic to determine if your environment has all the necessary dependencies: other Plugins/Contribs, perl libraries, 3rd-party software, etc. ♦ Note that you can have the installer re-check dependencies by executing it with the "dependencies" option from the server: cd /path/to/my/foswiki/ $ perl GenPDFAddOn_installer dependencies CGI,>=0,cpan,May be required for lib/Foswiki/Contrib/GenPDF.pm Data::Dumper,>=0,cpan,May be required for lib/Foswiki/Contrib/GenPDF.pm Error,>=0,cpan,May be required for lib/Foswiki/Contrib/GenPDF.pm File::Temp,>=0,cpan,May be required for lib/Foswiki/Contrib/GenPDF.pm htmldoc,0,external,Obtain from http://www.htmldoc.org/software.php • Check System.InstalledPlugins and look against your plugin to see if it is listed. ♦ If it is listed, then it must be enabled in configure. ♦ If there is an initialisation error, it will be shown and hopefully provides a clue on how to fix the problem. • Are you using a persistent perl environment such as Foswiki:Extensions.FastCGIEngineContrib or Foswiki:Extensions.ModPerlEngineContrib? Perhaps you need to restart your web server (apache, for example) so that the latest LocalSite.cfg changes may take effect • Are there any clues in the webserver's error log? • Are there any clues in Foswiki's warn log (on Foswiki 1.0.x, data/warnYYYYMM.txt - on Foswiki 1.1.x, default is working/logs/error.log)? • Perhaps the problem isn't with Foswiki itself (ie. not a problem with the plugin's perl code), but some interaction with the web server and/or web browser ♦ Are there any javascript errors reported by the web browser? ◊ Sometimes javascript libraries may be loaded in the wrong order. This might be due to the new ADDTOZONE feature - not all plugins have been updated to work properly. If you are on Foswiki 1.0.x, you must have the latest version of JQueryPlugin and Foswiki:Extensions.ZonePlugin installed. In configure, enabling {MergeHeadAndScriptZones} can help. ◊ Sometimes javascript libraries aren't correctly received by the web browser. You may wish to check your webserver's error log for 404 not found, 403 unauthorised etc. errors on your Foswiki's pub directory, Eg. https://support.deltacontrols.com/foswiki/pub/System If the web server's error logs aren't readily accessible, a web browser may be used instead. Using Firefox for example, the Firebug debugging plugin can show files that failed to download in the 'net' panel. The failed files should be shown in red (eg. 404 not found, 403, 400, etc. errors). This might lead you to check filesystem permissions and perhaps webserver access controls. Copyright © Delta Controls Inc. Generated 02 Oct 2021 - 14:48 1 of 2 support.deltacontrols.com/...System/FAQTroubleshootingExtensions Other resources • Check the "Tasks" page for your plugin - perhaps the issue is already known. You can check progress on the resolution and perhaps learn of some work-around. If the plugin is named EmptyPlugin, then its tasks page will be at Foswiki:Tasks.EmptyPlugin. • Browse existing support requests in the Support web to see if the problem you are having has an FAQ for it, or perhaps another user has worked through the same issue before as a support question. As with the Tasks system, if Foswiki:Extensions.EmptyPlugin has existing Support questions filed against it, they should be available at Foswiki:Support.EmptyPlugin Getting Help • #foswiki IRC on freenode • Ask a support question • foswiki-discuss mailing list • Commercial (paid) support Back to: FrequentlyAskedQuestion Related Topics: Foswiki:Support.Faq31, InstalledPlugins, AdminDocumentationCategory This topic: System > WebHome > UsersGuide > FrequentlyAskedQuestions > FAQTroubleshootingExtensions Topic revision: 05 Sep 2010, ProjectContributor Copyright © by the contributing authors. All material on this site is the property of the contributing authors. Ideas, requests, problems regarding Delta Controls Support? Send feedback Copyright © Delta Controls Inc. Generated 02 Oct 2021 - 14:48 2 of 2.