Le Monde de KrysKool - postgresql

Installation TinyERP 4.2 avec PostgreSQL 8.3

KrysKool — Sun, 25 May 2008 11:33:00 +0200

L'installation de TinyERP 4.2 (maintenant connu sous le nom de OpenERP) sous PostgreSQL 8.3 pose quelques soucis.

Depuis la version 8.3, certain CAST ne sont plus implicites, notamment ceux qui peuvent ramener des résultats inattendus. Dans la version de TinyERP 4.2 (4.2.2 actuellement) certaines requêtes avec des CAST implicites sur les dates étaient utilisés, ceux qui avec PostgreSQL 8.3 ramène un message d'erreur à l'utilisation de cette requête. La question que l'on se pose:

Doit on utiliser PostgreSQL 8.3 avec TinyERP 4.2.2 ?

La réponse est non, simplement que le version 4.2 de TinyERP est la version stable, il ne faut surtout pas toucher au code. Le Trunk du SVN fonctionne déjà avec la version 8.3, ainsi la prochaine version de OpenERP fonctionnera avec PostgreSQL 8.3.

Quelle version de PostgreSQL puis je utiliser ?

Avec TinyERP 4.2 il est possible d'utiliser PostgreSQL 7.4, 8.0, 8.1 et 8.2 sauf sous Windows ou les versions 8.0 et 8.1 ne sont plus maintenus. Sous Windows seule la version 8.2 est supporté.

08/09/2008 : Ceci n'est plus tout a fait vrai, voir ce billet pour les explications

Réinstallation PostgreSQL sous Windows XP

KrysKool — Mon, 31 Mar 2008 16:00:00 +0200

Lors de la réinstallation de PostgreSQL sous windows ou tout simplement l'installation d'une nouvelle version, il se peut que vous ayez eu ce message d'erreur

L'utilisateur 'postgres' n'a pas pu être créé : Le compte utilisateur existe déjà !
L'installation s'est terminée prématurément à cause d'une erreur.

Ce message d'erreur vous indique que l'utilisateur système Windows existe déjà, et donc par conséquent que sa création à échoué, si vous aviez mémorisé le mot de passe attribuer à ce compte, il vous suffit de le saisir, sinon il va falloir supprimer l'utilisateur avec la commande ci-dessous a lancer dans une fenêtre CMD avec les droits administrateurs.

net user postgres /DELETE

Ensuite il vous suffit de relancer l'installation, qui recréera le nouveau compte postgres.

Si vous avez également réinstallé PostgreSQL, lors de la précédente désinstallation, le répertoire de données se trouvant dans "Program Files\PostgreSQL\8.x\" (ou X est le numéro de version mineure) n'est pas supprimé, ce qui fait également échouer l'installation lors de la création du CLUSTER.

Base de données de test utilisée pour les articles du site

KrysKool — Wed, 12 Mar 2008 12:30:00 +0100

Afin de pouvoir réaliser les cours autour de PostgreSQL présent sur ce site, nous allons mettre en place un base de test contenant des données, et ainsi réaliser les exercices dans les mêmes conditions et obtenir les mêmes résultats.

La base de test utilisée, se nomme Pagila. Elle fait partie du projet DbSample sur pgFoundry.org vous pouvez la télécharger directement ici. La version 0.10 supporte la version 8.3 de PostgreSQL qui intègre nativement Tsearch2 (la recherche FullText native), les versions antérieurs de pagila nécessitait d'avoir tsearch2 d'activer ce qui n'était pas possible de faire sous Windows sans compilation.

L'installation de la base pagila se fera en ligne de commande. les utilisateurs de windows se réfèrerons a cet article pour utiliser correctement la méthode en ligne de commande, les utilisateurs sous Linux utiliserons l'utilisateur système postgres directement.

%PSQL%\createdb -U postgres -E UTF8 -e pagila

Lorsque vous allez valider cette commande, le mot de passe de l'utilisateur postgres vous sera demandé, et la base pagila sera crée avec un encodage en UTF8. La base de données est crée, nous allons pouvoir importer les données.

Positionnez vous dans le répertoire ou vous avez décompressez l'archive de Pagila, puis toujours en ligne de commande exécuter la commande suivante :

