Hauptmenü

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.

Procedure:

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