• Tutorial

---

Kompilieren

PgBouncer kann entweder mit dem Autoconf-basierten Build-System oder mit dem neueren, noch experimentellen Build-System Meson kompiliert werden. Für produktive Builds und die Paketerstellung wird derzeit Autoconf empfohlen. Voraussichtlich wird Meson in einer künftigen Version zum Standard und Autoconf entfernt. Daher sind Tests des Meson-Builds und Berichte über Probleme sehr willkommen. Für das Kompilieren werden einige Komponenten benötigt:

• Libevent 2.0+
• pkg-config
• OpenSSL 1.0.1+ für TLS-Unterstützung
• ein C-Compiler mit C11-Unterstützung
• (optional) c-ares als Alternative zu evdns von Libevent
• (optional) LDAP-Bibliotheken
• (optional) PAM-Bibliotheken

Der Meson-Build benötigt zusätzlich Meson 0.58+ und Ninja , der Autoconf-Build GNU Make 3.81+.

Wenn alle Abhängigkeiten installiert sind, mit Autoconf kompilieren:

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

oder mit Meson (experimentell):

$ meson setup build --prefix=/usr/local
$ meson compile -C build
$ meson install -C build

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 -Dcares=enabled (configure: --with-cares) erzwingen oder mit -Dcares=disabled (configure: --without-cares) deaktivieren. Wenn c-ares nicht verwendet wird (weil es nicht gefunden oder deaktiviert wurde), kommt Libevent zum Einsatz. Mit -Devdns=false (configure: --disable-evdns) wird evdns von Libevent deaktiviert und auf eine libc-basierte Implementierung zurückgegriffen.

---

Optionale Funktionen

Meson erkennt die Unterstützung für PAM, LDAP und systemd automatisch: Die Optionen -Dpam, -Dldap und -Dsystemd haben den Standardwert auto. Die jeweilige Funktion wird also eingebaut, wenn ihre Bibliotheken vorhanden sind. Mit -D<feature>=enabled lässt sich eine Funktion ausdrücklich aktivieren, mit -D<feature>=disabled deaktivieren. Der Autoconf-Build erkennt diese Funktionen nicht automatisch; sie müssen ausdrücklich mit --with-pam, --with-ldap oder --with-systemd aktiviert werden.

---

PAM-Authentifizierung

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

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

Die systemd-Unterstützung ermöglicht die Verwendung von Type=notify (oder Type=notify-reload mit systemd 253 oder neuer) sowie die Socket-Aktivierung. Beispiele finden sich in etc/pgbouncer.service und etc/pgbouncer.socket.

---

Aus dem Git-Repository kompilieren

Beim Autoconf-Build müssen die Header- und Konfigurationsdateien generiert werden, bevor configure ausgeführt werden kann:

$ git clone --branch pgbouncer_1_26_0 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 für den Autoconf-Build aus Git: autoconf, automake, libtool, pandoc

Mit Meson lässt sich direkt aus einem Checkout kompilieren; zum Erstellen der Handbuchseiten wird pandoc benötigt:

$ meson setup build
$ meson compile -C build
$ meson install -C build

Mit meson configure build lassen sich die verfügbaren -D-Optionen auflisten.

---

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.

Zum Kompilieren unter MinGW den üblichen Autoconf-Build ausführen:

$ ./configure
$ make

oder den experimentellen Meson-Build:

$ meson setup build
$ meson compile -C build

Für eine Cross-Kompilierung von Unix aus mit Autoconf:

$ ./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) 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