CentOS7Install: Difference between revisions

From Request Tracker Wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 32: Line 32:
systemctl stop httpd.service</pre>
systemctl stop httpd.service</pre>
* NOTE:  httpd service needs to be stopped to allow RT web based configuration later.
* NOTE:  httpd service needs to be stopped to allow RT web based configuration later.
 
# Configure Supporting Software
=== Configure Supporting Software ===
## Configure root password for mariadb:
 
<pre>mysqladmin -u root password</pre>
# Configure root password for mariadb:
* NOTE:  configure the internal DB password for the local instance of mysqld or mariadb
## Install CPAN minus.
  <pre>mysqladmin -u root password</pre>
<pre>curl -L http://cpanmin.us | perl - --sudo App::cpanminus</pre>
 
## Configure RT to use cpanm for fixdeps:
  #* NOTE:  configure the internal DB password for the local instance of mysqld or mariadb
<pre>export RT_FIX_DEPS_CMD=/usr/local/bin/cpanm</pre>
 
# RT Dependencies and Installation
# Install CPAN minus.
## Get RT and extract to /tmp.
 
<pre>wget https://download.bestpractical.com/pub/rt/release/rt-4.4.1.tar.gz
  <pre>curl -L http://cpanmin.us | perl - --sudo App::cpanminus</pre>
 
# Configure RT to use cpanm for fixdeps:
 
  <pre>export RT_FIX_DEPS_CMD=/usr/local/bin/cpanm</pre>
 
=== RT Dependencies and Installation ===
 
# Get RT and extract to /tmp.
  <pre>wget https://download.bestpractical.com/pub/rt/release/rt-4.4.1.tar.gz
tar xvzf rt-4.4.1.tar.gz -C /tmp
tar xvzf rt-4.4.1.tar.gz -C /tmp
cd /tmp/rt-4.4.1</pre>
cd /tmp/rt-4.4.1</pre>
 
## Configure RT:
# Configure RT:
<pre>./configure --enable-graphviz --enable-gd --with-web-user=apache --with-web-group=apache</pre>
 
## Test the dependencies:
  <pre>./configure --enable-graphviz --enable-gd --with-web-user=apache --with-web-group=apache</pre>
<pre>make testdeps</pre>
 
## Install the dependencies:
# Test the dependencies:
<pre>make fixdeps</pre>
 
* NOTE:  You may need to run the command more than once.  On RHEL/CentOS 6.8, you may need to manually force the addition of the GD perl module via <code>cpanm GD --force</code>, as there is a known issue with one of the built in tests for GD.
  <pre>make testdeps</pre>
## Confirm the dependencies are complete:
 
</pre>make testdeps<pre>
# Fix the dependencies:
## Install RT (default install is to the /opt/rt4 directory):
 
<pre> make install</pre>
  <pre>make fixdeps</pre>
# RT Configuration using Web Interface
 
  #* NOTE:  You may need to run the command more than once.  On RHEL/CentOS 6.8, you may need to manually force the addition of the GD perl module via <code>cpanm GD --force</code>, as there is a known issue with one of the built in tests for GD.
 
# Confirm the dependencies are complete:
  </pre>make testdeps<pre>
 
# Install RT (default install is to the /opt/rt4 directory):
 
  <pre> make install</pre>
 
=== 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.
(!) 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:
# Run the first run installation instance:
<pre>/opt/rt4/sbin/rt-server</pre>
 
## Configure using the web interface.
  <pre>/opt/rt4/sbin/rt-server</pre>
* 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.
# Configure using the web interface.
## Shutdown the rt-server instance.
 
* When completed Ctrl-C the rt-server instance started above.
  #* Access the server using a web browser on the http 80 port.
# Configure RT for hostname.domain.name/rt directory
 
  #* 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.
(!) 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:
# Modify /opt/rt4/etc/RT_SiteConfig.pm.  Add the following line:
<code>'''Set( $WebPath, '/rt' );'''</code>
 
# Configure web server
  <code>'''Set( $WebPath, '/rt' );'''</code>
## Modify /etc/httpd/conf.d/fcgid.conf.  Add:
 
