NMS-19060: Add Centos 10 installation docs

docs/antora.yml

@@ -9,10 +9,12 @@ asciidoc:
     source-language: asciidoc@
     xrefstyle: short@
     compatible-centos7: '7.x'
-    compatible-centos-stream: 'CentOS Stream 9.x'
+    compatible-centos-stream9: '9.x'
+    compatible-centos-stream10: '10.x'
     compatible-rhel7: '7.x'
     compatible-rhel8: '8.x'
     compatible-rhel9: '9.x'
+    compatible-rhel10: '10.x'
     compatible-ubuntu: '20.04 LTS'
     compatible-debian: '9 - 11'
     compatible-rocky-linux: '9.x'

docs/modules/deployment/pages/core/centos/adoptium.adoc

@@ -0,0 +1,18 @@
+.Add Adoptium repository. See official https://adoptium.net/installation[docs] for more information.
+[source, console]
+----
+sudo bash -c 'cat <<EOF > /etc/yum.repos.d/adoptium.repo
+[Adoptium]
+name=Adoptium
+baseurl=https://packages.adoptium.net/artifactory/rpm/${DISTRIBUTION_NAME:-$(. /etc/os-release; echo $ID)}/\$releasever/\$basearch
+enabled=1
+gpgcheck=1
+gpgkey=https://packages.adoptium.net/artifactory/api/gpg/key/public
+EOF'
+----
+
+.Install Temurin Java {compatible-javajdk}
+[source, console, subs="attributes"]
+----
+sudo dnf install temurin-{compatible-javajdk}-jdk
+----

docs/modules/deployment/pages/core/centos10/install-core.adoc

@@ -0,0 +1,33 @@
+ifeval::["{page-component-title}" == "Horizon"]
+include::../centos/adoptium.adoc[]
+endif::[]
+
+ifeval::["{page-component-title}" == "Horizon"]
+include::../../repos/rhel-centos/horizon-rhel10.adoc[]
+endif::[]
+
+ifeval::["{page-component-title}" == "Meridian"]
+include::../../repos/rhel-centos/meridian-rhel10.adoc[]
+endif::[]
+
+.Install {page-component-title} with all built-in dependencies
+[source, console, subs="attributes"]
+----
+sudo dnf -y install {package-prefix}
+----
+
+TIP: Disable the OpenNMS {page-component-title} repository after installation to prevent unwanted upgrades when upgrading other packages on the server.
+After upgrading, OpenNMS {page-component-title} requires manual steps to upgrade configuration files or migrate database schemas to a new version.
+We recommend excluding the {page-component-title} packages from updates except when you plan to perform an upgrade.
+If you have a minimal system installed, you may need to install the config manager with `sudo dnf install 'dnf-command(config-manager)'`.
+
+.Disable auto updates for OpenNMS {page-component-title}
+[source, console]
+----
+ifeval::["{page-component-title}" == "Horizon"]
+sudo dnf config-manager --disable opennms-repo-stable-*
+endif::[]
+ifeval::["{page-component-title}" == "Meridian"]
+sudo dnf config-manager --disable meridian
+endif::[]
+----

docs/modules/deployment/pages/core/centos10/postgresql.adoc

@@ -0,0 +1,41 @@
+.Install language packs and set language
+[source,console]
+----
+sudo dnf install langpacks-en glibc-all-langpacks -y
+sudo localectl set-locale LANG=en_US.UTF-8
+sudo localectl
+sudo dnf makecache
+sudo dnf update -y
+----
+
+.Install PostgreSQL
+[source, console]
+[subs="verbatim,attributes"]
+----
+sudo dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-10-x86_64/pgdg-redhat-repo-latest.noarch.rpm
+sudo dnf -qy module disable postgresql
+sudo dnf install -y postgresql{postgresql-version}-server
+sudo /usr/pgsql-{postgresql-version}/bin/postgresql-{postgresql-version}-setup initdb
+sudo systemctl enable postgresql-{postgresql-version}
+sudo systemctl start postgresql-{postgresql-version}
+----
+
+IMPORTANT: You must provide a secure password for the `opennms` database user account.
+This guide uses `YOUR-OPENNMS-PASSWORD` as a placeholder.
+
+.Create an opennms database user and password
+[source, console]
+sudo -i -u postgres createuser -P opennms
+
+.Create an empty database and set the owner to the opennms user
+[source, console]
+sudo -i -u postgres createdb -O opennms opennms
+
+IMPORTANT: Change `YOUR-POSTGRES-PASSWORD` to a secure one and use the prefixed space to avoid storing the password in the history.
+The superuser is required to be able to initialize and change the database schema for installation and updates.
+
+.Set a password for PostgreSQL superuser
+[source, console]
+----
+sudo -i -u postgres psql -c "ALTER USER postgres WITH PASSWORD 'YOUR-POSTGRES-PASSWORD';"
+----

docs/modules/deployment/pages/core/getting-started.adoc

@@ -93,6 +93,12 @@ CentOS 9::
 --
 include::centos9/postgresql.adoc[]
 --
+
+CentOS 10::
++
+--
+include::centos10/postgresql.adoc[]
+--
 ifeval::["{page-component-title}" == "Horizon"]
 
 Debian/Ubuntu::
@@ -122,6 +128,13 @@ CentOS 9::
 --
 include::centos9/install-core.adoc[]
 --
+
+CentOS 10::
++
+--
+include::centos10/install-core.adoc[]
+--
+
 ifeval::["{page-component-title}" == "Horizon"]
 
 Ubuntu::
@@ -155,6 +168,12 @@ CentOS 9::
 include::centos/initialize-core.adoc[]
 --
 
+CentOS 10::
++
+--
+include::centos/initialize-core.adoc[]
+--
+
 ifeval::["{page-component-title}" == "Horizon"]
 Debian/Ubuntu::
 +

docs/modules/deployment/pages/core/system-requirements.adoc

@@ -35,10 +35,12 @@ OpenNMS {page-component-title} requires one of the following operating systems:
 | Operating System  | Compatible Versions (64-bit)
 
 | RHEL
-| {compatible-rhel9}
+| {compatible-rhel9} +
+{compatible-rhel10}
 
 | CentOS
-| {compatible-centos-stream}
+| {compatible-centos-stream9} +
+{compatible-centos-stream10}
 
 ifeval::["{page-component-title}" == "Horizon"]
 | Debian

docs/modules/deployment/pages/repos/rhel-centos/horizon-rhel10.adoc

@@ -0,0 +1,10 @@
+.Add repository and import GPG key
+[source, console]
+----
+sudo dnf -y install https://yum.opennms.org/repofiles/opennms-repo-stable-rhel9.noarch.rpm
+----
+IMPORTANT: The next command is a workaround until https://opennms.atlassian.net/browse/NMS-19071 is solved.
+[source, console]
+----
+sudo sed -i 's/gpgcheck=1/gpgcheck=0/g' /etc/yum.repos.d/opennms-repo-stable-rhel9.repo
+----