The PostgreSQL Apt Repository now hosts installs of PostGIS, pgRouting, in addition to Postgresql and PGAdmin.
The following describes how to install Postgresql 9.6, PostGIS 2.3, pgRouting 2.3, PGAdmin on Ubuntu version 16.04. It is assumed to also work on Linux Mint, Lubuntu, and Xubuntu.
Run these in terminal:
Verify what version of Ubuntu you are running
sudo lsb_release -a
Add Respository to sources.list
You'll need to replace the nickname below with what you are running. Note to replace the word trusty with whatever version lsb states
Helper on http://www.postgresql.org/download/linux/ubuntu/
For xenial (16.04.2 LTS)
sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt xenial-pgdg main" >> /etc/apt/sources.list'
Add Keys
wget --quiet -O - http://apt.postgresql.org/pub/repos/apt/ACCC4CF8.asc | sudo apt-key add -
sudo apt-get update
Install
The following will install postgresql 9.6, PostGIS 2.3, PGAdmin4, pgRouting 2.3 and additional supplied modules including the adminpack extension:
sudo apt-get install postgresql-9.6 sudo apt-get install postgresql-9.6-postgis-2.3 postgresql-contrib-9.6 postgresql-9.6-postgis-scripts #to get the commandline tools shp2pgsql, raster2pgsql you need to do this sudo apt-get install postgis
To get pgRouting
# Install pgRouting 2.3 package sudo apt-get install postgresql-9.6-pgrouting
Enable Adminpack
While in terminal, log in to the psql console as postgres user:
sudo -u postgres psql
CREATE EXTENSION adminpack;
Never install PostGIS in the postgres database, create a user database You can also enable the PostGIS extension here (or with the GUI as described below):
sudo -u postgres psql
CREATE DATABASE gisdb; \connect gisdb; CREATE SCHEMA postgis; ALTER DATABASE gisdb SET search_path=public, postgis, contrib; \connect gisdb; -- this is to force new search path to take effect CREATE EXTENSION postgis SCHEMA postgis; SELECT postgis_full_version();
should give you output something like this:
postgis_full_version --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- POSTGIS="2.3.2 r15302" GEOS="3.5.0-CAPI-1.9.0 r4084" PROJ="Rel. 4.9.2, 08 September 2015" GDAL="GDAL 1.11.3, released 2015/09/16" LIBXML="2.9.3" LIBJSON="0.11.99" RASTER (1 row)
Installing postgis_sfcgal, if you need advanced 3D support
CREATE EXTENSION postgis_sfcgal SCHEMA postgis; SELECT postgis_full_version();
should give you:
postgis_full_version ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ POSTGIS="2.3.2 r15302" GEOS="3.5.0-CAPI-1.9.0 r4084" SFCGAL="1.2.2" PROJ="Rel. 4.9.2, 08 September 2015" GDAL="GDAL 1.11.3, released 2015/09/16" LIBXML="2.9.3" LIBJSON="0.11.99" RASTER (1 row)
Install pgRouting
CREATE EXTENSION pgrouting; SELECT * FROM pgr_version();
should give you:
version | tag | hash | branch | boost ---------+--------+-----------+--------+-------- 2.3.2 | v2.3.2 | 1f2af3c52 | master | 1.58.0 (1 row)
Exit the psql console:
\q
Open Access to Clients
If you need to allow access from external, you can do this as well
sudo -u postgres psql
ALTER SYSTEM SET listen_addresses='*'; \q
You may need to edit to pg_hba.conf and/or pg_ident.conf to allow external access
sudo nano /etc/postgresql/9.6/main/pg_hba.conf
If you need external access, scroll to the bottom of the pg_hba.conf file and add a line like this (which willa llow all clients with md5 password encrypt authentication (right after the local rules):
hostssl all all 0.0.0.0/0 md5
Click CTRL-X to save your changes, Y to write them to the file, and enter to exit.
If you change ip or port, you need to do a service restart.
sudo service postgresql restart
Note: you can also do from postgres psql console with below - only for changes that don't require restart)
SELECT pg_reload_conf();
Optional: check location of configuration files:
From the psql console(see above):
SELECT name, setting FROM pg_settings where category='File Locations';
Which will output something like:
name | setting
-------------------+------------------------------------------
config_file | /etc/postgresql/9.6/main/postgresql.conf
data_directory | /var/lib/postgresql/9.6/main
external_pid_file | /var/run/postgresql/9.6-main.pid
hba_file | /etc/postgresql/9.6/main/pg_hba.conf
ident_file | /etc/postgresql/9.6/main/pg_ident.conf
(5 rows)
Create new PGSQL user
You can create a new database super user to use instead of the default postgres user.
While in terminal, run:
sudo -u postgres psql CREATE ROLE mysuperuser LOGIN PASSWORD 'whatever' SUPERUSER;
Import SHP files using shp2pgsql-gui
Another handy piece of software shp2pgsql-gui tool. This will allow you to quickly connect to your new PostGIS database and import a Shapefile.
Note this will only work if you have Ubuntu with a desktop (not a headless Ubuntu)
Open terminal, and type:
sudo apt-get install postgis-gui
(Note: this is coming from the main Ubuntu software repository, as it seems the PostgreSQL APT repository doesn't package SHP2PGSQL-GUI anymore...)
Now open the SHP2PGSQL application:
shp2pgsql-gui
Follow the on-screen prompts to load your data.
For more information, visit the Boston GIS tutorial in the section "Load Towns Data"
ogr_fdw foreign data wrapper for spatial data
Unfortunately seems PostgreSQL Apt does not include ogr_fdw spatial data wrapper. The wrapper utilizes GDAL, so much of plumbing needed is already installed for you as part of PostGIS. Compiling isn't too difficult. On a vanilla Ubuntu, I was able to compile and install with following:
#for compiling ogr_fdw cd ~/ mkdir sources cd sources sudo apt-get install git sudo apt-get install postgresql-server-dev-9.6 sudo apt-get install make sudo apt-get install gcc sudo apt-get install libgdal1-dev sudo git clone -b master https://github.com/pramsey/pgsql-ogr-fdw.git pgsql_ogr_fdw cd pgsql_ogr_fdw export PATH=/usr/lib/postgresql/9.6/bin:$PATH make && make install
After you're done compiling and installing the binary, you can install the ogr_fdw extension in your database
sudo -u postgres psql
\connect gisdb;
CREATE EXTENSION ogr_fdw SCHEMA postgis;
CREATE SCHEMA IF NOT EXISTS staging ;
-- here I assume you have a file in root of /gis_data folder that postgres process has read rights to
-- any file that gdal can read will do e.g shape file, CSV, etc
CREATE SERVER svr_shp
FOREIGN DATA WRAPPER ogr_fdw
OPTIONS (
datasource '/gis_data',
format 'ESRI Shapefile' );
-- this will link in all your shapefile tables in folder gis_data as foreign tables
IMPORT FOREIGN SCHEMA ogr_all
FROM SERVER svr_shp INTO staging;
