Update Guide

Begonnen von Fabian Seibt, 03.04.2019 12:58:11

⏪ vorheriges - nächstes ⏩

Fabian Seibt

Hello everyone,

this is a short guide on how to update your system (using the example of Debian-, Ubuntu-Server)

Before you start:

Will pre-existing hot-/bugfixes be fixed within the new version or will it be necessary to apply them manually again?
Check custom extension packages for possible dependencies.


1. Create Snapshot or backup your system:
/opt/kix/scripts/backup.pl -d /tmp/ -c gzip -t fullbackup

2. Stop external connections / Check resources:

2. a) Stop web serverservice apache2 stop

2. b) Stop KIX cron jobs /opt/kix/bin/Cron.sh stop www-data

2. c) Check available disk space for the update

3. Activate KIX repositories

  • KIX repositories are often held back to perform OS-updates between your update cycle of KIX
  • Check if either the repos are commented out in /etc/apt/sources.list or unhold them:
apt-mark unhold kix kix-pg kixpro* (or kix-mariadb, kix-mysql)apt-mark showhold (shows held back packages)

4. Update repositories and packages (KIX, KIXPro, additional packages)
sudo apt-get update
sudo apt-get install kix-<DBMS> (kix-mariadb, kix-mysql, kix-pg)
sudo apt-get install kix
sudo apt-get instal kixpro
sudo apt-get install kixpro-*

5. Install any custom packages (OPMs, e.g. Extensions)
sudo -u www-data /opt/kix/./bin/kix.Console.pl Admin::Package::Install <Location+Package>

6. Delete caches and rebuild configuration (only needed if step 5 is performed)
sudo -u www-data /opt/kix/./bin/kix.Console.pl Maint::Cache::Delete
sudo -u www-data /opt/kix/./bin/kix.Console.pl Maint::Loader::CacheCleanup
sudo -u www-data /opt/kix/./bin/kix.Console.pl Maint::Config::Rebuild

7. Restart web server (only needed if step 5 is performed)
service apache2 restart

8. Start cron jobs/opt/kix/bin/Cron.sh start www-data

After the update:

  • Apply hot-/bugfixes if needed
  • Store/synchronize ACLs and processes again if they exist
  • Set KIX-repos on hold again
apt-mark hold kix kix-pg kixpro* (or kix-mariadb, kix-mysql)

best regards Fabian