Table des matières

• Licence d'utilisation
• Introduction
• Installation des pré-requis
• Installation de PostgreSQL
• Installation Linux avec paquetages d'origine
• Installation Linux ou Windows avec le "One click installer"
• Configuration de connexion du serveur et des permissions des clients
• Installation de Python
• Installation de Python sur Linux avec paquetages d'origine
• Installation de Python sur Windows
• Création de la base de données
• Initialisation des chemins
• Linux
• Windows
• Utilisation de installateur_sgde.py
  • Exemple
Création des comptes utilisateurs de PosgreSQl et du SGDE /EDMS
• Différents types d'utilisateurs ou rôles
• Rôle groupe PostgreSQL
• Rôle de connexion (utilisateur) PostgreSQL
• Intervenant SGDE / EDMS
• Groupe SGDE / EDMS
• Informations complémentaires

Licence d'utilisation

    sgde / edms - Systeme de gestion de donnees environnementales / 
                 Environmental Data Management System
    Copyright (c) 2010 Peches et Oceans Canada / Fisheries and Oceans Canada

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.

Introduction

Installation des pré-requis

Installation de PostgreSQL

Installation Linux avec paquetages d'origine

  $>su -        # Devenir super utilisateur
  $>yum install postgresql postgresql-jdbc \
            postgresql-libs  postgresql-python  \
            postgresql-server

  $>yum install pgadmin*

  $>su -        # Devenir super utilisateur
  $>service postgresql stop

  $>su - postgres # Devenir usager postgres
  $>echo $PGDATA   # Devrait être: /var/lib/pgsql/data
  $>initdb

  $>export PGDATA=/var/lib/pgsql/data

  $>su - # devenir super utilisateur
  $>service postgresql start

  $>psql -U postgres          
  psql (8.4.3)
  Saisissez « help » pour l'aide.

  postgres=# alter user postgres with password '<<mot_de_passe>';
  ALTER ROLE
  postgres=# \q

  $>psql -U postgres -W
  Mot de passe pour l'utilisateur postgres : ******* 
  psql (8.4.3)
  Saisissez « help » pour l'aide.

  postgres=# \q
  

Installation Linux ou Windows avec le "One click installer"

Exempe d'installation de PostgreSQL 8.4 sous Linux Fedora Core 12 avec le "One click installer"

$> chmod +x postgresql-8.4.3-1-linux-x64.bin
$> ./postgresql-8.4.3-1-linux-x64.bin

Il suffit par la suite de suivre les instructions.

Une fois l'installation de base complétée, le "One click installer" démarrera l'installateur des modules complémentaires, le "Stack Builder".

On choisit alors l'option "PostgreSQL 8.4 sur le port 5432" afin d'obtenir une liste des modules complémentaires:

On peut alors sélectionner les modules désirés tels les pilotes JDBC et ODBC du menu "Database Drivers".

L'installation sous Windows est pratiquement identique. Seuls le téléchargement de l'installateur et le répertoire d'installation diffèrent. Sous Linux, l'installation se fera dans le répertoire /opt/PostgreSQL alors que sous Windows, le répertoire sera C:\Program Files (x86)\PostgreSQL.

Configuration de connexion du serveur et des permissions des clients

sous Windows dans:

C:\Program Files (x86)\PostgreSQL\8.4\data\

et sous Linux dans :

/opt/PostgreSQL/8.4/data/ (installation "One click installer")

/var/lib/pgsql/data/ (installation à partir de paquetages rpm)

Dans un premier temps, il faut éditer le fichier postgresql.conf pour indiquer au serveur sur quelle interface réseau il doit attendre les demandes de connexion. Pour ce faire, il faut ajuster le paramètre listen_addresses à la valeur désirée. Par exemple, pour que le serveur accepte à la fois des demandes de connexions provenant de la machine locale "localhost" et de l'interface réseau "132.215.29.12", on ajuste listen_addresses comme suit:

listen_addresses = '132.215.29.12,localhost'

