Skip to content
Snippets Groups Projects

Changes

Page history
  • New page
  • Templates
    • Update zu ipv4 vs ipv6 authored by Michael Roth's avatar Michael Roth
    Hide whitespace changes
    Inline Side-by-side
    postgresql/Zentraler-PostgreSQL-Server.md
    View page @ ce62fca3
    # Zentraler PostgreSQL Server
    Der PostgreSQL-Server wird in verschiedenen Lehrveranstaltungen der [Fachgruppe Datenbanken](https://www.fbi.h-da.de/fachbereich/fachgruppen/datenbanken/) verwendet.
    ## Zugang
    Der offizielle Postgres-Server der Hochschule ist auch ausserhalb der Laborzeiten vom eigenen Rechner aus nutzbar. Der Server ist wie folgt erreichbar:
    Hostname: postgres.fbi.h-da.de
    IP-Adresse: 141.100.232.166
    Port: 5432 (Postgres-Standard)
    Von ausserhalb des Hochschulnetzes muss vorher eine [VPN-Verbindung](https://its.h-da.io/infra-docs/docs/vpn.html) aufgebaut werden.
    ## Einmalige Einrichtung der Datenbank im Self-Service
    Verbinden Sie sich mit SSH/[PuTTY](https://www.putty.org/), um die Datenbank automatisch über den Anmeldevorgang anzulegen.
    - PuTTY: Verwenden Sie ``postgres.fbi.h-da.de`` als Hostname und Port 22 (Voreinstellung). Sie werden dann nach dem Klick auf "Open" nach dem Benutzer gefragt, hier geben Sie ihren st-Zugang ein und dann das Passwort. Bestätigen Sie den Dialog zur Annahme des Server-Schlüssels mit "Ja", um zur Konsole zu gelangen.
    - Mit SSH geben Sie folgendes ein:
    ``ssh stbenutzer@postgres.fbi.h-da.de``.
    Sie können sich nach dem Verbindungsaufbau wieder vom System abmelden (``exit`` oder CTRL+D), da die Datenbank nun angelegt wurde.
    **Hinweis:** Da der Datenbankserver in der vorlesungsfreien Zeit zurück gesetzt wird, müssen Sie diese Einrichtung unter Umständen jedes Semester wiederholen.
    ## Hinweise zur Nutzung des PostgreSQL-Servers
    - Der PostgreSQL-Server ist unter der IP ``141.100.232.166`` oder dem Namen``postgres.fbi.h-da.de``, Port ``5432`` erreichbar.
    - Der PostgreSQL-Server ist so konfiguriert, dass Sie sich mit Ihrem Hochschul-Account (st...) anmelden können. Wenn Sie die Datenbank wie oben beschrieben über den Self-Service angelegt haben, existiert bereits eine gleichnamige Datenbank wie ihr st-Benutzer.
    - Sie können mit dem Server wie folgt arbeiten:
    - über das Administrationstool [pgAdmin](https://www.pgadmin.org/). Erstellen Sie in der linken Leiste mit einem Rechtsklick auf "Servers" Create > Server eine neue Verbindung zum Server. Geben Sie unter "General" einen beliebigen Namen für die Verbindung ein. Unter "Connection" geben Sie entweder Hostname oder die IP (siehe oben) ein. Tragen Sie unter "Maintenance DB" und "Username" ihren st-Benutzer oder den eigens erstellten Benutzer (siehe [Teams im Praktikum](https://code.fbi.h-da.de/lab-docs/db/wikis/postgresql/Teams-im-Praktikum)) ein, sowie das Passwort. Klicken Sie zum Abschluss auf "Save". Anschliessend öffnen Sie ihre neu angelegte Verbindung auf der linken Seite und suchen Sie aus dem Baum ihren Benutzer aus. Dort finden Sie dann Tabellen o.ä. Objekte.
    - über die PostgreSQL-Shell ``psql`` (nach Verbindung zum Server mit einem ssh-Client wie PuTTY o.ä.)
    - Unter Windows ist die Shell Bestandteil der pgAdmin Installation und die Datei ``psql.exe`` befindet sich im Installationsordner. Wichtig ist hierbei, die Datei nicht einfach doppelt anzuklicken, da es sich um ein Terminalprogramm handelt (Es erscheint kurz ein Fenster, welches sich gleich wieder schließt). Sinnvoll ist es, eine Verknüpfung zu erzeugen und dort die erforderlichen Parameter ``-h postgres.fbi.h-da.de -U stbenutzer -d datenbankname`` einzutragen.
    - Dokumentation zu PostgreSQL finden Sie hier: [PostgreSQL Dokumentation](https://www.postgresql.org/docs/current/static/index.html)
    ## FAQs & aktuelle Probleme
    ### Problem: Das Query Tool von pgAdmin öffnet sich nicht bzw. beim Öffnen erscheint eine Fehlermeldung
    **Lösung:**
    - Deaktivieren Sie zunächst die Verbindung (Rechtsklick auf die Verbindung->Disconnect Server)
    - Öffnen Sie die Einstellungen (Rechtsklick auf die Verbindung->Properties)
    - Im Reiter "Advanced" geben Sie bei "Host Address" ein: `141.100.232.166`
    - Klicken Sie _Save_ und stellen Sie die Verbindung wieder her
    ### Problem: Fehlermeldung im PGAdmin "pam-Authentifizierung fehlgeschlagen" oder "falsches Passwort" beim Verbindungsaufbau zur Datenbank
    - Dies kann auftreten, falls zuvor keine Datenbank per SSH-Anmeldung (Self-Service) angelegt wurde und gleich mit PGAdmin versucht wird, eine Verbindung aufzubauen. Trotz richtigem Passwort kommt keine Verbindung zustande, da noch keine Datenbank in PostgreSQL für diesen Benutzer existiert, folglich kann die Datenbank auf keinen Zugriff vergeben.
    **Lösung:**
    Es muss zuerst eine Verbindung per SSH/PuTTY zum Server mit dem betreffenden Benutzernamen aufgebaut werden, damit die Datenbank angelegt wird (siehe unten). Danach sollte die Verbindung im PGAdmin zustande kommen.
    ### Problem: Fehlermeldung im PGAdmin "Socket is not connected" beim Verbindungsaufbau zur Datenbank
    Nach dem Anlegen der Verbindung zum Server erscheint diese Fehlermeldung beim Öffnen des QueryTools oder beim arbeiten mit den eigenen Tabellen oder anderen Datenbank-Objekten.
    **Lösung:**
    In der Server-Verbindung muss statt dem Hostnamen die IP-Adresse des Servers (141.100.232.166) im Reiter "General" und "Advanced" eingetragen werden. PGAdmin versucht hier offensichtlich, sich mit IPv6 zu verbinden. Da dies der Server jedoch nicht unterstützt, muss durch Angabe der IP-Adresse die Verbindung als IPv4 aufgebaut werden, um zu funktionieren.
    # Zentraler PostgreSQL Server
    Der PostgreSQL-Server wird in verschiedenen Lehrveranstaltungen der [Fachgruppe Datenbanken](https://www.fbi.h-da.de/fachbereich/fachgruppen/datenbanken/) verwendet.
    ## Zugang
    Der offizielle Postgres-Server der Hochschule ist auch ausserhalb der Laborzeiten vom eigenen Rechner aus nutzbar. Der Server ist wie folgt erreichbar:
    Hostname: postgres.fbi.h-da.de
    IP-Adresse: 141.100.232.166
    Port: 5432 (Postgres-Standard)
    Von ausserhalb des Hochschulnetzes muss vorher eine [VPN-Verbindung](https://its.h-da.io/infra-docs/docs/vpn.html) aufgebaut werden.
    ## Einmalige Einrichtung der Datenbank im Self-Service
    Verbinden Sie sich mit SSH/[PuTTY](https://www.putty.org/), um die Datenbank automatisch über den Anmeldevorgang anzulegen.
    - PuTTY: Verwenden Sie ``postgres.fbi.h-da.de`` als Hostname und Port 22 (Voreinstellung). Sie werden dann nach dem Klick auf "Open" nach dem Benutzer gefragt, hier geben Sie ihren st-Zugang ein und dann das Passwort. Bestätigen Sie den Dialog zur Annahme des Server-Schlüssels mit "Ja", um zur Konsole zu gelangen.
    - Mit SSH geben Sie folgendes ein:
    ``ssh stbenutzer@postgres.fbi.h-da.de``.
    Sie können sich nach dem Verbindungsaufbau wieder vom System abmelden (``exit`` oder CTRL+D), da die Datenbank nun angelegt wurde.
    **Hinweis:** Da der Datenbankserver in der vorlesungsfreien Zeit zurück gesetzt wird, müssen Sie diese Einrichtung unter Umständen jedes Semester wiederholen.
    ## Hinweise zur Nutzung des PostgreSQL-Servers
    - Der PostgreSQL-Server ist unter der IP ``141.100.232.166`` oder dem Namen``postgres.fbi.h-da.de``, Port ``5432`` erreichbar.
    - Der PostgreSQL-Server ist so konfiguriert, dass Sie sich mit Ihrem Hochschul-Account (st...) anmelden können. Wenn Sie die Datenbank wie oben beschrieben über den Self-Service angelegt haben, existiert bereits eine gleichnamige Datenbank wie ihr st-Benutzer.
    - Sie können mit dem Server wie folgt arbeiten:
    - über das Administrationstool [pgAdmin](https://www.pgadmin.org/). Erstellen Sie in der linken Leiste mit einem Rechtsklick auf "Servers" Create > Server eine neue Verbindung zum Server. Geben Sie unter "General" einen beliebigen Namen für die Verbindung ein. Unter "Connection" geben Sie entweder Hostname oder die IP (siehe oben) ein. Tragen Sie unter "Maintenance DB" und "Username" ihren st-Benutzer oder den eigens erstellten Benutzer (siehe [Teams im Praktikum](https://code.fbi.h-da.de/lab-docs/db/wikis/postgresql/Teams-im-Praktikum)) ein, sowie das Passwort. Klicken Sie zum Abschluss auf "Save". Anschliessend öffnen Sie ihre neu angelegte Verbindung auf der linken Seite und suchen Sie aus dem Baum ihren Benutzer aus. Dort finden Sie dann Tabellen o.ä. Objekte.
    - über die PostgreSQL-Shell ``psql`` (nach Verbindung zum Server mit einem ssh-Client wie PuTTY o.ä.)
    - Unter Windows ist die Shell Bestandteil der pgAdmin Installation und die Datei ``psql.exe`` befindet sich im Installationsordner. Wichtig ist hierbei, die Datei nicht einfach doppelt anzuklicken, da es sich um ein Terminalprogramm handelt (Es erscheint kurz ein Fenster, welches sich gleich wieder schließt). Sinnvoll ist es, eine Verknüpfung zu erzeugen und dort die erforderlichen Parameter ``-h postgres.fbi.h-da.de -U stbenutzer -d datenbankname`` einzutragen.
    - Dokumentation zu PostgreSQL finden Sie hier: [PostgreSQL Dokumentation](https://www.postgresql.org/docs/current/static/index.html)
    ## FAQs & aktuelle Probleme
    ### Problem: Das Query Tool von pgAdmin öffnet sich nicht bzw. beim Öffnen erscheint eine Fehlermeldung
    **Lösung:**
    - Deaktivieren Sie zunächst die Verbindung (Rechtsklick auf die Verbindung->Disconnect Server)
    - Öffnen Sie die Einstellungen (Rechtsklick auf die Verbindung->Properties)
    - Im Reiter "Advanced" geben Sie bei "Host Address" ein: `141.100.232.166`
    - Klicken Sie _Save_ und stellen Sie die Verbindung wieder her
    ### Problem: Fehlermeldung im PGAdmin "pam-Authentifizierung fehlgeschlagen" oder "falsches Passwort" beim Verbindungsaufbau zur Datenbank
    - Dies kann auftreten, falls zuvor keine Datenbank per SSH-Anmeldung (Self-Service) angelegt wurde und gleich mit PGAdmin versucht wird, eine Verbindung aufzubauen. Trotz richtigem Passwort kommt keine Verbindung zustande, da noch keine Datenbank in PostgreSQL für diesen Benutzer existiert, folglich kann die Datenbank auf keinen Zugriff vergeben.
    **Lösung:**
    Es muss zuerst eine Verbindung per SSH/PuTTY zum Server mit dem betreffenden Benutzernamen aufgebaut werden, damit die Datenbank angelegt wird (siehe unten). Danach sollte die Verbindung im PGAdmin zustande kommen.
    ### Problem: Die Verbindung über ssh/psql/PGAdmin "stockt"
    **Lösung:**
    Verwenden Sie ausschließlich die IPv4 Adresse bzw. konfigurieren Sie den Client so, dass dieser IPv4 gegenüber IPv6 bevorzugt. Dies ist ein aktuell bekanntes Problem im Netz der h-da.