Installation Guide

Before you install KIX, first check the compatibility matrix in the download section.

 

1. add KIX repository
zypper addrepo --gpg http://packages.kixdesk.com/repository/suse/kix2017/stable kix

2. import the c.a.p.e. IT PublicKey to authenticate the packages
wget -q http://packages.kixdesk.com/repository/suse/PublicKey
rpm --import PublicKey
rm PublicKey

3. update repository sources
zypper refresh

4. install KIX

with PostgreSQL database (Default)
zypper install kix-pg kix

with MySQL database

It's necessary to set two additional environment variables, so that KIX is able to create the MySQL user and database.

If the variable KIXMYSQL_USER is omitted, the username „root“ will be used.

If MySQL is not installed on your system, the KIX installer will install the MySQL server, including libraries and client. During the installation of MySQL you will be prompted to configure the MySQL administrator passwort. This password must to be identical to the one you have set in
the environment variable KIXMYSQL_PASSWORD.

export KIXMYSQL_USER=<MySQL admin user>
export KIXMYSQL_PASSWORD=<MySQL admin password>
zypper install kix-mysql kix

Important:
During the installation of KIX the installer will change the MySQL variable „ innodb_log_file_size“ to a size of 150MB, otherwise the installation will fail. If you've already pre-configured the MySQL server to your own needs and don't want to change the variable during the installation, please set the following envionment variable PRIOR to the installation of KIX:

export KIXMYSQL_NO_CONFIG_CHANGE=1

with MariaDB database

Usually the installation will be executed using the root user. In this case MariaDB can be accessed without a password, so no additional environment variables have to be set before the installation. In some already configured operating environments a connection to MariaDB without giving a password might not be possible. In this case you have to set two environment variables to allow KIX to create the necessary MariaDB user and database.

If the variable KIXMARIADB_USER is omitted, the username „root“ will be used. The variable KIXMYSQL_PASSWORD must contain the password of the given MariaDB administrator user.

If MariaDB is not yet installed on your system, the KIX installer will install the MariaDB server, including libraries and client. If you will be asked for the MariaDB administrator password during the installation of MariaDB, the password you will enter here must to be identical to the one you have set in the environment variable.

export KIXMARIADB_USER=<MariaDB admin user>
export KIXMARIADB_PASSWORD=<MariaDB admin password>
zypper install kix-mariadb kix

Important:
During the installation of KIX the installer will change the MariaDB variable „ innodb_log_file_size“ to a size of 150MB, otherwise the installation will fail. If you've already pre-configured the MariaDB server to your own needs and don't want to change the variable during the installation, please set the following envionment variable PRIOR to the installation of KIX:

export KIXMARIADB_NO_CONFIG_CHANGE=1

5. change apache config

The default configuration of the apache webserver in openSUSE doesn't follow symbolic links (SymLink) in the filesystem. KIX creates such a SymLink (/opt/kix) and uses this one in the apache config. The webserver has to accept the SymLink, so the apache config has to be changed accordingly. The reasiest way to do this is to change the following line in /etc/apache2/httpd.conf:

# forbid access to the entire filesystem by default
<Directory />
    Options None +FollowSymLinks

6. use KIX
After the installation KIX can be used right away. There is no need to execute the installer.pl. Using one of the supported web browsers (see Compatibility Matrix), the system can be accessed via "<FQDN>/kix/index.pl". For the first login, please use the pre-configured administrator user "root@localhost" (password "root").

The user interface for the service staff can be reached via the following URL : "<Server Name>/kix/index.pl ". The self-service portal for users and customers is usable via "<Server Name>/kix/customer.pl ".