# PgBouncer kompilieren und installieren > Anleitung zum Kompilieren und Installieren von PgBouncer --- LLMS-Index: [llms.txt](/de/llms.txt) --- -------- ## Kompilieren {#building} 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 [GNU Make]: https://www.gnu.org/software/make/ [Libevent]: http://libevent.org/ [pkg-config]: https://www.freedesktop.org/wiki/Software/pkg-config/ [OpenSSL]: https://www.openssl.org/ [c-ares]: http://c-ares.haxx.se/ 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 {#dns-lookup-support} 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: | Backend | Parallel | EDNS0 (1) | /etc/hosts | SOA-Abfrage (2) | Hinweis | |----------------------------|----------|-----------|------------|------------------|------------------------------------------| | c-ares | ja | ja | ja | ja | IPv6+CNAME in Versionen <=1.10 fehlerhaft | | evdns, libevent 2.x | ja | nein | ja | nein | erkennt Änderungen an /etc/hosts nicht | | getaddrinfo_a, glibc 2.9+ | ja | ja (3) | ja | nein | N/A (auf Systemen ohne glibc nicht verfügbar) | | getaddrinfo, libc | nein | ja (3) | ja | nein | erfordert pthreads | 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 {#pam-authentication} 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 {#ldap-authentication} 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 {#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 {#building-from-git} 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 {#testing} Weitere Informationen zum Ausführen der Tests finden Sie in der Datei [`README.md` im Testverzeichnis][1]. [1]: https://github.com/pgbouncer/pgbouncer/blob/master/test/README.md -------- ## Kompilieren unter Windows {#building-on-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 {#running-on-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