%PSQL%\psql -U postgres -d pagila -f pagila-schema.sql

une fois la touche entrée validé, le mot de passe de l'utilisateur postgres peut vous être demander, et ensuite vous verrez apparaître le retour de chaque commande, vérifier qu'aucun message d'erreur n'apparaît. a cet instant le schéma devant accueillir les données a été inséré dans la base pagila crée précédemment.

Nous allons maintenant y inséré les données à l'aide de cette commande.

%PSQL%\psql -U postgres -d pagila -f pagila-data.sql

Si pas de message d'erreur, notre base de test est prête, nous allons faire une petite requête de vérification dans psql. une fois connecté, exécuter la requête suivante

pagila=# SELECT title, description FROM film WHERE film_id=1;
      title       |                                           description
------------------+--------------------------------------------------------------------------------------------------
 ACADEMY DINOSAUR | A Epic Drama of a Feminist And a Mad Scientist who must Battle a Teacher in The Canadian Rockies
(1 row)

pagila=#

Installation de PostgreSQL 8.3 sous Windows XP

KrysKool — Tue, 26 Feb 2008 14:02:00 +0100

Cette documentation vous guide pas à pas dans l'installation de PostgreSQL, mais également lors de la première connexion à la base de données avec psql et pgAdmin 3.

Téléchargement.

Avant l'installation de PostgreSQL 8.3, nous devons au préalable le récupérer, pour cela nous allons le télécharger sur l'un des miroirs disponibles.

Lancement.

Un fois le téléchargement terminé, vous obtenez un fichier nommé postgresql-8.3.0-1.zip dans votre répertoire de destination. Décompresser le et vous obtiendrez la liste de fichier ci-dessous.

Puisqu'il s'agit de la première version stable de la version 8.3, il est pas conseiller d'exécuter une mise à jour avec upgrade.bat, à partir des versions RC ou Beta. Le script upgrade.bat ne peut en aucun cas servir à mettre à jour une 8.2 vers une 8.3. Il servira uniquement à la mise à jour de votre 8.3 lorsque de nouvelle versions correctives sortiront.

Afin d'eviter le plantage lors du démarrage du service PostgreSQL une fois installé, il convient de vérifier que le service windows Connexion secondaire est démarré.

Pour commencer l'installation de PostgreSQL 8.3, exécuter indifféremment SETUP.bat ou postgresql-8.3.msi (si votre environnement Windows est correctement installé, le fichier msi devrait déclencher l'installation.). Un fois lancer vous obtiendrez l'écran suivant.

Ecran d'accueil.

Ce premier écran va nous permettre de sélectionner la langue utiliser pour le reste de l'installation, nous allons bien évidement choisir « French / Français ». Nous allons également cocher la case « Write detailed installation log to postgresql-8.3.log in the current directory », ceci enregistrera des informations utiles pour un éventuel dépannage, si l'installation ne se déroulait pas correctement.

Pour poursuivre l'installation appuyer sur le bouton « Start ».

Ecran bienvenue en Français.

Sur cette écran, rien de bien compliquer, il suffit de suivre les instructions, et de cliquer sur « Suivant »

License

Cette écran détaille toutes les licenses inclus dans cette installation

Option d'installation

Les options par défaut sont suffisantes, pour avoir la gestion de la langue, activé également Support de la langue. les messages d'erreurs apparaîtrons également traduit, il sera possible au niveau de la session de les obtenir en Anglais, ce qui vous permettra d'avoir plus de resultat lors de la recherche de message d'erreur similaire dans votre moteur de recherche favori.

Configuration du service

PostgreSQL sous Windows est vu comme un service, celui a besoin d'avoir un compte utilisateur avec le minimum de droit, par defaut l'utilisateur crée se nomme postgres, il convient de mémoriser son mot de passe, qui vous permettra par la suite de faire cohabiter plusieurs versions de PostgreSQL, en utilisant le même utilisateur système pour démarrer les différents services.

Initialisation du cluster

