
[[upgrade-basic]]
= Basic Upgrade Steps
:description: Basic steps to upgrade OpenNMS Horizon or Meridian, including PostgreSQL upgrade and configuration.

This procedure describes how to do a basic {page-component-title} upgrade.
You may need to complete additional steps to upgrade in a more complex setup (for example, if you run more than one {page-component-title} instance, have more complex database migration requirements, or depending on the age of current version).

If you use Git to track changes to your configuration files, see xref:deployment:upgrade/git-upgrade.adoc[Upgrade {page-component-title} with Git].

IMPORTANT: Make sure you complete the tasks in the xref:deployment:upgrade/introduction.adoc#byb_upgrade[before you begin] section before starting.
In addition, if the xref:releasenotes:whatsnew.adoc[system requirements] for the new version require you to <<posgresql-upgrade, upgrade your PostgreSQL database>>, you must do this before the {page-component-title} upgrade.

== Update and verify the {page-component-title} repository

[{tabs}]
====
CentOS/RHEL::
+
--
include::rhel/up-rhel.adoc[]
--

ifeval::["{page-component-title}" == "Horizon"]
Debian/Ubuntu::
+
--
include::debian/up-debian.adoc[]
--
endif::[]
====

[[posgresql-upgrade]]
== PostgreSQL upgrade and configuration

Refer to the https://www.postgresql.org/docs/[PostgreSQL documentation] for information on how to upgrade a PostgreSQL database.
You may also find the https://opennms.discourse.group/t/upgrading-postgresql/772#upgrading-on-rhel-or-centos-using-pg_upgrade-6[Upgrading PostgreSQL] article on Discourse useful.

NOTE: You must stop the {page-component-title} service while doing maintenance on database services.
