Cómo instalar PostgreSQL y pgAdmin4 en Ubuntu 18.04 LTS

pgAdmin4 es una herramienta de gestión de PostgreSQL de código abierto diseñada para múltiples versiones de bases de datos PostgreSQL. pgAdmin4 ha sido creado con todas las características que se pueden encontrar en el servidor PostgreSQL. Escrito en python y jquery y se puede instalar en Windows, Mac y Linux. Proporciona múltiples modelos de implementación, se puede instalar como una aplicación de escritorio o una aplicación de servidor que se ejecuta detrás del servidor web como Apache2.

En este tutorial, vamos a mostrarte la instalación y configuración de pgAdmin4 ‘Modo Servidor’ en el servidor Ubuntu 18.04. El pgAdmin4 se ejecutará como un servicio uWSGI detrás del servidor web Apache, y cubriremos ambas instalaciones de pgAdmin4 desde el repositorio y desde la fuente.

Requisitos previos

Servidor Ubuntu 18.04
Privilegios de root
Conocimientos básicos de instalación de PostgreSQL

Instalar PostgreSQL en el servidor Ubuntu 18.04

Primero, vamos a mostrarte la instalación y configuración básica de la base de datos PostgreSQL en sí. Se puede instalar desde el repositorio oficial de PostgreSQL y desde el repositorio predeterminado de Ubuntu.

Si deseas instalar la base de datos PostgreSQL desde el repositorio oficial, agrega la clave y el repositorio de Postgres ejecutando los siguientes comandos.

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'

Después de eso, actualiza todos los repositorios e instala PostgreSQL.

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

Después de la instalación, inicia sesión en el usuario predeterminado llamado ‘postgres’ y ejecuta la interfaz de línea de comandos de PostgreSQL ‘psql’.

su - postgres  
 psql

Ahora agrega una nueva contraseña para el usuario Postgres ejecutando la siguiente consulta en la interfaz psql.

    ext{password postgres}  
 TIPO TU CONTRASEÑA

Instalar pgAdmin4 desde el repositorio

Por defecto, PostgreSQL proporciona su propio repositorio para instalar los paquetes de pgAdmin4.

1. Agregar el repositorio de PostgreSQL

Descarga la clave de PostgreSQL y agrega el repositorio ejecutando el siguiente comando.

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. Instalar pgadmin4

Después de eso, actualiza todos los repositorios disponibles e instala los paquetes de pgAdmin4 utilizando el comando apt a continuación.

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

Durante la instalación, se te pedirá la configuración del nombre de usuario de correo electrónico y la configuración de la contraseña.

Escribe tu propia dirección de correo electrónico que se utilizará como nombre de usuario.

Luego escribe la contraseña.

Una vez que la instalación esté completa, abre tu navegador web y escribe la dirección IP del servidor como se muestra a continuación.

http://10.9.9.15/pgadmin4/

Y se te mostrará la página de inicio de sesión de pgAdmin4. Inicia sesión con tu dirección de correo electrónico y contraseña.

Y obtendrás el panel de control de pgAdmin.

Instalar pgAdmin4 desde la fuente

Para instalar pgAdmin4 desde la fuente, necesitamos instalar algunas dependencias de paquetes en el sistema y configurar manualmente el servidor web Apache para servir el servicio uWSGI de pgAdmin4.

- Crear usuario y directorios

Primero que nada, queremos instalar pgAdmin4 en un usuario que no sea root. Así que necesitamos crear un nuevo usuario y crear algunos directorios para pgAdmin4.

Crea un nuevo usuario llamado ‘ahmad’ ejecutando el siguiente comando.

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

Ahora crea el directorio de registro de pgAdmin4 y los directorios de datos para las ‘sesiones’ y ‘almacenamiento’.

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

Después de eso, cambia el propietario de todos esos directorios al usuario ‘ahmad’.

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

- Instalar dependencias

Instala todas las dependencias de paquetes necesarias como Python, Python pip y virtualenv para la instalación de pgAdmin4 ejecutando los siguientes comandos.

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

Después de eso, instala el servidor web Apache2 y el mod_wsgi.

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

- Crear entorno virtual de Python

Para esta guía, vamos a instalar pgAdmin4 dentro de un entorno virtual de Python.

Inicia sesión en el usuario ‘ahmad’ y crea un nuevo entorno virtual de Python llamado ‘pgadmin4’.

su - ahmad  
 virtualenv pgadmin4

Ahora ve al directorio ‘pgadmin4’ y activa el entorno virtual.

cd pgadmin4/  
 source bin/activate

- Instalar pgadmin4

Dentro del entorno virtual de Python, descarga el archivo del paquete pgAdmin4 whl.

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

Luego instala el paquete usando el comando pip.

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

Espera a que se complete la instalación de pgAdmin4.

Para ejecutar pgAdmin4 en ‘Modo Servidor’, necesitamos agregar una configuración adicional al directorio de site-packages de Python.

Ve al directorio ‘lib/python-version/site-packages/pgadmin4’ y crea un nuevo archivo de configuración llamado ‘config_local.py’.

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

Pega la configuración a continuación.

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

Guarda y cierra.

Después de eso, ejecuta el script ‘setup.py’.

python setup.py

Y se te pedirá la configuración del correo electrónico y la contraseña del administrador. Escribe tus datos y la instalación de pgAdmin se completó.

Nota:

Si recibes una notificación sobre que el paquete ‘psycopg2’ será renombrado en la próxima versión, simplemente instala la versión binaria del paquete.

pip install psycopg2-binary

Después de eso, desactiva el entorno virtual de Python y cambia el propietario de los directorios de registro y datos de pgAdmin4 al usuario ‘www-data’.

deactivate

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

- Configurar Apache2

Para esta guía, el servidor web Apache2 se utilizará como un proxy inverso para la aplicación uWSGI pgAdmin4.

Ve al directorio ‘/etc/apache2/sites-available’ y crea un nuevo archivo de host virtual llamado ‘pgadmin4.conf’.

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

Cambia el ‘ServerName’ con tu propio nombre de dominio y pégalo en él.


    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
 
    
        WSGIProcessGroup pgadmin
        WSGIApplicationGroup %{GLOBAL}
        Require all granted

Guarda y cierra.

Ahora prueba la configuración y activa los hosts virtuales de pgAdmin4.

apachectl configtest  
 a2ensite pgadmin4

Asegúrate de que no haya errores, luego reinicia el servicio Apache2.

systemctl restart apache2

Finalmente, pgAdmin4 ahora está en funcionamiento como un servicio uWSGI detrás del navegador web Apache.

Ahora abre tu navegador web y escribe el nombre de dominio de pgadmin.

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

Y obtendrás la página de inicio de sesión de pgAdmin4 como se muestra a continuación.

Conectar a la base de datos PostgreSQL con pgAdmin4

Inicia sesión en el panel de control de pgAdmin4 usando tu dirección de correo electrónico y contraseña.

Ahora haz clic en el botón ‘Agregar Servidor’, escribe los detalles del servidor PostgreSQL al que deseas conectarte.

Y haz clic en ‘Guardar’.

Después de eso, obtendrás detalles sobre tu base de datos PostgreSQL en el panel lateral izquierdo.

Finalmente, pgAdmin4 ahora está instalado en Ubuntu 18.04

Enlaces

https://www.pgadmin.org/