HowtoForge

Wie man Mantis Bug Tracker auf CentOS 8 installiert

von ·

MantisBT ist eine freie, quelloffene und webbasierte Fehlerverfolgungssoftware, die in PHP geschrieben wurde. Sie ist einfach, benutzerfreundlich und benutzerfreundlich und wird mit einer Vielzahl von Werkzeugen geliefert, die Ihnen helfen, mit Teams zusammenzuarbeiten, um Fehler und Probleme schnell zu lösen. Es bietet eine reichhaltige Reihe von Funktionen, einschließlich Benachrichtigung per E-Mail, rollenbasierte Zugriffskontrolle, Projekte, Unterprojekte und Kategorieunterstützung, Issue Relationship Graph, anpassbares Dashboard und vieles mehr.

In diesem Tutorial zeigen wir Ihnen, wie Sie das Mantis-Fehlerverfolgungssystem unter CentOS 8 installieren.

Voraussetzungen

  • Ein Server mit CentOS 8.
  • Ein gültiger Domänenname, der auf Ihre Server-IP zeigt.
  • Auf dem Server ist ein Root-Passwort konfiguriert.

LAMP-Server installieren

Zuerst müssen Sie den Apache-Webserver, den MariaDB-Server, PHP und andere erforderliche Pakete auf Ihrem System installieren. Sie können sie alle mit dem folgenden Befehl installieren:

dnf install httpd mariadb-server php php-mysqli php-mbstring php-curl unzip -y

Sobald alle Pakete installiert sind, starten Sie den Apache- und MariaDB-Dienst und ermöglichen es ihnen, beim Systemneustart mit dem folgenden Befehl zu starten:

systemctl start httpd
systemctl start mariadb
systemctl enable httpd
systemctl enable mariadb

Sobald Sie fertig sind, können Sie mit dem nächsten Schritt fortfahren.

Eine Datenbank für Mantis erstellen

Mantis verwendet MariaDB oder MySQL als Datenbank-Backend. Sie müssen also eine Datenbank und einen Benutzer für Mantis erstellen.

Loggen Sie sich zunächst mit dem folgenden Befehl in die MariaDB-Shell ein:

mysql

Sobald Sie sich angemeldet haben, erstellen Sie eine Datenbank und einen Benutzer mit dem folgenden Befehl:

MariaDB [(none)]> CREATE DATABASE mantisdb;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON mantisdb.* TO 'mantis'@'localhost' IDENTIFIED BY 'mantispassword';

Als nächstes löschen Sie die Privilegien und verlassen die MariaDB-Shell mit folgendem Befehl:

MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> EXIT;

Sobald Sie fertig sind, können Sie mit dem nächsten Schritt fortfahren.

Mantis installieren

Laden Sie zunächst die neueste Version von Mantis von der Sourceforge-Website mit folgendem Befehl herunter:

wget https://excellmedia.dl.sourceforge.net/project/mantisbt/mantis-stable/2.24.2/mantisbt-2.24.2.zip

Sobald der Download abgeschlossen ist, entpacken Sie die heruntergeladene Datei mit dem folgenden Befehl:

unzip mantisbt-2.24.2.zip

Kopieren Sie dann das extrahierte Verzeichnis mit folgendem Befehl in das Apache-Wurzelverzeichnis:

cp -r mantisbt-2.24.2 /var/www/html/mantis

Ändern Sie als nächstes den Eigentümer des Mantis-Verzeichnisses auf Apache:

chown -R apache:apache /var/www/html/mantis

Sobald Sie fertig sind, können Sie mit dem nächsten Schritt fortfahren.

Konfigurieren Sie Apache für Mantis

Als nächstes müssen Sie eine Apache-Konfigurationsdatei für virtuelle Hosts für Mantis erstellen. Sie können sie mit dem folgenden Befehl erstellen:

nano /etc/httpd/conf.d/mantis.conf

Fügen Sie die folgenden Zeilen hinzu:

<VirtualHost *:80>
ServerAdmin [email protected]
DocumentRoot "/var/www/html/mantis"
ServerName mantis.linuxbuz.com
<Directory "/var/www/html/mantis/">
Options MultiViews FollowSymlinks
AllowOverride All
Order allow,deny
Allow from all
</Directory>

