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
|
# --
# README.webserver - webserver description of OTRS
# Copyright (C) 2001-2003 Martin Edenhofer <martin+code@otrs.org>
# --
# $Id: README.webserver,v 1.13 2003/10/07 08:14:53 martin 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.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 (speed!):
=======================
Add this to the mod_perl stuff section in httpd.conf
[...]
Alias /otrs-web/ "/opt/otrs/var/httpd/htdocs/"
Alias /otrs/ "/opt/otrs/bin/cgi-bin/"
<Location /otrs>
SetHandler perl-script
PerlHandler Apache::Registry
Options ExecCGI
PerlSendHeader On
PerlSetupEnv On
</Location>
You may want to use a mod_perl startup script. Compiled modules on startup
(speed!)! Use the mod_perl startup script which comes with otrs
(scripts/apache-perl-startup.pl).
- Change the default startup script location of your httpd to
$OTRS_HOME/scripts/apache-perl-startup.pl in httpd.conf
[...]
# load all otrs modules
Perlrequire /opt/otrs/scripts/apache-perl-startup.pl
[...]
Edit the scripts/apache-perl-startup.pl script:
- Establish datababase connections on process startup (httpd).
[...]
use Apache ();
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! ,-)
PS: If you use mod_perl2 use the scripts/apache2-* scripts!
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
|
