RT 4.4.1 installation on CentOS 7.2.1511
NOTE: I'm tracking the formatting is out of control on this page. I'll be editing it to repair it. The text here is functional, I just need to work on the wiki markup formatting!
- Access to the internet and CentOS OS and update repositories is available.
- Installation testing was completed using CentOS 7.2.1511 minimal boot ISO.
- httpd (Apache) 2.4 and mod_fcgid Apache modules were used as the host environment.
- 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 expat gd graphviz mariadb-server openssl expat-devel gd-devel graphviz-devel mariadb-devel openssl-devel perl perl-CPAN wget screen mod_fcgid yum groupinstall "Development Tools" "Web Server"
- Patch OS
yum update reboot the OS.
- If you are continuing to next step immediately, do not reboot.
- Disable selinux, by editing /etc/sysconfig/selinux:
- reboot the OS
- Adjust local services:
systemctl enable mariadb.service systemctl enable httpd.service systemctl start mariadb.service systemctl stop httpd.service
- NOTE: httpd service needs to be stopped to allow RT web based configuration later.
Configure Supporting Software
- Configure root password for mariadb:
mysqladmin -u root password
- NOTE: configure the internal DB password for the local instance of mysqld or mariadb
- Install CPAN minus.
curl -L http://cpanmin.us | perl - --sudo App::cpanminus
- Configure RT to use cpanm for fixdeps:
RT Dependencies and Installation
- Get RT and extract to /tmp.
wget https://download.bestpractical.com/pub/rt/release/rt-4.4.1.tar.gz tar xvzf rt-4.4.1.tar.gz -C /tmp cd /tmp/rt-4.4.1
- Configure RT:
./configure --enable-graphviz --enable-gd --with-web-user=apache --with-web-group=apache
- Test the dependencies:
- Fix the dependencies:
- NOTE: You may need to run the command more than once. On RHEL 6.8, you may need to manually force the addition of the GD perl module via
cpanm GD --force, as there is a known issue with one of the build in tests for GD.
- Confirm the dependencies are complete:
<pre> make install
- 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.
- Run the first run installation instance:
- Access the server using a web browser on the http 80 port.
- Configure the rt instance using the web interface. Refer to the RT documentation.
- Shutdown the rt-server instance.
- When completed Ctrl-C the rt-server instance started above.
Configure RT for hostname.domain.name/rt directory
(!) This is a personal preference. The web server example below 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"
# 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
- Start apache:
systemctl start httpd.service
- Modify firewalld
- Complete your firewalld configuration to suite your local requirements.
(!) NOTE: Depending on install method, firewalld may not be installed. You can also stop it for testing with the "systemctl stop firewalld" command.
- Access RT
- Connect to RT using your web browser and start your customization.