Gap Analysis
We identified the following gaps in the existing documentation:
Pitfalls / Caveats / to be kept in mind
| Reporter | Summary | Date observed | Description |
|---|---|---|---|
| Ports have to be released on re-deploy | June 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 Slack | FOLIO requires md5 in pg_hba.conf | 2018, 2019, 2020, 2021, 2022 | Installation fails with this error message: Opening SQLConnection failed: com/ongres/scram/common/stringprep/StringPreparation Cause: FOLIO doesn't support scram-sha-256 password authentication. Solution: Configure 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. |