TransferLog /var/log/httpd/mantis_access.log
ErrorLog /var/log/httpd/mantis_error.log

</VirtualHost>

Speichern und schließen Sie die Datei, wenn Sie fertig sind, und starten Sie dann den Apache-Dienst neu, um die Änderungen zu übernehmen:

systemctl restart httpd

Sie können den Status des Apache auch mit dem folgenden Befehl überprüfen:

systemctl status httpd

Sie sollten die folgende Ausgabe erhalten:

? httpd.service - The Apache HTTP Server
   Loaded: loaded (/usr/lib/systemd/system/httpd.service; disabled; vendor preset: disabled)
  Drop-In: /usr/lib/systemd/system/httpd.service.d
           ??php-fpm.conf
   Active: active (running) since Sat 2020-09-19 11:06:51 EDT; 37s ago
     Docs: man:httpd.service(8)
 Main PID: 41737 (httpd)
   Status: "Running, listening on: port 80"
    Tasks: 213 (limit: 25014)
   Memory: 25.0M
   CGroup: /system.slice/httpd.service
           ??41737 /usr/sbin/httpd -DFOREGROUND
           ??41738 /usr/sbin/httpd -DFOREGROUND
           ??41739 /usr/sbin/httpd -DFOREGROUND
           ??41740 /usr/sbin/httpd -DFOREGROUND
           ??41741 /usr/sbin/httpd -DFOREGROUND

Sep 19 11:06:51 centos8 systemd[1]: Starting The Apache HTTP Server...

Sicheres Mantis mit Let’s Encrypt SSL

Als nächstes müssen Sie das Certbot-Dienstprogramm in Ihrem System installieren, um Let’s Encrypt SSL für Ihre Mantis-Website herunterzuladen und zu installieren.

Sie können den Certbot-Client mit dem folgenden Befehl installieren:

wget https://dl.eff.org/certbot-auto
mv certbot-auto /usr/local/bin/certbot-auto
chown root /usr/local/bin/certbot-auto
chmod 0755 /usr/local/bin/certbot-auto

Erhalten und installieren Sie als nächstes ein SSL-Zertifikat für Ihre Mantis-Webseite mit folgendem Befehl: Als nächstes müssen Sie ein SSL-Zertifikat für Ihre Mantis-Webseite erhalten und installieren:

certbot-auto --apache -d mantis.linuxbuz.com

Der obige Befehl installiert zunächst alle erforderlichen Abhängigkeiten auf Ihrem Server. Sobald die Installation abgeschlossen ist, werden Sie gebeten, eine E-Mail-Adresse anzugeben und die Dienstzeit wie unten gezeigt zu akzeptieren:

Saving debug log to /var/log/letsencrypt/letsencrypt.log
Plugins selected: Authenticator apache, Installer apache
Enter email address (used for urgent renewal and security notices) (Enter 'c' to
cancel): [email protected]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. You must
agree in order to register with the ACME server at
https://acme-v02.api.letsencrypt.org/directory
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(A)gree/(C)ancel: A

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Would you be willing to share your email address with the Electronic Frontier
Foundation, a founding partner of the Let's Encrypt project and the non-profit
organization that develops Certbot? We'd like to send you email about our work
encrypting the web, EFF news, campaigns, and ways to support digital freedom.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y 


Obtaining a new certificate
Performing the following challenges:
http-01 challenge for mantis.linuxbuz.com
Waiting for verification...
Cleaning up challenges
Deploying Certificate to VirtualHost /etc/apache/conf.d/mantis.conf

Als nächstes müssen Sie wählen, ob HTTP-Verkehr wie unten gezeigt zu HTTPS umgeleitet werden soll oder nicht:

Please choose whether or not to redirect HTTP traffic to HTTPS, removing HTTP access.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1: No redirect - Make no further changes to the webserver configuration.
2: Redirect - Make all requests redirect to secure HTTPS access. Choose this for
new sites, or if you're confident your site works on HTTPS. You can undo this
change by editing your web server's configuration.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Select the appropriate number [1-2] then [enter] (press 'c' to cancel): 2

