[mapserver-commits] r13135 - trunk/docs/en/mapcache

[svn at osgeo.org]

Author: racicot
Date: 2012-02-09 11:39:24 -0800 (Thu, 09 Feb 2012)
New Revision: 13135

Modified:
   trunk/docs/en/mapcache/install.txt
Log:
Adding some specifics about mapcache install... specifically around nginx.  Submitted by Greg Corradini.

Modified: trunk/docs/en/mapcache/install.txt
===================================================================
--- trunk/docs/en/mapcache/install.txt	2012-02-09 18:36:14 UTC (rev 13134)
+++ trunk/docs/en/mapcache/install.txt	2012-02-09 19:39:24 UTC (rev 13135)
@@ -65,16 +65,19 @@
 
   $ ./configure
   $ make
+  $ sudo make install
 
 Apache Module Specific Instructions
 -----------------------------------
 
+The make install above installs the apache module, but if you need to
+specifically need to install only the apache module you can do the following
+
 .. code-block:: bash
 
   $ sudo make install-module
   $ sudo ldconfig
 
-
 The installation script takes care of putting the built module in the apache
 module directory.  The process for activating a module is usually distro
 specific, but can be resumed by the following snippet that should be present in
@@ -107,6 +110,68 @@
 If you have not disabled the demo service, you should now have access to it on
 http://myserver/mapcache/demo
 
+Nginx Specific Instructions
+----------------------------
+
+.. warning:: Working with nginx is still highly experimental. The following workflow has only been tested on the development version of nginx-1.1.14
+
+For nginx support you need to build mapcache's nginx module against the 
+nginx source. Download the nginx source code:
+
+.. code-block:: bash
+
+   $ cd /usr/local/src
+   $ mkdir nginx
+   $ cd nginx
+   $ wget http://nginx.org/download/nginx-1.1.14.tar.gz
+   $ tar -xzvf nginx-1.1.14.tar.gz
+   $ cd nginx-1.1.14/
+
+Run the configure command with the flag\  ``--add-module`` \. This flag
+must point to mapcache's nginx child directory. Assuming that 
+mapserver trunk was checked out to\  ``/usr/local/src`` \, an example configure
+command for nginx would look like this:
+
+.. code-block:: bash
+
+   $ ./configure --add-module=/usr/local/src/mapserver-trunk/mapcache/nginx
+
+Then build nginx:
+
+.. code-block:: bash
+
+   $ make 
+   $ sudo make install
+
+Mapcache supplies a\  ``nginx.conf`` \in its nginx child directory. The conf 
+contains an example configuration to load mapcache. The most relevant part of
+the configuration is the location directive that points the\  ``mapcache`` \URI 
+to the\  ``mapcache.xml`` \path. You will need to change this path to point to 
+your own\  ``mapcache.xml`` \ in the mapcache source
+
+.. code-block:: bash
+
+	## BEFORE PATH EDIT
+        location ~ ^/mapcache(?<path_info>/.*|$) {
+           set $url_prefix "/mapcache";
+           mapcache /home/tbonfort/dev/mapserver-trunk/mapcache/mapcache.xml;
+        }
+
+	## AFTER PATH EDIT
+        location ~ ^/mapcache(?<path_info>/.*|$) {
+           set $url_prefix "/mapcache";
+           mapcache /usr/local/src/mapserver-trunk/mapcache/mapcache.xml;
+        }
+
+Now copy the\  ``nginx.conf`` \ from mapcache's nginx child directory into
+nginx's conf directory (the nginx root directory in this case is \  ``/usr/local/nginx`` \) 
+
+.. code-block:: bash
+
+   $ sudo cp /usr/local/src/mapserver-trunk/mapcache/nginx/nginx.conf /usr/local/nginx/conf       
+
+You should now have access to the demo. Notice the port number:  http://myserver:8083/mapcache/demo
+
 CGI/FastCGI Specific Instructions
 ---------------------------------
 
@@ -574,4 +639,4 @@
 - Zoom in a few times, and your configured cache location should be generating tiles (in this case inside 
   D:/ms4w/tmp/ms_tmp/cache/).
   
-  .. image:: ../images/mapcache-disk.jpg
\ No newline at end of file
+  .. image:: ../images/mapcache-disk.jpg