Skip to content

GGU-CONNECT - PostgreSQL Instanz unter Windows lokal bzw. im eigenen Netzwerk (kostenlos)

Die Persistenz per PostgreSQL ist aktuell noch im Modus: Experimentell.

Download

Download folgender Software:

  • PostgreSQL → Version 15 oder höher (kostenlos)

  • pgAdmin (kostenlos) - Grafische Administrationsoberfläche für PostgreSQL

Installation

  1. PostgreSQL Installation:

  2. postgresql-xx.x-x-windows-x64.exe → Standard-Installation durchführen

  3. Während der Installation:

    • Superuser-Passwort festlegen (z.B. für User postgres)

    • Port: Standard-Port 5432 beibehalten

    • Locale: German, Germany oder Default locale

    • Installation abschließen
    • Dienst überprüfen:

  4. Windows-Dienste öffnen (services.msc)

  5. Prüfen, ob der Dienst postgresql-x64-15 (oder entsprechende Version) läuft

  6. pgAdmin starten:

  7. Programm "pgAdmin 4" starten

  8. Browser öffnet sich automatisch

  9. Master-Passwort für pgAdmin festlegen

  10. Verbindung zu lokalem PostgreSQL Server herstellen:

    • Host: localhost

    • Port: 5432

    • Username: postgres

    • Passwort:

Datenbank erstellen

  1. Neue Datenbank anlegen:

  2. In pgAdmin: Rechtsklick auf "Databases"

  3. Klick auf "Create" → "Database..."

  4. Datenbankname eingeben z.B.: GGUConnect-230627

  5. Name ist beliebig wählbar

  6. "Save" klicken

  7. Datenbankschema installieren:

  8. Rechtsklick auf die neu erstellte Datenbank

  9. "Query Tool" auswählen

  10. Es öffnet sich ein SQL-Editor

  11. Dort den Inhalt des aktuellen PostgreSQL-Datenbank Scripts hineinkopieren

  12. Für die Zusendung des SQL Scripts bitte anfragen unter support@ggu-software.com

  13. Auf "Execute/Refresh" (F5) drücken

  14. → GGU-CONNECT Datenbankschema ist installiert

Externe Verbindungen aktivieren

  1. PostgreSQL Konfiguration anpassen:

  2. PostgreSQL Installationsverzeichnis öffnen (meist C:\\Program Files\\PostgreSQL\\15\\data\\)

  3. Datei postgresql.conf mit einem Texteditor öffnen

  4. Zeile suchen: #listen_addresses = 'localhost'

  5. Ändern zu: listen_addresses = '*'

  6. Datei speichern

  7. Client-Authentifizierung konfigurieren:

  8. Datei pg_hba.conf im gleichen Verzeichnis öffnen

  9. Am Ende der Datei folgende Zeile hinzufügen:

CODE

Copy

  • Datei speichern

  • PostgreSQL-Dienst neu starten:

  • Windows-Dienste öffnen (services.msc)

  • Dienst postgresql-x64-15 (oder entsprechende Version) auswählen

  • Rechtsklick → "Neustart"

  • Windows Firewall konfigurieren:

  • Programm "Windows Defender Firewall" öffnen

  • "Erweiterte Einstellungen" → "Eingehende Regeln"

  • "Neue Regel..." → "Port" → "TCP" → "Bestimmte lokale Ports: 5432"

  • "Verbindung zulassen" → Regel benennen (z.B. "PostgreSQL")

Oder per Kommandozeile:

CMD

Copy

Nutzerrolle anlegen

Um die Verwaltung von Nutzern in Connect zu vereinfachen, sollte die Gruppe connect_contributor angelegt werden.

Im Normalfall wird die Gruppe bei der Initialisierung der Datenbank über das Initialisierungsskript bereits erstellt worden sein. Wenn dies bei Ihnen nicht der Fall ist, folgen Sie bitte der folgenden Anleitung:

Die Rolle ist Datenbank spezifisch und gilt somit nur für die von Ihnen gewählte Datenbank.

  1. In pgAdmin

  2. Verbindung zu PostgreSQL Server herstellen

  3. Rechtsklick auf die Datenbank

  4. “Query Tool” auswählen

  5. Den folgenden Schnipsel ausführen:

    SQL

    ```sql

    ```

    Copy

    Jeder Nutzer der Gruppe connect_contributor ist jetzt berechtigt, in der Datenbank Daten zu lesen, zu erstellen, zu aktualisieren und zu löschen.

User anlegen

  1. In pgAdmin:

  2. Verbindung zu PostgreSQL Server herstellen

  3. Rechtsklick auf "Login/Group Roles"

  4. "Create" → "Login/Group Role..."

  5. Allgemein-Tab:

  6. Name: gguconnect_user (oder beliebiger Name)

  7. Definition-Tab:

  8. Passwort eingeben und bestätigen

  9. Privilegien-Tab:

  10. "Can login?" → Ja

  11. "Superuser?" → Nein (aus Sicherheitsgründen)

  12. "Create roles?" → Nein

  13. "Create databases?" → Ja

  14. "Inherit rights from parent roles?" → Ja

  15. Nutzer die Rolle connect_contributor hinzufügen.

  16. Wenn die Rolle noch nicht erstellt ist, folgen Sie hier der Anleitung.

  17. In Reiter Membershipwechseln und bei Member of einen neuen Eintrag mit connect_contributor hinzufügen.

  18. Berechtigung für die Datenbank:

  19. Rechtsklick auf die Datenbank GGUConnect-230627

  20. "Properties" → "Security"

  21. "Add" klicken → User gguconnect_user auswählen

  22. Privilegien setzen: ALL

  23. Speichern

→ User für den Datenbank-Zugriff via GGU-CONNECT ist eingerichtet und berechtigt.

Via GGU-CONNECT verbinden

  1. GGU-CONNECT starten

  2. Datenbankverbindung einrichten:

  3. Im Menü "Datenbank" → "Mit SQL-Datenbank verbinden"

  4. Verbindungsinformationen wie folgt hinterlegen:

    • Name:<beliebig>

    • Datenbanktyp:PostgreSQL

    • URL:localhost (wenn DB lokal läuft) oder IP-Adresse/Host-Name des Rechners

    • Port:5432

    • Username:gguconnect_user (oder wie oben gewählt)

    • Passwort:<wie oben gewählt>

    • Datenbank:GGUConnect-230627

    • Verbindung testen:

  5. Klick auf "Verbinden" (Icon mit Wolke und +)

→ GGU-CONNECT ist einsatzbereit mit der PostgreSQL-Datenbank

Zusätzliche Hinweise

  • Backup erstellen: In pgAdmin Rechtsklick auf Datenbank → "Backup..." → Format "Custom" wählen

  • Backup wiederherstellen: Rechtsklick auf Databases → "Restore..." → Backup-Datei auswählen

  • Monitoring: pgAdmin bietet umfangreiche Monitoring-Tools unter dem Dashboard

  • Logs: PostgreSQL-Logs finden sich im Verzeichnis C:\\Program Files\\PostgreSQL\\15\\data\\log\\