Amtliche Schulverwaltung - Dokumentation - alle:technik:postgresql

Aktualisierung der PostgreSQL-Installation

anonymous@undisclosed.example.com (Anonymous) — Thu, 26 Jun 2025 08:14:15 +0000

Aktualisierung der PostgreSQL-Installation

Die Doku zur PostgreSQL-Aktualisierung teilt sich in zwei Bereiche auf:

Update zu neuer Major-Version (= diese Seite) (z. B. PSQL13 auf PSQL15)
Update zu neuer Minor-Version (z. B. PSQL14.1 auf PSQL 14.2)

Diese Anleitung beschränkt sich auf Windows-Installationen und ist so aufgebaut, dass sie an Schulen einfach und schnell durchgeführt werden kann. Natürlich steht es jedem versierten Systemadministrator frei, eine der anderen Möglichkeiten zu nutzen.

1. Sicherung der Daten
1.1 Sicherung der PostgreSQL-Datenbank mit pgAdmin
1.2 Sicherung der lokalen Konfigurationsdateien (asv.params.local.cfg; configuration/config.local.ini)

2. Vorbereitung der Neuinstallation
2.1 Download des Voll-Installers aus dem Download-Bereich
2.2 Download einer aktuellen PostgreSQL- Version (14, 15, 16 oder - ab ASV 25.2 - 17)
2.3 Zertifikat und Installations-PIN bereithalten
2.4 Deinstallation von PostgreSQL-Server und ASV-Server

3. Neuinstallation
3.1 Installation des PostgreSQL-Servers
3.2 Installation des ASV-Servers
3.3 Rücksichern der Datenbank

Postgres manuell als Dienst unter Windows installieren

anonymous@undisclosed.example.com (Anonymous) — Tue, 20 Jun 2023 15:54:42 +0000

Postgres manuell als Dienst unter Windows installieren

Bitte verwenden Sie die folgende Anleitung nur als versierter Anwender!

Installation der Datenbank

1. Download der postgres-binaries unter pgbindownload.do

Im Folgenden wird davon ausgegangen, dass die Binaries nach c:\programme\pgsql kopiert worden sind.

2. Ins Unterverzeichnis c:\programme\pgsql \bin wechseln, dann aufrufen:

initdb –D C:\programme\pgsql\data

Nur zum Test: Jetzt sollte man den postgres-Server mit

pg_ctl –D C:\Programme\pgsql\data –l logfile.txt start

starten können (Abbruch mit <Strg> c ).

Registrierung als Windows-Dienst:

1. Den Windows-user postgres anlegen (statt „passwort“ natürlich ein vernünftiges Passwort setzen!):

net user postgres passwort

2. Anmelden in Windows als user postgres, dann Aufruf von c:\programme\pgsql\bin\pgsql

3. Es erscheint der SQL-Prompt der Datenbank. Dort eingeben:

alter user postgres with password  ‘dbpasswort‘;

Statt „dbpasswort“ natürlich wieder ein vernünftiges Passwort setzen. Das Passwort wird bei der Installation des DSS benötigt.

Mit \q kann man den Datenbank-Prompt wieder verlassen.

4. Dem Windows-User postgres Vollzugriff auf c:\programme\pgsql und alle Unterverzeichnisse geben.

5. Dem Windows-User postgres das Recht geben, Dienste zu starten: Einstellungen → Verwaltung → Lokale Sicherheitsrichtlinie → Lokale Richtlinien → Zuweisen von Benutzerrechten Dann in der rechten Spalte Rechtsklick auf „Als Dienst anmelden“, Eigenschaften Jetzt mit „Benutzer oder Gruppe hinzufügen“ postgres in die Liste aufnehmen.

6. Einloggen als Windows-Administrator, dann Registrieren des Windows-Service mittels

C:\programme\psql\bin pg_ctl register –N postgresService –U postgres –P passwort –D c:\Programme\pgsql\data

Fertig!

Deinstallation:

1. Registrierung des Dienstes löschen:

