Autor Thema: Debian / Ubuntu  (Gelesen 3317 mal)

Beatrice Müller

  • Global Moderator
  • Beiträge: 137
Debian / Ubuntu
« am: 09.09.2019 09:31:54 »
Bevor Sie KIX installieren möchten, sichten Sie bitte zunächst die Kompatibilitätsmatrix im Bereich Download.

1.) Folgende Zeile zur /etc/apt/sources.list hinzufügen   
deb [trusted=yes] https://packages.kixdesk.com/repository/debian kix2017 stable
2.) PublicKey von cape IT zur Authentisierung der Pakete importieren
wget -qO - https://packages.kixdesk.com/repository/debian/PublicKey | apt-key add -
3.) apt-Quellen erneuern
apt-get update
4.) KIX installieren
  • mit PostgreSQL-Datenbank (Standard)
apt-get install kix
  • 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.
export KIXMYSQL_USER=<MySQL admin user>
export KIXMYSQL_PASSWORD=<MySQL admin password>
apt-get install kix-mysql kix

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.


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
Wichtige Hinweise zu MySQL:
Ab der Server-Version von Debian 9 ist der MySQL-Server nicht mehr in den Standard Paketquellen des Betriebssystems enthalten, stattdessen werden MariaDB-Server sowie PostgreSQL-Server bereitgestellt. Für eine Installation von KIX mit MySQL-Server, muss dieser vorab über separate Paketquellen eingebunden und installiert werden. KIX unterstützt MySQL in den Versionen 5.5 bis 5.7.
Für Debian 10 und Ubuntu 20.04 wird mySQL nicht mehr unterstützt!

  • 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.
export KIXMARIADB_USER=<MariaDB admin user>
export KIXMARIADB_PASSWORD=<MariaDB admin password>
apt-get install kix-mariadb kix

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.

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
5.) 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