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.
This page 'OpenSuSE103InstallGuide' is tagged as 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. |
If you have checked or updated this page and found the content to be suitable, please remove this notice by editing the page and remove the Outdated template tag. |
OpenSuSE 10.3
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
==================================================
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