Autor Thema: Update Guide  (Gelesen 928 mal)

Fabian Seibt

  • Global Moderator
  • Beiträge: 147
Update Guide
« am: 03.04.2019 12:58:11 »
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

Tags: