KIX - Forum

English => Guides & How Tos => Thema gestartet von: Fabian Seibt am 03.04.2019 12:58:11

Titel: Update Guide
Beitrag von: Fabian Seibt 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.


1. Create Snapshot or backup your system:
/opt/kix/scripts/ -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/ stop www-data
2. c) Check available disk space for the update

3. Activate KIX repositories
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/ 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/ Maint::Cache::Delete
sudo -u www-data /opt/kix/./bin/ Maint::Loader::CacheCleanup
sudo -u www-data /opt/kix/./bin/ Maint::Config::Rebuild

7. Restart web server (only needed if step 5 is performed)
service apache2 restart
8. Start cron jobs/opt/kix/bin/ start www-data

After the update:
apt-mark hold kix kix-pg kixpro* (or kix-mariadb, kix-mysql)

best regards Fabian