Geben Sie 2 ein und drücken Sie Enter, um fortzufahren. Sobald die Installation abgeschlossen ist, sollten Sie die folgende Ausgabe sehen:

Redirecting all traffic on port 80 to ssl in /etc/apache/conf.d/mantis.conf

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Congratulations! You have successfully enabled https://mantis.linuxbuz.com

You should test your configuration at:
https://www.ssllabs.com/ssltest/analyze.html?d=mantis.linuxbuz.com
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

IMPORTANT NOTES:
 - Congratulations! Your certificate and chain have been saved at:
   /etc/letsencrypt/live/mantis.linuxbuz.com/fullchain.pem
   Your key file has been saved at:
   /etc/letsencrypt/live/mantis.linuxbuz.com/privkey.pem
   Your cert will expire on 2020-03-23. To obtain a new or tweaked
   version of this certificate in the future, simply run certbot-auto
   again with the "certonly" option. To non-interactively renew *all*
   of your certificates, run "certbot-auto renew"
 - If you like Certbot, please consider supporting our work by:

   Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
   Donating to EFF:                    https://eff.org/donate-le

Konfigurieren von SELinux und Firewall

Standardmäßig ist SELinux in CentOS 8 aktiviert. Sie müssen es also für Ihre Mantis-Website konfigurieren.

Sie können SELinux mit dem folgenden Befehl konfigurieren:

setsebool httpd_can_network_connect on -P
chcon -R -u system_u -t httpd_sys_rw_content_t -r object_r /var/www/html/mantis

Als nächstes lassen Sie Port 80 und 443 durch die Firewall mit folgendem Befehl zu:

firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-service=https
firewall-cmd --reload

Sobald Sie fertig sind, können Sie mit dem nächsten Schritt fortfahren.

Zugriff auf die Mantis-Web-Benutzeroberfläche

Öffnen Sie nun Ihren Webbrowser und greifen Sie über die URL https://mantis.linuxbuz.com auf die Mantis-Webschnittstelle zu. Sie sollten den folgenden Bildschirm sehen:

Mantis-Prüfung vor der Installation

Konfigurieren Sie die Datenbank

Geben Sie Ihren Datenbanknamen, Ihren Benutzernamen, Ihren Administrator-Benutzernamen, Ihr Passwort und Ihre E-Mail-Adresse an und klicken Sie auf die Schaltfläche Datenbank installieren/aktualisieren. Sobald die Installation abgeschlossen ist, sollten Sie den folgenden Bildschirm sehen:

Mantis-Installation abgeschlossen

Klicken Sie dann auf die Schaltfläche „Weiter„. Im folgenden Bildschirm sollten Sie die Anmeldeseite von Mantis BT sehen:

Anmeldung bei Mantis

Geben Sie einen Standard-Administrator für den Mantis-Benutzernamen an und klicken Sie auf die Schaltfläche Login. Sie werden gebeten, das Passwort einzugeben, wie auf dem folgenden Bildschirm gezeigt:

Administrator-Passwort eingeben

Geben Sie das Mantis-Standardpasswort „root“ ein und klicken Sie auf die Schaltfläche Login. Sie werden auf den folgenden Bildschirm weitergeleitet:

Mantis Dashboard

Administrator-Passwort ändern

Es wird empfohlen, Ihr Standard-Administrator-Passwort zu ändern. Geben Sie Ihr aktuelles Passwort, Ihr neues Passwort, Ihre E-Mail-Adresse, Ihren echten Namen, die Zugriffsebene und die Projektzugriffsebene an und klicken Sie auf die Schaltfläche „Benutzer aktualisieren“. Im folgenden Bildschirm sollten Sie das Mantis Dashboard sehen:

Mantis Bugtracker Dashboard

Schlussfolgerung

Herzlichen Glückwunsch! Sie haben Mantis mit Let’s Encrypt SSL erfolgreich auf CentOS 8 installiert. Sie können nun Mantis in Ihrer Entwicklungsumgebung implementieren und mit Teams zusammenarbeiten. Zögern Sie nicht, mich zu fragen, wenn Sie Fragen haben.

Das könnte dich auch interessieren …