psql dans une console Windows a besoin d'un encodage WIN1252. dans cette configuration coté serveur faut absolument choisir l'encodage UTF8. Par défaut un utilisateur postgres est crée dans la base de données, il s'agit du super utilisateur qui possèdent les pleins droits sur le cluster de base de données. Pour cette raison il faut bien mémoriser le mot de passe que vous lui attribuer, car celui ci servira à établir la première connexion à la base de données, en vue du crée votre première base, mais également un utilisateur lambda. Il est bien sur fortement conseiller de mettre un mot de passe différents de celui qui a servit à créer l'utilisateur local de la machine.

Ce message vous indique que vous avez activé la connexion TCP/IP et que votre serveur PostgreSQL est accessible à travers toutes les machines du réseau, pour en restreindre l'usage, consulter cette partie de la documentation.

Dans cette configuration il convient de choisir un mot de passe pour le super-utilisateur postgres qui ne soit pas identique au login.

Langages procéduraux

Les langages proceduraux (PL) peuvent être installer séparément, pendant l'installation ou ultérieurement. Par défaut PL/pgSQL est activé, cela signifie qu'il sera installé dans la base template1 qui est utilisé comme modèle lors de la création d'une nouvelle base de données. L'activation des case a coché pour les autres langages dépend si le module d'installation a détecté la présence des interpreteurs pour les différents langages.

Choix des contrib

Par défaut 2 contributions sont installés

Adminpack
Debugger

Si vous cochez d'autres contributions, celles-ci seront installés et activés par défaut, sinon elle seront juste installés dans le répertoire de contrib et leur activation se fera au travers de leurs scripts d'installation respectif (dans ce même répertoire se trouve également les scripts de désinstallations).

Progression de l'installation

L'installation ne devrait pas poser de soucis, sinon vous obtiendrez un message d'erreur explique, mais également une trace dans le fichier de log.

Fin d'installation

Voila PostgreSQL est fraichement installé sur votre environnement. sur ce dernier écran il vous est conseillé de vous inscrire à la liste psql-announce pour être informer des nouvelles mises à jour mais également des bugs ou correction de bug.

Première connexion.

Avec psql.

Pour la première connexion avec psql, faite Demarrer / Executer puis saisissez cmd. Lorsque la console est ouverte saisissez les lignes ci-dessous.

chcp 1252
set PSQL="c:\Program Files\PostgreSQL\8.3\bin"
%PSQL%\psql -U postgres

vous devriez obtenir l'écran ci-dessous, après avoir saisie le mot de passe de l'utilisateur postgres

Password for user postgres:
Welcome to psql 8.3.0, the PostgreSQL interactive terminal.

Type:  \copyright for distribution terms
       \h for help with SQL commands
       \? for help with psql commands
       \g or terminate with semicolon to execute query
       \q to quit

postgres=#

Avec pgAdmin III

Pour lancer pgAdmin3, aller sur Demarrer / Programmes / PostgreSQL 8.3 / pgAdmin3 Choisissez le serveur sur lequel vous souhaitez vous connecter, pour l'instant 1 seul est déclaré et faites un clic droit, puis Se connecter, vous pouvez maintenant naviguer dans l'arborescence, et commencer par créer un Utilisateur puis une base de données.

Utilisation de psql sous Windows

KrysKool — Mon, 27 Aug 2007 21:00:00 +0200

Sous Windows l'utilisation de psql n'est pas aussi pratique que sous Linux/BSD.

Il faut d'abord changer le codepage du terminal en CP 1252, mais également se rendre dans les propriété de la fenêtre et choisir la police Lucida Console en taille 14 et enregistrer les changement pour les fenêtres futures.

En prime un petit script qui fait ça automatiquement, et qui se connecte via un service, détaillé dans un article précédent.

chcp 1252
rem
rem Script pour lancer PSQL avec le bon codepage 
rem et aussi le service qui nous intéresse directement
rem
@echo off
set PSQL="C:\Program Files\PostgreSQL\8.2\bin"
set PGSERVICE=drupal
cls
echo **************************************************
echo * Nom du service psql actif : %PGSERVICE%        
echo **************************************************
echo *
%PSQL%\psql

Utilisation du fichier pg_service.conf pour se connecter à PostgtreSQL

KrysKool — Mon, 27 Aug 2007 17:21:00 +0200

Depuis la version 8.1 il existe une nouvelle méthode de connexion des applications qui se base sur la libpq utilisant un nom de service.

