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:

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

   • 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

2. Dienst überprüfen:

   • Windows-Dienste öffnen (services.msc)

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

3. pgAdmin starten:

   • Programm "pgAdmin 4" starten

   • Browser öffnet sich automatisch

   • Master-Passwort für pgAdmin festlegen

   • Verbindung zu lokalem PostgreSQL Server herstellen:

     • Host: localhost

     • Port: 5432

     • Username: postgres

     • Passwort: <das bei der Installation gewählte Passwort>

Datenbank erstellen

1. Neue Datenbank anlegen:

   • In pgAdmin: Rechtsklick auf "Databases"

   • Klick auf "Create" → "Database..."

   • Datenbankname eingeben z.B.: GGUConnect-230627

   • Name ist beliebig wählbar

   • "Save" klicken

2. Datenbankschema installieren:

   • Rechtsklick auf die neu erstellte Datenbank

   • "Query Tool" auswählen

   • Es öffnet sich ein SQL-Editor

   • Dort den Inhalt des aktuellen PostgreSQL-Datenbank Scripts hineinkopieren

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

   • Auf "Execute/Refresh" (F5) drücken

   • → GGU-CONNECT Datenbankschema ist installiert

Externe Verbindungen aktivieren

1. PostgreSQL Konfiguration anpassen:

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

   • Datei postgresql.conf mit einem Texteditor öffnen

   • Zeile suchen: #listen_addresses = 'localhost'

   • Ändern zu: listen_addresses = '*'

   • Datei speichern

2. Client-Authentifizierung konfigurieren:

   • Datei pg_hba.conf im gleichen Verzeichnis öffnen

   • Am Ende der Datei folgende Zeile hinzufügen:

   CODE

   host    all             all             0.0.0.0/0               md5

   • Datei speichern

3. PostgreSQL-Dienst neu starten:

   • Windows-Dienste öffnen (services.msc)

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

   • Rechtsklick → "Neustart"

4. 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

   netsh advfirewall firewall add rule name="PostgreSQL" dir=in action=allow protocol=TCP localport=5432

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

   • Verbindung zu PostgreSQL Server herstellen

   • Rechtsklick auf die Datenbank

   • “Query Tool” auswählen

   • Den folgenden Schnipsel ausführen:

     SQL

     CREATE ROLE connect_contributor NOLOGIN;
     GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO connect_contributor;

     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:

   • Verbindung zu PostgreSQL Server herstellen

   • Rechtsklick auf "Login/Group Roles"

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

2. Allgemein-Tab:

   • Name: gguconnect_user (oder beliebiger Name)

3. Definition-Tab:

   • Passwort eingeben und bestätigen

4. Privilegien-Tab:

   • "Can login?" → Ja

   • "Superuser?" → Nein (aus Sicherheitsgründen)

   • "Create roles?" → Nein

   • "Create databases?" → Ja

   • "Inherit rights from parent roles?" → Ja

5. Nutzer die Rolle connect_contributor hinzufügen.

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

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

6. Berechtigung für die Datenbank:

   • Rechtsklick auf die Datenbank GGUConnect-230627

   • "Properties" → "Security"

   • "Add" klicken → User gguconnect_user auswählen

   • Privilegien setzen: ALL

7. 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:

   • Im Menü "Datenbank" → "Mit SQL-Datenbank verbinden"

   • 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

3. Verbindung testen:

   • 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\\