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 as the freeside freeside user.  See
  35 the <a href="install.html">New Installation</a> section of the documentation.
  36   <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.
  37   </ul>
  38 </body>