#------------------------------------------------------------------------------
# CONNECTIONS AND AUTHENTICATION
#------------------------------------------------------------------------------

# - Connection Settings -

listen_addresses = '*'		# what IP address(es) to listen on;
					# comma-separated list of addresses;
					# defaults to 'localhost', '*' = all
					# (change requires restart)
port = 5432				# (change requires restart)

host    all         all         132.215.11.17/32          md5

# Put your actual configuration here
# ----------------------------------
#
# If you want to allow non-local connections, you need to add more
# "host" records. In that case you will also need to make PostgreSQL listen
# on a non-local interface via the listen_addresses configuration parameter,
# or via the -i or -h command line switches.
#



# TYPE  DATABASE    USER        CIDR-ADDRESS          METHOD

# "local" is for Unix domain socket connections only
local   all         all                               md5
# IPv4 local connections:
host    all         all         127.0.0.1/32          md5
# IPv6 local connections:
host    all         all         ::1/128               md5

Si on a fait l'installation à partir de paquetages (rpm), on peut redémarrer le serveur de la façon suivante:

  $>su - # devenir super utilisateur
  $>service postgresql restart

Installation de Python

Installation de Python sur Linux avec paquetages d'origine

  $>su -        # Devenir super utilisateur
  $>yum install python
  

Installation de Python sur Windows

Création de la base de données

   psql:script_creation_sgde.sql:32: ERROR:  role "groupe_sgde" already exists 
   psql:script_creation_sgde.sql:34: ERROR:  role "sgde" already exists
   psql:script_creation_sgde.sql:35: NOTICE:  role "sgde" is already a member of role "groupe_sgde"

Initialisation des chemins

Linux

   $>which python
   /usr/bin/python
   $>which psql
   /usr/bin/psql

   $>export PATH=${PATH}:/opt/PostgreSQL/8.4/bin
 

Windows

Utilisation de installateur_sgde.py

 
    $> <chemin_install>/installateur_sgde.py
     
 

    $>chcp 1252     # Passer à l'encodage Windows-1252
    $> <chemin_install>\installateur_sgde.py

Nom (ou adresse IP) du serveur de base de données:

Nom ou adresse IP de la machine sur laquelle a été installé le serveur PostgreSQL. Si l'installateur est exécuté sur la même machine que le serveur de bases de données, on utilise localhost comme nom de machine. Il n'y a pas de valeur par défaut.

Nom du rôle groupe pour votre SGDE [groupe_sgde]:

Chaque utilisateur de PostgreSQL fait partie d'un groupe duquel il hérite certains droits. Un rôle groupe n'a pas le droit de se connecter à une base de données Tous les utilsateurs du SGDE / EDMS doivent faire partie du groupe indiqué ici. Valeur par défaut: groupe_sgde

Nom du rôle utilisateur pour votre SGDE [sgde]:

L'installateur créera un premier utilisateur de PostgreSQL ayant le droit de se connecter et d'administrer le SGDE / EDMS. En plus, une nouvelle entrée sera ajoutée à la table intervenant de la base de données. Valeur par défaut: <sgde>

Mot de passe du rôle utilisateur pour votre SGDE [sgde]:

Mot de passe qui sera utilisé par l'utilisateur sgde pour se connecter à PostgreSQL. Valeur par défaut: sgde

Nom de la base de données pour votre SGDE [sgde]:

Nom qui sera attribué à la base de données. Une base de données PostgreSQL est le "contenant" à l'intérieur duquel sont regroupés des schémas. Valeur par défaut: sgde

Nom du schéma pour les données [sgde]:

Nom qui sera attribué au schéma à l'intérieur duquel seront créées les tables et procédures principales du SGDE / EDMS . Un schéma est le "contenant" à l'intérieur duquel on regroupe un ensemble de tables, fonctions, vues, etc. Valeur par défaut: sgde.

Nom du schéma pour les fonctions spatio-temporelles [st]:

Nom qui sera attribué au schéma à l'intérieur duquel seront conservées les fonctions et procédures spatio-temporelles du SGDE / EDMS. Valeur par défaut: st

