Update process

Database Upgrades

From time to time we need to do some long running database updates. For this reason you should always run the update from a screen or tmux session.

While the database update is in progress, your monitoring is still available and schedules checks.

Long running database updates will always print a status information, like in the following example: Convert table nagios_logentries from int to bigint(20) unsigned. This could take awhile...

All database changes will be applied full automatically - no manual action is required.

Backup your current nagios.cfg

All openITCOCKPIT configuration files, are located in the directory /etc/openitcockpit. If you have modified one of the configuration files manually, apt will offer you the following options:

1. 1) Install the package maintainer's version
2. 2) Keep the local version currently installed
3. 3) Show the differences between the versions
4. 4) Other options...

Most of the time you will see this notice for the file /etc/openitcockpit/nagios.cfg. This will happen, if we update the Nagios or Naemon Core to a new version.

To avoid any issues, you should always use the nagios.cfg we ship with our packages (Option 1). Experienced users can also merge the files together.

To reapply your manual changes, after the update is done, you should create a backup of the file /etc/openitcockpit/nagios.cfg first. Example:

cp /etc/openitcockpit/nagios.cfg /root/nagios.cfg_upgrade

Run the update

tmux
sudo apt-get update
sudo apt-get dist-upgrade

Yes, that's all .

Update in a nutshell

Happy new year, your openITCOCKPIT Team!

Check which repository you are using

As already mentioned, usually openITCOCKPIT will update automatically to the new repository.

Via the Interface

Browse to Administration Package Manager. If you are still on the old repository, you will see the following warning:

Via the CLI

Make sure that the file /etc/apt/sources.list.d/openitcockpit.list contains our new repository https://packages.openitcockpit.com.

How to update to our new repository

Import the repository key:

apt-key adv --recv --keyserver hkp://keyserver.ubuntu.com 1148DA8E

Add the new repository to your sources.list. In this example for Ubuntu Xenial:

echo 'deb https://packages.openitcockpit.com/repositories/xenial xenial main' > /etc/apt/sources.list.d/openitcockpit.list
apt-get update

You can find all supported distributions in our download section or on our GitHub Repository.