PgBouncer kompilieren und installieren

Kompilieren

Für das Kompilieren von PgBouncer werden einige Komponenten benötigt:

• GNU Make 3.81+
• Libevent 2.0+
• pkg-config
• OpenSSL 1.0.1+ für TLS-Unterstützung
• (optional) c-ares als Alternative zu evdns von Libevent
• (optional) LDAP-Bibliotheken
• (optional) PAM-Bibliotheken

Wenn alle Abhängigkeiten installiert sind, führen Sie folgende Befehle aus:

$ ./configure --prefix=/usr/local
$ make
$ make install

Wenn Sie PgBouncer direkt aus dem Git-Repository oder für Windows kompilieren, beachten Sie die entsprechenden Anleitungen weiter unten.

Unterstützung für DNS-Abfragen

PgBouncer löst Hostnamen beim Verbindungsaufbau auf und nicht nur einmal beim Einlesen der Konfiguration. Dafür ist eine asynchrone DNS-Implementierung erforderlich. Die folgende Tabelle zeigt die unterstützten Backends und die Reihenfolge, in der sie geprüft werden:

1. EDNS0 ist erforderlich, wenn einem Hostnamen mehr als 8 Adressen zugeordnet sind.
2. Eine SOA-Abfrage ist erforderlich, um Hostnamen bei einer Änderung der Zonen-Seriennummer erneut zu prüfen.
3. Um EDNS0 zu aktivieren, fügen Sie options edns0 zu /etc/resolv.conf hinzu.

c-ares ist die Implementierung mit dem größten Funktionsumfang und wird für die meisten Einsatzbereiche sowie für die Erstellung von Binärpaketen empfohlen (sofern eine ausreichend neue Version verfügbar ist). Das in Libevent integrierte evdns eignet sich unter Beachtung der genannten Einschränkungen ebenfalls für viele Einsatzbereiche. Die übrigen Backends sind inzwischen weitgehend veraltet und werden kaum noch getestet.

Standardmäßig wird c-ares verwendet, sofern es gefunden wird. Der Einsatz lässt sich mit configure --with-cares erzwingen oder mit --without-cares deaktivieren. Wenn c-ares nicht verwendet wird (weil es nicht gefunden oder deaktiviert wurde), kommt Libevent zum Einsatz. Mit --disable-evdns deaktivieren Sie evdns von Libevent; anschließend wird auf eine libc-basierte Implementierung zurückgegriffen.

PAM-Authentifizierung

Um die PAM-Authentifizierung zu aktivieren, rufen Sie ./configure mit der Option --with-pam auf (standardmäßig deaktiviert). Nach dem Kompilieren mit PAM-Unterstützung steht der neue globale Authentifizierungstyp pam zur Verfügung, mit dem Benutzer über PAM authentifiziert werden können.

LDAP-Authentifizierung

Um die LDAP-Authentifizierung zu aktivieren, rufen Sie ./configure mit der Option --with-ldap auf (standardmäßig deaktiviert). Nach dem Kompilieren mit LDAP-Unterstützung steht der neue globale Authentifizierungstyp ldap zur Verfügung, mit dem Benutzer über LDAP authentifiziert werden können.

systemd-Integration

Um die systemd-Integration zu aktivieren, rufen Sie configure mit der Option --with-systemd auf. Damit lassen sich Type=notify (oder Type=notify-reload, wenn Sie systemd 253 oder neuer verwenden) sowie die Socket-Aktivierung nutzen. Beispiele finden Sie in etc/pgbouncer.service und etc/pgbouncer.socket.

Aus dem Git-Repository kompilieren

Wenn Sie PgBouncer direkt aus dem Git-Repository kompilieren, müssen Sie die Header- und Konfigurationsdateien generieren, bevor Sie configure ausführen können:

$ git clone https://github.com/pgbouncer/pgbouncer.git
$ cd pgbouncer
$ ./autogen.sh
$ ./configure
$ make
$ make install

Standardmäßig werden alle Dateien unter /usr/local installiert. Sie können für configure eine oder mehrere Befehlszeilenoptionen angeben. Führen Sie ./configure --help aus, um die verfügbaren Optionen und die Umgebungsvariablen aufzulisten, mit denen sich die Konfiguration anpassen lässt.

Zusätzlich erforderliche Pakete: autoconf, automake, libtool, pandoc

Tests

Weitere Informationen zum Ausführen der Tests finden Sie in der Datei README.md im Testverzeichnis .

Kompilieren unter Windows

Die einzige unterstützte Build-Umgebung unter Windows ist MinGW. Cygwin und Visual $ANYTHING werden nicht unterstützt.

Führen Sie zum Kompilieren unter MinGW die üblichen Schritte aus:

$ ./configure
$ make

Für eine Cross-Kompilierung unter Unix verwenden Sie:

$ ./configure --host=i586-mingw32msvc

Die LDAP-Kompilierungsoption wird unter Windows derzeit nicht unterstützt.

Betrieb unter Windows

Der Aufruf über die Befehlszeile erfolgt wie üblich. Die Schalter -d (Daemon-Modus), -R (Neustart) und -u (Benutzerwechsel) funktionieren jedoch nicht.

Wenn Sie PgBouncer als Windows-Dienst ausführen möchten, legen Sie mit dem Parameter service_name einen Namen für den Dienst fest. Danach:

$ pgbouncer -regservice config.ini

Zum Deinstallieren des Dienstes:

$ pgbouncer -unregservice config.ini

Um das Windows-Ereignisprotokoll zu nutzen, setzen Sie syslog = 1 in der Konfigurationsdatei. Zuvor müssen Sie pgbevent.dll registrieren:

$ regsvr32 pgbevent.dll

Um die Registrierung aufzuheben, führen Sie folgenden Befehl aus:

$ regsvr32 /u pgbevent.dll