# -- # README.web server - web server configuration for OTRS # Copyright (C) 2001-2011 OTRS AG, http://otrs.org/ # -- # $Id: README.webserver,v 1.23 2011/01/17 14:10:22 mb Exp $ # -- # This software comes with ABSOLUTELY NO WARRANTY. For details, see # the enclosed file COPYING for license information (AGPL). If you # did not receive this file, see http://www.gnu.org/licenses/agpl.txt. # -- Which web server is needed? =========================== We recommend the apache web server (http://httpd.apache.org). Configuration: ============== After these steps, you will find the login page at http://your-host/otrs/index.pl or http://your-host/otrs/installer.pl. SuSE Linux: =========== a) Install the RPM-Package (http://otrs.org/ - "rpm -i otrs-xxx.rpm"). b) The manual way: Use the configuration file included in your installation "$OTRS_HOME/scripts/suse-httpd.include.conf" Add it to /etc/sysconfig/apache with HTTPD_CONF_INCLUDE_FILES [...] HTTPD_CONF_INCLUDE_FILES=/var/www/otrs/scripts/suse-httpd.include.conf [...] Start SuSEconfig and restart the web server (rcapache restart). Or edit httpd.conf directly: ============================ a) *) Change the web server user (normally wwwrun) to the OTRS user (otrs). [...] User wwwrun [...] User otrs [...] *) If you can't change the user and group of your web server (system-wide), because you have other applications running on this server, you can also work with group permissions. This is somewhat more work. Webserver with OTRS user: "bin/otrs.SetPermissions.pl --otrs-user=otrs --web-user=otrs /var/www/otrs" Webserver with wwwrun user (e. g. SuSE): "bin/otrs.SetPermissions.pl --otrs-user=otrs --web-user=wwwrun /var/www/otrs" Webserver with apache user (e. g. Redhat): "bin/otrs.SetPermissions.pl --otrs-user=otrs --web-user=apache --otrs-group=apache --web-group=apache /var/www/otrs" b) *) Without mod_perl (just CGI): ============================ Add this to the cgi-bin stuff section in httpd.conf [...] Alias /otrs-web/ "/var/www/otrs/var/httpd/htdocs/" ScriptAlias /otrs/ "/var/www/otrs/bin/cgi-bin/" [...] *) With mod_perl 2 (fast): ========================= Add this to the mod_perl stuff section in httpd.conf [...] # agent, admin and customer frontend ScriptAlias /otrs/ "/var/www/otrs/bin/cgi-bin/" Alias /otrs-web/ "/var/www/otrs/var/httpd/htdocs/" # load all otrs modules Perlrequire /var/www/otrs/scripts/apache2-perl-startup.pl # Apache::Reload - Reload Perl Modules when Changed on Disk PerlModule Apache2::Reload PerlInitHandler Apache2::Reload PerlModule Apache2::RequestRec # set mod_perl2 options <Location /otrs> # ErrorDocument 403 /otrs/customer.pl ErrorDocument 403 /otrs/index.pl SetHandler perl-script PerlResponseHandler ModPerl::Registry Options +ExecCGI PerlOptions +ParseHeaders PerlOptions +SetupEnv Order allow,deny Allow from all </Location> [...] Edit the scripts/apache2-perl-startup.pl script: - Establish database connections on process startup (httpd). [...] use Apache::DBI (); Apache::DBI->connect_on_init('DBI:mysql:otrs', 'otrs', 'some-pass'); # Apache::DBI->connect_on_init($data_source, $username, $auth, \%attr) [...] - Change the otrs lib dir (if needed)! [...] # ---------------------------------------- # set otrs lib path! # ---------------------------------------- use lib "/path/to/otrs/"; use lib "/path/to/otrs/Kernel/cpan-lib"; [...] Nice! You will love mod_perl! ,-) c) Restart the web server ====================== d) Web-Installer ============= http://yourhost/otrs/installer.pl First login =========== http://yourhost/otrs/index.pl User: root@localhost Password: root EOF