Anmelden als Windows-Administrator, dann ausführen:

C:\programme\psql\bin pg_ctl register –N postgresService

2. Löschen von C:\programme\psql und allen Unterverzeichnissen. Vorsicht: Damit werden auch alle Daten in der Datenbank gelöscht (Unterverzeichnis data)!

3. Entfernen des Windows-Benutzers postgres:

net user postgres /delete

(M. Pabst, Januar 2010)

Umstellung des PostgreSQL-Datenbanksystems von MD5- auf SCRAM-SHA-256-Authentifizierung

anonymous@undisclosed.example.com (Anonymous) — Tue, 05 Nov 2024 16:10:11 +0000

Umstellung des PostgreSQL-Datenbanksystems von MD5- auf SCRAM-SHA-256-Authentifizierung

Vom ASV-Team wird kein Support für den PostgreSQL-Datenbankserver geleistet. Dennoch stellen wir Ihnen im Folgenden eine Vorgehensbeschreibung für die Umstellung von MD5 auf SCRAM-SHA-256 zur Verfügung.

Von ASV-Seite sind keinerlei Konfigurationsänderungen erforderlich.

Für die hier beschriebenen Konfigurationsarbeiten ist es nicht erforderlich, den DSS zu stoppen oder die Arbeit mit ASV zu unterbrechen. Die Schritte können im laufenden Betrieb vollzogen werden.

Begründung der Notwendigkeit und technischer Hintergrund

Das bislang landläufig im Einsatz befindliche MD5-Verfahren, um die Benutzerpasswörter des PostgreSQL-Datenbankservers verschlüsselt zu speichern, weist Schwachstellen auf und muss daher im produktiven Einsatz durch SCRAM-SHA-256 abgelöst werden:

https://www.bsi.bund.de/SharedDocs/Downloads/DE/BSI/Grundschutz/Download/IT-GS-Bausteine/Webservices/Baustein-Web-Services-B5_24.pdf?__blob=publicationFile&v=1 (Punkt G 4.35)

SCRAM-SHA-256 wird ab PostgreSQL Version 10.x unterstützt. Unabhängig davon ist der Betrieb ab der ASV-Version 24.4 nur noch mit PostgreSQL Version 13 aufwärts möglich.

Alle Schulen und Betreiber, die ASV in der Enterprise-Variante (d. h. mit PostgreSQL als Datenbank-Backend) einsetzen, sind daher aufgefordert, zum nächstmöglichen Zeitpunkt von der MD5-Verschlüsselung auf das neue, sichere SCRAM-SHA-256-Verfahren umzustellen.

Beachten Sie, dass auch in den PostgreSQL-Versionen 11 und 12 standardmäßig noch mit MD5 verschlüsselt wird – d. h. hier besteht in der Regel Handlungsbedarf.

Schritt 1: Prüfen, für welche Datenbank-Benutzer Handlungsbedarf besteht

Liefert das nachfolgende SQL-Statement Treffer, bei denen has_upgraded den Wert FALSE hat, so sind die PostgreSQL-Passwörter der betroffenen Benutzer noch mit dem MD5-Verfahren verschlüsselt.

SELECT rolname, rolpassword ~ '^SCRAM-SHA-256\$' AS has_upgraded
FROM pg_authid
WHERE rolcanlogin;

Schritt 2: Umstellung der Passwortverschlüsselungsmethode

Unter Windows befinden sich die nachfolgend zu bearbeitenden Dateien in der Regel im Verzeichnis C:\Program Files\PostgreSQL\13\data, wobei 13 ggf. durch die verwendete PostgreSQL-Version zu ersetzen ist.

