pgAdmin4 einrichten

​pgAdmin4 ist ein sehr mächtiges, grafisches Werkzeug, mit dessen Hilfe die PostgreSQL-Datenbank des Systems administriert und deren Inhalte bearbeitet werden können; über die Web-Oberfläche sind nahezu alle Funktionen von TransplantAct/AKI-Sentinel konfigurier- bzw. steuerbar.

• Alle ab dem 01.01.2023 eingerichteten TransplantAct/AKI-Sentinel-Instanzen verfügen bereits über pgAdmin4; die Web-Oberfläche ist jeweils über…

  http:/mein-transplantact-server/pgadmin4
  

  …erreichbar (bitte ersetzen Sie mein-transplantact-server durch die Adresse oder den Namen Ihres Servers).

---

Installation und Konfiguration

​pgAdmin4-Debian-Repository zur künftigen Nutzung registrieren:

Als root ausführen:

apt-get install curl gnupg2 -y

Datei pgdg.list herunterladen und im Verzeichnis…

/etc/apt/sources.list.d/

…platzieren.

Relevant ist folgende Zeile (in der heruntergeladenen Datei bereits enthalten):

deb https://ftp.postgresql.org/pub/pgadmin/pgadmin4/apt/buster pgadmin4 main

Datei ​packages_pgadmin_org.pub herunterladen und im Verzeichnis…

/tmp/

…der virtuellen Maschine platzieren.

Als root ausführen:

apt-key add /tmp/packages_pgadmin_org.pub

apt update

apt upgrade

apt install pgadmin4-web

• Abhängig von der Struktur des Zertfikate-Managements können bei der Ausführung der vorangehenden Schritte folgende Probleme gemeldet werden:
  • Certificate verification failed: The certificate is NOT trusted. The certificate issuer is unknown. Could not handshake: Error in the certificate verification. […] Updating from such a repository can't be done securely, and is therefore disabled by default.

• Bitte modifizieren Sie in der zuvor hinterlegten Datei /etc/apt/sources.list.d/pgdg.list die einzige Zeile wie folgt:
  • Alt:
    deb https://ftp.postgresql.org/pub/pgadmin/pgadmin4/apt/buster pgadmin4 main
  • Neu:
    deb [trusted=yes] https://ftp.postgresql.org/pub/pgadmin/pgadmin4/apt/buster pgadmin4 main

• Führen Sie anschließend die 3 obigen Kommandos erneut aus:
  apt update
  apt upgrade
  apt install pgadmin4-web

• Bitte beachten Sie unbedingt die auf diesen Seiten zu findenden Sicherheitshinweise:
  • ​Manpage zu APT-SECURE (Buster)
  • ​Manpage zu sources.list (Buster)

• Ein Anpassung des Zertifikate-Managements ist - falls möglich - vorzuziehen!

Als root folgendes Kommando ausführen…

/usr/pgadmin4/bin/setup-web.sh

…und im Verlauf der Installation (sobald die entsprechenden Fragen gestellt werden) folgendes Benutzerkonto (mit einem Passwort Ihrer Wahl) anlegen:

admin@transplantact-local.org

Datei config.py im Verzeichnis…

/usr/pgadmin4/web

…editieren:

In Zeile 138 die Adresse für DEFAULT_SERVER von <127.0.0.1> zu <0.0.0.0> ändern.

Die pgAdmin4-Web-Oberfläche ist nun über

http:/mein-transplantact-server/pgadmin4

…erreichbar (bitte ersetzen Sie mein-transplantact-server durch die Adresse oder den Namen Ihres Servers).

Nach der Anmeldung mit den zuvor definierten Zugangsdaten des Kontos <admin@transplantact-local.org> müssen Sie noch in einem weiteren Schritt die zu einem früheren Zeitpunkt übermittelten Zugangsdaten des PostgreSQL-Benutzerkontos <transplantact> verwenden, um Ihren Server registrieren und administrieren zu können.

---

Screenshot