PostgreSQL : Installation et premières manipulations

Afin de pouvoir naviguer parmi les lignes (historique, édition de la ligne en cours), la bibliothèque libreadline est nécessaire. Si vous utilisez un système de gestion de packages, il faut disposer du package libreadline-devel, sinon, téléchargez, compilez et installez les sources.

Vous aurez bien sûr également besoin d'un environnement de compilation complet (gcc, configure & Cie). Il est fort possible que cet environnement soit déjà présent sur votre système.

Dans ce tutoriel, nous allons tout faire depuis la compilation jusqu'au paramétrage de la première base. C'est-à-dire que nous n'installons rien à partir de package (excepté éventuellement librealine). Il faut donc commencer par récupérer les sources sur http://www.postgresl.org/ftp. Vous y trouverez un répertoire v8.x.y (v8.0.3 pour moi), descendez dedans et téléchargez l'archive nommée postgresql-8.x.y.tar.gz.

Une fois l'archive téléchargée, il faut la décompresser :

su -

cd /usr/src

tar zxvf /path/vers/postgres-8.x.y.tar.gz

Le mot de passe root vous est demandé après la première commande. Ensuite, les sources sont décompressées ce qui crée un répertoire postgres-8.x.y dans /usr/src. On peut ensuite passer à la compilation proprement dite :

adduser postgres

chown postgres:postgres /usr/src/postgres-8.x.y/ -R

su - postgres

cd /usr/src/postgres-8.x.y

./configure

make

make check

logout

make install

Le script configure accepte diverses options qui permettent de configurer précisément la façon dont est construit PostgreSQL :

• --prefix=PREFIX : installe tous les fichiers dans le répertoire PREFIX au lieu de /usr/local/pgsql. Les fichiers seront en fait installés dans divers sous-répertoires ; aucun fichier ne sera installé directement dans le répertoire PREFIX ;
• --exec-prefix=EXEC-PREFIX : installe les fichiers exécutables dépendant de l'architecture dans le répertoire EXEC-PREFIX. Dans le cas où il n'est pas précisé, EXEC-PREFIX vaut PREFIX ;
• --bindir=DIRECTORY : Indique le répertoire des fichiers exécutables. Par défaut vaut EXEC-PREFIX/bin (soit /usr/local/pgsql/bin par défaut) ;
• --datadir=DIRECTORY : indique le répertoire des fichiers en lecture seule utilisés par PostgreSQL. Par défaut vaut PREFIX/share. Cela n'a rien à voir avec l'emplacement des fichiers de base de données ;
• --sysconfdir=DIRECTORY : répertoire pour les fichiers de configuration, PREFIX/etc par défaut ;
• --libdir=DIRECTORY : emplacement des bibliothèques et des modules dynamiques. Par défaut, EXEC-PREFIX/lib ;
• --includedir=DIRECTORY : répertoire d'installation des fichiers d'en-tête C et C++. Par défaut, PREFIX/include ;
• --mandir=DIRECTORY : les pages de manuel de PostgreSQL seront installées dans ce répertoire. Par défaut, PREFIX/man ;
• --with-docdir=DIRECTORY : les fichiers de documentation, sauf les pages de manuel, seront installées dans ce répertoire. Par défaut, PREFIX/doc ;
• --without-docdir : n'installe pas la documentation lors du make install ;
• --with-includes=DIRECTORIES : DIRECTORIES est une liste de répertoires séparés par deux-points dans lesquels seront recherchés les fichiers d'include en plus des répertoires standards. Utile si vous avez des bibliothèques (comme GNU Readline) installées dans des répertoires particuliers ;
• --with-libraries=DIRECTORIES : DIRECTORIES est une liste de répertoires séparés par deux-points dans lesquels seront recherchés les bibliothèques. Comme pour --with-includes, à n'utiliser que si vous disposez de packages installés dans des emplacements non standards ;
• --enable-nls[=LANGUAGES] : active l'affichage des messages dans d'autres langues que l'anglais. LANGUAGES est une liste des codes à supporter séparés par des espaces. Si vous n'indiquez rien, toutes les traductions sont installées. Nécessite une implémentation de l'API Gettext ;
• --with-pgport=NUMBER : paramètre le numéro de port par défaut du serveur et des clients. Par défaut, vaut 5432. À n'utiliser que si vous voulez lancer plusieurs instances de PostgreSQL sur la même machine ;
• --with-perl : compile le langage PL/Perl côté serveur ;
• --with-python : compile le langage PL/Python côté serveur ;
• --with-tcl : compile le langage PL/Tcl côté serveur ;
• --with-tclconfig=DIRECTORY : chemin contenant les informations de configuration pour l'interfaçage avec Tcl situées dans le fichier tclConfig.sh. À utiliser si vous voulez utiliser une version de Tcl différente de celle installée ;
• --with-krb4, --with-krb5 : support de l'authentification Kerberos 4 ou 5, mais pas les deux ;
• --with-krb-srvnam=NAME : nom du service principal de Kerberos ;
• --with-openssl : support pour les connexions SSL (cryptées). Requiert le package OpenSSL ;
• --with-pam : support PAM (Pluggable Authentication Modules) ;
• --without-readline : évite l'utilisation de la bibliothèque Readline ce qui désactive l'historique des commandes et l'édition de la ligne en cours ;
• --with-rendezvous : support Rendezvous (recommandé sur Mac OS X) ;
• --disable-spinlocks : Permet de compiler PostgreSQL même si aucun support pour le spinlock CPU de la plateforme. Résulte en des performances médiocres ;
• --enable-thread-safety : rend les bibliothèques client thread-safe ;
• --without-zlib : évite l'utilisation de la bibliothèque Zlib. Désactive les archives compressées de pg_dump (à n'utiliser que si vous ne disposez pas de zlib) ;
• --enable-debug : inclut les informations de débogage dans les binaires et les bilbiothèques, uniquement pour le développement ;
• --enable-cassert : active les vérifications d'assertions, uniquement pour le développement ;
• --enable-depend ; active la surveillance automatique des dépendances. Les makefiles résultants forceront la recréation des binaires si un des headers a changé. Ne fonctionne que sur GCC, pour le développement ;
• comme pour les scripts configure classiques, vous pouvez paramétrer le compilateur via la variable d'environnement CC (par défaut, GCC est utilisé), les drapeaux du compilateur via CFLAGS, vous pouvez passer ces variables sur la ligne de commande (./configure CC=/opt/bin/gcc CFLAGS='-O2 -pipe').

