Gap Analysis

Owned by Ingolf Kuss
Last updated: Jan 14, 2022 by Julian LadischVersion comment

We identified the following gaps in the existing documentation:


Pitfalls / Caveats / to be kept in mind

ReporterSummaryDate observedDescription

Ingolf Kuss

Ports have to be released on re-deployJune 2018

When I restart Okapi (for example in order to pull a current, stable version) I have to re-deploy the modules afterwards. But this didn't work at first try, because the ports 9131 - ... were still not free. Before I could re-deploy the modules, I had to restart the Docker service. This releases the ports.

Under SLES, it works like this

systemctl stop docker.service
#  this releases ports 9131 - ...
systemctl start docker.service
Multiple on SlackFOLIO requires md5 in pg_hba.conf2018, 2019, 2020, 2021, 2022

Installation fails with this error message:

Opening SQLConnection failed: com/ongres/scram/common/stringprep/StringPreparation
java.lang.NoClassDefFoundError: com/ongres/scram/common/stringprep/StringPreparation

Cause:

FOLIO doesn't support scram-sha-256 password authentication.

Solution:

Configure md5 password authentication in PostgreSQL's pg_hba.conf file.

Additional information:

https://www.postgresql.org/docs/current/auth-password.html

https://folio-org.atlassian.net/browse/FOLIO-2411 "Use SCRAM-SHA-256 for passwords on PostgreSQL server, drop MD5" and the sub-issues listed in the Issue Links section.