[mapserver-commits] r13238 - trunk/docs/en/installation
svn at osgeo.org
svn at osgeo.org
Tue Mar 13 08:57:59 EDT 2012
Author: havatv
Date: 2012-03-13 05:57:59 -0700 (Tue, 13 Mar 2012)
New Revision: 13238
Modified:
trunk/docs/en/installation/unix.txt
Log:
Fixed some overlong lines in the PDF document for the unix installation document (#3947). Also did some other updates on that page (formatting, flash support, pdf support, ...). More should probably be done.
Modified: trunk/docs/en/installation/unix.txt
===================================================================
--- trunk/docs/en/installation/unix.txt 2012-03-13 12:02:51 UTC (rev 13237)
+++ trunk/docs/en/installation/unix.txt 2012-03-13 12:57:59 UTC (rev 13238)
@@ -68,10 +68,9 @@
support for MapServer. Version 4.4.6 or greater is required.
* `libcurl <http://curl.haxx.se/libcurl/>`__: libcurl is the foundation of
OGC (WFS/WMS/WCS) client and server support. Version 7.10 or greater is
- required
+ required. Installing libcurl::
- .. installing libcurl::
- sudo apt-get install -y libcurl4-gnutls-dev
+ apt-get install -y libcurl4-gnutls-dev
* `OGR <http://www.gdal.org/ogr/>`__: OGR provides access to at least 18
different vector formats.
@@ -145,28 +144,35 @@
* `pdflib (lite) <http://www.pdflib.com/products/pdflib-family/pdflib-lite/>`__:
PDFlib Lite is the Open Source version of PDFlib that allows MapServer
to produce PDF output. Version 4.0.3 or greater is required.
+
+ .. note::
+
+ PDF output is supported through Cairo in recent versions of
+ Mapserver.
* `libming <http://www.libming.org>`__: libming provides Macromedia
Flash output to MapServer. Version 0.2a is required. Later versions are
not known to work.
-* `libgif-dev <http://sourceforge.net/projects/giflib/>`__: giflib is one of the
- default renderers, but can be disabled with the "--without-gif" configure option.
+ .. note::
+ SWF (flash) support was dropped in Mapserver version 6.
+
+* `libgif-dev <http://sourceforge.net/projects/giflib/>`__: giflib is
+ one of the default renderers, but can be disabled with the
+ "--without-gif" configure option.
+
* `FastCGI <http://www.fastcgi.com>`__: FastCGI is a popular protocol for
interfacing MapServer with various web servers. You will need to install
the development package if you use the "--with-fastcgi" configure option.
More details on how to use this feature in MapServer is here :ref:`fastcgi`.
- On Ubuntu, that would be
+ On Ubuntu, that would be::
- ::
+ $ 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"
+ can be installed with "apt-get install -y libcairo2-dev"
* `kml support <http://mapserver.org/output/kml_output.html>`__: This renderer is
controlled with the "--with-kml" parameter.
@@ -206,7 +212,7 @@
::
- [user at host mapserver]$ gdlib-config --version
+ $ gdlib-config --version
-----------------------------------------------------------------------------
libiconv
@@ -219,7 +225,7 @@
::
- [user at host mapserver]$ gdlib-config --libs
+ $ gdlib-config --libs
-----------------------------------------------------------------------------
Pre-packaged/system libraries
@@ -320,8 +326,7 @@
OGC Support
=============================================================================
MapServer provides support for many `OGC <http://www.opengeospatial.org>`__
-specifications. At 4.2.3, it provides support for WMS (:ref:`wms_server`),
-SLD (:ref:`sld`), WFS (:ref:`wfs_server`), and WCS (:ref:`wcs_server`).
+specifications. For an overview, see :ref:`ogc_support`.
-----------------------------------------------------------------------------
WMS support
@@ -329,7 +334,7 @@
WMS Server
-------------------
-Support for this specification is automatically enabled when you
+Support for `WMS server` is automatically enabled when you
include PROJ.4 support. (--with-proj)
You can check this yourself by looking for the following
in your "configure" output:
@@ -362,9 +367,11 @@
checking whether we should include WMS Client Connections support...
OGC WMS Client Connections enabled (-DUSE_WMS_LYR).
-Note that this feature is disabled by default, you have to
-specifically request it.
+.. note::
+ This feature is disabled by default, you have to specifically
+ request it.
+
More information on using this feature is available in :ref:`wms_client`.
-----------------------------------------------------------------------------
@@ -373,7 +380,7 @@
WFS Server
-------------------
-Support for this specification is enabled by passing the configure
+Support for `WFS server` is enabled by passing the configure
script the "--with-wfs" option. OGR and PROJ.4 support is required.
You can check this yourself by looking for the following in your
@@ -384,8 +391,9 @@
checking whether we should include WFS Server support...
OGC WFS Server support enabled (-DUSE_WFS_SVR).
-Note that this feature is disabled by default, you have to
-specifically request it.
+.. note::
+ This feature is disabled by default, you have to specifically
+ request it.
More information on using this feature is available in
:ref:`wfs_server`.
@@ -396,29 +404,30 @@
reads it's data from a remote server's WFS output and renders it into a map,
just like it would when reading data from a shapefile.
-In order to enable this feature, you will need to make sure you include
-OGR (Built with Xerces support) and PROJ.4 support, and pass the
-"--with-wfsclient" option to your configure script. MapServer will automatically
-look for libcurl, which is also required.
+In order to enable this feature, you will need to make sure you
+include OGR (Built with Xerces support) and PROJ.4 support, and pass
+the "--with-wfsclient" option to your configure script. MapServer will
+automatically look for libcurl, which is also required.
To verify that the :ref:`wfs_client` feature is enabled, check the output
-from the configure script:
+from the configure script::
-::
-
checking whether we should include WFS Client Connections support...
OGC WFS Client Connections enabled (-DUSE_WFS_LYR).
-Note that this feature is disabled by default, you have to specifically
-request it.
+.. note::
+
+ This feature is disabled by default, you have to specifically
+ request it.
More information on using this feature is available in :ref:`wfs_client`.
WCS Server
-------------------
-Support for WCS is enabled by passing the "--with-wcs" option to the
-configure script. WCS must be compiled against certain libraries.
-More information on this service is available in :ref:`wcs_server`.
+Support for `WCS server` is enabled by passing the "--with-wcs"
+option to the configure script. WCS must be compiled against certain
+libraries. More information on this service is available in
+:ref:`wcs_server`.
SOS Server
-------------------
@@ -450,10 +459,8 @@
roll your own if needed.
MapServer can use PostGIS as a data source. In order to do so simply use
-"--with-postgis" when running your configure script.
+"--with-postgis" when running your configure script::
-::
-
--with-postgis=/usr/local/pgsql/bin/pg_config
-----------------------------------------------------------------------------
@@ -464,10 +471,8 @@
at your disposition, and have them installed on the machine running MapServer.
In order to enable SDE support in MapServer, you have to compile it
-with two options specified:
+with two options specified::
-::
-
--with-sde=/opt/sdeexe90
--with-sde-version=90
@@ -478,10 +483,8 @@
In order to connect to it, you will need to compile MapServer against
the Oracle libraries by passing the "--with-oraclespatial" argument to
your configure script. You will very likely need an ORACLE_HOME environment
-variable set to have it configure things correctly.
+variable set to have it configure things correctly::
-::
-
--with-oraclespatial=/opt/oracle
=============================================================================
@@ -508,95 +511,88 @@
3. Compile Proj.4. Proj.4 is a straight-forward configure/make/make install
library.
-4. Compile libcurl. libcurl is a straight-forward configure/make/make install
- library. This library is only used along with other features, so
- "--with-curl-config" won't do anything unless something like "--with-wmsclient"
- or "--with-wfsclient" is also selected.
+4. Compile libcurl. libcurl is a straight-forward configure/make/make
+ install library. This library is only used along with other
+ features, so "--with-curl-config" won't do anything unless
+ something like "--with-wmsclient" or "--with-wfsclient" is also
+ selected.
.. note::
- If you want to configure MapServer to use SSL when accessing a WMS/WFS server
- libcurl must be configured / compiled with the "--with-ssl" option.
- Details about how to set this up is available in :ref:`wxs_secure`.
+ If you want to configure MapServer to use SSL when accessing a
+ WMS/WFS server libcurl must be configured / compiled with the
+ "--with-ssl" option. Details about how to set this up is
+ available in :ref:`wxs_secure`.
5. Compile/install optional libraries. These might include SDE, PostGIS,
Oracle Spatial, AGG, Ming, PDFlib, or MyGIS. Mix and match as you need
them.
-6. Unpack the MapServer tarball and cd into the mapserver directory:
-
- ::
+6. Unpack the MapServer tarball and cd into the mapserver directory::
- [user at host user]$ tar -zxvf mapserver-X.Y.Z.tar.gz
+ $ tar -zxvf mapserver-X.Y.Z.tar.gz
-7. Configure your environment using "configure". I often place my configure
- command in its own file and changes its mode to be executable (+x) to save
- typing and have a record of how MapServer was configured. This is meant to be
- an example, you will need to edit the following script. If you get
- "No such file or directory" errors, try removing the "#" comments in this script.
+7. Configure your environment using "configure". I often place my
+ configure command in its own file and changes its mode to be
+ executable (+x) to save typing and have a record of how MapServer
+ was configured. This is meant to be an example, you will need to
+ edit the following script. If you get "No such file or directory"
+ errors, try removing the "#" comments in this script::
- ::
-
- ./configure --with-sde=/usr/sde/sdeexe90 \
- --with-sde-version=90 \
- --with-ogr=/usr/local/bin/gdal-config \
- --with-gdal=/usr/local/bin/gdal-config \
- --with-httpd=/usr/sbin/httpd \
- --with-wfsclient \
- --with-wmsclient \
- --enable-debug \
- --with-curl-config=/usr/bin/curl-config \
- --with-proj=/usr/local \
- --with-tiff \
- --with-gd=/usr/local/ \
- --with-jpeg \
- --with-freetype=/usr/ \
- --with-oraclespatial=/usr/oracle \
- --with-threads \
- --with-wcs \
- --with-postgis=/usr/local/database/bin/pg_config \
- --with-libiconv=/usr \ # new in 4.8
- --with-geos=/usr/local/bin/geos-config \ # new in 4.8
- --with-xml2-config=/usr/bin/xml2-config \ # new in 4.10
- --with-sos \ # new in 4.10
- --with-agg=/path/to/agg-2.4
+ ./configure --with-sde=/usr/sde/sdeexe90 \
+ --with-sde-version=90 \
+ --with-ogr=/usr/local/bin/gdal-config \
+ --with-gdal=/usr/local/bin/gdal-config \
+ --with-httpd=/usr/sbin/httpd \
+ --with-wfsclient \
+ --with-wmsclient \
+ --enable-debug \
+ --with-curl-config=/usr/bin/curl-config \
+ --with-proj=/usr/local \
+ --with-tiff \
+ --with-gd=/usr/local/ \
+ --with-jpeg \
+ --with-freetype=/usr/ \
+ --with-oraclespatial=/usr/oracle \
+ --with-threads \
+ --with-wcs \
+ --with-postgis=/usr/local/database/bin/pg_config \
+ --with-libiconv=/usr \ # new in 4.8
+ --with-geos=/usr/local/bin/geos-config \ # new in 4.8
+ --with-xml2-config=/usr/bin/xml2-config \ # new in 4.10
+ --with-sos \ # new in 4.10
+ --with-agg=/path/to/agg-2.4 \ # not needed with >= 5.6
8. Now that you have configured your build options and selected all the
libraries you wish mapserver to use, you're ready to compile the
source code into an executable.
- This is actually quite simple, just execute "make":
+ This is actually quite simple, just execute "make"::
- ::
-
- [user at host mapserver]$ make
+ $ make
-9. There is now a *make install* step in the installation of MapServer (yes,
- you read that correctly). This will install the 'mapserver' libraries.
- The other output of the compilation of MapServer is a binary executable that you
- can use in a CGI execution environment.
+9. Since Mapserver 6.2 there is a *make install* step in the
+ installation of MapServer (yes, you read that correctly). This
+ will install the 'mapserver' libraries. The other output of the
+ compilation of MapServer is a binary executable that you can use in
+ a CGI execution environment::
- ::
-
- [user at host mapserver]$ sudo make install
+ # make install
- To make sure all went well, look for the file called *mapserv*
+ To make sure all went well, look for the file called *mapserv*::
- ::
-
- [user at host mapserver]$ ls -al mapserv
+ $ ls -al mapserv
-rwxr-xr-x 1 user user 351177 Dec 21 11:38 mapserv
+ $
- A simple test is to try and run it:
+ A simple test is to try and run it::
- ::
-
- [user at host mapserver]$ ./mapserv
+ $ ./mapserv
This script can only be used to decode form results and
should be initiated as a CGI process via a httpd server.
- [user at host mapserver]$
+ $
The message above is perfectly normal, and means exactly what it says.
If you get anything else, something went terribly wrong.
@@ -616,49 +612,50 @@
to edit your httpd.conf (the main apache configuration file), or have
someone (such as your webmaster) help you with the configuration details.
- ::
+If you don't have apache installed, and you want apache, php, fastcgi,
+etc, that might look something like this::
- If you don't have apache installed, and you want apache, php, fastcgi, etc,
- That might look something like this:
+ $ apt-get install -y apache2 apache2-mpm-worker libapache2-mod-fastcgi
+ $ a2enmod actions fastcgi alias
+ $ apt-get install libapache2-mod-php5 php5-common php5-cli php5-fpm php5
- [user at host mapserver]$ sudo apt-get install -y apache2 apache2-mpm-worker libapache2-mod-fastcgi
- [user at host mapserver]$ sudo a2enmod actions fastcgi alias
- [user at host mapserver]$ sudo apt-get install libapache2-mod-php5 php5-common php5-cli php5-fpm php5
-
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,
-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::
+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::
- [user at host mapserver]$ cat /etc/apache2/sites-available/default | grep 'cgi-bin'
- ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
+ $ 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 "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.
+ # ln -s /usr/local/bin/mapserv /usr/lib/cgi-bin/mapserv
-3. You'll want to setup a symlink to that executable from your cgi-bin directory::
+ .. warning::
- [user at host mapserver]$ sudo ln -s /usr/local/bin/mapserv /usr/lib/cgi-bin/mapserv
+ 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.
- .. 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:
+
+Placing the mapserv file in this directory makes it accessible by the
+following URL:
"http://yourhostname.com/cgi-bin/mapserv". When accessing this URL through your
web client, you should expect the following output if all has worked well:
"No query information to decode. QUERY_STRING is set, but empty." If you get
@@ -680,7 +677,7 @@
fine and safe:
::
- [user at host cgi-bin]$ chmod o+x mapserv
+ $ chmod o+x mapserv
Apache errors
-------------------
@@ -696,7 +693,7 @@
::
Check your server logs
- [user at host mapserver]$ tail /var/log/apache2/error.log
+ $ tail /var/log/apache2/error.log
-----------------------------------------------------------------------------
More information about the mapserver-commits
mailing list