Si vous n'êtes pas familier aux commandes Unix voici une description "en français" de ce que l'on a fait :

• on passe en root (administrateur) ;
• on ajoute l'utilisateur postgres, ce sera l'administrateur du serveur PostgreSQL (vous devrez entrer son mot de passe, choisissez-le bien) ;
• on donne la propriété des sources à cet utilisateur ;
• on se logue en tant qu'utilisateur postgres ;
• on lance la configuration automatique des sources (détection de la plate-forme, etc.), il est possible de passer plusieurs options à cette commande, pour plus d'informations, tapez ./configure --help. Si vous ne disposez pas de la bibliothèque libreadline, configure échouera, vous pouvez forcer la non-utilisation de libreadline via l'option --without-readline, mais il n'y aura plus d'historique des commandes ;
• il est également possible de configurer les différents répertoires utilisés par PostgreSQL (par défaut /usr/local/pgsql/) ;
• on lance la compilation ;
• make check effectue des tests de non-régression, cette étape est facultative ;
• on se déconnecte de l'utilisateur postgres, nous revenons donc au prompt root ;
• on installe les binaires que l'on vient de créer.

Une fois l'installation effectuée, il est nécessaire de paramétrer différentes variables d'environnement. Pour cela, il suffit d'ajouter les lignes suivantes au fichier /etc/profile (pour les shells type bash) :

# Modifiez les chemins si nécessaire

export LD_LIBRARY_PATH=/usr/local/pgsql/lib

# On a accès aux commandes de PostgreSQL sans les préfixer

export PATH=/usr/local/pgsql/bin :$PATH

Nous commençons par autoriser les utilisateurs à accéder aux binaires et à la documentation de PostgreSQL :

chmod o+rx /usr/local/pgsql

Il faut ensuite créer le répertoire qui contiendra les différentes bases de données et en donner la propriété à postgres :

mkdir /usr/local/pgsql/data

chown postgres /usr/local/pgsql/data

Puis, on initialise la base de données. L'option -A md5 demande le cryptage des mots de passe en MD5, l'option -W assigne un mot de passe au superutilisateur. Sans cela, tous les utilisateurs locaux peuvent avoir accès au serveur sans sécurité.

su postgres

initdb -D /usr/local/pgsql/data -A md5 -W

Afin de ne pas avoir à indiquer l'option -D à chaque démarrage du daemon, vous pouvez ajouter la variable PGDATA à l'environnement de l'utilisateur postgres, pour cela, il suffit d'ajouter la ligne suivante au fichier /home/postgres/.bash_profile :

export PGDATA=/usr/local/pgsql/data

Ce n'est pas nécessaire si vous lancez PostgreSQL comme service au démarrage de l'ordinateur.

Comme les développeurs de PostgreSQL sont gentils, ils ont préparé les scripts de démarrage pour différentes plateformes. Ceux-ci se trouvent dans le répertoire /usr/src/PG/contrib/start-scripts/. Par exemple sous Debian, on copiera le script linux vers /etc/init.d/postgres.

