RT 4.4.2 installation on CentOS 6.10
NOTE: Cloned from original document for CentOS 7 install.
This document provides a quick methodology for installing RT 4.4.2 on CentOS/RHEL 6.10 for an internet-connected server.
CAUTION: While this document has been upgraded for CentOS 6.10, you cannot use this method to install RT 4.4.3 directly - there is an issue with the web install on RT 4.4.3. I've asked Best Practical to look at the issue. It would appear that the PGP key for RT-4.4.3 is not certified, and the web install fails during attempts to follow the method below. I can confirm an upgrade to RT 4.4.3 is possible after following this install, but with the PGP key issue, I do not recommend the upgrade until Best Practical resolves the PGP certified key issue.
* Access to the internet and CentOS OS, update and EPEL repositories is available. * Installation testing was completed using CentOS 6.10 minimal boot ISO. * httpd (Apache) 2.2 and mod_fcgid Apache modules were used as the host environment. * mod_fcgid requires enabling the EPEL repository * Testing was conducted in both KVM and vSphere environments.
- OS Installation and Initial Configuration
* (!) It is possible to automate the majority of this section using kickstart files.
- Install OS.
* Install the OS from ISO or PXE boot using your normal methodology.
- Install prerequisites for RT from OS repository.
yum install epel-release yum install expat gd graphviz openssl expat-devel gd-devel graphviz-devel openssl-devel perl perl-CPAN wget screen mod_fcgid postgresql-server postgresql-devel yum groupinstall "Development Tools" "Web Server"
* NOTES: We use PostgreSQL as the DB which allows us to enable full text search. We need to enable the EPEL repository to install mod_fcgid on CentOS 6.
- Patch OS
- Disable selinux, by editing /etc/sysconfig/selinux:
- Reboot the OS
* reboot the OS
- Initialize the database:
service postgresql initdb
- Adjust local services:
chkconfig postgresql on chkconfig httpd on service postgresql start service httpd stop
* NOTE: httpd service needs to be stopped to allow RT web based configuration later.
- Configure Supporting Software
- Configure postgres user password for postgresql:
sudo -u postgres psql ALTER USER postgres PASSWORD 'xxx'; \q
* NOTE: This step configures the internal DB postgres password for the local instance of postgresql
- Reconfigure postgres local user access
* Configure PostgreSQL to use md5 passwords (needed for RT). Edit
/var/lib/pgsql/data/pg_hba.confand modify the following line from peer to md5:
# "local" is for Unix domain socket connections only #local all all ident local all all md5
* Restart postgresql for the changed configuration
service postgresql restart
- Install CPAN minus.
curl -L http://cpanmin.us | perl - --sudo App::cpanminus
- RT Dependencies and Installation
- Get RT
mkdir rt cd rt wget https://download.bestpractical.com/pub/rt/release/rt-4.4.2.tar.gz wget https://download.bestpractical.com/pub/rt/release/rt-4.4.2.tar.gz.asc
- Verify downloads
* NOTE: Release notes are found at https://bestpractical.com/release-notes/rt/4.4.2 * extract the sha256sums from the release notes online and add them to a new
b2e366e18c8cb1dfd5bc6c46c116fd28cfa690a368b13fbf3131b21a0b9bbe68 rt-4.4.2.tar.gz 2185c2be31b352ad0a7605f9a4e4720b2c3607df75aae1c0cbace9eb9e6fcef8 rt-4.4.2.tar.gz.asc
* confirm the files:
sha256sum -c sha256sum.txt
- Get RT and extract to /tmp.
tar xvzf rt-4.4.2.tar.gz -C /tmp cd /tmp/rt-4.4.2
- Configure RT:
./configure --enable-graphviz --enable-gd --with-web-user=apache --with-web-group=apache --with-db-type=Pg
- Configure RT to use cpanm for fixdeps:
- Test the dependencies:
- Install the dependencies:
* NOTE: You may need to run the command more than once. On RHEL/CentOS 6.10, you may need to manually force the installation of the
MooX::latemodule, a dependency of
Gpg::Interfaceand then rerun fixdeps.
cpanm MooX::late --force
- Confirm dependencies:
- Install RT (default install is to the /opt/rt4 directory):
- RT Configuration using Web Interface
* (!) It is possible to complete this step by editing the RT files directly, and creating the database. Refer to the RT documentation for manual steps.
- Start the first run installation instance:
- Configure using the web interface.
* Access the server using a web browser to access the http port. * Configure the RT instance using the web interface. Refer to the RT documentation. * With the local database instance, you will need to leave the Database Host and Database Port field empty on the Check Database Credentials page. * NOTE: You will likely need to disable your firewall or open port 80 to access the web page remotely.
service iptables stopwill disable the firewall temporarily.
- Shutdown the rt-server instance.
* When completed Ctrl-C the rt-server instance started above.
- Configure RT:
* Modify RT to allow web access using a trailing /rt * (!) This is a personal preference. The web server example in the next section assumes /rt is used.
- Modify /opt/rt4/etc/RT_SiteConfig.pm. Add the following line:
Set( $WebPath, '/rt' );
- Configure web server
- Modify /etc/httpd/conf.d/fcgid.conf. Add:
- Create /etc/httpd/conf.d/rt.conf:
# RT4 configuration for Apache ### Optional apache logs for RT # Ensure that your log rotation scripts know about these files # ErrorLog /opt/rt4/var/log/apache2.error # TransferLog /opt/rt4/var/log/apache2.access # LogLevel debug AddDefaultCharset UTF-8 Alias /rt/NoAuth/images /opt/rt4/share/html/NoAuth/images/ ScriptAlias /rt /opt/rt4/sbin/rt-server.fcgi/ DocumentRoot "/opt/rt4/share/html" <Location /rt> # For Centos7/Apache 2.4 this line: # Require all granted # For Centos6/Apache 2.2 these two lines: Order allow,deny Allow from all Options +ExecCGI AddHandler fcgid-script fcgi </Location>
- Start apache:
service httpd start
- Modify iptables
* Complete your iptables configuration to suite your local requirements. * To open the firewall for port 80, edit the
/etc/sysconfig/iptablesfile and insert the following line after the SSH (dport 22) line:
-A INPUT -m state --state NEW -m tcp -p tcp --dport 80 -j ACCEPT
* Then restart iptables
service iptables restart
* conduct a reboot to confirm the web server restarts and enable provides access to RT.
- Installation Complete
- Access RT
* Connect to RT using your web browser, login using the root user and start your site customization.