OpenSuSE103InstallGuide

From Request Tracker Wiki
Jump to navigation Jump to search


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.


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.

  1. 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
 &lt;Directory /var/srv/www/rt3/share/html&gt;
    AllowOverride All
    Options ExecCGI FollowSymLinks
    &lt;IfModule mod_access.c&gt;
       Order allow,deny
       Allow from all
    &lt;/IfModule&gt;
 &lt;/Directory&gt;

 &lt;Directory "/var/srv/www/rt3/share/html"&gt;
    Order allow,deny
    Allow from all
 &lt;/Directory&gt;

 &lt;Location /rt&gt;
    RewriteEngine On
    RedirectMatch permanent (.*)/$ $1/index.html

    AddDefaultCharset UTF-8
    SetHandler perl-script
    PerlHandler RT::Mason
 &lt;/Location&gt;

</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