Il est nécessaire de modifier le script de démarrage afin de positionner différentes variables (des commentaires indiquent la zone où il peut être nécessaire d'apporter des modifications). Si vous n'avez rien changé, il n'est pas utile de modifier quoi que ce soit. Néanmoins, pour des questions pratiques, il peut être intéressant de personnaliser le fichier où PostgreSQL va enregistrer les différents événements :

# On crée le fichier où on va logger

touch /var/log/pgsql

chown postgres:postgres /var/log/pgsql

# On interdit l'écriture pour les autres (sécurité)

chmod go-w /var/log/pgsql

On positionne alors la variable PGLOG dans le script de démarrage pour pointer vers notre répertoire.

Ensuite il faut créer les liens symboliques pour que le service soit démarré aux bons niveaux d'exécution. Sous Debian update-rc.d postgres defaults. Sous Fedora regardez du côté de chkconfig.

Le serveur est maintenant prêt à être démarré. Pour cela, il suffit d'utiliser le script que l'on vient de mettre en place : /etc/init.d/postgres start.

Nous ne présentons ici que les options de configuration principales, pour une description complète, référez-vous à http://www.postgresql.org/docs/8.0/interactive/runtime-config.html.

Le fichier de configuration principal se nomme postgresql.conf, il se trouve normalement dans le répertoire de données de PostgreSQL (défini par la variable d'environnement PGDATA ou par l'option -D sur la ligne de commandes) mais il est possible de redéfinir son emplacement en utilisant l'option -c config_file=/path/vers/le/fichier. Il s'agit d'une liste de couples nom/valeur, éventuellement séparés par un signe égal. Le signe dièse (#) permet d'introduire des commentaires.

Les valeurs passées via la ligne de commande (option (-c nom=valeur)*) sont prioritaires par rapport à celles mentionnées dans le fichier postgresql.conf. Il est également possible pour le client de positionner la variable d'environnement PGOPTIONS (au même format que les options en ligne de commande). De plus, il est possible de définir des paramètres au niveau utilisateur ou base via les commandes ALTER ou au niveau session avec la commande SET.

IX-A-1. Emplacement des fichiers▲

IX-A-2. Paramètres de connexion▲

IX-A-3. Erreurs et journalisation▲

IX-A-4. Autres directives▲

Le fichier de configuration de l'identification au niveau hôte, traditionnellement nommé pg_hba.conf, contrôle l'authentification des clients. La commande initdb en crée un par défaut.

Le format du fichier pg_hba.conf est une suite d'enregistrements (un par ligne, les lignes blanches sont ignorées, il est possible d'inclure des commentaires précédés d'un signe dièse). Les enregistrements indiquent différents paramètres de connexion, le premier enregistrement qui correspond aux paramètres de connexion du client est sélectionné et si l'authentification échoue, la connexion est refusée.

Tout d'abord, on indique la méthode de connexion : local est une connexion via les sockets Unix, host une connexion TCP/IP avec ou sans SSL, hostssl/hostnossl sont identiques à host, mais correspondent respectivement à une connexion avec SSL et une connexion sans SSL.

Vient ensuite le nom de la ou des (séparés par des virgules) base(s) de données. Les valeurs spéciales all, sameuser et samegroup indiquent respectivement toutes les bases, les bases ayant le même nom que l'utilisateur et les bases ayant le même nom que le groupe de l'utilisateur. Un fichier contenant les noms des bases de données peut être indiqué en le préfixant par @.

Il faut ensuite indiquer le ou les utilisateur(s) autorisé(s) à se connecter. La valeur spéciale all peut là aussi être utilisée. Si plusieurs utilisateurs sont spécifiés, leur nom doit être séparé par des virgules.

Dans le cas où l'on utilise une méthode de connexion autre que local, il faut indiquer soit l'adresse CIDR (Classless Inter-Domain Routing), c'est-à-dire une adresse IP suivie d'un slash et du nombre de bits pour le masque (192.168.1.0/24 par exemple) ; soit une adresse IP suivie du masque de sous-réseau (192.168.1.0 255.255.255.0).

Puis, il faut préciser la méthode d'identification, qui peut être trust (aucune identification, pas de mot de passe), reject (refus de connexion), md5 (mot de passe MD5), crypt (à n'utiliser qu'avec les clients antérieurs à la version 7.5), password (mot de passe en clair), krb4 ou krb5 (Kerberos version 4 ou 5), ident (le nom d'utilisateur est obtenu par la méthode ident puis mis en relation avec une liste d'utilisateurs autorisés) ou pam (utilisation du service PAM).

Enfin, si vous choisissez la méthode d'identification ident, il faut indiquer le nom de la map utilisée pour déterminer si un utilisateur est autorisé à se connecter ou non. La valeur spéciale sameuser peut être utilisée pour indiquer qu'un utilisateur ne peut se connecter à la base que sous le nom renvoyé par ident. Les maps sont déclarées dans le fichier pg_ident.conf (ou dans le fichier indiqué par la directive ident_file) qui contient des enregistrements au format nom_map nom_utilisateur_ident nom_utilisateur_base. Lisez la page Authentification Methods pour plus d'informations. En particulier : "The Identification Protocol is not intended as an authorization or access control protocol." (cette méthode est donc peu conseillée).