2 <title>Troubleshooting</title>
5 <h1>Troubleshooting</h1>
7 <li>When troubleshooting the web interface, helpful information is often in your web server's error log.
8 <li>Internet Explorer will not work with Freeside's HTML interface.
9 <a HREF="http://www.netscape.com">Netscape</a>,
10 <a HREF="http://lynx.browser.org">Lynx</a>, and
11 <a HREF="http://www.cs.indiana.edu/elisp/w3/docs.html">Emacs/W3</a>,
12 among others, should work fine.
13 <li>If bin/svc_acct.import fails with an "Out of memory!" error using MySQL, upgrede MySQL and recompile the Perl DBD. There was a memory leak in some older versions of MySQL.
14 <li>If you get tons of errors in your web server's error log like this:
16 Ambiguous use of value => resolved to "value" =>
17 at /usr/lib/perl5/site_perl/File/CounterFile.pm line 132.
19 This clutters up your log files but is otherwise harmless. Upgrade to the latest File::CounterFile.
20 <li>If you get an Internal Server Error when adding or editing, but find that the update has occured, and you get something like the following in your web server's error log:
22 access to <i>/your/path</i>/edit/process/<i>some_table</i>.cgi failed for
23 <i>machine.domain.tld</i>, reason: malformed header from script.
24 Bad header=HTTP/1.0 302 Moved Temporarily
26 Then you forgot to apply this <a href="CGI-modules-2.76-patch.txt">patch</a> as mentioned in the <a href="install.html">New Installation</a> section of the documentation.
27 <li>If you get errors like this:
29 UID.pm: Can't open /var/spool/freeside/conf/secrets: Permission denied
30 at <i>/your/path</i>/site_perl/FS/UID.pm line 26.
31 BEGIN failed--compilation aborted at
32 <i>/your/path</i>/edit/process/part_svc.cgi line 15.
34 Then the scripts are not running setuid freeside. If you were editing
35 the files, it is possible you inadvertantly removed the setuid bit.
36 As mentioned in the <a href="install.html">New Installation</a> section of the documentation, set ownership and permissions for the web interface. Your system should support secure setuid scripts or Perl's emulation, see <a href="http://www.perl.com/CPAN-local/doc/manual/html/pod/perlsec.html#Security_Bugs">perlsec: Security Bugs</a> for information and workarounds.
37 <pre>cd /usr/local/apache/htdocs/freeside
39 chmod 4755 browse/*.cgi edit/*.cgi edit/process/*.cgi misc/*.cgi misc/process/*.cgi search/*.cgi view/*.cgi</pre>