Compilation et installation de PgBouncer

Instructions de compilation et d’installation de PgBouncer

Tutoriel

Construction

PgBouncer dépend de quelques éléments pour être compilé :

GNU Make 3.81+
Libevent 2.0+
pkg-config
OpenSSL 1.0.1+ pour la prise en charge du TLS
(facultatif) c-ares en tant qu’alternative à evdns de Libevent
(facultatif) bibliothèques LDAP
(facultatif) bibliothèques PAM

Lorsque les dépendances sont installées, exécutez simplement :

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

Si vous compilez à partir de Git, ou si vous compilez pour Windows, veuillez consulter les instructions de compilation spécifiques ci-dessous.

Prise en charge des recherches DNS

PgBouncer effectue des recherches de noms d’hôte au moment de la connexion, et non une seule fois au moment du chargement de la configuration. Cela nécessite une implémentation DNS asynchrone. Le tableau suivant indique les backends pris en charge ainsi que leur ordre de sondage :

backend	parallel	EDNS0 (1)	/etc/hosts	SOA lookup (2)	note
c-ares	yes	yes	yes	yes	problème avec IPv6+CNAME pour les versions ≤ 1.10
evdns, libevent 2.x	yes	no	yes	no	ne vérifie pas les mises à jour de /etc/hosts
getaddrinfo_a, glibc 2.9+	yes	yes (3)	yes	no	non disponible sur les systèmes non-glibc
getaddrinfo, libc	no	yes (3)	yes	no	nécessite pthreads

EDNS0 est requis pour avoir plus de 8 adresses derrière un même nom d’hôte.
Une requête SOA est nécessaire pour vérifier à nouveau les noms d’hôte en cas de changement du numéro de série de la zone.
Pour activer EDNS0, ajoutez options edns0 à /etc/resolv.conf.

c-ares est l’implémentation la plus complète et est recommandée pour la plupart des utilisations et des paquetages binaires (si une version suffisamment récente est disponible). L’implémentation evdns intégrée à libevent convient également à de nombreuses utilisations, sous réserve des restrictions mentionnées. Les autres backends sont principalement des options héritées à l’heure actuelle et ne bénéficient plus d’un test important.

Par défaut, c-ares est utilisé s’il est détecté. Son utilisation peut être imposée avec configure --with-cares ou désactivée avec --without-cares. Si c-ares n’est pas utilisé (non trouvé ou désactivé), alors Libevent est utilisé. Spécifiez --disable-evdns pour désactiver l’utilisation de evdns de Libevent et revenir à une implémentation basée sur libc.

Authentification PAM

Pour activer l’authentification PAM, ./configure dispose d’un indicateur --with-pam (valeur par défaut : no). Lorsqu’il est compilé avec le support PAM, un nouveau type d’authentification global pam devient disponible pour valider les utilisateurs via PAM.

Authentification LDAP

Pour activer l’authentification LDAP, ./configure dispose d’un indicateur --with-ldap (valeur par défaut : no). Lorsqu’il est compilé avec le support LDAP, un nouveau type d’authentification global ldap devient disponible pour valider les utilisateurs via LDAP.

intégration systemd

Pour activer l’intégration avec systemd, utilisez l’option configure --with-systemd. Cela permet d’utiliser Type=notify (ou Type=notify-reload si vous utilisez systemd 253 ou une version ultérieure) ainsi que l’activation par socket. Consultez etc/pgbouncer.service et etc/pgbouncer.socket pour des exemples.

Construction à partir de Git

La compilation de PgBouncer à partir de Git nécessite de générer les fichiers d’en-tête et de configuration avant de pouvoir exécuter configure :

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

Tous les fichiers seront installés sous /usr/local par défaut. Vous pouvez fournir une ou plusieurs options en ligne de commande à configure. Exécutez ./configure --help pour afficher les options disponibles et les variables d’environnement qui personnalisent la configuration.

Paquets supplémentaires requis : autoconf, automake, libtool, pandoc

Test

Consultez le fichier README.md dans le répertoire de test pour savoir comment exécuter les tests.

Construction sous Windows

L’environnement de compilation pris en charge sur Windows est uniquement MinGW. Cygwin et Visual $ANYTHING ne sont pas pris en charge.

Pour compiler sous MinGW, procédez comme d’habitude :

$ ./configure
$ make

Si vous effectuez une compilation croisée depuis Unix :

$ ./configure --host=i586-mingw32msvc

L’option de compilation LDAP n’est actuellement pas prise en charge sous Windows.

Exécution sous Windows

Exécution depuis la ligne de commande se déroule normalement, à l’exception des options -d (daemonize), -R (reboot) et -u (switch user) qui ne fonctionnent pas.

Pour exécuter PgBouncer en tant que service Windows, vous devez configurer le paramètre service_name afin de définir un nom pour le service. Ensuite :

$ pgbouncer -regservice config.ini

Pour désinstaller le service :

$ pgbouncer -unregservice config.ini

Pour utiliser le journal des événements Windows, définissez syslog = 1 dans le fichier de configuration. Mais avant cela, vous devez inscrire pgbevent.dll :

$ regsvr32 pgbevent.dll

Pour le désenregistrer, procédez comme suit :

$ regsvr32 /u pgbevent.dll