- enhance README.SUSE OBS-URL: https://build.opensuse.org/package/show/devel:languages:perl/request-tracker?expand=0&rev=71
69 lines
2.5 KiB
Plaintext
69 lines
2.5 KiB
Plaintext
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.
|
|
|