Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Remove references to postgresql-evr #3167

Draft
wants to merge 5 commits into
base: master
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,6 @@ include::modules/con_migrating-from-internal-databases-to-external-databases.ado

include::modules/con_postgresql-as-an-external-database-considerations.adoc[leveloffset=+1]

include::modules/proc_preparing-a-host-for-external-databases.adoc[leveloffset=+1]

include::modules/proc_installing-postgresql.adoc[leveloffset=+1]

include::modules/proc_migrating-to-external-databases.adoc[leveloffset=+1]
Expand Down
4 changes: 0 additions & 4 deletions guides/common/assembly_using-external-databases.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -14,17 +14,13 @@ endif::[]

To create and use external databases for {Project}, you must complete the following procedures:

. xref:preparing-a-host-for-external-databases_{context}[].
Prepare a host for the external databases.
. xref:installing-postgresql_{context}[].
Prepare PostgreSQL with databases for {Project}, Candlepin and Pulp with dedicated users owning them.
. xref:Configuring_Server_to_Use_External_Databases_{context}[].
Edit the parameters of `{foreman-installer}` to point to the new databases, and run `{foreman-installer}`.

include::modules/con_postgresql-as-an-external-database-considerations.adoc[leveloffset=+1]

include::modules/proc_preparing-a-host-for-external-databases.adoc[leveloffset=+1]

include::modules/proc_installing-postgresql.adoc[leveloffset=+1]

include::modules/proc_configuring-satellite-to-use-external-databases.adoc[leveloffset=+1]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,8 +20,6 @@ endif::[]

To migrate from the default internal databases to external databases, you must complete the following procedures:

. xref:preparing-a-host-for-external-databases_{context}[].
Prepare a {RHEL} 8 server to host the external databases.
. xref:installing-postgresql_{context}[].
Prepare PostgreSQL with databases for {Project}, Pulp and Candlepin with dedicated users owning them.
. xref:migrating-to-external-databases_{context}[].
Expand Down
11 changes: 9 additions & 2 deletions guides/common/modules/proc_installing-postgresql.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,24 @@
= Installing PostgreSQL

You can install only the same version of PostgreSQL that is installed with the `{foreman-installer}` tool during an internal database installation.
{Project} supports PostgreSQL version 12.
{Project} supports PostgreSQL version 13.

include::snip_firewalld.adoc[]

.Prerequisits
* The prepared host must meet {Project}'s {InstallingServerDocURL}storage-requirements_{project-context}[Storage Requirements].
* The prepared host has base operating system repositories enabled.
ifdef::orcharhino[]
* The prepared host has the same content available as your {ProjectServer}.
endif::[]

.Procedure

. To install PostgreSQL, enter the following command:
+
----
ifdef::katello,satellite,orcharhino[]
# dnf install postgresql-server postgresql-evr postgresql-contrib
# dnf install postgresql-server postgresql-contrib
endif::[]
ifndef::katello,satellite,orcharhino[]
# dnf install postgresql-server
Expand Down

This file was deleted.

Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
[id="Upgrading_the_External_Database_Operating_System{context}"]
= Upgrading the external database operating system

You can upgrade an external database from {EL} 8 to {EL} 9 while upgrading {Project} from {ProjectVersionPrevious} to {ProjectVersion}.

.Prerequisites
* Create a new {EL} 9 based host for PostgreSQL server that follows the external database on {EL} 9 documentation.
ifdef::katello,orcharhino,satellite[]
For more information, see {InstallingServerDocURL}using-external-databases_{project-context}[Using External Databases with {Project}].
endif::[]

