Upgrade Horizon

This section outlines the steps to follow to upgrade to a newer version of Horizon. You may need to complete additional steps to upgrade in a more complex setup (running more than one OpenNMS instance, database migration requirements, age of current version, and so on).

A basic upgrade of one instance can take about an hour. This time varies, and will be longer depending on how customized and complex your setup is.

Before you begin

There are a number of tasks you should complete before starting an upgrade:

  • Check the release notes for breaking changes in each release between your current version and the version you want to upgrade to. Address any issues that might affect you.

    Release notes for versions 28 and later are not available at the vault docs link (above) at this time. Please check the branches on GitHub for those release notes.
  • Stop OpenNMS and PostgreSQL services.

  • Prune unneeded events.

  • Back up your database. (same day/state)

  • Back up RRD files. (same day/state)

  • Back up the ${OPENNMS_HOME}/etc directory. (same day/state)

  • Assess the events table size. Especially important if you have a particularly large network with lots of events.

  • Identify the configuration files you have changed to determine what you need to migrate as part of an upgrade.

Assess Events Table Size

If, after pruning unneeded events, you still have a large number of events, you may need to increase the amount of memory passed to the OpenNMS install tool. For example, if you have 250k events, you will need almost 600MB of heap. When you upgrade and have the available memory, choose a large value to pass to the install, as in the following:

${OPENNMS_HOME}/bin/install -Xms1024m -Xmx2048m -dis