OpenBSD38InstallGuide

From Request Tracker Wiki
Jump to: navigation, 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.


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.

Note: It was also done on OpenBSD 3.7 and should still work, with the exception that some of the packages required are not available on OpenBSD 3.7 and must be installed via CPAN instead.

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

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

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

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

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.

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