Exemple

• Serveur de base de données : localhost
• Nom du rôle groupe : role_env
• Nom du rôle utilisateur (rôle de connexion): admin_env
• Mot de passe du rôle utilisateur : admin_env
• Nom de la base de données: bd_env
• Nom du schéma pour les données : bd_env
• Nom du schéma pour les fonctions spatio-temporelles: st_env

   $>./installateur_sgde.py
   Nom (ou adresse IP) du serveur de base de donnees: localhost
   Nom du role groupe pour votre SGDE [groupe_sgde]: role_env
   Nom du role utilisateur pour votre SGDE [sgde]: admin_env
   Mot de passe du role utilisateur pour votre SGDE [sgde]: admin_env
   Nom de la base de donnees pour votre SGDE [sgde]: bd_env
   Nom du schema pour les donnees [sgde]: bd_env
   Nom du schema pour les fonctions spatio-temporelles [st]: st_env

CREATE ROLE
CREATE ROLE
GRANT ROLE
CREATE DATABASE
GRANT
GRANT
GRANT

...

   $>psql -U admin_env -d bd_env -h localhost
   Mot de passe pour l'utilisateur admin_env : ******** 
   psql (8.4.3)
   Saisissez « help » pour l'aide.
   bd_env=>
   bd_env=>select * from version_sgde;
    seq_vers_sgde | no_vers_sgde | action_vers_sgde |   message_vers_sgde   
   ---------------+--------------+------------------+-----------------------
                1 |       1.0000 | Postgresql 8.1 + | SGDE-EDMS Version 1.0
   (1 ligne)

   bd_env=> select * from intervenant;
    acr_nom_int | seq_int |  nom_int  | coor_int | status_emploi| empl_int | mot_de_passe | courriel 
   -------------+---------+-----------+----------+--------------+----------+--------------+----------
    admin_env   |       1 | admin_env |          | indetermine  |          | BIDON        | 
   (1 ligne)

   bd_env=> select * from groupes_sgde;
    acr_nom_groupe | responsable | description 
   ----------------+-------------+----------------------------------------------
    admin_env      |             | 
    PUBLIC         | sgde        | Groupe pour acces public aux jeux de donnees
   (2 lignes)


   bd_env=> select * from intervenant_groupe;
    acr_nom_int | acr_nom_groupe 
   -------------+----------------
    admin_env   | admin_env
   (1 ligne)


   bd_env=> select count(*) from mot_dict;
    count 
   -------
      174
   (1 ligne)

   bd_env=>\q 
   $>
   

Création des comptes utilisateurs de PosgreSQl et du SGDE /EDMS

Différents types d'utilisateurs ou rôles

Rôle groupe PostgreSQL

   $>psql -U postgres  -h localhost -W
   Mot de passe pour l'utilisateur postgres : ******** 
   psql (8.4.3)
   Saisissez « help » pour l'aide.
   postgres=#CREATE ROLE groupe_sgde INHERIT NOSUPERSUER NOCREATEDB NOCREATEROLE;
   CREATE ROLE
   postgres=#
   postgres=#\q
   $>  

Rôle de connexion (utilisateur) PostgreSQL

  $>psql -U postgres  -h localhost -W
   Mot de passe pour l'utilisateur postgres : ******** 
   psql (8.4.3)
   Saisissez « help » pour l'aide.
   postgres=#CREATE ROLE sgde LOGIN INHERIT NOSUPERSUER CREATEDB CREATEROLE PASSWORD 'mot_de_passe';
   CREATE ROLE

   postgres=#GRANT groupe_sgde to sgde;
   postgres=#
   postgres=#\q
   $>  

   $>psql -U postgres -h localhost
   psql (8.4.4)
   Saisissez « help » pour l'aide.

   postgres=# \du
                       Liste des rôles
   Nom du rôle |        Attributs         |   Membre de   
   -------------+--------------------------+---------------
   groupe_sgde | Ne peut pas se connecter | {}
   postgres    | Superutilisateur         | {}
               : Créer un rôle              
               : Créer une base             
   sgde        | Créer un rôle            | {groupe_sgde}
               : Créer une base             
   postgres=# 
   postgres=#\q
   $>  

  $>psql -U postgres  -h localhost -W
   Mot de passe pour l'utilisateur postgres : ******** 
   psql (8.4.3)
   Saisissez « help » pour l'aide.
   postgres=#CREATE ROLE nouveau_role LOGIN INHERIT NOSUPERSUER NOCREATEDB NOCREATEROLE PASSWORD 'mot_de_passe';
   CREATE ROLE
   postgres=#GRANT groupe_sgde to nouveau_role;
   postgres=#\q
   $>  

