HowtoForge

Tutoriels Linux

Comment installer PostgreSQL et pgAdmin4 sur Ubuntu 18.04 LTS

pgAdmin4 est un outil de gestion PostgreSQL open source conçu pour plusieurs versions de bases de données PostgreSQL. pgAdmin4 a été créé avec toutes les fonctionnalités que l’on peut trouver sur le serveur PostgreSQL. Il est écrit en python et jquery et peut être installé sur Windows, Mac et Linux. Il offre plusieurs modèles de déploiement, peut être installé en tant qu’application de bureau ou en tant qu’application serveur fonctionnant derrière un serveur Web tel qu’Apache2.

Dans ce tutoriel, nous allons te montrer l’installation et la configuration de pgAdmin4 ‘Server Mode’ sur le serveur Ubuntu 18.04. pgAdmin4 fonctionnera comme un service uWSGI derrière le serveur Web Apache, et nous couvrirons les deux installations de pgAdmin4 à partir du référentiel et des sources.

Prérequis

  • Serveur Ubuntu 18.04
  • Privilèges de racine
  • Connaissances de base Installation de PostgreSQL

Installer PostgreSQL sur le serveur Ubuntu 18.04

Tout d’abord, nous allons te montrer l’installation et la configuration de base de la base de données PostgreSQL elle-même. Elle peut être installée à partir du dépôt officiel de PostgreSQL et du dépôt par défaut d’Ubuntu.

Si tu veux installer la base de données PostgreSQL à partir du référentiel officiel, ajoute la clé Postgres et le référentiel en exécutant les commandes suivantes.

wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
 sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt/ `lsb_release -cs`-pgdg main" >> /etc/apt/sources.list.d/pgdg.list'

Après cela, mets à jour tous les référentiels et installe PostgreSQL.

sudo apt update
 sudo apt -y install postgresql postgresql-contrib

Après l’installation, connecte-toi à l’utilisateur par défaut appelé ‘postgres’ et exécute l’interface de ligne de commande PostgreSQL ‘psql’.

su - postgres
 psql

Ajoute maintenant un nouveau mot de passe pour l’utilisateur Postgres en exécutant la requête suivante dans l’interface psql.

\password postgres
 TYPE YOUR PASSWORD

Installe pgAdmin4 à partir du référentiel

Par défaut, PostgreSQL fournit son propre référentiel pour installer les paquets pgAdmin4.

1. Ajoute le référentiel PostgreSQL

Télécharge la clé PostgreSQL et ajoute le référentiel en exécutant la commande suivante.

wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
 sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt/ `lsb_release -cs`-pgdg main" >> /etc/apt/sources.list.d/pgdg.list'

2. Installe pgadmin4

Ensuite, mets à jour tous les référentiels disponibles et installe les paquets pgAdmin4 à l’aide de la commande apt ci-dessous.

sudo apt update
 sudo apt install pgadmin4 pgadmin4-apache2 -y

Pendant l’installation, tu seras invité à configurer le nom d’utilisateur de l’email et le mot de passe.

Tape ta propre adresse e-mail qui sera utilisée comme nom d’utilisateur.

Puis tape le mot de passe.

Une fois l’installation terminée, ouvre ton navigateur Web et tape l’adresse IP du serveur comme ci-dessous.

http://10.9.9.15/pgadmin4/

Et tu verras apparaître la page de connexion de pgAdmin4. Connecte-toi avec ton adresse e-mail et ton mot de passe.

Et tu obtiendras le tableau de bord de pgAdmin.

Installer pgAdmin4 à partir de la source

Pour installer pgAdmin4 à partir des sources, nous devons installer certaines dépendances de paquets sur le système et configurer manuellement le serveur Web Apache pour qu’il serve le service uWSGI de pgAdmin4.

– Créer l’utilisateur et les répertoires

Tout d’abord, nous voulons installer pgAdmin4 sur l’utilisateur non-root. Nous devons donc créer un nouvel utilisateur et créer quelques répertoires pour pgAdmin4.

Crée un nouvel utilisateur appelé ‘ahmad’ en exécutant la commande suivante.

useradd -m -s /bin/bash ahmad
 passwd ahmad

Crée maintenant le répertoire de journal de pgAdmin4 et les répertoires de données pour les ‘sessions’ et le ‘stockage’.

mkdir -p /var/log/pgadmin4/
 mkdir -p /var/lib/pgadmin4/{sessions,storage}

Ensuite, change le propriétaire de tous ces répertoires pour l’utilisateur ‘ahmad’.

chown -R ahmad:ahmad /var/log/pgadmin4/ /var/lib/pgadmin4/

– Installe les dépendances

Installe toutes les dépendances nécessaires telles que Python, Python pip et virtualenv pour l’installation de pgAdmin4 en exécutant les commandes suivantes.

sudo apt install build-essential libssl-dev libffi-dev libgmp3-dev virtualenv python-pip libpq-dev python-dev -y

Ensuite, installe le serveur Web Apache2 et le mod_wsgi.