Auparavant on utilisait une chaine de connexion qui parfois était compilé avec les informations en dur

host=localhost user=toto password=tata dbname=drupal port=5432

la méthode utilisant la notion de service est beaucoup plus simple, il suffit de remplacer la chaine précédente par :

service=drupal

Il faut ensuite renseigner le fichier pg_service.conf avec les valeurs de la chaine précédente, le nom du service est placé entre [...].

# Commentaire du service DRUPAL
[drupal]
host=localhost 
user=toto 
password=tata 
dbname=drupal 
port=5432

si l'un des paramètres venait à changer il est plus simple d'ajuster le fichier pg_service.conf

il est possible d'indiquer l'emplacement de ce fichier grâce à la variable d'environnement PGSYSCONFDIR

par exemple sous Linux

$ PGSYSCONFDIR=/etc/postgresql
$ export PGSYSCONFDIR

Ou sous Windows

set PGSYSCONFDIR="C:\Program Files\PostgreSQL\8.2"

J'ai crée dans ce répertoire un sous dossier etc dans lequel j'ai mis le fichier pg_service.conf.

Pour vérifier que cela fonctionne avec psql, faite comme ci dessous

Sous Linux

$ PGSERVICE=drupal
$ PGSERVICE
$ psql

Sous Windows

set PGSERVICE=drupal
psql

La variable d'environnement PGSERVICE contient le nom du service auquel l'on souhaite se connecter, comme l'on exécute psql sans aucun paramètre celui regarde si cette variable d'environnement existe et s'y connecte.

Réalisation du paquet de pgBouncer sous Debian Sarge

KrysKool — Fri, 24 Aug 2007 10:21:00 +0200

pgPool premier du nom déstabilisant un de mes serveurs sous Debian Sarge, j'ai décidé de m'intéresser à pgBouncer.

On récupère tout d'abord les sources (version 1.0.8 lors de la rédaction de l'article)

# http://pgfoundry.org/frs/download.php/1399/pgbouncer-1.0.8.tgz

# tar zxvf pgbouncer-1.0.8.tgz

Il convient de vérifier que l'on dispose de la librairie libevent de développement

# apt-get install libevent-dev

ensuite les instructions standard

# ./configure
# make

si vous ne disposez pas des outils de création de paquet lancer

# apt-get install devscripts yada

ensuite l'on va réaliser le paquet source

# make deb

Si vous n'avez aucun message d'erreur vous avez le paquet Debian qui est disponible dans le répertoire précédent, il ne reste plus qu'a l'installer

# cd ..
# dpkg -i pgbouncer_1.0.8-1_i386.deb

Ensuite reporter à cette page pour l'installation

Il manque un script init.d pour pgBouncer il faut donc le lancer à la main.

Effacer les contenus des tables d'un schéma

KrysKool — Tue, 22 May 2007 22:00:00 +0200

Il est parfois utile d'effacer tous les jeux de test que l'on a effectué de la base de données avant le démarrage en production. le script ci dessous est à rejouer une fois celui-ci enregistrer

Le script ci dessous construit un fichier qui ferra un TRUNCATE des tables du schéma sélectionné.

SELECT 'TRUNCATE TABLE '||table_schema||'.'||table_name||';'
FROM   information_schema.tables 
WHERE  table_type='BASE TABLE' 
AND    table_schema='public';

cela donnera le résultat ci dessous.

TRUNCATE TABLE public.table1;
TRUNCATE TABLE public.table2;
TRUNCATE TABLE public.table3;

enregistrer ce script et rejouer le.

Changer les droits des tables pour un utilisateur

KrysKool — Fri, 11 May 2007 13:00:00 +0200

J'ai publié sur le site un astuce pour changer les droits d'un utilisateur sur toutesles tables d'un schéma suite a une demande utilisateur sur le salon #postgresqlfr.

La requête ci dessous permet de générer un script qui donne les droits SELECT à un utilisateur de la base PostgreSQL.

SELECT 'GRANT SELECT ON '||table_schema||'.'||table_name||' TO mon_user;'
FROM   information_schema.tables 
WHERE  table_type='BASE TABLE' 
AND    table_schema='public';

puis enregistrer le contenu retourner dans un fichier, et rejouer le script précédemment enregistrer.

