Merge pull request #7651 from IQSS/7374-postgresql-update

7374 postgresql update

doc/release-notes/7374-postgresql-update.md

@@ -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 upgrade documentation for more information, for example https://www.postgresql.org/docs/13/upgrading.html#UPGRADING-VIA-PGDUMPALL. 

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
 ~~~~~~~~~~~~

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::
 

pom.xml

@@ -27,7 +27,7 @@
 
         <jakartaee-api.version>8.0.0</jakartaee-api.version>
         <payara.version>5.2020.6</payara.version>
-        <postgresql.version>42.2.18</postgresql.version>
+        <postgresql.version>42.2.19</postgresql.version>
         <aws.version>1.11.762</aws.version>
         <commons.logging.version>1.2</commons.logging.version>
         <httpcomponents.client.version>4.5.5</httpcomponents.client.version>