= pgAdmin4 einrichten =

[https://www.pgadmin.org/docs/pgadmin4/development/index.html 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 [#Screenshot Web-Oberfläche] sind nahezu alle Funktionen von !TransplantAct/AKI-Sentinel konfigurier- bzw. steuerbar.

{{{#!box note
 * 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 ==

[https://www.pgadmin.org/download/pgadmin-4-apt/ pgAdmin4-Debian-Repository] zur künftigen Nutzung registrieren:

Als '''root''' ausführen:
{{{
apt-get install curl gnupg2 -y
}}}

Datei [raw-attachment:pgdg.list 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 [https://www.pgadmin.org/static/packages_pgadmin_org.pub 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
}}}


{{{#!box warning
 * 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:[[BR]]'''''deb !https://ftp.postgresql.org/pub/pgadmin/pgadmin4/apt/buster pgadmin4 main'''''
   * Neu:[[BR]]'''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:[[BR]]'''apt update'''[[BR]]'''apt upgrade'''[[BR]]'''apt install pgadmin4-web'''

 * Bitte beachten Sie unbedingt die auf diesen Seiten zu findenden Sicherheitshinweise:
   * [https://manpages.debian.org/buster/apt/apt-secure.8.de.html Manpage zu APT-SECURE (Buster)]
   * [https://manpages.debian.org/buster/apt/sources.list.5.de.html 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

[[Image(transplantact_pgadmin4_001.png, border=1, link=)]]