sudo apt install apache2 apache2-utils libapache2-mod-wsgi libexpat1 ssl-cert python -y

– Créer l’environnement virtuel Python

Pour ce guide, nous allons installer pgAdmin4 dans l’environnement virtuel Python.

Connecte-toi à l’utilisateur ‘ahmad’ et crée un nouvel environnement virtuel python nommé ‘pgamdin4’.

su - ahmad
 virtualenv pgadmin4

Va maintenant dans le répertoire ‘pgadmin4’ et active l’environnement virtuel.

cd pgadmin4/
 source bin/activate

– Installe pgadmin4

Dans l’environnement virtuel python, télécharge le fichier du paquet pgAdmin4 whl.

wget https://ftp.postgresql.org/pub/pgadmin/pgadmin4/v3.6/pip/pgadmin4-3.6-py2.py3-none-any.whl

Puis installe le paquet à l’aide de la commande pip.

pip install pgadmin4-3.6-py2.py3-none-any.whl

Attends l’installation de pgAdmin4.

Afin d’exécuter pgAdmin4 en ‘mode serveur’, nous devons ajouter une configuration supplémentaire au répertoire python site-packages.

Va dans le répertoire ‘lib/python-version/site-packages/pgadmin4’ et crée un nouveau fichier de configuration nommé ‘config_local.py’.

cd lib/python2.7/site-packages/pgadmin4/
 vim config_local.py

Colle la configuration ci-dessous.

LOG_FILE = '/var/log/pgadmin4/pgadmin4.log'
SQLITE_PATH = '/var/lib/pgadmin4/pgadmin4.db'
SESSION_DB_PATH = '/var/lib/pgadmin4/sessions'
STORAGE_DIR = '/var/lib/pgadmin4/storage'
SERVER_MODE = True

Enregistre et ferme.

Ensuite, exécute le script ‘setup.py’.

python setup.py

Tu seras invité à configurer l’email et le mot de passe de l’administrateur. Saisis tes coordonnées et l’installation de pgAdmin est terminée.

Remarque :

Si tu reçois une notification indiquant que le paquet ‘psycopg2’ sera renommé dans la prochaine version, installe simplement la version binaire du paquet.

pip install psycopg2-binary

Ensuite, désactive l’environnement virtuel python et change le propriétaire des répertoires de logs et de données de pgAdmin4 pour l’utilisateur ‘www-data’.

Désactiver

chown -R www-data:www-data /var/lib/pgadmin4/
 chown -R www-data:www-data /var/log/pgadmin4/

– Configurer Apache2

Pour ce guide, le serveur Web Apache2 sera utilisé comme proxy inverse pour l’application uWSGI pgAdmin4.

Va dans le répertoire ‘/etc/apache2/sites-available’ et crée un nouveau fichier d’hôte virtuel nommé ‘pgadmin4.conf’.

cd /etc/apache2/sites-available/
 vim pgadmin4.conf

Remplace le ‘ServerName’ par ton propre nom de domaine et colle-le dans le fichier.

<VirtualHost *:80>
    ServerName pgadmin.ahmad-labs.io
    LogLevel debug
    ErrorLog ${APACHE_LOG_DIR}/pgadmin-error.log
    CustomLog ${APACHE_LOG_DIR}/pgadmin-access.log combined

    LoadModule wsgi_module modules/mod_wsgi.so
    WSGIDaemonProcess pgadmin processes=1 threads=25 python-home=/home/ahmad/pgadmin4
    WSGIScriptAlias / /home/ahmad/pgadmin4/lib/python2.7/site-packages/pgadmin4/pgAdmin4.wsgi
 
    <Directory "/home/ahmad/pgadmin4/lib/python2.7/site-packages/pgadmin4/">
        WSGIProcessGroup pgadmin
        WSGIApplicationGroup %{GLOBAL}
        Require all granted
    </Directory>
</VirtualHost>

Enregistre et ferme.

Maintenant, teste la configuration et active les hôtes virtuels pgAdmin4.

apachectl configtest
 a2ensite pgadmin4

Assure-toi qu’il n’y a pas d’erreur, puis redémarre le service Apache2.

systemctl restart apache2

Enfin, pgAdmin4 est maintenant en place et fonctionne comme un service uWSGI derrière le navigateur Web Apache.

Ouvre maintenant ton navigateur Web et tape le nom de domaine pgadmin.

http://pgadmin.hakase-labs.io/

Et tu obtiendras la page de connexion de pgAdmin4 comme ci-dessous.

Connexion à la base de données PostgreSQL avec pgAdmin4

Connecte-toi au tableau de bord de pgAdmin4 en utilisant ton adresse email et ton mot de passe.

Clique maintenant sur le bouton ‘Ajouter un serveur’, tape les détails du serveur PostgreSQL auquel tu veux te connecter.

Et clique sur ‘Enregistrer’.

Après cela, tu obtiendras des détails sur ta base de données PostgreSQL sur le côté gauche du panneau.

Enfin, pgAdmin4 est maintenant installé sur Ubuntu 18.04

Liens

Vous aimerez aussi...