htdocs/docs/trouble.html

   1 <head>
   2   <title>Troubleshooting</title>
   3 </head>
   4 <body>
   5   <h1>Troubleshooting</h1>
   6   <ul>
   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.  <b>This may be fixed in >1.2, please report your experiences!</b>
   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:
  15 <pre>
  16 Ambiguous use of value => resolved to "value" =>
  17 at /usr/lib/perl5/site_perl/File/CounterFile.pm line 132.
  18 </pre>
  19         This clutters up your log files but is otherwise harmless.  Upgrade to the latest File::CounterFile.
  20     <li><b>(No longer applicable in >1.2!)</b> 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:
  21 <pre>
  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
  25 </pre>
  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:
  28 <pre>
  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.
  33 </pre>
  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
  38 chown -R freeside .
  39 chmod 4755 browse/*.cgi edit/*.cgi edit/process/*.cgi misc/*.cgi misc/process/*.cgi search/*.cgi view/*.cgi</pre>
  40   <li>If you receive `can not connect to server' errors using MySQL on a system that doesn't support native threading, you may need to specify the full hostname in your DBI datasource.  See the <a href="http://www.mysql.com/Manual_chapter/manual_Problems.html#Can_not_connect_to_server">MySQL documentation</a>, DBI manpage and the DBD::mysql manpage for details.
  41   </ul>
  42 </body>