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