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)
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
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
5. install KIX
with PostgreSQL database (Default)
yum install kix-pg kix
with MySQL database
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
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:
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
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:
6. restart system to activate the SELinux policy
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 ".