Missing pre-requisites for QGIS Server installation documentation

[MarkSetchell]

Missing pre-requisites for QGIS Server installation documentation

Page URL: https://docs.qgis.org/3.4/en/docs/training_manual/qgis_server/install.html

Section 12.1.3 seems to assume several things exist without showing how to create them or where they come from or what they contain.

• It assumes there is a directory called /home/qgis. Am I supposed to have run adduser qgis or some other command? Does the qgis user have to have a specific uid or a specific groupid?

• It assumes there is a file called /home/qgis/projects/world.qgs. Who creates that, how, with what content?

• It assumes some authorisation file exists as /home/qgis/qgisserverdb/qgis-auth.db. Who creates that, how?

• It assumes there is a config and password file in /home/qgis/.pg_service.conf and /home/qgis/.pgpass Who creates those? How?

Then later on in a "Note" is says myhost.conf and /etc/hosts must be configured. It doesn't tell me where to find myhost.conf nor what is supposed to be in it.

[tudorbarascu]

@MarkSetchell Hello! Thank you for trying QGIS Server.

For the /home/qgis part it's just just an example. You can have your own directory, e.g. /home/mark.. but you need to change all the /home/qgis parts to /home/mark.

You need to download the demo data as shown here: https://docs.qgis.org/3.4/en/docs/training_manual/qgis_server/wms.html

The myhost part is clearly written: In order to setup the virtual host the simplest way would be to make a myhost.conf file in the /etc/apache2/sites-available directory that has the same content as qgis.demo.conf except for the ServerName line that should be ServerName myhost.
.

There is a comment on the .pg_service.conf part, right above it # See https://docs.qgis.org/testing/en/docs/user_manual/working_with_vector/supported_data.html#pg-service-file SetEnv PGSERVICEFILE /home/qgis/.pg_service.conf.

Just follow the link in the comment to see how they're configured.
The pg_service.conf and .pgpass are optional, in case you want to use them for pg connections.

It assumes some authorisation file exists as /home/qgis/qgisserverdb/qgis-auth.db. Who creates that, how?

Those are created by qgis server automatically.

The tutorial assumes basic knowledge on web services/virtual hosts etc. If that exists it's easy to follow.

Hope this helps,
Pull request would be nice to enhance the docs!

All the best,
Tudor