-
Notifications
You must be signed in to change notification settings - Fork 0
DebianLinux
== MapServer Debian Package ==
!MapServer 4.0.1 is installable directly as a debian package via apt-get on Debian Woody (and above). The package can be installed by adding the following lines to your /etc/apt/sources.list file:
- deb http://www.paulbaker.net/debian stable main
- deb-src http://www.paulbaker.net/debian stable main
!MapServer is available as three packages:
- mapserver-cgi - The mapserv cgi program installed in /usr/lib/cgi-bin
- mapserver-utils - The other miscellaneous programs compiled as part of !MapServer.
- libmapscript-perl - Mapscript/Perl? module.
To install them, issue into a root shell:
apt-get install mapserver-cgi mapserver-utils libmapscript-perl
or use your favorite package manager (aptitude, synaptic...).
Running /usr/lib/cgi-bin/mapserv -v should return the following output:
!MapServer version 4.0.1 OUTPUT=PNG OUTPUT=JPEG OUTPUT=WBMP SUPPORTS=PROJ
SUPPORTS=FREETYPE SUPPORTS=WMS_SERVER SUPPORTS=WMS_CLIENT SUPPORTS=WFS_CLIENT
INPUT=TIFF INPUT=EPPL7 INPUT=JPEG INPUT=OGR INPUT=GDAL INPUT=SHAPEFILE
As of 2004/07/21, a vanilla Debian Sarge installation will cause mapserv to fail with:
mapserv: relocation error: /usr/lib/libgdal.so.1: undefined symbol: _ZTI13XMLEntityDecl?
because of changes in the current libgdal1_1.2.0-1 package. The solution is to force the installation of the package in Paul's repository. Check the current version:
http://www.paulbaker.net/debian/dists/stable/main/binary-i386/gdal/
feed it to apt-get, and flag it with hold so its not upgraded:
apt-get install libgdal1=1.2+cvs.031111-1.0woody.1
echo libgdal1 hold | dpkg --set-selections
As usual, apt will uninstall any previously installed libgdal1.
== What's missing? ==
So what's missing? WFS-Server, Flash/Ming?, Mapscript for all other languages besides Perl, PostGIS, MyGIS?, SDE, Oracle, and PDF. If you need these features, either email the package maintainer, Paul Baker at mailto:pbaker@where2getit.com, and/or build !MapServer yourself following steps below.
== Compiling MapServer for Debian ==
This description relates to pre-woody (Debian r2.x) releases. Many of the supporting libraries are now available as packages, and many of the steps described here are likely to be obsolete.
=== 0.1 Install Debian Woody base system ===
You'll want to read http://www.debian.org/releases/stable/installmanual for instructions on that.
=== 0.2 Compile kernel 2.4.18 so we have ext3 filesystems ===
=== 0.3 Install useful packages ===
apt-get install sash # A statically link root shell for fixing fatal mistakes
apt-get install sshd # Secure shell because telnet is bad.
apt-get install dpkg-dev # Needed to use source packages
Stable version of tune2fs doesn't support ext3 journals, use testing version of the e2fsprogs package
vi /etc/apt/sources.list; apt-get update # point apt at testing distro
apt-get install e2fsprogs
Since writing this, I have left apt pointing to testing (woody) since most of the libraries are closer to what !MapServer wants compared to stable (2.2r6).
=== 0.4 Update filesystems to use ext3 ===
=== 1.0 Installing support libraries needed for !MapServer ===
=== 1.1 Proj4 (v4.4.3-1) ===
My working Mapserver 3.5 box uses a compiled 4.4.3-2, but I notice 4.4.3 is available as a package.
apt-get install proj
=== 1.2 GD ===
Mapserver requires 1.2 or higher, at this time the Debian package is 1.7.3-0.1
apt-get install libgd1g
libgd1g lists !FreeType2 as a dependancy, !FreeType support is required by !MapServer:
http://www.mapserver.org/installation/unix.html
=== 1.3 PHP ===
I like DSOs for regular PHP work on the server, so let's compile a DSO for PHP and a CGI version that will only be used with PHPMapscript pages (.phtml)
apt-get install flex # PHP needs lex to compile
apt-get install apache # else PHP and apache conflict on apache-common version
apt-get install apache-dev # PHP needs APXS to compile
apt-get install php4
apt-get source php4 # Probably needed for PHPMapscript to compile against
We need to compile PHP since the Debian pacakge has --with-regex=PHP while the 3.6 configure.in says that --with-system-regex should be used. (and we want a CGI as well anyway)
=== 1.3.1 libPDF ===
I am currently compiling in libPDF into PHP, native Mapserver PDF may be a far neater solution, but this has been convenient and I can use PDF in other apps. PDFlib is not available as a package so we must compile it:
cd /usr/src/pdflib-4.0.2
./configure
make
make test
make install
=== 1.3.2 PostgreSQL ===
apt-get install libpgsql2
=== 1.3.2 Compiling and installing PHP ===
For PHP 4.1.2 source retrived by apt-source, I used:
apt-get install libtiff3g # Required by PHP PDF functions
./configure --with-mysql --with-apxs --with-regex=system --with-postgresql --with-pdflib=/usr/local --with-jpeg --with-tiff --with-zlib
make
Since we are not making major changes, let's just replace the PHP DSO rather than running make install:
cd /usr/lib/apache/1.3
mv libphp4.so libphp4.so.debian412
cp /usr/src/php4-4.1.2/.libs/libphp4.so libphp4.so.mapserv
ln -s libphp4.so.mapserv libphp.so
/etc/init.d/apache restart
This creates an Apache DSO which Mapserver will refuse to use, but I want to keep the majority of my PHP running from the DSO. Therefore I will compile PHP a second time as a CGI and only associate PHP/Mapscript? with .phtml. To create a CGI php executable:
./configure --with-mysql --with-regex=system --with-postgresql --with-gd --with-jpeg --with-png --with-freetype --with-pdflib=/usr/local --with-zlib --enable-force-cgi-redirect
make
To install, follow the instructions in PHPMapScriptCGI (in my case to associate .phtml with the CGI version of PHP), do read these instructions as there are important security considerations to be made.
cp php /usr/lib/cgi-bin/
vi /etc/apache/srm.conf
<< AddHandler? phtml-script .phtml
<< Action phtml-script /cgi-bin/php
vi /etc/apache/httpd.conf # uncommment mod_actions.so
/etc/init.d/apache restart
=== 1.4 GDAL and OGR ===
GDAL wants g++, g++ wants libraries from the testing distribution so on advice from a Debian expert, I will leave apt pointed at testing.
cd /usr/src/gdal-1.1.7
apt-get install g++
./configure
make
make install # installs to usr/local/ ./bin, ./include, ./share and ./lib
vi /etc/ld.so.conf # add /usr/local/lib to libs
ldconfig # updates changes to ld.so.conf
!MapServer 3.7 seems to require GDAL 1.1.8 for to get "CSLFetchBoolean?"
=== 2.0 Compile !MapServer ===
Remember to remove ./config.cache if you change anything! I re-installed GD three times before I noticed this.
apt-get install libwww0 # Needed by --with-wmsclient
apt-get install libwww-dev # Also needed by --with-wmsclient
apt-get install libjpeg62 # So GD can render jpgs
apt-get install libpng2 # So GD can render PNGs
apt-get install libgd-dev # replaces libgd1g and more
apt-get install proj # upgrade PROJ4 to 4.4.5
./configure --with-gd --without-tiff --with-freetype --with-proj --with-ogr --with-gdal --with-wmsclient --with-php=/usr/src/php4-4.1.2/
make
These notes were written for v 3.6.0, but I have recompiled using 3.6.3 and 3.7 with only minor differences (the replacement of libwww with libcurl and the addition of PDFlib and Ming).
=== 3.0 Install !MapServer ===
cp ./.libs/php_mapscript.so /usr/lib/php/20010901/
# This next bit is an ugly hack until I set up PHP to look at
# my extensions directory:
ln -s /usr/libs/php/20010901 /usr/local/lib/php4/extensions/no-debug-non-zts-20010901
cp mapserv /usr/lib/cgi-bin # Only needed for our older CGI based apps
=== 4.0 Testing ===
==== Install MapServer 4.2.2 and PHPMapScript from Debian Binary Packages ====
Add the next line in /etc/apt/sources.list
for testing:
deb http://agrogeomatic.educagri.fr/debian sarge main
for stable:
deb http://agrogeomatic.educagri.fr/debian woody main
And execute:
apt-get update ;
apt-get install php-mapscript cgi-mapserver php4
More info in http://agrogeomatic.educagri.fr/debia