GeoHelm/docs/components/pgtileserv/index.rst

295 lines
6.8 KiB
ReStructuredText
Raw Normal View History

2024-01-27 19:04:46 +00:00
.. This is a comment. Note how any initial comments are moved by
transforms to after the document title, subtitle, and docinfo.
.. demo.rst from: http://docutils.sourceforge.net/docs/user/rst/demo.txt
.. |EXAMPLE| image:: static/yi_jing_01_chien.jpg
:width: 1em
**********************
pg_tileserv
**********************
.. contents:: Table of Contents
About
==================
pg_tileserv is produced by Crunch Data (https://www.crunchydata.com/)
The documentation and examples provided are extensive (https://access.crunchydata.com/documentation/pg_tileserv/latest/)
We'll confine ourselves below to the usage and layout of the service in GeoSuite
pg_tileserv
==================
pg_tileserv is installed as a systemd service during installation.
The service can be started and stopped via command line or Webmin.
The service file contents are show below.
.. code-block:: console
[Unit]
Description=PG TileServ
After=multi-user.target
[Service]
User=pgis
WorkingDirectory=/opt/pg_tileserv
Type=simple
Restart=always
ExecStart=/opt/pg_tileserv/pg_tileserv --config /opt/pg_tileserv/config/pg_tileserv.toml
[Install]
WantedBy=multi-user.target
The file is installed at
.. code-block:: console
/etc/systemd/system/pg_tileserv.service
Command Line
============
Service commands:
.. code-block:: console
root@postgis:~# service pg_tileser stop | start
Access
============
pg_tileserv runs of port 7800 and can be accessed at http://doamin.com:7800
You can change the port via the pg_tileserv.toml file located under /opt/pg_tileserv/config
Webmin
============
To start and stop the pg_tileserv service, click the button as below.
.. image:: _static/pgtileserv.png
.. image:: _static/spacer.png
Database
=========
On installation, a database is created called postgisftw.
This database contains the demo data.
A user pgis is also created and given permission to the database.
The password for pgis is displayed at the end of installation as well as saved to /root/auth.txt
Loading Data
============
When loading data to any database for which you will use pg_tileserv, you MUST set a SRID
Without a declared SRID, pg_tileserv will not pick up the table.
.. image:: _static/set-SRID.png
.. image:: _static/spacer.png
Structure
==========
pg_tileserv is installed by default at
.. code-block:: console
/opt/pgtileserv
The directory structure is show below
.. code-block:: console
/opt/pg_tileserv
├── LICENSE.md
├── README.md
├── assets
   ├── index.html
    ├── preview-function.html
   └── preview-table.html
├── config
   ├── pg_tileserv.toml
   └── pg_tileserv.toml.example.save
└── pg_tileserv
Configuration File
==================
On installation, the pg_tileserv.toml configuration file is updated to include the postgisftw connection inforation
.. code-block:: console
DbConnection = "postgresql://pgis:G84iwLdL9jeyA7IiwkTmWhyHwKR41Qxz@localhost/postgisftw"
Enable SSL
==========
To enable SSL on pg_tileserv, follow the steps below
**1. Copy the fullchaim.pem and privkey.pem files from letsencrypt to the pg_tileserv directory**
.. code-block:: console
cp /etc/letsencrypt/live/domain.com/fullchain.pem /opt/pg_tileserv/fullchain.pem
cp /etc/letsencrypt/live/domain.com/privkey.pem /opt/pg_tileserv/privkey.pem
**2. Change to the /opt/pg_tileserv directory and chown the owner of the chain and key files to user pgis**
.. code-block:: console
cd /opt/pg_tileserv
chown pgis:pgis fullchain.pem
chown pgis:pgis privkey.pem
**3. Find the following lines in /opt/pg_tileserv/config/pg_tileserv.toml**
.. code-block:: console
# Accept connections on this port
HttpPort = 7800
# HttpsPort = 7801
**4. Update the lines to below**
.. code-block:: console
# Accept connections on this port
# HttpPort = 7800
HttpsPort = 7801
**5. Find the following lines in /opt/pg_tileserv/config/pg_tileserv.toml**
.. code-block:: console
# TlsServerCertificateFile = "server.crt"
# TlsServerPrivateKeyFile = "server.key"
**6. Update the lines to below**
.. code-block:: console
TlsServerCertificateFile = "fullchain.pem"
TlsServerPrivateKeyFile = "privkey.pem"
**7. Restart pg_tileserv to pick up changes**
.. code-block:: console
service pg_tileserv restart
or use the Restart button in the control panel
You should now be able to access pg_tileserv via:
https://yourdomain.com:7801
The postgisftw Database
========================
As part of the GeoSuite installation, a database, user, and password are created.
This database, postgisftw, is actually the demo database created for pg_tileserv, but we use it throughout the tutorials.
To connect to the database via SSH:
1. su to user postgres:
.. code-block:: console
su - postgres
postgres@lizmap-demo:~$
2. Start pgsql
.. code-block:: console
postgres@demo:~$ psql
psql (15.3 (Ubuntu 15.3-1.pgdg22.04+1))
Type "help" for help.
3. List database using \\l This will provide a list of database, as well as owners:
.. code-block:: bash
postgres=# \l
List of databases
Name | Owner | Encoding | Collate | Ctype | ICU Locale | Locale Provider | Access privileges
------------+----------+----------+---------+---------+------------+-----------------+-----------------------
geostore | postgres | UTF8 | C.UTF-8 | C.UTF-8 | | libc |
postgisftw | pgis | UTF8 | C.UTF-8 | C.UTF-8 | | libc |
postgres | postgres | UTF8 | C.UTF-8 | C.UTF-8 | | libc |
template0 | postgres | UTF8 | C.UTF-8 | C.UTF-8 | | libc | =c/postgres +
| | | | | | | postgres=CTc/postgres
template1 | postgres | UTF8 | C.UTF-8 | C.UTF-8 | | libc | =c/postgres +
| | | | | | | postgres=CTc/postgres
(5 rows)
(END)
4. Connect to the postgisftw datbase using the \\c command
.. code-block:: console
postgres=# \c postgisftw
You are now connected to database "postgisftw" as user "postgres".
5. List the tables in the database using the \\dt command
.. code-block:: bash
postgisftw=# \dt
List of relations
Schema | Name | Type | Owner
--------+-------------------+-------+----------
public | configuration | table | pgis
public | countries | table | pgis
public | pointsofinterest | table | pgis
public | spatial_ref_sys | table | postgres
public | ways | table | pgis
public | ways_vertices_pgr | table | pgis
(8 rows)
postgisftw=#
========================
Documentation
==================
https://access.crunchydata.com/documentation/pg_tileserv/latest/