[mapserver-commits] r13098 - in trunk/docs/en: installation tinyows
svn at osgeo.org
svn at osgeo.org
Wed Feb 8 14:39:40 EST 2012
Author: dmiddlecamp
Date: 2012-02-08 11:39:40 -0800 (Wed, 08 Feb 2012)
New Revision: 13098
Modified:
trunk/docs/en/installation/unix.txt
trunk/docs/en/tinyows/serverinstallation.txt
trunk/docs/en/tinyows/servertuning.txt
Log:
cleanup, expanding performance tips, adding install link warning
Modified: trunk/docs/en/installation/unix.txt
===================================================================
--- trunk/docs/en/installation/unix.txt 2012-02-08 19:25:22 UTC (rev 13097)
+++ trunk/docs/en/installation/unix.txt 2012-02-08 19:39:40 UTC (rev 13098)
@@ -159,9 +159,11 @@
More details on how to use this feature in MapServer is here :ref:`fastcgi`.
On Ubuntu, that would be
- .. installing fastcgi development package::
- sudo apt-get -y install libfcgi-dev
+ ::
+ installing fastcgi development package
+ [user at host mapserver]$ sudo apt-get -y install libfcgi-dev
+
* `cairo (svg, pdf) support <http://cairographics.org/>`__: This library is required
when using the "--with-cairo" configure option. If you're on an ubuntu system, it
can be installed with "sudo apt-get install -y libcairo2-dev"
@@ -204,7 +206,7 @@
::
- gdlib-config --version
+ [user at host mapserver]$ gdlib-config --version
-----------------------------------------------------------------------------
libiconv
@@ -217,7 +219,7 @@
::
- gdlib-config --libs
+ [user at host mapserver]$ gdlib-config --libs
-----------------------------------------------------------------------------
Pre-packaged/system libraries
@@ -260,8 +262,8 @@
checking where FreeType is installed...
checking for FT_Init_FreeType in -lfreetype... yes
- using libfreetype -lfreetype from system libs.
-
+ using libfreetype -lfreetype from system libs.
+
Even though you have FreeType installed on your system *and* the
configure script finds it, does *NOT* mean you will have TrueType
font support. GD *MUST* be compiled against FreeType either way.
@@ -627,31 +629,33 @@
The main goal is to get the "mapserv" binary installed in a publicly
accessible directory that is configured to run CGI programs and scripts.
-1. Locate your cgi-bin directory. Under a default configuration,
+1. Locate your cgi-bin directory. Under a default configuration,
the CGI directory is "/usr/local/apache/cgi-bin" (RedHat users
will use "/home/httpd/cgi-bin"). if you're using apache, there should be a
-ScriptAlias directive in your http.conf, or default site, something like:
+ScriptAlias directive in your http.conf, or default site, something like::
- ::
+ [user at host mapserver]$ cat /etc/apache2/sites-available/default | grep 'cgi-bin'
+ ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
- [user at host mapserver]$ cat /etc/apache2/sites-available/default | grep 'cgi-bin'
- ...
- ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
-2. Locate the installation path of your freshly compiled mapserv executable.
-This is shown when you run "sudo make install", something like this:
+2. Locate the installation path of your freshly compiled mapserv executable.
+This is shown when you run "sudo make install", something like this::
- ::
+ libtool: install: /usr/bin/install -c .libs/mapserv /usr/local/bin/mapserv
- libtool: install: /usr/bin/install -c .libs/mapserv /usr/local/bin/mapserv
-3. You'll want to setup a symlink to that executable from your cgi-bin directory.
+.. This indent is driving me insane.
- ::
+3. You'll want to setup a symlink to that executable from your cgi-bin directory::
- [user at host mapserver]$ sudo ln -s /usr/local/bin/mapserv /usr/lib/cgi-bin/mapserv
+ [user at host mapserver]$ sudo ln -s /usr/local/bin/mapserv /usr/lib/cgi-bin/mapserv
+ .. warning::
+ Make sure you are linking against the installed mapserv file (after running 'make install')
+ and NOT against where it was compiled in your source tree.
+
+
Testing your new Install
-------------------
Placing the mapserv file in this directory makes it accessible by the following URL:
Modified: trunk/docs/en/tinyows/serverinstallation.txt
===================================================================
--- trunk/docs/en/tinyows/serverinstallation.txt 2012-02-08 19:25:22 UTC (rev 13097)
+++ trunk/docs/en/tinyows/serverinstallation.txt 2012-02-08 19:39:40 UTC (rev 13098)
@@ -4,23 +4,17 @@
TinyOWS Installation
*****************************************************************************
-.. warning:: Fix author block
+.. warning:: Author Block?
-:Author: Howard Butler
-:Contact: hobu.inc at gmail.com
-:Revision: $Revision: 13079 $
-:Date: $Date: 2012-02-07 13:58:04 -0800 (Tue, 07 Feb 2012) $
-
-
Requires
-----------------------------------------------------------------------------
TinyOWS need following librairies/applications:
- * LibXML2 (2.6.20 version or later)
- * PostGIS (1.5.x version or later)
- * PostgreSQL (with libpq headers)
- * A working Web Server with cgi-bin support
- * Fast-CGI is recommended
+ * LibXML2 (2.6.20 version or later)
+ * PostGIS (1.5.x version or later)
+ * PostgreSQL (with libpq headers)
+ * A working Web Server with cgi-bin support
+ * Fast-CGI is recommended
Installing from a stable source release
~~~~~~~~~~~~~~~~~~~~~~
@@ -42,8 +36,8 @@
Installing from SVN
~~~~~~~~~~~~~~~~~~~~~~
Build from SVN need also following librairies/applications:
- * autoconf
- * SVN client
+ * autoconf
+ * SVN client
::
@@ -57,8 +51,7 @@
And then copy tinyows binary in your cgi-bin directory
-Installing on Windows from SVN
+Installing from SVN on Windows
~~~~~~~~~~~~~~~~~~~~~~
-From SVN with Visual C++ for Win32
- * [http://gis-lab.info/qa/tinyows-compile-vce-eng.html] (written by Alexander Bruy)
+ * `From SVN with Visual C++ for Win32 <http://gis-lab.info/qa/tinyows-compile-vce-eng.html>`_ (written by Alexander Bruy)
Modified: trunk/docs/en/tinyows/servertuning.txt
===================================================================
--- trunk/docs/en/tinyows/servertuning.txt 2012-02-08 19:25:22 UTC (rev 13097)
+++ trunk/docs/en/tinyows/servertuning.txt 2012-02-08 19:39:40 UTC (rev 13098)
@@ -1,45 +1,76 @@
.. _tinyows_servertuning:
*****************************************************************************
-= Server Tuning: How to speed up your TinyOWS server ? =
+Server Tuning: How to speed up your TinyOWS server
*****************************************************************************
-== PostgreSQL/PostGIS datas ==
- * Be sure to have a spatial index on your geometry/geography datas
- * Put index on each column who could be used frequently as a filter
-----
+.. warning:: Author Block?
-== HTTP Gzip compression ==
- * In Apache, activate mod_deflate
- * Deflate basic configuration:
-{{{
-AddOutputFilterByType DEFLATE text/html text/plain text/xml application/xml application/json
-}}}
-----
+Tips and Tricks for PostgreSQL / PostGIS databases
+-----------------------------------------------------------------------------
+ * Index any column that could be used frequently as a filter
+ * Use Spatial Indexes on your geometry/geography columns
+ `PostGIS Spatial Indexes <http://postgis.refractions.net/docs/ch04.html#id2628096>`_.
-== Fast-CGI ==
- * Check that your TinyOWS is compiled with FastCGI support:
-{{{
-tinyows --check
-TinyOWS version: 0.9.0 SVN
-FCGI support: Yes
-...
-}}}
+ * General `PostGIS Performance tips <http://postgis.refractions.net/docs/ch06.html>`_
+ * General `PostgreSQL Performance tips <http://wiki.postgresql.org/wiki/Performance_Optimization>`_
+ * `Even more tips on Tuning PostgreSQL <http://wiki.postgresql.org/wiki/Tuning_Your_PostgreSQL_Server>`_
-=== Unix Like ===
+Tips and Tricks for Apache
+-----------------------------------------------------------------------------
+
+HTTP Gzip compression
+~~~~~~~~~~~~~~~~~~~~~~
+* In Apache, activate `mod_deflate <http://httpd.apache.org/docs/2.0/mod/mod_deflate.html>`_
+* Deflate basic configuration, (note we're including xml and json):
+
+ ::
+
+ AddOutputFilterByType DEFLATE text/html text/plain text/xml application/xml application/json
+
+
+Using Fast-CGI
+-----------------------------------------------------------------------------
+* Check that your TinyOWS is compiled with FastCGI support:
+
+ ::
+
+ [user at host mapserver]$ tinyows --check
+ TinyOWS version: 1.0.0 SVN
+ FCGI support: Yes
+ ...
+
+Fast-CGI in Apache
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
* In Apache, activate mod_fcgi
+
+ ::
+
+ [user at host mapserver]$ sudo apt-get install -y libapache2-mod-fastcgi
+ [user at host mapserver]$ sudo a2enmod fastcgi
+
+
* Apache fast-cgi configuration:
-{{{
- FastCgiServer /usr/lib/cgi-bin/tinyows.fcgi -processes 40
- FastCgiConfig -initial-env LD_LIBRARY_PATH=/usr/local/lib:/usr/pgsql/lib:/usr/lib:/lib -appConnTimeout 60 -idle-timeout 60 -init-start-delay 1 -minProcesses 3 -maxClassProcesses 30 -startDelay 10
-}}}
+ ::
-=== MS4W ===
- * Please refer to the fastcgi doc in ms4w: [http://www.maptools.org/ms4w/index.phtml?page=README_INSTALL.html#f-fastcgi]
- * Add the following 2 lines:
-{{{
-DefaultInitEnv TINYOWS_CONFIG_FILE "/ms4w/apps/tinyows/config.xml"
-DefaultInitEnv TINYOWS_SCHEMA_DIR "/ms4w/apps/tinyows/schema/"
-}}}
+ #in your CGI-BIN directive, add the following to run all cgi-bin using FastCGI
+ SetHandler fastcgi-script
+
+ #in your FastCGI config file (typically something like /etc/apache2/mods-enabled/fastcgi.conf)
+ FastCgiServer /usr/lib/cgi-bin/tinyows.fcgi -processes 40
+ FastCgiConfig -initial-env LD_LIBRARY_PATH=/usr/local/lib:/usr/pgsql/lib:/usr/lib:/lib -appConnTimeout 60 -idle-timeout 60 -init-start-delay 1 -minProcesses 3 -maxClassProcesses 30 -startDelay 10
+
+
+Fast-CGI in MS4W
+~~~~~~~~~~~~~~~~~~~~~~
+* Please refer to the `fastcgi doc in ms4w <http://www.maptools.org/ms4w/index.phtml?page=README_INSTALL.html#f-fastcgi>`_
+* Add the following 2 lines:
+
+ ::
+
+ DefaultInitEnv TINYOWS_CONFIG_FILE "/ms4w/apps/tinyows/config.xml"
+ DefaultInitEnv TINYOWS_SCHEMA_DIR "/ms4w/apps/tinyows/schema/"
+
More information about the mapserver-commits
mailing list