- 0 Talk
-
OpenSuSE103InstallGuide
Unofficial Installation Guide
This is an unofficial installation guide. It may be outdated or apply only to very specific configurations and versions. The official and maintained installation steps for RT are in the README and UPGRADING documents included in the official .tar.gz packages.
Outdated
This page contains out of date and possibly misleading information or instructions such as installation methods or configuration examples that no longer apply. Please consider this warning when reading the page below.
RT 3.3.6 Install on OpenSUSE 10.3 2008-06-05
Using: apache2, apache2-devel, apache2-example-pages, apache2-mod_perl, apache2-mod_php5, apache2-prefork, apache2-utils, apache2-worker, libapr-util1, libapr-util1-devel, libapr1, libapr1-devel, perl-Apache-DBI, limal-perl, pcre, perl, perl-Archive-Tar, (misc perl modules), mysql, mysql-Max, mysql-client, perl-DBD-mysql, lftp, ncftp, curl, wget.
Installed via YaST2.
Note: Due to SuSE's security configuration, you cannot use softlinks in -ANY- directory that apache will use. (ie: I moved '/srv' to '/var/srv' and then created a softlink from '/var/srv' to '/srv'. I then needed to edit the apache config files to reflect the same.)
cd /var/srv/source tar -xzvf rt-3.6.6.tar.gz cd rt-3.6.6
Note: SuSE renames Apache v2.x.x as Apache2, and various of its related basic commands similarly. Therefore, you need to create a softlink as follows:
ln -sf /usr/sbin/apache2ctl /usr/sbin/apachectl
Create rt group
groupadd rt
Configure CPAN in Perl (if not already configured.)
perl -e "use CPAN::FirstTime; CPAN::FirstTime::init();"
Note: I am installing rt in '/var/srv/www/rt3' (See first note above.) So I need to set configures prefix accordingly.
./configure --prefix=/var/srv/www/rt3 --with-web-user=wwwrun --with-web-group=www --with-apachectl
Note: Use RT's built-in dependency check tools to resolve any missing perl modules, etc.
make testdeps make fixdeps
Note: Ensure the hostname of your server is configured correctly so that the URL can resolve correctly even without DNS. In my case: linux.local
vi /etc/hosts hostname
Note: Install the RT application to the filesystem.
make install
Note: Create/Initialize RT's database
make initialize-database
Note: I have copied my RT_SiteConfig.pm file below. Modify as desired. Note also that I am using PORT 8088 for my purposes.
# RT_SiteConfig.pm 2008-06-05 by Patrick S. Kyne Set( $rtname, 'linux.local'); Set($WebPath , "/rt"); Set($WebPort , 8088);# + ($< * 7274) % 32766 + ($< && 1024)); 1; # EOF vi /var/srv/www/rt3/etc/RT_SiteConfig.pm
Note: Now we need to ensure that Apache will load the right modules. I have included the APACHE_MODULES configuration line from '/etc/sysconfig/apache2'. I included the following modules: auth_digest, perl, php5, rewrite.
APACHE_MODULES="actions alias auth_basic auth_digest authn_file authz_host authz_groupfile \ authz_default authz_user authn_dbm autoindex cgi dir env expires include log_config mime \ negotiation perl php5 rewrite setenvif ssl suexec userdir" vi /etc/sysconfig/apache2
Note: Now we need to configure apache's virtual host file. I've included mine below. Note also that I am using PORT 8088 for my purposes.
#rt.conf 2008-06-05 by Patrick S. Kyne
Listen *:8088
<VirtualHost *:8088>
ServerName localhost
ServerAdmin root@localhost
Alias /rt "/var/srv/www/rt3/share/html"
PerlModule Apache::DBI
PerlRequire /var/srv/www/rt3/bin/webmux.pl
<Directory /var/srv/www/rt3/share/html>
AllowOverride All
Options ExecCGI FollowSymLinks
<IfModule mod_access.c>
Order allow,deny
Allow from all
</IfModule>
</Directory>
<Directory "/var/srv/www/rt3/share/html">
Order allow,deny
Allow from all
</Directory>
<Location /rt>
RewriteEngine On
RedirectMatch permanent (.*)/$ $1/index.html
AddDefaultCharset UTF-8
SetHandler perl-script
PerlHandler RT::Mason
</Location>
</VirtualHost>
#EOF
vi /etc/apache2/vhosts.d/rt.conf
Note: Now restart apache to read in the new configuration.
rcapache2 restart
==================================================
Edit
Login to your new RT instance and test things out.
Default URL : http://yourhost.yourdomain.com/rt/
My Test URL : http://linux.local:8088/rt/
Default User: root
Default Pass: password