dudefellah.rt

Overview

This guide describes how to install and set up Request Tracker (RT) on your system.

Requirements

CentOS 7:

• CPAN Dependencies: The installation includes CPAN dependencies. However, on CentOS 7, some older Perl module dependencies may be installed unintentionally if you use the cpanminus package. To avoid this issue, the role does not use cpanminus, and will fail if you try to set up the rt_cpan_locallib option on CentOS 7. It’s better to install CPAN dependencies globally.

• GnuPG Version: CentOS 7 only supports GnuPG version 2.0.x, while RT requires version 2.2 or higher. You'll need to install a newer version of GnuPG manually. You can find instructions for this in the Install gnupg2 2.2+ task in the relevant file.

• Using GnuPG 1: If you’re only using GnuPG 1.4, it should work fine. Just ensure that /usr/bin/gpg points to the GnuPG 1 binary. The installer does not differentiate between GnuPG 1 and 2 based on the binary name.

Role Variables

You can find configurable variables in the comments section of defaults/main.yml. Additional information about automatically determined defaults can be found in vars/main.yml. These values are organized by distribution and version for clarity.

Be cautious when editing the rt_cpan_modules list. The default module requirements ensure a smooth installation. It's recommended to check that you don’t remove necessary dependencies if you customize this list. Always keep the existing modules from vars/main.yml and add to them if needed.

Dependencies

• This role requires certain collections, which have been renamed for clarity:

  • ansible.posix
  • community.general
  • community.mysql (used only for backups during upgrades)

• Ensure CPAN is installed and configured because this role does not use cpanminus.

• You may need to install an updated version of gpg2 first.

Example Playbook

A sample playbook might look like this:

- hosts: db_servers
  tasks:
    - block:
        - name: Install and configure the database
          ansible.builtin.include_role:
            name: dudefellah.postgresql
          vars:
            ...
      become: true

- hosts: rt_servers
  tasks:
    - block:
        - name: Install RT
          ansible.builtin.include_role:
            name: dudefellah.rt
          vars:
            rt_version: 5.0.1
            ...
        
        - name: Configure Apache
          ansible.builtin.include_role:
            name: geerlingguy.apache
          vars:
            apache_vhosts: |
              ...
            apache_vhosts_ssl: |
              ...

License

GPLv2+

Author Information

Dan - github.com/dudefellah