Skip to content

Instantly share code, notes, and snippets.

@isaacarnault
Last active October 31, 2020 14:10
Show Gist options
  • Save isaacarnault/23be8dbe582af2cdaea7d2b4baa9f5e6 to your computer and use it in GitHub Desktop.
Save isaacarnault/23be8dbe582af2cdaea7d2b4baa9f5e6 to your computer and use it in GitHub Desktop.
PostgreSQL integration & setting up: an effective way
________ ________ ___ __ ___
|\_____ \|\ __ \|\ \|\ \ |\ \
\|___/ /\ \ \|\ \ \ \/ /|\ \ \
/ / /\ \ __ \ \ ___ \ \ \
/ /_/__\ \ \ \ \ \ \\ \ \ \ \
|\________\ \__\ \__\ \__\\ \__\ \__\
\|_______|\|__|\|__|\|__| \|__|\|__|
Ignore Azure and GCP. This gist was implemented on AWS.

isaac-arnault.png

PostgreSQL integration & setting up: one effective way

β€’ Database: PostgreSQL
β€’ Programming : Shell (bash), SQL
β€’ Cloud: AWS
β€’ OS : Linux
β€’ Distribution : this gist works on Ubuntu 19.10 eoan (on prem'), Ubuntu 18.04 LTS (AWS)

Gist writing, testing and debugging : 12 hrs - Author : Isaac Arnault - License : MITΒ©, 2020

Project Status: Concept – Minimal or no implementation has been done yet, or the repository is only intended to be a limited example, demo, or proof-of-concept.

The following gist is intended to Data Architects and is part of my AWS cloud series.
It will help you start with PostgreSQL on AWS.
Since Postgres is the one of the most advanced SQL or relational databases, you may want to consider it for a professional use.
Please fork it if you find this useful.

How is gist is structured

This gist is structured into 3 parts.
You are invited to take each part one after the other.

Part 1. Deploy PostgresSQL 12 on a Linux system using AWS EC2 (back-end)
Part 2. Deploy pgadmin4 on your EC2 instance to administrate your database (front)
Part 3. Start with PostgreSQL 12 on back-end (EC2) and check your tasks on pgAdmin4 (front-end)

Few words before we start

PostgreSQL is a free and open-source powerful relational database management system (RDBMS) designed to handle many workloads, from single VMs to datawarehouses.
If you are a Data Engineer or Data Architect you may be familiar with ACID properties of relational databases.
Please note that PostgreSQL guarantees Atomicity, Consistency, Isolation and Durability of your databases.

| Some useful resources
. Encyclopedical : https://en.wikipedia.org/wiki/PostgreSQL - English
. Practical : https://waytolearnx.com/2018/11/difference-entre-mysql-et-postgresql.html - French
. Tactical : https://fr.slideshare.net/EnterpriseDB/postgresql-12-what-is-coming-up-enterprise-postgres-day - English

Related tags

β€’ AWS
β€’ EC2
β€’ PostgreSQL
β€’ Postgres
β€’ pgAdmin4
β€’ SQL
β€’ RDBMS
β€’ Cloud computing

About the author : Isaac Arnault is Big Data Architect, https://isaacarnault.github.io.

Useful PostgreSQL Linux commands

Checking the service status

$ ubuntu@ipv4-public-address:~$ systemctl status postgresql.service
$ ubuntu@ipv4-public-address:~$ systemctl status postgresql@12-main.service
$ ubuntu@ipv4-public-address:~$ systemctl status postgresql@12-main.service

Troubleshooting

If pgAdmin 4 does not launch on your web browser :
Way to check if you receive traffic to your EC2 vm
Open a new Terminal window (Ctrl + Alt + T) and ping your EC2 instance's IPV4 public address :
If you receive some packets, this mean your VM is accepting traffic.
Please note that traffic restrictions on AWS may be caused by improper Security Group configuration: your EC2 instance should at least allow inbound traffic on port 22 (SSH) and outbound traffic on Http and Https.

πŸ”΄ See output

isaac-arnault-aws-20.png

Useful syntax

Create a user

mydatabase=# CREATE USER zaki WITH SUPERUSER LOGIN PASSWORD 'mypassword';

Check whether the user has been created or not

mydatabase=# \du

Log in with the user β€œzaki”

postgres@ip-v4-address:~$ psql su -l zaki
# OR
postgres@ip-v4-address:~$ psql -h localhost -d test -U zaki

Delete a user

postgres@ip-v4-address:~$ sudo deluser zaki

List all databases

mydatabase=# \l

Logout from your database

mydatabase=# \q

Logout from user "postgres"

postgres@ipv4-public-address:~$ exit

List all PostgreSQL packages

ubuntu@ipv4-public-address:~$ pdpkg -l | grep postgres

Delete all PostgreSQL packages

ubuntu@ipv4-public-address:~$ apt-get --purge remove package1 package2 packagen

Verify that all PostgreSQL packages are deleted

ubuntu@ipv4-public-address:~$ pdpkg -l | grep postgres

Remove PostgreSQL from your EC2 compute machine or Linux virtual machine

ubuntu@ipv4-public-address:~$ sudo apt-get --purge remove postgresql

Remove pgAdmin4 from your EC2 compute machine or Linux virtual machine

ubuntu@ipv4-public-address:~$ sudo apt autoremove pgadmin4
MIT License
Copyright (c) 2020 Isaac Arnault
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Part 1. Deploy PostgresSQL 12 on a Linux system using AWS EC2 (back-end)

  1. Log into your AWS console, https://signin.aws.amazon.com/.
    In order to enhance the security access of my root account, I have MFA activated on my AWS account. I advise you to do so.
πŸ”΄ See hint

Once logged into your account, click on EC2.

isaacarnault-aws.png

!! Please note that AWS has a new layout interface which is pretty cool !!

  1. Click on Instances > Launch instance
πŸ”΄ See hint

isaac-arnault-aws2.png

  1. Select Ubuntu Server 18.04 LTS (HVM)
πŸ”΄ See hint

isaac-arnault-aws-3.png

| Hint : You can perform installation of PostgreSQL 12 and pgAdmin4 on a Ubuntu 19.10 eoan distribution, which is not currently available on AWS.

  1. Choose a free tier eligible instance for the purposes of your test.

You may consider more robust instances plans if you want your database to support concurrent workloads.

πŸ”΄ See hint

instance.png

Review and Launch > Launch
Create a new key pair > Key pair name : PostgresKP > Download key pair
Click on Launch instances > View instances

πŸ”΄ See hint

isaac-arnault-aws-5.png

  1. Once your instance is deployed (2/2 checks), go to Actions > Instance settings > Change termination protection
    Click on "Yes, enable". This will prevent your EC2 instance to terminate accidentally.
πŸ”΄ See hint

isaac-arnault-aws-19.png

Now you are ready to go for some Shell commands.

  1. Connect to your EC2 instance using Open SSH on your Terminal

If you don't have `Open SSH` installed on your `Terminal`, use as follows:
sudo apt update
sudo apt install openssh-server

We have to remember that we've downloaded an Postgres.pem file earlier. We will now move this file to a newly created directory.

Ctrl + Alt + T # to open a new CLI window<br>
$ cd Desktop > $ mkdir SSH` # Creates an SSH directory to store our Key Pair (credentials)
$ cd Downloads` > `$ sudo mv /home/zaki/Downloads/Postgres.pem /home/zaki/Desktop>SSH`

Go to your SSH directory and check that the file persists there :

$ cd Desktop/SSH` > ls
  • We change the permissions to .pem file, ie:
$ chmod 400 PostgresKP.pem`
πŸ”΄ See hint

isaac-arnault-aws-6.png

  1. We can now connect to our EC2 instance
$ ssh -i "PostgresKP.pem" ubuntu@ec2-your-ipv4-public-address.compute-1.amazonaws.com
  • Type "yes" when prompted by the CLI
πŸ”΄ See output

isaac-arnault-aws-8.png


Important If you can't connect to your EC2 instance from SSH, feel free to retake another gist I posted months ago where I give you few other hints :
| * [Deploying a Wordpress site using AWS RDS and free tier EC2 instance - Hands-on](https://gist.github.com/isaacarnault/8c701f200699176e06362a1877909665)
  1. Check that everything is setting up correctly and start installing Postgres
$ lsb_release -a # this retrives information regarding your EC2 instance (your virtual compute machine)

Now you are ready to deep dive into PostgreSQL installation on AWS.

1. Install PostgreSQL server on your EC2 instance

To install PostgreSQL 12 perform as follows:

$ sudo su
$ wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add - # this will import GPG key and add PostgreSQL 12 repository into our Ubuntu EC2 machine
$ echo "deb http://apt.postgresql.org/pub/repos/apt/ `lsb_release -cs`-pgdg main" |sudo tee  /etc/apt/sources.list.d/pgdg.list # this will add add repository contents into our Ubuntu Ubuntu EC2 machine
$ sudo apt update
$ sudo apt -y install postgresql-12 postgresql-client-12 # this will install the latest available version

Once installation is complete, you can check your PostgreSQL server status.

2. Check PostgreSQL service status

$ cd
$ cd /etc/init.d
$ ./postgresql status

If PostgreSQL 12 was correctly installed and is active, you should have this :

πŸ”΄ See output

isaac-arnault-aws-9.png

If not, feel free to restart the server.

$ ./postgresql restart
$ ./postgresql status

We can also check all packages installed related to our PostgreSQL server by doing a grep command.

$ dpkg -l | grep postgres
πŸ”΄ See output

isaac-arnault-aws-10.png

3. Configure PostgreSQL server

$ sudo nano /etc/postgresql/12/main/postgresql.conf

Search for listen_addresses and replace as follows :

listen_addresses = '*'
πŸ”΄ See output

isaac-arnault-aws10.png Ctrl + S to save the conf file, Ctrl + X to exit.

4. Restart PostgreSQL service

$ sudo systemctl restart postgresql

After restarting PostgreSQL server, confirm the server is listening on port 5432 using a netstat command:

$ sudo netstat -antup | grep 5432
πŸ”΄ See output

isaac-arnault-aws11.png

5. Access PotgreSQL

$ sudo su -l postgres
$ psql
πŸ”΄ See output

isaac-arnault-aws-30.png

6. Secure PostgreSQL database

This step is very important because you might encounter restrictions if your database server is not properly set regarding users access.

6.1 Set password for Linux user (postgres)

$ sudo su
$ passwd postgres
πŸ”΄ See hint

isaac-arnault-aws-13.png

6.2 Set password for DB administrator (postgres)

su - postgres
psql
πŸ”΄ See hint

isaac-arnault-aws-14.png

6.3 Test PostgreSQL connection

πŸ”΄ See hint

isaac-arnault-aws-18.png

Now that you've installed PostgreSQL server on your EC2L instance and set both passwords for Linux user and DB administrator, you are ready to take part 2 of this gist.

Part 2. Deploy pgadmin4 on your EC2 instance to administrate your database (front-end)

After completing Part 1, you are now ready to install pgAdmin4 which will help you administrate your database and see jobs performed on your EC2 compute machine.

  1. Log into your EC2 instance in SSH (see Part 1 , 7) and perform as follows :
sudo apt update
sudo apt install pgadmin4 pgadmin4-apache2 -y

When prompted by your Terminal, leave settings as default and OK.

πŸ”΄ See output

isaac-arnault-aws-15.png

  1. Set initial pgAdmin4 password and OK.
πŸ”΄ See hint

isaac-arnault-aws-16.png

  1. Check if Apache service is started on your EC2 compute machine.
$ systemctl status apache2
  1. Allow http and https traffic from your EC2 compute machine to the Internet.
    See HINTS section part of this gist if you have problems displaying pgAdmin4 viewer on your browser.
sudo ufw allow http
sudo ufw allow https
πŸ”΄ See hint

isaac-arnault-aws-17.png

  1. Open your web browser and enter your IPv4 public address (you can find it on AWS on your EC2 console) and the listening port of pgAdmin4 which is 5432.
    | i.e: my-ipv4-address/pgadmin4/browser
    | use following login details to log into pgAdmin4
    ID: postgres@localhost Pwd: the one you've chosen upon PostgreSQL server configuration
πŸ”΅ See application

isaac-arnault-aws-21.png

  1. Once logged in, click on Servers > Add New Server
πŸ”΅ See application

isaac-arnault-aws-22.png

For server configuration set the following fields as follows:

Name : postgres
Hostname/address : localhost
Username : postgres
Password : the one you've chosen upon server configuration

πŸ”΅ See setting

isaac-arnault-aws-23.png

Then click on Save.
There you are !

πŸ”΅ See application

Your PostgreSQL server is setted correctly on your EC2 instance and accessible via pgAdmin4.
You can now take part 3 of this gist. You'll learn how to create a database, a table on your EC2 compute machine and perform some administration tasks via pgAdmin4.

Learn how to create a database and a table now that you've successfully completed Parts 1 and 2.

  1. Connect to your EC2 compute machine : open terminal and SSH to your EC2 instance
πŸ”΄ See output

isaac-arnault-aws-24.png

  1. Create new database
$ sudo su -l postgres
$ psql
postgres=# CREATE DATABASE github; # creates a database called github
postgres=# \l # lists all databases on your PostgreSQL server - you have a postgres database by default
πŸ”΄ See output

isaac-arnault-aws-26.png

  1. Go to pgAdmin4 and refresh your server : right click to refresh
    You should now be able to see your newly database githubcreated.
    Click on the Dashboard tab to see live charts related to your PostreSQL database server such as:

Transactions per second
Tuples in
Tuples out
Block I/O
PID

πŸ”΄ See output

isaac-arnault-aws-28.png

Right click on database github > properties, fill the comment section and click on Save.

πŸ”΄ See output

isaac-arnault-aws-28.png

  1. If we click on SQL tab, we'll have the SQL syntax of your database called "github".
πŸ”΄ See output

isaac-arnault-aws-30.png

  1. Let's go back to our EC2 instance compute machine to perform some Postgres commands.
    We'll now create our fist table in our github database.
postgres=# \c github # to allow user postgres to connect to the database "github"
postgres=# CREATE TABLE clients (
ID serial primary key,
NAME text,
SURNAME text,
GENDER text,
AGE integer,
COUNTRY text,
PURCHASE integer,
VENUE date
);
postgres=# SELECT * FROM clients;
πŸ”΄ See output

isaac-arnault-aws-31.png

Now we are going to insert multiple data into our clients table in just one SQL query :

INSERT INTO clients (ID, NAME, SURNAME, GENDER, AGE, COUNTRY, PURCHASE, VENUE) VALUES
    (1, 'Luiz', 'Marciano', 'Male', 45, 'Brazil', 1450.00, '1999-01-08'),
    (2, 'Maria', 'Kukushka', 'Female', 21, 'Belarus', 230.00, '2014-11-21'),
    (3, 'Manuel', 'Ortega', 'Male', 32, 'Spain', 1350.00, '2003-07-14'),
    (4, 'Gwendal', 'Dupond', 'Male', 32, 'France', 2825.00, '2010-02-17');    

For date/time types, feel free to check : https://www.postgresql.org/docs/9.1/datatype-datetime.html

πŸ”΄ See output

isaac-arnault-aws-32.png

Now let's go back to pgadmin4 and refresh our PostgreSQL server.

Go to databases > github > schema > tables we can see our clients table.
Right click on the table > View/Edit data > First 100 Rows
As we can see, our table clients is shown along with all data inserted using our EC2 compute machine.

πŸ”΄ See output

isaac-arnault-aws-33.png

If we click on the Statistics tab, we'll see some useful stats related to the table we've just created.

πŸ”΄ See output

isaac-arnault-AWS-34.png

If you are not technical and you would like to bypass the Command Line Interface, you can perform the same table creation task using pgAdmin4 available tools above the application.

isaac-arnault-aws-34.png

Now we have an EC2 compute machine and a PostgreSQL database running, as well as one table created... all fully operational and ready for production. Feel free to check the HINTS section of this gist to get other useful commands related to PostgreSQL.
Please fork this gist if you find it useful and for showing support. Many thanks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment