OpenBSD40InstallGuide

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 'OpenBSD40InstallGuide' 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.

Update of the OpenBSD38InstallGuide Originally by Bill Chmura / StrongpointNetworks

Overview:

The install follows the manual install guide provided on this site with a few exceptions.

• • I change to install RT under /var/www
  • I set it to use postgresql

Getting Started

You must have installed xbase40.tgz during installation. If you didn't, fetch it and run this command:

tar -xzpf xbase40.tgz -C /

Get the source

Download and Unpack the latest RT to your OpenBSD box. According to the web site this should get the latest version.

# wget http://download.bestpractical.com/pub/rt/release/rt.tar.gz
 # tar xzpf rt.tar.gz
 # cd rt-3.6.3/
 
 

Configuring RT

I used the defaults and got it to work, but I use a slightly different verion

./configure --with-db-type=Pg --prefix=/var/www/rt3

This sets it to use PostGreSQL and install it under /var/www instead of in /opt

Satisfy Dependencies

I found that it was easiest to install as much as possible from the OpenBSD packages. Under OpenBSD 4.0 I was able to install the following from Packages, which also did some dependencies automatically.

p5-HTML-Mason-1.26
mod_perl-1.29p0
p5-Apache-DBI-0.94
p5-Apache-Session-1.6
p5-Apache-Test-1.21
p5-DBD-Pg-1.41
p5-DBI-1.45p1
p5-DBIx-SearchBuilder-1.27
p5-HTTP-Server-Simple-0.18
p5-HTTP-Server-Simple-Mason-0.09
p5-HTML-Scrubber-0.08
p5-Locale-Maketext-Fuzzy-0.02
p5-Locale-Maketext-Lexicon-0.47
p5-Log-Dispatch-2.10
p5-MLDBM-2.01
p5-Module-Refresh-0.05
p5-Module-Versions-Report-1.02
p5-Regexp-Common-2.118
p5-Term-ReadKey-2.30
p5-Test-Inline-0.16
p5-Text-Autoformat-1.12
p5-Text-Quoted-1.8
p5-Text-Template-1.44
p5-Text-Wrapper-1.000
p5-Tree-Simple-1.14
p5-XML-NamespaceSupport-1.08
p5-XML-RSS-1.10
p5-XML-SAX-0.12
p5-XML-Simple-2.14
p5-LWP-UserAgent-Determined-1.03
p5-libwww-5.803
p5-Mail-Tools-1.67
p5-MIME-tools-5.411ap0
p5-Test-WWW-Mechanize-1.04
p5-Time-modules-2003.1126
p5-HTML-Format-2.04
p5-Text-WikiFormat-0.77
p5-GD-2.30
p5-GD-Graph-1.43
p5-GD-TextUtil-0.86

And for Postgres

postgresql-client-8.0.3
postgresql-docs-8.0.3p0
postgresql-server-8.0.3

If you are planning on installing the RTx-Statistics package you will also need

p5-GD-Graph-1.43.tgz

Now you can run

# make testdeps | grep MISSING
 
 

which will show you what is missing.

Next make sure you have cpan configured, then run:

# make fixdeps
 
 

Create a unix group for RT

Create a new Unix group called 'rt' (or whatever you gave to the –with-rt-group option to the configure script).

# groupadd rt
 
 

Install Initialize the DB as per the manual installation instructions.

Configuring Apache

The configuration for apache is the same as the manual install instructions for Apache (not Apache2), with the exception of changing the paths to reflect /var/www/rt.

Apache by default runs chrooted, which causes an RT::Handler error when you try to access it. You need to run Apache unchrooted by adding to rc.conf.local

httpd_flags="-u"

This is also where you would enable SSL for Apache. Documentation elsewhere on that.

I think this has covered the oddities

I've encountered no other problems. I am using Postfix for my MTA and have the mail gateway working fine.

Good luck

Things to do:

• • Get chroot apache working
  • Links to getting PostgresQL started on openbsd
  • Links to getting https configured on Apache