File README.SUSE of Package request-tracker

Overview Repositories Revisions Requests Users Attributes Meta

File README.SUSE of Package request-tracker

This is a supplement for the request-tracker README and UPGRADING-* files.

rt-setup-database MUST be run from /usr/share/request-tracker

Installation:
-------------
The following steps are very short and maybe no complete. Better refer to the 
official RT documentation at https://rt-wiki.bestpractical.com/wiki/InstallationGuides

1. Add the devel:languages:perl repository from OBS
   zypper ar -f 'http://download.opensuse.org/repositories/devel:/languages:/perl/openSUSE_$releasever/devel:languages:perl.repo'

2. Install the request-tracker package
   zypper in request-tracker

3. The initial setup requires a local database (can be migrated to another machine later).
   You can decide between MySQL, MariaDB and PostgreSQL on a free openSUSE distribution.
   We choose MariaDB here in the example:

Set mariadb root password and configure mysql daemon
   /usr/bin/systemctl enable --now mariadb.service
   /usr/bin/mysql_secure_installation

4. Initialize Request Tracker's database:
   /usr/sbin/rt-setup-database --action init

5. Configure and start postfix
   (have a look at /etc/sysconfig/postfix and adjust to your personal needs)
   /usr/bin/systemctl enable --now postfix.service

6. Configure apache
   We use mod_perl here in the example:
   /usr/sbin/a2enmod actions
   /usr/sbin/a2enmod perl
   ln -s /etc/request-tracker/apache2/apache2-modperl2.conf /etc/apache2/conf.d/
   /usr/bin/systemctl enable --now apache2.service

7. Create an initial

8. Visit your new RT page and finish the installation
   http://localhost/rt/

Upgrading:
----------
To be performed in place of Step 6b of the README upgrade instructions.

1. Change to /usr/share/request-tracker
    cd /usr/share/request-tracker

2. Upgrade the database
    rt-setup-database --action upgrade --dba postgres

3. Clear mason cache and restart web server
    rt-clean-mason-cache

4. Check the systemd timers, which replaced the former cron jobs:
    systemctl list-timers -all
   Per default, the RT timers are disabled (to avoid spamming as long 
   as your RT is not set up correctly.
   Please enable the timers via:
    systemctl enable --now rt-email-dashboard.timer \
                           rt-email-digest-daily.timer \
                           rt-email-digest-weekly.timer
   This will create the needed symlinks to start the timers automatically 
   and - in addition - run all timers for the first time.
   You can - of course - also decide to skip some of the timers above in 
   your installation, if they are not needed.

Places

File README.SUSE of Package request-tracker

Places