<code>'''FcgidMaxRequestLen 1073741824'''</code>
=== Configure web server ===
## Create /etc/httpd/conf.d/rt.conf:
 
<code>'''# RT4 configuration for Apache
# Modify /etc/httpd/conf.d/fcgid.conf.  Add:
  <code>'''FcgidMaxRequestLen 1073741824'''</code>
 
# Create /etc/httpd/conf.d/rt.conf:
 
  <code>'''# RT4 configuration for Apache
 
### Optional apache logs for RT
### Optional apache logs for RT
# Ensure that your log rotation scripts know about these files
# Ensure that your log rotation scripts know about these files
Line 139: Line 98:
</Location>'''</code>
</Location>'''</code>


# Start apache:
## Start apache:
 
<pre>systemctl start httpd.service</pre>
  <pre>systemctl start httpd.service</pre>
## Modify firewalld
 
* Complete your firewalld configuration to suite your local requirements.
# Modify firewalld
(!) NOTE:  Depending on install method, firewalld may not be installed.  You can also stop it for testing with the "systemctl stop firewalld" command.
 
# Installation Complete
  #* Complete your firewalld configuration to suite your local requirements.
## Access RT
 
* Connect to RT using your web browser and start your customization.
  (!) 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.

Revision as of 09:41, 12 October 2016

RT 4.4.1 installation on CentOS 7.2.1511

Assumptions

  • 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.

Installation Steps

  1. OS Installation and Initial Configuration

(!) It is possible to automate the majority of this section using kickstart files.

    1. Install OS.
  • Install the OS from ISO or PXE boot using your normal methodology.
    1. 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"
  • NOTE: On previous versions of CentOS/RHEL, replace the mariadb-server and mariadb-devel RPMs above with mysql-server and mysql-devel.
    1. Patch OS
yum update
reboot the OS.
  • If you are continuing to next step immediately, do not reboot.
    1. Disable selinux, by editing /etc/sysconfig/selinux:

SELINUX=disabled

  • reboot the OS
    1. 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.
  1. Configure Supporting Software
    1. Configure root password for mariadb:
mysqladmin -u root password
  • NOTE: configure the internal DB password for the local instance of mysqld or mariadb
    1. Install CPAN minus.
curl -L http://cpanmin.us | perl - --sudo App::cpanminus
    1. Configure RT to use cpanm for fixdeps:
export RT_FIX_DEPS_CMD=/usr/local/bin/cpanm
  1. RT Dependencies and Installation
    1. 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
    1. Configure RT:
./configure --enable-graphviz --enable-gd --with-web-user=apache --with-web-group=apache
    1. Test the dependencies:
make testdeps
    1. Install the dependencies:
make fixdeps
  • NOTE: You may need to run the command more than once. On RHEL/CentOS 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 built in tests for GD.
    1. Confirm the dependencies are complete:

make testdeps

    1. Install RT (default install is to the /opt/rt4 directory):

<pre> make install
  1. 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.

    1. Run the first run installation instance:
/opt/rt4/sbin/rt-server
    1. Configure using the web interface.
  • 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.
    1. Shutdown the rt-server instance.
  • When completed Ctrl-C the rt-server instance started above.
  1. Configure RT for hostname.domain.name/rt directory

(!) This is a personal preference. The web server example below assumes /rt is used.

    1. Modify /opt/rt4/etc/RT_SiteConfig.pm. Add the following line:

Set( $WebPath, '/rt' );

  1. Configure web server
    1. Modify /etc/httpd/conf.d/fcgid.conf. Add:

FcgidMaxRequestLen 1073741824

    1. Create /etc/httpd/conf.d/rt.conf:

# RT4 configuration for Apache

      1. Optional apache logs for RT
  2. Ensure that your log rotation scripts know about these files
  3. ErrorLog /opt/rt4/var/log/apache2.error
  4. TransferLog /opt/rt4/var/log/apache2.access
  5. 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>

    1. Start apache:
systemctl start httpd.service
    1. 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.

  1. Installation Complete
    1. Access RT
  • Connect to RT using your web browser and start your customization.
Retrieved from "https://rt-wiki.bestpractical.com/index.php?title=CentOS7Install&oldid=26401"