[QGIS Commit] r15905 - in docs/trunk/english_us/user_guide: . qgis_server_images

Sun Aug 14 12:29:57 EDT 2011

Author: dassau
Date: 2011-08-14 09:29:57 -0700 (Sun, 14 Aug 2011)
New Revision: 15905

Added:
   docs/trunk/english_us/user_guide/qgis_server_images/standard_wms_usa.png
   docs/trunk/english_us/user_guide/qgis_server_images/wms_server_definition.png
   docs/trunk/english_us/user_guide/qgis_server_images/wms_server_project.png
Modified:
   docs/trunk/english_us/user_guide/qgis_server.tex
   docs/trunk/english_us/user_guide/qgis_style.sty
Log:
added sample qgis server installation

Modified: docs/trunk/english_us/user_guide/qgis_server.tex
===================================================================

--- docs/trunk/english_us/user_guide/qgis_server.tex	2011-08-10 12:09:18 UTC (rev 15904)
+++ docs/trunk/english_us/user_guide/qgis_server.tex	2011-08-14 16:29:57 UTC (rev 15905)
@@ -5,9 +5,8 @@
 
 % when the revision of a section has been finalized,
 % comment out the following line:
-\updatedisclaimer
+% \updatedisclaimer
 
-% Ripped off working_with_ogc.tex (SH: 20110330)
 QGIS Server is an open source WMS 1.3 implementation which, in addition,
 implements advanced cartographic features for thematic mapping. The QGIS
 Server is a FastCGI/CGI (Common Gateway Interface) application written in
@@ -44,10 +43,72 @@
 \item \url{http://linfiniti.com/2010/08/qgis-mapserver-a-wms-server-for-the-masses/}
 \end{itemize}
 
-\section{Installation under Linux}
+\section{Sample installation on Debian Squeeze}
 
 At this point we will give a short and simple sample installation howto for 
-Debian Squeeze. Many other OS provide packages for QGIS Server, too. If you have to 
-build it all from source, please refer to the URLs above.  
+Debian Squeeze. Many other OS provide packages for QGIS Server, too. If you 
+have to build it all from source, please refer to the URLs above.
 
+Apart from qgis and qgis-mapserver you need a webserver, in our case apache2. 
+You can install all packages with aptitude or apt-get install together 
+with other necessary dependency packages.
+
+After installation you should test, if the webserver and qgis server works as 
+expected. 
+
+Make sure the apache server is runnung with '/etc/init.d/apache2 start'. Open 
+a web browser and type URL: http://localhost. If apache is up, you should see 
+the message 'It works!'.
+
+Now we test the qgis server installation. The qgis\_mapserv.fcgi is available at 
+/usr/lib/cgi-bin/qgis\_mapserv.fcgi and provides a standard wms that shows the 
+state boundaries of the Unites States of America \ref{fig:usa_wms}. Add 
+the WMS with the URL http://localhost/cgi-bin/qgis\_mapserv.fcgi as described 
+in section \ref{sec:ogc-wms-servers}.
+
+\begin{figure}[ht]
+\centering
+\includegraphics[clip=true, width=9cm]{standard_wms_usa}
+\caption{Standard WMS with USA boundaries included in the qgis server \nixcaption}
+\label{fig:usa_wms}
+\end{figure}
+
+\section{Creating a WMS from a QGIS project}
+
+To provide a new qgis wms server we have to create a qgis project file with some 
+data. Here we use the 'regions' and the 'aiport' shapefiles from the 
+qgis\_sample\_dataset. 
+
+First load the shapefiles and define the colors and styles of the layers in 
+QGIS and define the project CRS, if not already done. In a next step open the 
+\tab{WMS Server} tab under \mainmenuopt{Settings} \arrow \mainmenuopt{Project 
+Properties} and define the fields 'Service Capabilities', 'Coordinate System 
+Restrictions' and 'Advertised Extend'. Additionally you can enable the checkbox 
+\checkbox{Add WKT geometry to feature into response} to make the layers 
+queryable (see figure \ref{fig:wmsdefinition}). Now save the session in a 
+project file 'alaska\_airports.qgs'. 
+
+\begin{figure}[ht]
+\centering
+\includegraphics[clip=true, width=9cm]{wms_server_definition}
+\caption{Definitions for a qgis project WMS server \nixcaption}
+\label{fig:wmsdefinition}
+\end{figure}
+
+To provide the project as a WMS, we create a new folder '/usr/lib/cgi-bin/project' 
+with admin privileges and add the project file 'alaska\_airports.qgs' and a copy 
+of the qgis\_mapserv.fcgi file - that's all.
+
+Now we test our project WMS, add the WMS with the URL 
+http://localhost/cgi-bin/project/qgis\_mapserv.fcgi as described in section 
+\ref{sec:ogc-wms-servers} to QGIS and load the WMS, see figure 
+\ref{fig:wmsproject}.
+
+\begin{figure}[ht]
+\centering
+\includegraphics[clip=true, width=\textwidth]{wms_server_project}
+\caption{QGIS WMS Server based on a qgis project \nixcaption}
+\label{fig:wmsproject}
+\end{figure}
+
 \FloatBarrier

Added: docs/trunk/english_us/user_guide/qgis_server_images/standard_wms_usa.png
===================================================================
(Binary files differ)


Property changes on: docs/trunk/english_us/user_guide/qgis_server_images/standard_wms_usa.png
___________________________________________________________________
Added: svn:mime-type
   + application/octet-stream

Added: docs/trunk/english_us/user_guide/qgis_server_images/wms_server_definition.png
===================================================================
(Binary files differ)


Property changes on: docs/trunk/english_us/user_guide/qgis_server_images/wms_server_definition.png
___________________________________________________________________
Added: svn:mime-type
   + application/octet-stream

Added: docs/trunk/english_us/user_guide/qgis_server_images/wms_server_project.png
===================================================================
(Binary files differ)


Property changes on: docs/trunk/english_us/user_guide/qgis_server_images/wms_server_project.png
___________________________________________________________________
Added: svn:mime-type
   + application/octet-stream

Modified: docs/trunk/english_us/user_guide/qgis_style.sty
===================================================================
--- docs/trunk/english_us/user_guide/qgis_style.sty	2011-08-10 12:09:18 UTC (rev 15904)
+++ docs/trunk/english_us/user_guide/qgis_style.sty	2011-08-14 16:29:57 UTC (rev 15905)
@@ -68,6 +68,7 @@
 {./working_with_vector_screenies/}
 {./grass_integration_screenies/}
 {./plugins_add_wfs_layer_images/}
+{./qgis_server_images/}
 {./plugins_coordinate_capture_images/}
 {./plugins_decorations_images/}
 {./plugins_delimited_text_images/}

