Wie installiere ich pgAdmin 4 v5, das PostgreSQL Administrationstool unter Debian 11
pgAdmin ist ein kostenloses und einfach zu bedienendes grafisches Verwaltungstool für PostgreSQL, das Open-Source ist. Es unterstützt PostgreSQL 9.6 und höher und kann auf mehreren Betriebssystemen ausgeführt werden, darunter Windows, macOS und Linux.
Im Gegensatz zu anderen grafischen Datenbankverwaltungstools kann pgAdmin in 3 verschiedenen Modi ausgeführt werden:
- Desktop-Modus – kann als Benutzeranwendung auf deinem Laptop und Computer installiert werden. Diese Methode wird empfohlen, wenn du pgAdmin auf deinem Laptop oder Computer installieren möchtest.
- Servermodus – diese Art der Bereitstellung kann auf dem Server angewendet werden. Es ist wie phpMyAdmin auf MySQL.
- Container-Modus – kann als Docker-Container ausgeführt werden.
In diesem Tutorial erfährst du, wie du pgAdmin im Servermodus auf dem neuesten Debian 11 Bullseye installierst. Du erfährst, wie du pgAdmin mit dem Apache-Webserver einrichtest und lernst die grundlegende Verwendung von pgAdmin für die Verwaltung der PostgreSQL-Datenbank und der Benutzer kennen.
Voraussetzungen
- Ein Debian 11 Server. Stelle sicher, dass alle Pakete auf die neueste Version aktualisiert sind.
- Ein Root-Benutzer oder ein Benutzer mit Root-Rechten. Dieser Benutzer wird für die Installation neuer Pakete und die Bearbeitung der Systemkonfigurationen verwendet.
- PostgreSQL-Datenbankserver – oder du kannst ihn mit Hilfe der folgenden Anleitung installieren.
Bevor du mit dieser Anleitung beginnst, führe den Befehl’sudo‚ oder’su‚ aus, um die Root-Rechte zu erhalten.
# Type password for your user sudo su
# Type your root password
su
Installation von PostgreSQL
Wenn du den PostgreSQL-Server bereits installiert hast, überspringe diesen ersten Schritt und fahre fort. Andernfalls kannst du PostgreSQL mit Hilfe der folgenden Anleitung installieren.
1. Um den PostgreSQL-Server auf dem Debian-Server zu installieren, führe den folgenden apt-Befehl aus.
apt install postgresql
Gib„y“ ein und drücke„Enter„, um die Installation von PostgreSQL fortzusetzen.
2. Wenn die Installation abgeschlossen ist, überprüfe den PostgreSQL-Dienst, indem du die folgenden Befehle ausführst.
systemctl is-enabled postgresql systemctl status postgresql
Du wirst eine ähnliche Ausgabe wie unten sehen.
Wie auf dem Screenshot zu sehen ist, ist PostgreSQL„aktiviert„, d.h. es wird beim Systemstart automatisch ausgeführt. Der aktuelle Status von PostgreSQL ist„active (exited)„, d.h. der Dienst läuft, aber systemd kann den PostgreSQL-Daemon nicht finden und überwachen.
3. Als Nächstes richtest du das Passwort für den Standard-Datenbankbenutzer „postgres“ ein.
Melde dich mit dem unten stehenden Befehl in der PostgreSQL-Shell an.
sudo -u postgres psql
Erstelle ein neues Passwort für den Datenbankbenutzer„postgres„, indem du die unten stehende Abfrage ausführst. Achte darauf, dass du das„strongpostgrespassword“ durch dein Passwort ersetzt.
ALTER USER postgres WITH PASSWORD 'strongpostgrespassword';
Gib nun„\q“ ein oder drücke„Strg+d„, um die PostgreSQL-Shell zu verlassen.
## Hinzufügen des pgAdmin4 Repository zu Debian 11
pgAdmin bietet ein Repository für seine Installation für verschiedene Linux-Betriebssysteme an, darunter Debian und RHEL. In diesem Schritt fügst du ein neues Repository für pgAdmin auf dem Debian 11 System hinzu.
1. Installiere zunächst das Paket gnupg2 mit dem unten stehenden apt-Befehl.
apt install gnupg gnupg2
2. Führe anschließend den folgenden Befehl aus, um das pgAdmin-Repository für das Debian-System hinzuzufügen.
echo "deb https://ftp.postgresql.org/pub/pgadmin/pgadmin4/apt/$(lsb_release -cs) pgadmin4 main"\ | sudo tee /etc/apt/sources.list.d/pgadmin4.list
3. Füge den gpg-Schlüssel des pgAdmin-Repositorys mit dem folgenden Befehl hinzu.
curl https://www.pgadmin.org/static/packages_pgadmin_org.pub | sudo apt-key add
4. Aktualisiere alle Repositories mit dem folgenden Befehl
sudo apt update
Jetzt kannst du pgAdmin auf dem Debian-System installieren.
Installieren und Konfigurieren von pgAdmin4 unter Debian 11
1. Um pgAdmin im Servermodus zu installieren, installiere das Paket „pgadmin4-web“ mit dem unten stehenden apt-Befehl.
apt install pgadmin4-web
Gib„y“ ein und drücke„Enter„, um die Installation fortzusetzen.
2. Wenn die Installation abgeschlossen ist, führe den folgenden Befehl aus, um das pgAdmin4-Benutzerkonto und die Konfiguration des virtuellen Apache-Hosts zu konfigurieren.
/usr/pgadmin4/bin/setup-web.sh
Gib die E-Mail-Adresse und das Passwort des Benutzers ein, um einen neuen pgAdmin-Benutzer anzulegen, und drücke dann„Enter„.
Danach wirst du gefragt, ob du den Apache-Webserver konfigurieren möchtest, gib„y“ ein und drücke„Enter„.
Gib nun erneut „y“ ein und drücke „Enter“, um den Apache-Dienst neu zu starten und die neue Konfiguration anzuwenden.
Jetzt ist die pgAdmin-Installation unter dem URL-Pfad‚/pgadmin4‚ erreichbar.
Zusätzliche Informationen:
Das Installationsskript„setup-web.sh“ erstellt und aktiviert automatisch die Apache-Konfiguration im Verzeichnis„/etc/apache2/conf-enabled„. Das kannst du mit dem folgenden Befehl überprüfen.
cd /etc/apache2/conf-enabled/ cat pgadmin4.conf
Nachfolgend siehst du die Konfiguration, die du sehen wirst.
Überprüfe die pgAdmin-Installation
1. Öffne deinen Webbrowser und gib die IP-Adresse des Servers oder den Domänennamen ein, gefolgt von dem Pfad „/pgadmin4“, wie unten gezeigt.
2. Wenn die Installation erfolgreich war, wird die Anmeldeseite von pgadmin4 angezeigt (siehe unten).
Gib deinen Login-Benutzer und deine E-Mail-Adresse ein und klicke auf die Schaltfläche„Login„.
Nun siehst du das pgadmin4 Dashboard wie unten abgebildet.
Verbindung zum PostgreSQL Server mit pgAdmin4
Nachdem du dich in das pgAdmin-Dashboard eingeloggt hast, fügst du eine neue Verbindung zu deinem PostgreSQL-Server hinzu.
1. Klicke im pgAdmin-Dashboard auf das Symbol „Add New Server„.
2. Es öffnet sich ein kleines Fenster.
Auf der Registerkarte„Allgemein“ gibst du einen neuen„Namen“ für deine Verbindung ein.
In diesem Leitfaden geben wir der neuen Verbindung den Namen„local„.
3. Wechsle zur Registerkarte„Verbindung“ und gib deinen PostgreSQL-Host, die Datenbank, den Benutzer und das Passwort ein.
In diesem Beispiel verwenden wir den lokalen PostgreSQL-Server mit dem Benutzer„postgres„, um eine Standarddatenbank„postgres“ zu verwalten.
Klicke anschließend auf die Schaltfläche„Speichern„, um eine neue Verbindung zu speichern.
4. Wenn deine Verbindung erfolgreich ist, siehst du eine ähnliche Seite wie unten. Andernfalls siehst du eine Fehlermeldung.
Wie du unten im Screenshot sehen kannst, ist der Benutzer„postgres“ mit der Anwendung„pgAdmin4“ mit der Datenbank„postgres“ verbunden und der Status der Verbindung ist„aktiv„.
Grundlegende Verwendung pgAdmin4: Neuen Benutzer anlegen
In diesem Schritt legst du mit dem Tool pgAdmin4 einen neuen PostgreSQL-Benutzer an.
1. Klicke mit der rechten Maustaste auf den Verbindungsnamen im Menü„local => Create => Login/Group Role…„.
2. Auf der Registerkarte„Allgemein“ gibst du den neuen Benutzer ein, den du erstellen möchtest. In diesem Beispiel wirst du einen neuen Benutzer„alice“ erstellen.
3. Gehe zur Registerkarte„Definition“ und gib das Passwort für deinen Benutzer ein.
4. Gehe zur Registerkarte„Berechtigungen“ und aktiviere einige Berechtigungen, die du brauchst.
Klicke jetzt auf die Schaltfläche„Speichern„.
5. Um deinen neuen Benutzer zu überprüfen, klicke auf das Menü„Login/Gruppenrollen“ auf der linken Seite und dann auf die soeben erstellte„alice„.
Klicke auf der Seite auf die Registerkarte„Eigenschaften“ und du erhältst die Details des Benutzers wie auf dem oberen Screenshot.
Grundlegende Verwendung von pgAdmin4: Neue Datenbank erstellen
In diesem Schritt erstellst du eine neue Datenbank über das pgAdmin-Dashboard.
1. Klicke mit der rechten Maustaste auf den Verbindungsnamen im Menü„local => Create => Database…„.
2. Auf der Registerkarte„Allgemein“ gibst du den Namen deiner neuen Datenbank ein und wählst den Benutzer, dem sie gehört. In diesem Beispiel erstellst du eine neue Datenbank„alicedb“ und wählst den Benutzer„alice“ als Besitzer.
Klicke jetzt auf die Schaltfläche„Speichern„.
3. Um deine neue Datenbank zu überprüfen, klicke links im Menü auf„Datenbanken“ und dann auf die Datenbank„alicedb„, die du gerade erstellt hast.
Klicke auf der Seite auf die Registerkarte„Eigenschaften“ und du erhältst die Details der Datenbank„alicedb“ wie auf dem oberen Screenshot.
Überprüfe die Benutzerverbindung
Nachdem du im pgAdmin4 einen neuen Benutzer und eine neue Datenbank angelegt hast, erstellst du im pgAdmin4 eine neue PostgreSQL-Verbindung mit dem Benutzer„alice“ und der Datenbank„alicedb„.
1. Gehe zurück zum pgAdmin4 Dashboard und klicke auf das Symbol„Neuen Server hinzufügen„.
2. Auf der Registerkarte„Allgemein“ gibst du den neuen Verbindungsnamen„alice-connection“ ein (siehe unten).
3. Wechsle zur Registerkarte„Verbindung“ und gib die Details der neuen Verbindung ein. Der Host ist„127.0.0.1“ mit dem Benutzer„alice„, der die Datenbank„alicedb“ verwaltet, und vergiss nicht, das Passwort für den Benutzer„alice“ einzugeben.
Klicke jetzt auf die Schaltfläche„Speichern„.
4. Wenn deine Datenbank-Anmeldedaten korrekt sind, siehst du eine ähnliche Seite wie unten.
Wie du unten im Screenshot sehen kannst, ist der Benutzer„alice“ mit der Anwendung„pgAdmin4“ mit der Datenbank„alicedb“ verbunden und der Status der Verbindung ist„aktiv„.
Fazit
Herzlichen Glückwunsch! Jetzt hast du das pgAdmin4 Administrationstool für PostgreSQL erfolgreich auf Debian 11 Bullseye installiert. Außerdem hast du gelernt, wie du eine neue PostgreSQL-Verbindung mit pgAdmin4 erstellst. Und die grundlegende Verwendung von pgAdmin4 zum Anlegen einer neuen Datenbank und eines neuen Benutzers. Im nächsten Schritt kannst du deine PostgreSQL-Serververbindung hinzufügen und deine Datenbank über das pgAdmin4 Dashboard verwalten.