Installation Guide

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

 

1. add KIX repository (i.e. /etc/yum.repos.d/kix.repo)
[kix]
name=kix
baseurl=http://packages.kixdesk.com/repository/redhat/kix2017/stable
gpgcheck=1
enabled=1
gpgkey=
proxy=_none_

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

3. activate EPEL repositories (necessary for needed perl modules)
Follow the directions on the EPEL website to install the epel-release package appropriate to the RHEL version of the system in question.
Ensure that you install the EPEL release that corresponds to the RHEL release you are running.
(see also thread at Redhat Customer Portal)

4. update repository sources
yum check-updates

5. install KIX

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

with MySQL database

Please note:
MySQL is no longer contained in the current Red Hat repositories. However, if you consider to install from some other repository which provides the package "mysql-server", please follow these instructions.

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>
yum 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>
yum 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

6. restart system to activate the SELinux policy
reboot

7. 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 ".