Sortie de la 1.6 Beta 1 de PgAdmin 3

KrysKool — Fri, 15 Sep 2006 10:12:00 +0200

PgAdmin3, l'outil graphique de gestion de base de données PostgreSQL passe en version 1.6, on en ai qu'au stade de la Beta 1, donc amis testeur à vos claviers. Au sommaire plusieurs nouveautés dont

Un bloc note
Générateur de rapport XHTML ou XML

Voici quelques copies d'écran, avec celles bien sûr des nouveautés

L'écran principal.

La fenêtre d'exécution des requêtes.

Le générateur de rapport.

Installation de Dotclear 2 sous PostgreSQL

KrysKool — Thu, 17 Aug 2006 15:12:00 +0200

Dotclear 2 étant sortie en béta 2 fonctionnant sous PostgreSQL je me devais de le tester, l'installation se fait simplement en suivant les recommandations de la documentation.

Module mod_auth_pgsql

KrysKool — Tue, 06 Jul 2004 15:22:00 +0200

ce module permet d'ouvrir une fenêtre d'authentification (a l'aide d'un fichier .htaccess) et de vérifier les informations rentrées dans une base de données utilisateurs. Cette install est testée sous Debian Sarge

Pré-requis.

- Debian ou autre
- Apache
- PostgreSQL
- mod_auth_pgsql

Configuration d'Apache.

Dans cette partie l'on considère que Apache est déja installé et fonctionnel Tous d'abord nous installons le module Apache : Mod-Auth-Pgsql.

apt-get install libapache-mod-auth-pgsql

Ensuite nous devons utiliser

/usr/sbin/modules-config apache

Pour ajouter le chargement du module dans /etc/apache/modules.conf.
Cette manipulation n'a pas fonctionné correctement chez moi et je vous conseille de rajouter la ligne ci dessous si celle ci n'est pas présente dans votre fichier modules.conf.

LoadModule auth_pgsql_module /usr/lib/apache/1.3/mod_auth_pgsql.so

ensuite un rechargement de la configuration d'Apache pour prendre en compte ce nouveau module.

/etc/init.d/apache reload

Configuration PostgreSQL.

Du coté de PostgreSQL, il suffit de créer une table contenant un minimum de 2 champs (login, mot de passe).

Voici mon exemple.

CREATE TABLE users (
   id integer NOT NULL,
   login character varying(20) NOT NULL,
   nom character varying(20),
   prenom character varying(16),
   mail character varying(120),
   adresse character varying(50),
   codpos character(5),
   ville character varying(26),
   pays character varying(20),
   description text,
   gnupg character(40),
   passwd character varying(32) NOT NULL
);

Vous pouvez charger cette table via PHPPgAdmin .

Protection du répertoire.

Pour cela nous utilisons les .htaccess, voici en détail la configuration que j'utilise. Dans la base, mon mot de passe est crypter en MD5.

AuthName "Mon Reseau"
AuthType Basic
Auth_PG_host localhost
Auth_PG_port 5432
Auth_PG_user kryskool
Auth_PG_pwd xxxxxxxx
Auth_PG_database test
Auth_PG_pwd_table "users"
Auth_PG_uid_field login
Auth_PG_pwd_field passwd
Auth_PG_encrypted on
Auth_PG_hash_type MD5
<LIMIT GET POST>
       require valid-user
</LIMIT>

Il faut renseigner les champs suivants avec vos valeurs

Auth_PG_host : Nom ou adresse IP du serveur PostgreSQL
Auth_PG_port : Port utilisé, par default 5432
Auth_PG_user : Nom de l'utilisateur PostGresql
Auth_PG_pwd : Mot de passe de l'utilisateur
Auth_PG_database : Nom de la base de données
Auth_PG_pwd_table : Nom de la table ou sont stockées les utilisateurs
Auth_PG_uid_field : Nom du champ qui contient le Login de l'utilisateur
Auth_PG_pwd_field : Nom du champ qui contient les mot de passe
Auth_PG_encrypted : Si off les mot de passe sont stockés en clair dans la table (déconseillé)
Auth_PG_hash_type : Soit MD5 ou CRYPT

le reste est standard au fichier .htaccess
A noter qu'il existe le même module pour MySql et LDAP.