In der Datei postgresql.conf muss die Einstellung, welche Methode zur Passwortverschlüsselung eingesetzt wird, wie folgt eingetragen bzw. abgeändert werden (ein vorhandenes Hashtag # am Zeilenanfang ist zu entfernen!):

password_encryption = scram-sha-256

Damit die Änderung wirksam wird, speichern Sie die Datei und laden Sie die PostgreSQL-Konfiguration neu:

SELECT pg_reload_conf();

Das Absetzen des SQL-Statements

SHOW password_encryption;

muss nun als Verschlüsselungsverfahren scram-sha-256 zurückliefern.

Schritt 3: Aktualisierung aller bislang MD5-verschlüsselten Passwörter

Bei den im Ergebnis des SQL-Statements aus Schritt 1 aufgelisteten, noch nicht auf SCRAM-SHA-256 migrierten Benutzern muss das Passwort noch einmal aktiv neu gesetzt werden, damit es mit SCRAM-SHA-256 verschlüsselt wird. Dieser Vorgang ist nicht automatisierbar, da PostgreSQL das Passwort nicht im Klartext kennt, sondern nur dessen MD5-Hash.

Öffnen Sie dazu eine psql-Konsole. Beispiel für Windows und PostgreSQL-Version 13:

"C:\Program Files\PostgreSQL\13\bin\psql.exe" -h localhost -U postgres

Setzen Sie nun für die betroffenen Benutzer (i. d. R. geht es nur um die beiden Benutzer postgres sowie asv) deren bestehendes Passwort erneut:

\password postgres

bzw.

\password asv

Anschließend muss das jeweilige Passwort sowie dessen Wiederholung eingegeben werden.

Bitte beachten Sie, dass Sie während der Eingabe keine Rückmeldung (in Form von „Sternchen“ o. ä.) erhalten, sondern die Passwort-Eingabe vollständig „blind“ erfolgt. Lassen Sie sich davon nicht irritieren und schließen Sie die Eingabe des vollständigen Passworts (sowie dessen Wiederholung) jeweils durch Drücken der „Enter“-Taste ab.

Schritt 4: Erneute Überprüfung der Benutzer

Die abermalige Ausführung des SQL-Statements aus Schritt 1 sollte nun bei allen Benutzern für has_upgraded den Wert TRUE oder NULL zurückliefern.

Damit ist sichergestellt, dass die Tabelle pg_authid keine MD5-verschlüsselten Passwörter mehr enthält.

Schritt 5: Anpassung der Datei pg_hba.conf, um SCRAM-SHA-256 zu erzwingen

Öffnen Sie die Datei pg_hba.conf. In der Regel bietet sich folgendes Bild (falls der DSS auf einer anderen Maschine läuft als PostgreSQL, können es auch einige Zeilen mehr sein):

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# IPv4 local connections:
host    all             all             127.0.0.1/32            md5
# IPv6 local connections:
host    all             all             ::1/128                 md5
# Allow replication connections from localhost, by a user with the
# replication privilege.
host    replication     all             127.0.0.1/32            md5
host    replication     all             ::1/128                 md5

Ändern Sie alle Zeilen, die als Verschlüsselungsmethode (Spalte METHOD) bisher md5 ausweisen, auf scram-sha-256 ab:

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# IPv4 local connections:
host    all             all             127.0.0.1/32            scram-sha-256
# IPv6 local connections:
host    all             all             ::1/128                 scram-sha-256
# Allow replication connections from localhost, by a user with the
# replication privilege.
host    replication     all             127.0.0.1/32            scram-sha-256
host    replication     all             ::1/128                 scram-sha-256

Speichern Sie anschließend die Datei und laden Sie die Postgres-Konfiguration noch einmal neu, um die Änderungen anzuziehen:

SELECT pg_reload_conf();

Die Umstellung auf SCRAM-SHA-256 (für bestehende und zukünftig vergebene Passwörter) ist damit abgeschlossen.

PostgreSQL

anonymous@undisclosed.example.com (Anonymous) — Thu, 26 Jun 2025 08:15:09 +0000

PostgreSQL

Hinweis: Bitte prüfen Sie vor einer Installation die Installationsart: Für die Installation eines ASV-Servers School und eines ASV-Clients ist keine Installation von PostgreSQL notwendig! Sie benötigen PostgreSQL nur für die Installationsart "Mehrplatzserver" in der Variante ASV-Server Enterprise.

Ab ASV-Version 25.2 (Bereitstellung: Ende Juni 2025) können die PostgreSQL-Versionen 13, 14, 15, 16 und 17 mit ASV eingesetzt werden. PostgreSQL 13 wird ab Version 25.4 (November 2025) nicht mehr unterstützt werden!

Für eine Neuinstallation wird die PostgreSQL-Version 17 empfohlen, da der Support für dieses Release erst im November 2029 ausläuft.

Prüfen Sie beim Umstieg auf eine neue PostgreSQL-Version unbedingt, ob bei Ihnen noch das unsichere MD5-Verschlüsselungsverfahren eingesetzt wird.

Die diesbezügliche Verantwortung liegt bei der jeweiligen Schule bzw. dem jeweiligen Betreiber der ASV-Installation.

Eine Vorgehensbeschreibung für den Wechsel zum SCRAM-SHA-256-Verfahren finden Sie hier.

Bitte beachten Sie die Final-Release-Termine der Entwickler und planen Sie die Aktualisierung rechtzeitig ein. https://www.postgresql.org/support/versioning/

Der Windows-Installer für PostgreSQL der Firma EDB wird nur für wenige Windows Varianten getestet. Erfahrungsgemäß funktioniert dieser Installer jedoch auf allen aktuellen Windows Varianten (Desktop- wie Server-Betriebssysteme).

PostgreSQL steht für alle gängigen Betriebssysteme zur Verfügung (siehe Herstellerseite). Bitte informieren Sie sich - abhängig von Ihren betriebsbedingten Voraussetzungen - über die notwendigen Installationsschritte.

Unter Linux ist PostgreSQL in der Regel in den Repositories vorhanden (siehe zum Beispiel https://wiki.ubuntuusers.de/PostgreSQL/)

Installationsanleitungen

Zum Thema Sicherung und Rücksicherung ist eine eigene Seite vorhanden.

Für die regelmäßige Sicherung durch den Aktualisierungsdienst ist eine spezifische Konfiguration (Eintrag in der config.local.ini) nach der Installation erforderlich.

Falls Sie eigene Sicherungsskripten (Batch-Dateien o. ä.) einsetzen, denken Sie bei PostgreSQL-Updates daran, dort ggf. den Pfad zur Datei pg_dump.exe anzupassen und prüfen Sie das Sicherungsverzeichnis.

Upgrade Minor- und Major-Release

Update des PostgreSQL-Datenbankservers

anonymous@undisclosed.example.com (Anonymous) — Mon, 13 Nov 2023 13:16:56 +0000

Update des PostgreSQL-Datenbankservers

Die Doku zur PostgreSQL-Aktualisierung teilt sich in zwei Bereiche auf:

Update zu neuer Major-Version (z. B. PSQL13 auf PSQL15)
Update zu neuer Minor-Version (= diese Seite) (z. B. PSQL14.1 auf PSQL 14.2)

Von Zeit zu Zeit kann es notwendig sein, ein Update des PostgreSQL-Datenbankservers durchzuführen, weil neue Sicherheitslücken bekannt geworden und in einer neuen Version behoben sind. Hierüber werden Sie per RSS-Feed informiert.

Mit der vorliegenden Seite erhalten Sie eine Anleitung zum Update.

Unter Linux empfiehlt es sich, PostgreSQL über das distributionsspezifische Repository zu installieren und auch die dort verfügbaren Updates einzuspielen.

Prüfen Sie beim Umstieg auf eine neue PostgreSQL-Version 11 unbedingt, ob bei Ihnen noch das unsichere MD5-Verschlüsselungsverfahren eingesetzt wird. Die diesbezügliche Verantwortung liegt bei der jeweiligen Schule bzw. dem jeweiligen Betreiber der ASV-Installation. Eine Vorgehensbeschreibung für den Wechsel zum SCRAM-SHA-256-Verfahren finden Sie hier.

Sicherung der Datenbank mit pgAdmin

Bitte folgen Sie den Anweisungen auf dieser Seite, um eine Sicherung des Datenbestands anzulegen.

Ermittlung des aktuell installierten PostgreSQL-Releases (für Windows; analog für Linux)

Öffnen Sie mit der Tastenkombination Windows-Taste + R (wie „Run“) das „Ausführen“-Dialogfeld und geben Sie dort cmd ein. Klicken Sie nun auf OK.

Geben Sie in den Kommandozeilenprompt den Befehl psql –V ein und drücken Sie anschließend Enter. Sie erhalten nun die installierte PostgreSQL-Version zurückgemeldet.

Falls dies nicht aus dem angezeigten Verzeichnis funktionieren sollte, wechseln Sie über den Begriff cd c:\ ins Wurzelverzeichnis. Anschließend wechseln Sie ggfs. mit X: das Laufwerk und gehen dann mit dem Befehl cd Pfad\PostgreSQL\11\bin ins entsprechende Verzeichnis. Dort führen Sie anschließend den obigen Befehl aus.

Es muss das entsprechend passende Update heruntergeladen und eingespielt werden.

Die von ASV unterstützten PostgreSQL Versionen finden Sie unter PostgreSQL.

Stoppen des PostgreSQL-Dienstes

Bitte beachten Sie, dass der Datenbankserver nur gestoppt werden kann, wenn keine aktiven Verbindungen mehr bestehen. Insbesondere darf kein ASV-Server mehr verbunden sein, keine pgAdmin-Instanz, etc. Stoppen Sie vorher den ASV-Server.

Öffnen Sie mit der Tastenkombination Windows-Taste + R (wie „Run“) das „Ausführen“-Dialogfeld und geben Sie dort services.msc ein. Klicken Sie nun auf OK.

Suchen Sie in der Liste den PostgreSQL-Dienst und klicken Sie mit der rechten Maustaste auf den Eintrag. Wählen Sie dort die Option Beenden.

Download und Installation des Updates

Über den Link https://www.enterprisedb.com/downloads/postgres-postgresql-downloads gelangen Sie direkt zu den PostgreSQL-Downloads. Wählen Sie die für Sie passende Version sowie Ihr Betriebssystem und klicken Sie anschließend auf Download now.

Öffnen Sie nun Ihren Downloads-Ordner und führen Sie einen Doppelklick auf den PostgreSQL-Installer durch.

Klicken Sie auf Next.

Die Setup-Routine findet Ihre bestehende PostgreSQL-Installation und bietet ein Update an:

Klicken Sie mehrmals auf Next, um die eigentliche Installation zu starten.

Entfernen Sie im letzten Schritt noch das Häkchen für die Installation des Stack Builders.

Der Update-Installer startet den PostgreSQL-Dienst selbsttätig wieder, so dass an dieser Stelle kein zusätzlicher Eingriff erforderlich ist. Sie haben das Update erfolgreich vollzogen und können durch einen nochmaligen Aufruf von psql -V den Versionssprung prüfen.

Umstieg auf ein neues Major-Release von PostgreSQL-Server

anonymous@undisclosed.example.com (Anonymous) — Fri, 12 May 2023 16:24:16 +0000

Umstieg auf ein neues Major-Release von PostgreSQL-Server

Es wird ausdrücklich empfohlen eine Umstellung von PostgreSQL-Server auf ein neues Major-Release dann zu machen, wenn ohnehin der ASV-Server neu aufgesetzt wird. Ggf. ist das neue PostgreSQL-Release der Anlass den ASV-Server neu aufzusetzen.

Wer sich dennoch für ein Upgrade auf dem selben Server entscheidet, ist selbst für die gebotenen Maßnahmen zur Sicherung etc. verantwortlich. Maßgeblich ist die Dokumentation von PostgreSQL. Das ASV-Supportteam kann dafür nur sehr eingeschränkt unterstützen und keinerlei Verantwortung übernehmen. Beachten Sie bitte die Informationen zur Aktualisierung einer Postgres Version.