Intervenant SGDE /EDMS

   $>psql -U sgde -h localhost
   Mot de passe pour l'utilisateur sgde : 
   psql (8.4.4)
   Saisissez « help » pour l'aide.

   sgde=> select * from intervenant;
    acr_nom_int | seq_int | nom_int | coor_int | status_emploi | empl_int | mot_de_passe | courriel 
   -------------+---------+---------+----------+--------------+----------+--------------+----------
    sgde        |       1 | sgde    |          | indetermine  |          | BIDON        | 
(1 ligne)

   $>psql -U sgde -h localhost
   Mot de passe pour l'utilisateur sgde : 
   psql (8.4.4)
   Saisissez « help » pour l'aide.
   sgde=> insert into intervenant(acr_nom_int,nom_int,status_emploi, mot_de_passe) values ('hamlet','hamlet','Prince du Danemark', 'BIDON');
   INSERT 0 1
   sgde=> insert into intervenant(acr_nom_int,nom_int,status_emploi, mot_de_passe) values ('othello','Othello','le Maure de Venise', 'BIDON');
   INSERT 0 1
   sgde=> select * from intervenant;
    acr_nom_int | seq_int |   nom_int    | coor_int | status_emploi      | empl_int | mot_de_passe | courriel 
   -------------+---------+--------------+----------+--------------------+----------+--------------+----------
    sgde        |       1 | sgde         |          | indetermine        |          | BIDON        | 
    hamlet      |       3 | hamlet       |          | Prince du Danemark |          | BIDON        | 
    othello     |       4 | Othello      |          | le Maure de Venise |          | BIDON        | 
    (3 lignes)
   sgde=>\q
   $>

Groupe SGDE /EDMS

   sgde=> select * from groupes_sgde;
    acr_nom_groupe | responsable |                 description                  
   ----------------+-------------+----------------------------------------------
    sgde           |             | 
    PUBLIC         | sgde        | Groupe pour acces public aux jeux de donnees
    hamlet         |             | 
    othello        |             | 
   (4 lignes)

   sgde=> select * from intervenant_groupe;
    acr_nom_int | acr_nom_groupe 
   -------------+----------------
    sgde        | sgde
    hamlet      | hamlet
    othello     | othello
    (3 lignes)

   sgde=>

   $>psql -U sgde -h localhost
   Mot de passe pour l'utilisateur sgde : 
   psql (8.4.4)
   Saisissez « help » pour l'aide.
   sgde=> insert into groupes_sgde(acr_nom_groupe,responsable,description) values ('Shakespeare','sgde','Pieces de Shakespeare');
   INSERT 0 1
   sgde=>

    sgde=> insert into intervenant_groupe (acr_nom_int,acr_nom_groupe) values('hamlet','Shakespeare');
    INSERT 0 1
    sgde=> insert into intervenant_groupe (acr_nom_int,acr_nom_groupe) values('othello','Shakespeare');
    INSERT 0 1
    sgde=>
    sgde=> select * from intervenant_groupe;
     acr_nom_int | acr_nom_groupe 
    -------------+----------------
     sgde        | sgde
     hamlet      | hamlet
     hamlet      | Shakespeare
     othello     | othello
     othello     | Shakespeare
    (5 lignes)

Informations complémentaires