Update Guide

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

Procedure:

1. Create Snapshot or backup your system:

Code Auswählen Erweitern

/opt/kix/scripts/backup.pl -d /tmp/ -c gzip -t fullbackup

2. Stop external connections / Check resources:

2. a) Stop web server

Code Auswählen Erweitern

service apache2 stop

2. b) Stop KIX cron jobs

Code Auswählen Erweitern

/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:

Code Auswählen Erweitern

apt-mark unhold kix kix-pg kixpro* (or kix-mariadb, kix-mysql)

Code Auswählen Erweitern

apt-mark showhold (shows held back packages)

4. Update repositories and packages (KIX, KIXPro, additional packages)

Code Auswählen Erweitern

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)

Code Auswählen Erweitern

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)

Code Auswählen Erweitern

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)

Code Auswählen Erweitern

service apache2 restart

8. Start cron jobs

Code Auswählen Erweitern

/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

Code Auswählen Erweitern

apt-mark hold kix kix-pg kixpro* (or kix-mariadb, kix-mysql)

best regards Fabian