.Procedure
. Create a backup.
. Restore the backup on the new server.
. If {Project} reaches the new database server via the old name, no further changes are required.
Otherwise reconfigure {Project} to use the new name:
+
[options="nowrap", subs="+quotes,verbatim,attributes"]
----
# {foreman-installer} \
--foreman-db-host _newpostgres.example.com_ \
--katello-candlepin-db-host _newpostgres.example.com_ \
--foreman-proxy-content-pulpcore-postgresql-host _newpostgres.example.com_
----
21 changes: 7 additions & 14 deletions guides/common/modules/proc_upgrading-the-external-database.adoc
Original file line number Diff line number Diff line change
@@ -1,24 +1,17 @@
[id="Upgrading_the_External_Database_{context}"]
[id="Upgrading_the_External_Database{context}"]
= Upgrading the external database

You can upgrade an external database from {EL} 7 to {EL} 8 while upgrading {Project} from {ProjectVersionPrevious} to {ProjectVersion}.
The external database will be upgraded when running the {foreman-installer} on the {Project} server.

.Prerequisites
* Create a new {EL} 8 based host for PostgreSQL server that follows the external database on {EL} 8 documentation.
ifdef::katello,orcharhino,satellite[]
For more information, see {InstallingServerDocURL}using-external-databases_{project-context}[Using External Databases with {Project}].
endif::[]
* The {InstallingServerDocURL}using-external-databases_{project-context}[Using External Databases with {Project}] guide has been followed.

.Procedure
. Create a backup.
. Restore the backup on the new server.
. If {Project} reaches the new database server via the old name, no further changes are required.
Otherwise reconfigure {Project} to use the new name:
. Update permissions to prepare the postgresql-evr extension for removal:
+
[options="nowrap", subs="+quotes,verbatim,attributes"]
----
# {foreman-installer} \
--foreman-db-host _newpostgres.example.com_ \
--katello-candlepin-db-host _newpostgres.example.com_ \
--foreman-proxy-content-pulpcore-postgresql-host _newpostgres.example.com_
# runuser -l postgres -c \
"psql -d foreman -c \"UPDATE pg_extension SET extowner = (SELECT oid FROM pg_authid WHERE rolname='foreman') WHERE extname='evr';\""
----
. Follow the {UpgradingDocURL}upgrading_a_connected_{project-context}_server_{context}[Upgrading {Project}] guide.
6 changes: 5 additions & 1 deletion guides/doc-Release_Notes/topics/katello.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,11 @@
[id="katello-headline-features"]
== Headline Features

There are no highlights with Katello {KatelloVersion}.
=== postgresql-evr extension no longer required

Installation of the Katello database on remote systems where root access is not available is now possible.
Only a basic PostgreSQL installation is required, which should enable installs on systems like Amazon RDS or Azure Database for PostgreSQL.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is out of scope, but we have a guide https://docs.theforeman.org/nightly/Deploying_Project_on_AWS/index-katello.html and using Amazon RDS would be a good thing to document, after it's been verified.

The contents of postgresql-evr have been moved into Katello itself as a migration, which enables this new capability.

[id="katello-upgrade-warnings"]
== Upgrade Warnings
Expand Down
1 change: 1 addition & 0 deletions guides/doc-Upgrading_Project/master.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -50,5 +50,6 @@ include::common/modules/proc_upgrading-smartproxy-server.adoc[leveloffset=+2]
ifdef::foreman-el,katello,satellite,orcharhino[]
// Upgrading the External database
include::common/modules/proc_upgrading-the-external-database.adoc[leveloffset=+2]
include::common/modules/proc_upgrading-the-external-database-operating-system.adoc[leveloffset=+2]
endif::[]
endif::[]
1 change: 1 addition & 0 deletions guides/doc-Upgrading_Project_Disconnected/master.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -45,5 +45,6 @@ include::common/modules/proc_upgrading-smartproxy-server.adoc[leveloffset=+2]
ifdef::foreman-el,katello,satellite,orcharhino[]
// Upgrading the External database
include::common/modules/proc_upgrading-the-external-database.adoc[leveloffset=+2]
include::common/modules/proc_upgrading-the-external-database-operating-system.adoc[leveloffset=+2]
endif::[]
endif::[]