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
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.
Originally by Bill Chmura / StrongpointNetworks
This has been tested on OpenBSD 3.8 over multiple installs. It produces a working RT system, but I am always open to suggestions. Share the knowledge. Since OpenBSD users tend to be a bit more hands-on, I don't do much hand holding through this. Sorry.
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
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
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
I found that it was easiest to install as much as possible from the OpenBSD packages. Under OpenBSD 3.8 I was able to install the following from Packages, which also did some dependencies automatically.
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-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-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
And for Postgres
If you are planning on installing the RTx-Statistics package you will also need
note: I had a problem with the png-1.2.7 package from 3.7 not upgrading during my conversion to 3.8. If you get problems with a png lib not being found, pkg_add -r png-1.2.8. I am not sure why it did not do it during my upgrade of all my other packages, but there you go.
Note: The OpenBSD 3.8 packages include p5-XML-RSS, but it is not a new enough version. The only other issue I had was with p5-Test-WWW-Mechanize which would not install.
p5-Test-WWW-Mechanize-1.04 is working fine here. Also added this to the list above.
Now you can run
# make testdeps
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.
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
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.
Things to do:
- Get chroot apache working
- Links to getting PostgresQL started on openbsd
- Links to getting https configured on Apache