1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
|
# --
# README.webserver - webserver description of OTRS
# Copyright (C) 2001-2008 OTRS AG, http://otrs.org/
# --
# $Id: README.webserver,v 1.17 2008/04/29 11:40:58 tr Exp $
# --
# This software comes with ABSOLUTELY NO WARRANTY. For details, see
# the enclosed file COPYING for license information (GPL). If you
# did not receive this file, see http://www.gnu.org/licenses/gpl-2.0.txt.
# --
Which webserver is needed?
==========================
I prefer the apache webserver (http://httpd.apache.org).
Configuration:
==============
"After" this steps, you will get 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 "$OTRS_HOME/scripts/suse-httpd.include.conf" include config file.
Add it to /etc/sysconfig/apache with HTTPD_CONF_INCLUDE_FILES
[...]
HTTPD_CONF_INCLUDE_FILES=/opt/otrs/scripts/suse-httpd.include.conf
[...]
Start SuSEconfig and restart the webserver (rcapache restart).
Or edit the httpd.conf directly:
================================
a)
*) Change the webserver user (normaly wwwrun) to the OTRS user (otrs).
[...]
User wwwrun
[...]
User otrs
[...]
*) If you can't change the user and group of your webserver (system-wide),
because you have other applications running on this server, you can
also work with group permissions (more tricky).
Use "$HOME/bin/SetPermissions.sh <OTRS_HOME> <OTRS_USER> <WEBSERVER_USER> [OTRS_GROUP] [WEB_GROUP]"
e. g.
Webserver with otrs user: "SetPermissions.sh /opt/otrs otrs otrs"
Webserver with wwwrun user (e. g. SuSE): "SetPermissions.sh /opt/otrs otrs wwwrun"
Webserver with apache user (e. g. Redhat): "SetPermissions.sh /opt/otrs otrs apache"
b)
*)
Without mod_perl (just CGI):
============================
Add this to the cgi-bin stuff section in httpd.conf
[...]
Alias /otrs-web/ "/opt/otrs/var/httpd/htdocs/"
ScriptAlias /otrs/ "/opt/otrs/bin/cgi-bin/"
[...]
*)
With mod_perl 1 (speed!):
=======================
Add this to the mod_perl stuff section in httpd.conf
[...]
# agent, admin and customer frontend (mod_alias required!)
ScriptAlias /otrs/ "/opt/otrs/bin/cgi-bin/"
Alias /otrs-web/ "/opt/otrs/var/httpd/htdocs/"
# load all otrs modules (speed improvement!)
# Perlrequire /opt/otrs/scripts/apache-perl-startup.pl
# Apache::StatINC - Reload %INC files when updated on disk
# (just use it for testing, setup, ... not for high productiv systems)
# PerlInitHandler Apache::StatINC
<Location /otrs>
ErrorDocument 403 /otrs/index.pl
SetHandler perl-script
PerlHandler Apache::Registry
Options ExecCGI
PerlSendHeader On
PerlSetupEnv On
</Location>
[...]
*)
With mod_perl 2 (speed!):
=======================
Add this to the mod_perl stuff section in httpd.conf
[...]
# agent, admin and customer frontend
ScriptAlias /otrs/ "/opt/otrs/bin/cgi-bin/"
Alias /otrs-web/ "/opt/otrs/var/httpd/htdocs/"
# load all otrs modules
Perlrequire /opt/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/apache-perl-startup.pl / scripts/apache2-perl-startup.pl script:
- Establish datababase 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 webserver
=====================
d)
Web-Installer
=============
http://yourhost/otrs/installer.pl
First login
===========
http://yourhost/otrs/index.pl
User: root@localhost
PW: root
EOF
|