9. Troubleshooting

You finished setup, but application is not working. Following list will help you diagnose a problem.

Links bellow are using default configurations for gisapp, QGIS Server,...

GENERAL

1. Check requirements page again. If you are using too old versions of Apache, PHP and PostgreSQL first fix that.

QGIS SERVER

2. Test direct call to QGIS Server - http://localhost/cgi-bin/qgis_mapserv.fcgi?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities

You should see standard OGC WMS GetCapabilities XML document.

3. Test QGIS Server call to helloworld project (correct your port and path locations if necessary)

Linux: http://localhost/cgi-bin/qgis_mapserv.fcgi?SERVICE=WMS&VERSION=1.3&REQUEST=GetProjectSettings&map=/var/www/html/gisapp/_demo/helloworld.qgs

Windows: http://localhost:8080/cgi-bin/qgis_mapserv.fcgi.exe?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetProjectSettings&map=c:/Apache24/apache/www/gisapp/_demo/helloworld.qgs

EXT. QWC

4. Log out - http://localhost/gisapp/admin/login.php?action=logout

This clears all session data if you are still logged in.

5. Open cache settings and click on Clear all cache http://localhost/gisapp/admin/cache.php

This clears all QGIS Server cached data generated by EQWC (qgis server has internal caching which is not related to this).

6. Try Hello world example - http://localhost/gisapp/helloworld, login as guest.

In case of problems:

• hit CTRL+F5 to hard reload client cached files in browser and try again. Might be problem with old versions.

• open Cache settings page http://localhost/gisapp/admin/cache.php - and click on view for helloworld GetProjectSettings link. It should be same as nr. 3.

• if there is no error message, look for errors in logs: Apache web server, QGIS server and PostgreSQL.

  If this is working, you have correctly setup QGIS Server, Database and settings.php.