141 lines
3.4 KiB
ReStructuredText
141 lines
3.4 KiB
ReStructuredText
.. 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_service.conf
|
|
**********************
|
|
|
|
.. contents:: Table of Contents
|
|
|
|
|
|
Why Use It?
|
|
=====================
|
|
|
|
The pg_service.conf file allows you to connect your QGIS project using only a Service Name, so your password is not stored (even in in encrypted format) in your QGIS document.
|
|
|
|
|
|
This is particulary important with QGIS as a misconfigured qgis_mapserver or Apache/NGINX can cause the .qgis file to be downloaded rather than rendered in the browser.
|
|
|
|
|
|
|
|
Create File on Server
|
|
=====================
|
|
|
|
**1. Create the pg_service.conf file under the /etc/postgresql-common directory**
|
|
|
|
.. image:: _static/40-pg_service-1.png
|
|
|
|
.. image:: _static/spacer.png
|
|
|
|
|
|
**2. The contents of the file should be as below. Make sure to substitute your geouser password for the password show below**
|
|
|
|
.. image:: _static/40-pg_service-2.png
|
|
|
|
.. image:: _static/spacer.png
|
|
|
|
|
|
Test File on Server
|
|
===================
|
|
|
|
It's a good idea to test your file.
|
|
|
|
To do, su to user postgres::
|
|
|
|
root@suite:~# su - postgres
|
|
|
|
Issue psql service=geosuiteb::
|
|
|
|
postgres@suite:~$ psql service=geosuitedb
|
|
psql (15.3 (Ubuntu 15.3-1.pgdg22.04+1))
|
|
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, compression: off)
|
|
Type "help" for help.
|
|
geodb=>
|
|
|
|
You have now verified the pg_service.conf file is working correctly.
|
|
|
|
Create File on Desktop
|
|
=====================
|
|
|
|
**1. Copy the pg_service.conf file you created above to your desktop and note the location**
|
|
|
|
**2. Change the host to the hostname (or IP) of your GeoSuite server**
|
|
|
|
So, for example, if your GeoSuite is running on IP 1.2.3.4, your file would look as below::
|
|
|
|
|
|
[geosuitedb]
|
|
host=1.2.3.4
|
|
port=5432
|
|
dbname=geodb
|
|
user=geouser
|
|
password=Tristan1902
|
|
|
|
|
|
Register File
|
|
============
|
|
|
|
To registet the file, on Windows:
|
|
|
|
**1. Go to Control Panel and click on User Acccounts**
|
|
|
|
.. image:: _static/control-panel.png
|
|
|
|
.. image:: _static/spacer.png
|
|
|
|
**2. Click the User Acccounts link**
|
|
|
|
.. image:: _static/control-panel-2.png
|
|
|
|
.. image:: _static/spacer.png
|
|
|
|
**3. On the left menu, click "Change my environmental variables"**
|
|
|
|
.. image:: _static/control-panel-3.png
|
|
|
|
.. image:: _static/spacer.png
|
|
|
|
**4. In the Environmental Variables box click new. In the New User Variable box enter PGSERVICEFILE for Variable name and the location you saved the pg_service.conf file above as Variable value. Click OK**
|
|
|
|
.. image:: _static/control-panel-4.png
|
|
|
|
.. image:: _static/spacer.png
|
|
|
|
You have now registered your pg_service.conf file.
|
|
|
|
Test File on Desktop
|
|
======================
|
|
|
|
To test our pg_service.conf file on our desktop, start QGIS.
|
|
|
|
**1. On the left menu, click PostGIS and then right click "Add New Connection"**
|
|
|
|
.. image:: _static/30-qgis-2.png
|
|
|
|
.. image:: _static/spacer.png
|
|
|
|
**2. In the Create New PostGIS Connection box, give your connection and name enter your service name**
|
|
|
|
.. image:: _static/30-qgis-0-2.png
|
|
|
|
.. image:: _static/spacer.png
|
|
|
|
**3. Click the Test Connection button. You should see a success message at top as show below**
|
|
|
|
|
|
.. image:: _static/30-qgis-0-3.png
|
|
|
|
.. image:: _static/spacer.png
|
|
|
|
Congradualtions, you have successfully create a pg_service.conf file on your server and desktop
|
|
|
|
|
|
|
|
|
|
|