Observium has been designed from its initial inception to be easy and seamless to upgrade. We recommend keeping Community Edition installations updated to the latest version and updating Subscription Edition installations at least once per month.
To jump immediately to the Subscription Edition update instructions, click here
What is the Subscription Edition?
The Subscription Edition is released in
current trains using our SVN-based update system. It includes the new alerting system with advanced features, the traffic accounting system, routing protocols and additional future Service Provider and Enterprise-targeted features. It receives receive rapid bug fixes and feature improvements thanks to the SVN-based updates system.
You can subscribe using our Subscription signup page.
What is SVN?
Subversion (SVN) is a version control system that allows users to download the very latest version of Observium without having to wait for someone to get around to packaging it. Advantages to using Subversion include the latest version, vastly simplified updating, the ability to roll back an upgrade and the ability to easily create and submit patches.
Below are some quick directions for a couple of common tasks.
Why use SVN?
We use SVN as an automatic update mechanism in order to rapidly deliver improvements and fixes to users without the hassle of traditional packaged updates.
Rolling and Stable
Our use of SVN allows us to maintain two parallel trains of Observium,
rolling receives daily updates, and
stable receives weekly updates. The
stable train is intended to be safe to use for automatically updating installations.
Switch between Rolling and Stable trains
Sometime required to switch from stable to rolling train, for exaple to check fixed issue or updated/added feature. For switch use this commands from main observium dirrectory:
Stable -> Rolling
svn up svn switch https://svn.observium.org/svn/observium/trunk
Rolling -> Stable
svn switch https://svn.observium.org/svn/observium/branches/stable
Upgrading the Subscription Edition to the very latest version
Upgrading between releases with SVN is simple. If you have direct access to the command-line on the server, you can enter the commands below directly; alternatively, you can maintain a copy on a local machine and upload updated versions to the server.
To upgrade Observium, simply use the command below in the root of the installation directory.
To ensure that your database is kept up to date, you must run discovery.php immediately after an SVN update.
Upgrading the Subscription Edition to a specific version
You can upgrade to a specific revision with the following command:
svn update -r <revision number>
Let's say you want to install/upgrade version 0.12.4.3049. The SVN revision is the last number, so run the following:
svn update -r 3049
It may be possible something is broken in an official release and was fixed in the development version. We can not oversee all code changes and impact they may have to any of your devices, so we can not accept bug reports for non-very-latest versions. If you find a bug, try the latest version and if it's still broken, contact us. If it's not broken any longer, well, excellent!
Upgrade to latest Major release
Disable observium cronjobs
Run the following commands (as root):
cd /opt mv observium observium_old wget -Oobservium-community-latest.tar.gz https://www.observium.org/observium-community-latest.tar.gz tar zxvf observium-community-latest.tar.gz mv /opt/observium_old/rrd observium/ mv /opt/observium_old/logs observium/ mv /opt/observium_old/config.php observium/
Update DB schema:
If it has been a very long time since you've updated (12 months or more), you may want to force an immediate rediscovery of all devices to make sure things are up to date :
/opt/observium/discovery.php -h all
Re-enable observium cronjobs
You may now delete your observium_old directory if everything has updated correctly:
rm -rf observium_old