Autor Thema: CentOS 7.8  (Gelesen 1648 mal)

Beatrice Müller

  • Global Moderator
  • Beiträge: 137
CentOS 7.8
« am: 09.09.2019 10:56:41 »
Bevor Sie KIX installieren möchten, sichten Sie bitte zunächst die Kompatibilitätsmatrix im Bereich Download.

1.) EPEL-Repositories aktivieren (notwendig für benötigte Perl-Module)
yum install epel-release
2.) Policycoreutils hinzufügen
yum install policycoreutils-python
3.) KIX-Repository hinzufügen (z.B. /etc/yum.repos.d/kix.repo)
[kix]
name=kix
baseurl=https://packages.kixdesk.com/repository/redhat/kix2017/stable
gpgcheck=1
enabled=1
gpgkey=
proxy=_none_

4.) PublicKey von cape IT zur Authentisierung der Pakete importieren
wget -q https://packages.kixdesk.com/repository/redhat/PublicKey
rpm --import PublicKey
rm PublicKey

5.) Weitere benötigte Perl-Pakete installieren
yum -y install "perl(Mail::IMAPClient)" "perl(Crypt::SSLeay)"
6.) Repository-Quellen aktualisieren
yum check-update
7.) KIX installieren
  • mit PostgreSQL-Datenbank (Standard)
yum install kix-pg kix
sudo firewall-cmd --zone=public --add-port=80/tcp --permanent
sudo firewall-cmd --reload
systemctl enable httpd.service
systemctl enable postgresql.service
reboot
  • mit MySQL-Datenbank
    Hier ist es notwendig zwei Umgebungsvariablen vor der Installation zu setzen, damit KIX den MySQL-Nutzer und die MySQL-Datenbank anlegen kann.
    Falls die Variable KIXMYSQL_USER nicht angegeben ist, wird „root“ verwendet.

    Ist MySQL noch nicht auf dem System installiert, wird der KIX-Installer den MySQL-Server, die notwendigen Bibliotheken und den MySQL-Client mit installieren. Während der Installation von MySQL werden Sie zur Einrichtung des MySQL-Administrator-Passwortes aufgefordert. Das Passwort welches Sie hier eingeben muss zwingend identisch mit dem Passwort sein, welches Sie in der Umgebungsvariablen KIXMYSQL_PASSWORD gesetzt haben.
export KIXMYSQL_USER=<MySQL admin user>
export KIXMYSQL_PASSWORD=<MySQL admin password>
yum install kix-mysql kix
sudo firewall-cmd --zone=public --add-port=80/tcp --permanent
sudo firewall-cmd --reload
systemctl enable httpd.service
systemctl enable  mysql.service
reboot

Wichtiger Hinweis:

Während der Installation muss KIX die MySQL-Variable „innodb_log_file_size“ auf eine Größe von 150 MB, sowie die Variable „max_allowed_packet“ auf 30 MB anpassen, damit die Installation durchgeführt werden kann. Falls Sie bereits einen MySQL-Server nach Ihren Vorgaben konfiguriert haben und keine Anpassung wünschen, setzen Sie bitte VOR der Installation von KIX noch folgende Umgebungsvariable:export KIXMYSQL_NO_CONFIG_CHANGE=1
  • mit MariaDB-Datenbank
    Üblicherweise erfolgt die Installation unter dem root-Nutzer und eine Anmeldung an den MariaDB-Server ist für diesen Nutzer ohne Passwort möglich. In diesem Falle müssen keine Umgebungsvariablen gesetzt werden. Je nach vorhandener Systemumgebung ist eine Anmeldung ohne Passwort u.U. dennoch nicht möglich, z.B. weil bereits ein MariaDB-Server nach eigenen Sicherheitsvorgaben konfiguriert wurde. In diesem Falle ist es notwendig zwei Umgebungsvariablen vor der Installation zu setzen, damit KIX den MariaDB-Nutzer und die MariaDB-Datenbank anlegen kann.

    Falls die Variable KIXMARIADB_USER nicht angegeben ist, wird „root“ verwendet. Die Variable KIXMARIADB_PASSWORD muss das Passwort des angegebenen MariaDB-Administrator-Nutzers enthalten.

    Ist MariaDB noch nicht auf dem System installiert, wird der KIX-Installer den MariaDB-Server, die notwendigen Bibliotheken und den MariaDB-Client mit installieren. Falls Sie bei der Installation nach dem Passwort des Administrator-Nutzers gefragt werden, muss dieses Passwort identisch mit dem sein, welches Sie in der Umgebungsvariablen KIXMARIADB_PASSWORD gesetzt haben.
export KIXMARIADB_USER=<MariaDB admin user>
export KIXMARIADB_PASSWORD=<MariaDB admin password>
yum install kix-mariadb kix
sudo firewall-cmd --zone=public --add-port=80/tcp --permanent
sudo firewall-cmd --reload
systemctl enable httpd.service
systemctl enable  mariadb.service
reboot

Wichtiger Hinweis:

Während der Installation muss KIX die MariaDB-Variable „innodb_log_file_size“ auf eine Größe von 150 MB, sowie die Variable „max_allowed_packet“ auf 30 MB anpassen, damit die Installation durchgeführt werden kann. Falls Sie bereits einen MariaDB-Server nach Ihren Vorgaben konfiguriert haben und keine Anpassung wünschen, setzen Sie bitte VOR der Installation von KIX noch folgende Umgebungsvariable:export KIXMARIADB_NO_CONFIG_CHANGE=1
8.) Vorbereitungen zur Nutzung
Falls SELinux deaktiviert ist:
setenforce 0
9.) KIX nutzen
KIX ist nach der Installation sofort einsetzbar. Es ist keine Datenbankinstallation via installer.pl notwendig. Zugang erhält man durch den Aufruf der URL "<FQDN>/kix/index.pl" in einem der unterstützten Browser (siehe Kompatibilitätsmatrix). Für die erste Anmeldung steht der vorkonfigurierte Administrator-Nutzer "root@localhost" (Passwort "root")  bereit.

Die Arbeitsoberfläche für Service-Mitarbeiter erreichen Sie nach der Installation über folgende URL: "<Servername>/kix/index.pl". Das Self-Service-Portal für Anwender und Kunden ist über "<Servername>/kix/customer.pl" benutzbar.

Tags: installationsanleitung