Problems with Apache

Most people who have problems with the Apache did build their own very special Apache. Of course you are welcome to do so but in case you run into trouble we suggest to your the vanilla version which is provided by your favorate distribution.

Internal Server Error

In this case check the syntax of the index.pl file to find the error:
shell:~ # cd ~otrs
It's important to be in the $HOME of the otrs user.
shell:/opt/otrs # perl -cw bin/cgi-bin/index.pl 
bin/cgi-bin/index.pl syntax OK
shell:/opt/otrs #
If you get an error message, in most cases you have to install missing perl modules from CPAN.

Install CPAN modules via cpan shell:
shell:~ # perl -MCPAN -e shell;
 -- (may you have to configure cpan first) --

cpan shell -- CPAN exploration and modules installation (v1.59_54)
ReadLine support enabled

cpan> install Digest::MD5
[installing Digest::MD5 module]
cpan> 
Check the perl syntax again (perl -cw bin/cgi-bin/index.pl) and install further missing modules if necessary.

Error: Can't connect to database!

If your browser get the message "Error: Can't connect to database!" after you changed the database settings, restart the webserver. mod_perl reads the ~otrs/Kernel/Config.pm only on startup.

If the "Error: Can't connect to database!" message is still there, check the error log of your webserver (e. g. /var/log/httpd/error_log).

FreeBSD, PostgeSQL and Apache (install_driver(Pg) failed)

Everything is working fine just if I want to use the web interface I get always: [...] Software error: install_driver(Pg) failed: [Thu Sep 19 16:52:18 2002] index.pl: [Thu Sep 19 16:52:18 2002] index.pl: Can't load '/usr/local/lib/perl5/site_perl/5.005/i386-freebsd/auto/DBD/Pg/Pg.so' for module DBD::Pg: Shared object "libpq.so.2" not found at /usr/libdata/perl/5.00503/DynaLoader.pm line 169. [Thu Sep 19 16:52:18 2002] index.pl: [Thu Sep 19 16:52:18 2002] index.pl: [Thu Sep 19 16:52:18 2002] index.pl: [Thu Sep 19 16:52:18 2002] index.pl: at (eval 124) line 3 Perhaps a required shared library or dll isn't installed where expected at /usr/local/otrs/bin/cgi-bin/../../Kernel/System/DB.pm line 67 [...]

To solve this problem, you can tell the Apache httpd.conf to include the environmental variable LD_LIBRARY_PATH= /usr/local/pgsql/lib. Put this line to httpd.confand then restart "SetEnv LD_LIBRARY_PATH /usr/local/pgsql/lib" and then restart (source http://lists.otrs.org/pipermail/otrs/2002-September/000248.html).