From 17b85ea3755cc73325fc3c17c6b2fa1b87f3cfb6 Mon Sep 17 00:00:00 2001 From: Leonid Andreev Date: Thu, 4 Mar 2021 11:17:22 -0500 Subject: [PATCH 1/4] Changing the language on required postgres versions/announcing support for later versions. (#7374) --- doc/release-notes/7374-postgresql-update | 9 ++++++++ .../source/installation/prerequisites.rst | 23 ++++++------------- pom.xml | 2 +- 3 files changed, 17 insertions(+), 17 deletions(-) create mode 100644 doc/release-notes/7374-postgresql-update diff --git a/doc/release-notes/7374-postgresql-update b/doc/release-notes/7374-postgresql-update new file mode 100644 index 00000000000..332ffda0060 --- /dev/null +++ b/doc/release-notes/7374-postgresql-update @@ -0,0 +1,9 @@ +## Notes for Dataverse Administrators + +Up until this release our installation guide "strongly recommended" to install PostgreSQL v. 9.6. While that version is known to be very stable, it is nearing its end-of-life (in Nov. 2021). Dataverse Software has now been tested with versions up to 13. If you decide to upgrade PostgreSQL, the tested and recommended way of doing that is as follows: + +- Export your current database with ``pg_dumpall``; +- Install the new version of PostgreSQL; (make sure it's running on the same port, etc. so that no changes are needed in the Payara configuration) +- Re-import the database with ``psql``, as the postgres user. + +Consult the PostgreSQL upgrde documentation for more information, for example https://www.postgresql.org/docs/13/upgrading.html#UPGRADING-VIA-PGDUMPALL. diff --git a/doc/sphinx-guides/source/installation/prerequisites.rst b/doc/sphinx-guides/source/installation/prerequisites.rst index b1643fabf40..2606ad5fbb5 100644 --- a/doc/sphinx-guides/source/installation/prerequisites.rst +++ b/doc/sphinx-guides/source/installation/prerequisites.rst @@ -98,25 +98,16 @@ PostgreSQL Installing PostgreSQL ======================= -Version 9.6 is strongly recommended because it is the version developers and QA test with:: +The application has been tested with PostgreSQL versions up to 13. We recommend installing the latest version that is available for your OS distribution. *For example*, to install PostgreSQL 13 under RHEL/CentOS 7:: # yum install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm # yum makecache fast - # yum install -y postgresql96-server - # /usr/pgsql-9.6/bin/postgresql96-setup initdb - # /usr/bin/systemctl start postgresql-9.6 - # /usr/bin/systemctl enable postgresql-9.6 + # yum install -y postgresql13-server + # /usr/pgsql-13/bin/postgresql-13-setup initdb + # /usr/bin/systemctl start postgresql-13 + # /usr/bin/systemctl enable postgresql-13 -The above steps are specific to RHEL/CentOS 7. For RHEL/CentOS 8 you must install Postgres 10 or higher:: - - # yum install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm - # yum makecache fast - # yum install -y postgresql10-server - # /usr/pgsql-10/bin/postgresql-10-setup initdb - # systemctl start postgresql-10 - # systemctl enable postgresql-10 - -Note that the Dataverse Software installer includes its own Postgres JDBC driver. If you choose to install the newest version of Postgres (12 as of this writing), you may need to grab a current JDBC driver from https://jdbc.postgresql.org/download.html before launching the install script. +For RHEL/CentOS 8 the process would be identical, except for the very first command - you would need to install the "EL-8" yum repository configuration instead. Configuring Database Access for the Dataverse Installation (and the Dataverse Software Installer) ================================================================================================= @@ -152,7 +143,7 @@ Configuring Database Access for the Dataverse Installation (and the Dataverse So - **Important: PostgreSQL must be restarted** for the configuration changes to take effect! On RHEL/CentOS 7 and similar (provided you installed Postgres as instructed above):: - # systemctl restart postgresql-9.6 + # systemctl restart postgresql-13 On MacOS X a "Reload Configuration" icon is usually supplied in the PostgreSQL application folder. Or you could look up the process id of the PostgreSQL postmaster process, and send it the SIGHUP signal:: diff --git a/pom.xml b/pom.xml index de8ff91863a..790e0649d39 100644 --- a/pom.xml +++ b/pom.xml @@ -27,7 +27,7 @@ 8.0.0 5.2020.6 - 42.2.18 + 42.2.19 1.11.762 1.2 4.5.5 From f00b6378a1d995c29a3d6d01db1b909fd57644c3 Mon Sep 17 00:00:00 2001 From: Leonid Andreev Date: Thu, 4 Mar 2021 11:23:46 -0500 Subject: [PATCH 2/4] typo. (#7374) --- doc/release-notes/7374-postgresql-update | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/release-notes/7374-postgresql-update b/doc/release-notes/7374-postgresql-update index 332ffda0060..3ac74ad70a1 100644 --- a/doc/release-notes/7374-postgresql-update +++ b/doc/release-notes/7374-postgresql-update @@ -6,4 +6,4 @@ Up until this release our installation guide "strongly recommended" to install P - Install the new version of PostgreSQL; (make sure it's running on the same port, etc. so that no changes are needed in the Payara configuration) - Re-import the database with ``psql``, as the postgres user. -Consult the PostgreSQL upgrde documentation for more information, for example https://www.postgresql.org/docs/13/upgrading.html#UPGRADING-VIA-PGDUMPALL. +Consult the PostgreSQL upgrade documentation for more information, for example https://www.postgresql.org/docs/13/upgrading.html#UPGRADING-VIA-PGDUMPALL. From 0565ff90bb7c3912219caab3b2db98f5effe688e Mon Sep 17 00:00:00 2001 From: Leonid Andreev Date: Thu, 4 Mar 2021 12:49:38 -0500 Subject: [PATCH 3/4] similar changes for the dev. guide. (#7374) --- doc/sphinx-guides/source/developers/dev-environment.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/sphinx-guides/source/developers/dev-environment.rst b/doc/sphinx-guides/source/developers/dev-environment.rst index 63f482b86ee..e5cab7df0d1 100755 --- a/doc/sphinx-guides/source/developers/dev-environment.rst +++ b/doc/sphinx-guides/source/developers/dev-environment.rst @@ -94,9 +94,9 @@ To install Payara, run the following commands: Install PostgreSQL ~~~~~~~~~~~~~~~~~~ -PostgreSQL 9.6 is recommended to match the version in the Installation Guide. +For the past few release cycles much of the development has been done under PostgreSQL 9.6. While that version is known to be very stable, it is nearing its end-of-life (in Nov. 2021). The Dataverse Software has now been tested with versions up to 13 (13.2 is the latest released version as of writing this). -On Mac, go to https://www.postgresql.org/download/macosx/ and choose "Interactive installer by EDB" option. We've tested version 9.6.19. When prompted to set a password for the "database superuser (postgres)" just enter "password". +On Mac, go to https://www.postgresql.org/download/macosx/ and choose "Interactive installer by EDB" option. Note that version 9.6 is used in the command line examples below, but the process will be identical for any version up to 13. When prompted to set a password for the "database superuser (postgres)" just enter "password". After installation is complete, make a backup of the ``pg_hba.conf`` file like this: @@ -112,7 +112,7 @@ In the Finder, click "Applications" then "PostgreSQL 9.6" and launch the "Reload Next, to confirm the edit worked, launch the "pgAdmin" application from the same folder. Under "Browser", expand "Servers" and double click "PostgreSQL 9.6". When you are prompted for a password, leave it blank and click "OK". If you have successfully edited "pg_hba.conf", you can get in without a password. -On Linux, you should just install PostgreSQL from your package manager without worrying about the version as long as it's 9.x. Find ``pg_hba.conf`` and set the authentication method to "trust" and restart PostgreSQL. +On Linux, you should just install PostgreSQL using your favorite package manager, such as ``yum``. (Consult the PostgreSQL section of :doc:`/installation/prerequisites` in the main Installation guide for more info and command line examples). Find ``pg_hba.conf`` and set the authentication method to "trust" and restart PostgreSQL. Install Solr ~~~~~~~~~~~~ From 34453f533e2bc911f0532aa4b9f67e3bb7f6f05f Mon Sep 17 00:00:00 2001 From: Leonid Andreev Date: Thu, 4 Mar 2021 13:12:40 -0500 Subject: [PATCH 4/4] renamed the release note (#7374) --- .../{7374-postgresql-update => 7374-postgresql-update.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename doc/release-notes/{7374-postgresql-update => 7374-postgresql-update.md} (100%) diff --git a/doc/release-notes/7374-postgresql-update b/doc/release-notes/7374-postgresql-update.md similarity index 100% rename from doc/release-notes/7374-postgresql-update rename to doc/release-notes/7374-postgresql-update.md