style
[freeside.git] / httemplate / 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>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.
9     <li>If you get tons of errors in your web server's error log like this:
10 <pre>
11 Ambiguous use of value => resolved to "value" =>
12 at /usr/lib/perl5/site_perl/File/CounterFile.pm line 132.
13 </pre>
14         This clutters up your log files but is otherwise harmless.  Upgrade to the latest File::CounterFile. 
15     <li>If you get errors like this:
16 <pre>
17 UID.pm: Can't open /var/spool/freeside/conf/secrets: Permission denied 
18 at <i>/your/path</i>/site_perl/FS/UID.pm line 26.
19 BEGIN failed--compilation aborted at
20 <i>/your/path</i>/edit/process/part_svc.cgi line 15.
21 </pre>
22         Then the scripts are not running as the freeside freeside user.  See
23 the <a href="install.html">New Installation</a> section of the documentation.
24   <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.
25   </ul>
26 </body>