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 führen Sie (sicherheitshalber) folgendes Kommando als root aus (der Vorgang nimmt mehrere Minuten in Anspruch):
  apt install —reinstall ca-certificates
  • Alternativ können Sie versuchsweise folgendes Kommando ausführen:

    curl -fsS http://www.pgadmin.org/static/packages_pgadmin_org.pub | gpg --dearmor -o /usr/share/keyrings/packages-pgadmin-org.gpg
    

• Sofern NTP nicht konfiguriert ist: prüfen Sie bitte die Systemzeit (​Korrektur durchführen, falls erforderlich), indem Sie als root folgendes Kommando ausführen:
  date

• 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 http://ftp.postgresql.org/pub/pgadmin/pgadmin4/apt/buster pgadmin4 main
    
    
    • Falls das Problem weiterhin auftritt, ersetzen Sie die einzige Zeile bitte durch diese Variante:
      deb [trusted=yes] http://ftp.postgresql.org/pub/pgadmin/pgadmin4/apt/buster pgadmin4 main

• Führen Sie anschließend die 3 obigen Kommandos erneut als root 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 stets 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.

Hinweis

• Wie kann die integrierte SQL-Funktionalität von pgAdmin4 genutzt werden?

---

Screenshot