| Documentation PostgreSQL 9.3.25 > Administration du serveur > Installation à partir du code source sur WindowsTM | |
| PrécédentNotes spécifiques à des plateformes | Construire libpq avec Visual C++ ou Borland C++Suivant |
Il est recommandé que la plupart des utilisateurs téléchargent la distribution binaire pour Windows, disponible sous la forme d'un package d'installation graphique à partir du site web de PostgreSQLTM. Construire à partir des sources a pour seule cible les personnes qui développent PostgreSQLTM ou des extensions.
Il existe différentes façons de construire PostgreSQL sur WindowsTM. La façon la plus simple de le faire est d'utiliser les outils Microsoft. Pour cela, il faut installer une version supportée de Visual Studio Express 2013 for Windows DesktopTM et utiliser le compilateur inclus. Il est aussi possible de construire PostgreSQL avec Microsoft Visual C++ 2005 à 2017TM. Dans certains cas, il faut installer le Windows SDKTM en plus du compilateur.
Il est aussi possible de construire PostgreSQL en utilisant les outils de compilation GNU fournis par MinGWTM ou en utilisant CygwinTM pour les anciennes versions de WindowsTM.
Enfin, la bibliothèque d'accès pour les clients (libpq) peut être construit en utilisant Visual C++ 7.1TM ou Borland C++TM pour la compatibilité avec des applications liées statiquement en utilisant ces outils.
La construction par MinGWTM ou CygwinTM utilise le système habituel de construction, voir Chapitre 15, Procédure d'installation de PostgreSQLTM du code source et les notes spécifiques dans Section 15.9.6, « MinGW/Windows Natif » et Section 15.9.2, « Cygwin ». Pour produire des binaires natifs 64 bits dans ces environnements, utilisez les outils de MinGW-w64TM. Ces outils peuvent également être utilisés pour faire de la cross-compilation pour les systèmes WindowsTM 32 et 64 bits sur d'autres machines, telles que LinuxTM et DarwinTM. Il n'est pas recommandé d'utiliser CygwinTM pour faire fonctionner un serveur de production. Il devrait uniquement être utilisé pour le fonctionnement sur d'anciennes versions de WindowsTM, où le build natif ne fonctionne pas, comme Windows 98TM. Les exécutables officiels sont construits avec Visual StudioTM.
Les constructions natives de psql ne supportent pas l'édition de la ligne de commande. La version de psql construite avec CygwinTM supporte l'édition de ligne de commande, donc elle devrait être utilisée là où on a besoin de psql pour des besoins interactifs sous WindowsTM.
PostgreSQL peut être construit en utilisant la suite de compilation Visual C++ de Microsoft. Ces compilateurs peuvent être soit Visual StudioTM, soit Visual Studio ExpressTM soit certaines versions du Microsoft Windows SDKTM. Si vous n'avez pas déjà un environnement Visual StudioTM configuré, le plus simple est d'utiliser les compilateurs disponibles dans Visual Studio Express 2017 for Windows DesktopTM ou ceux fournis dans le Windows SDK 8.1TM, qui sont tous disponibles en libre téléchargement sur le site de Microsoft.
Il est possible d'utiliser la suite Microsoft Compiler pour des constructions 32 et 64 bits. Les constructions 32 bits sont possibles avec Visual Studio 2005TM jusqu'à Visual Studio 2017TM (incluant les éditions Express), ainsi que les versions autonomes du Windows SDK de la 6.0 à la 8.1. Les constructions 64 bits sont supportées avec Microsoft Windows SDKTM de la version 6.0a à la version 8.1 ou avec Visual Studio 2008TM et ultérieures. La compilation est supportée de Windows XPTM à Windows Server 2003TM lors d'une construction avec Visual Studio 2005TM jusqu'à Visual Studio 2013TM. Construire avec Visual Studio 2015TM est supporté de Windows VistaTM à Windows Server 2008TM. Construire avec Visual Studio 2017TM est supporté de Windows 7 SP1TM jusqu'à Windows Server 2008 R2 SP1TM.
Les outils pour compiler avec Visual C++TM ou Platform SDKTM sont dans le répertoire src/tools/msvc. Lors de la construction, assurez-vous qu'il n'y a pas d'outils provenant de MinGWTM ou CygwinTM présents dans le chemin des applications du système. De plus, assuez-vous que vous avez tous les outils Visual C++ requis disponibles dans le PATH. Dans Visual StudioTM, lancez le Visual Studio Command Prompt. Si vous souhaitez construire une version 64-bit, vous devez utiliser une version 64-bit de la commande, et vice versa. Dans Microsoft Windows SDKTM, lancez le CMD shell listé dans le menu SDK du menu de démarrage. Dans les versions récentes du SDK, vous pouvez changer l'architecture CPU ciblée, le type de construction et le système cible en utilisant la commande setenv, par exemple setenv /x86 /release /xp pour cibler Windows XP ou supérieur avec une construction 32 bits. Voir /? pour les autres options de setenv. Toutes les commandes doivent être exécutées du répertoire src\tools\msvc.
Avant de lancer la construction, vous aurez besoin d'éditer le fichier config.pl pour y modifier toutes les options de configuration nécessaires, ainsi que les chemins utilisés par les bibliothèques de tierces parties. La configuration complète est déterminée tout d'abord en lisant et en analysant le fichier config_default.pl, puis en appliquant les modifications provenant du fichier config.pl. Par exemple, pour indiquer l'emplacement de votre installation de PythonTM, placez la ligne suivante dans config.pl :
$config->{python} = 'c:\python26';
Vous avez seulement besoin de spécifier les paramètres qui sont différents de la configuration par défaut, spécifiée par le fichier config_default.pl.
Si vous avez besoin de configurer d'autres variables d'environnement, créez un fichier appelé buildenv.pl et placez-y les commandes souhaitées. Par exemple, pour ajouter le chemin vers bison s'il ne se trouve pas dans le PATH, créez un fichier contenant :
$ENV{PATH}=$ENV{PATH} . ';c:\chemin\vers\bison\bin';
Les outils supplémentaires suivants sont requis pour construire PostgreSQLTM. Utilisez le fichier config.pl pour indiquer les répertoires où se trouvent les bibliothèques.
Si votre environnement de compilation ne contient pas une version supportée du Microsoft Windows SDKTM, il est recommandé de mettre à jour avec la dernière version supportée (actuellement la version 7.1), téléchargeable sur https://www.microsoft.com/download.
Vous devez toujours inclure la partie Windows Headers and Libraries du SDK. Si vous installez un Windows SDKTM incluant les compilateurs (Visual C++ Compilers), vous n'avez pas de Visual StudioTM. Notez que la version 8.0a du Windows SDK ne contient plus d'environnement complet de compilation en ligne de commande.
ActiveState Perl est requis pour exécuter les scripts de construction. Le Perl de MinGW et de Cygwin ne fonctionnera pas. Il doit aussi être présent dans le PATH. Les binaires de cet outil sont téléchargeables à partir de http://www.activestate.com (Note : la version 5.8.3 ou ultérieure est requise, la distribution standard libre est suffisante).
Les produits suivants ne sont pas nécessaires pour commencer, mais sont requis pour installer la distribution complète. Utilisez le fichier config.pl pour indiquer les répertoires où sont placées les bibliothèques.
Requis pour construire PL/TCL (Note : la version 8.4 est requise, la distribution standard libre est suffisante).
BisonTM et FlexTM sont requis pour construire à partir de Git, mais ne le sont pas pour construire à partir d'une version distribuée. Seul BisonTM 1.875 ou les versions 2.2 et ultérieures fonctionneront. FlexTM doit être en version 2.5.31 ou supérieure.
BisonTM et FlexTM sont inclus dans la suite d'outils msysTM, disponible à partir de ce site et faisant partie de la suite de compilation MinGWTM.
Vous aurez besoin d'ajouter le répertoire contenant flex.exe et bison.exe à la variable d'environnement PATH dans buildenv.pl sauf s'ils sont déjà dans le PATH. Dans le cas de MinGW, le répertoire est le sous-répertoire \msys1円.0\bin de votre répertoire d'installation de MinGW.
La distribution Bison de GnuWin32 a apparemment un bug qui cause des disfonctionnements de Bison lorsqu'il est installé dans un répertoire dont le nom contient des espaces, tels que l'emplacement par défaut dans les installations en Anglais : C:\Program Files\GnuWin32. Installez donc plutôt dans C:\GnuWin32 ou utilisez le chemin court NTFS de GnuWin32 dans votre variable d'environnement PATH (par exemple C:\PROGRA~1\GnuWin32).
Les binaires obsolètes "winflex" distribués sur le site FTP de PostgreSQL et référencés dans les anciennes documentations échoueront avec le message "flex: fatal internal error, exec failed" sur des serveurs Windows 64 bits. Utilisez flex à partir du paquet msys.
Diff est nécessaire pour exécuter les tests de régression, et peut être téléchargé à partir de http://gnuwin32.sourceforge.net.
Gettext est requis pour construire le support NLS, et peut être téléchargé à partir de http://gnuwin32.sourceforge.net. Notez que les binaires, dépendances et fichiers développeurs sont tous nécessaires.
Requis pour le support de l'authentification Kerberos. MIT Kerberos est téléchargeable sur http://web.mit.edu/Kerberos/dist/index.html.
Requis pour le support du XML. Les binaires sont disponibles sur http://zlatkovic.com/pub/libxml et les sources sur http://xmlsoft.org. Notez que libxml2 nécessite iconv, qui est disponible sur le même site web.
Requis pour le support de SSL. Les binaires peuvent être téléchargés à partir de http://www.slproweb.com/products/Win32OpenSSL.html alors que les sources sont disponibles sur http://www.openssl.org.
Requis pour le support d'UUID-OSSP (seulement en contrib). Les sources peuvent être récupérées sur le site ossp.org.
Requis pour la construction de PL/Python. Les binaires sont téléchargeables sur http://www.python.org.
Requis pour le support de la compression dans pg_dump et pg_restore. Les binaires sont disponibles à partir de http://www.zlib.net.
PostgreSQL ne peut être compilé pour l'architecture x64 que sur Windows 64-bits, il n'y a pas de support pour les processeurs Itanium.
Mixer des versions 32-bits et des versions 64-bits dans le même répertoire de construction n'est pas supporté. Le système de compilation détectera automatiquement si l'environnement est 32-bits ou 64-bits, et construira PostgreSQL en accord. Pour cette raison, il est important de commencer avec la bonne invite de commande avant de lancer la compilation.
Pour utiliser une bibliothèque de tierce partie côté serveur comme pythonTM ou opensslTM, cette bibliothèque doit aussi être en 64-bits. Il n'y a pas de support pour le chargement d'une bibliothèque 32-bits sur un serveur 64-bits. Plusieurs bibliothèques de tierce partie que PostgreSQL supporte ne sont disponibles qu'en version 32-bits, auquel cas elles ne peuvent pas être utilisées avec un PostgreSQL 64-bits.
Pour construire tout PostgreSQL dans la configuration par défaut, exécutez la commande :
build
Pour construire tout PostgreSQL dans la configuration de débogage, exécutez la commande :
build DEBUG
Pour construire un seul projet, par exemple psql, exécutez les commandes :
build psql build DEBUG psql
Pour modifier la configuration de construction par défaut, placez ce qui suit dans le fichier buildenv.pl :
Il est aussi possible de construire à partir de l'interface de Visual Studio. Dans ce cas, vous devez exécuter :
perl mkvcbuild.pl
à partir de l'invite, puis ouvrir le fichier pgsql.sln généré (dans le répertoire racine des sources) dans Visual Studio.
La plupart du temps, la récupération automatique des dépendances dans Visual Studio prendra en charge les fichiers modifiés. Mais, s'il y a eu trop de modifications, vous pouvez avoir besoin de nettoyer l'installation. Pour cela, exécutez simplement la commande clean.bat, qui nettoiera automatiquement les fichiers générés. Vous pouvez aussi l'exécuter avec le paramètre dist, auquel cas il se comporte comme make distclean et supprime les fichiers flex/bison en sortie.
Par défaut, tous les fichiers sont écrits dans un sous-répertoire de debug ou release. Pour installer ces fichiers en utilisant les emplacements standards et pour générer aussi les fichiers requis pour initialiser et utiliser la base de données, exécutez la commande :
install c:\destination\directory
Pour exécuter les tests de régression, assurez-vous que vous avez terminé la construction de toutes les parties requises. Ensuite, assurez-vous que les DLL nécessaires au chargement de toutes les parties du système (comme les DLL Perl et Python pour les langages de procédure) sont présentes dans le chemin système. Dans le cas contraire, configurez-les dans le fichier buildenv.pl. Pour lancer les tests, exécutez une des commandes suivantes à partir du répertoire src\tools\msvc :
vcregress check vcregress installcheck vcregress plcheck vcregress contribcheck
Pour modifier la planification utilisée (en parallèle par défaut), ajoutez-la à la ligne de commande, comme :
vcregress check serial
Pour plus d'informations sur les tests de régression, voir Chapitre 30, Tests de régression.
Construire la documentation PostgreSQL au format HTML nécessite plusieurs outils et fichiers. Créez un répertoire racine pour tous ces fichiers et stockez-les dans des sous-répertoires conformément à la liste ci-dessous.
À télécharger à partir de http://sourceforge.net/projects/openjade/files/openjade/1.3.1/openjade-1_3_1-2-bin.zip/download et à décompresser dans le sous-répertoire openjade-1.3.1.
À télécharger à partir de http://www.oasis-open.org/docbook/sgml/4.2/docbook-4.2.zip et à décompresser dans le sous-répertoire docbook.
À télécharger à partir de http://sourceforge.net/projects/docbook/files/docbook-dsssl/1.79/docbook-dsssl-1.79.zip/download et à décompresser dans le sous-répertoire docbook-dsssl-1.79.
À télécharger à partir de http://www.oasis-open.org/cover/ISOEnts.zip et à décompresser dans le sous-répertoire docbook.
Modifiez le fichier buildenv.pl et ajoutez une variable pour l'emplacement du répertoire racine, par exemple :
$ENV{DOCROOT}='c:\docbook';
Pour construire la documentation, exécutez la commande builddoc.bat. Notez que ceci exécutera la construction une deuxième fois, pour générer les index. Les fichiers HTML générés seront dans le répertoire doc\src\sgml.