Building MapGuide on CentOS 5

Prerequisite

User account

If you have just installed the OS, be sure to create a user account for yourself from root:

adduser <username>
passwd <username>

Add yourself to the sudoer list from root:

visudo

Add your entry after root "<username> ALL=(ALL) ALL", at about line 77. The program uses commands from vi or vim, so you need to insert text using i, then after inserting text, you need to hit the ESC key, then:wq (write, quit). Logout of root, and log in as yourself.

System development tools and libraries

Install system development tools (as root via su):

yum install gcc* gd-* 
yum install automake* bison* flex doxygen expat* swig 
yum install libtool* libjpeg-devel libpng libpng-devel alsa-lib-devel libxml2 libxml2-devel
yum install openssl openssl-devel 
yum install curl curl-devel
yum install libxslt libxslt-devel
yum install subversion

Sun Java

A Sun Java Development Kit is required. The plain package is fine, no need for NetBeans or Java EE. You can download the JDK from http://java.sun.com/javase/downloads/index.jsp. Detailed installation instructions can be found at http://wiki.centos.org/HowTos/JavaOnCentOS (follow the instructions for "Sun JDK 1.6").

Check "java -version" and you should see "Java(TM)" somewhere in the output.

JAVA_HOME does not always gets set during this installation. It is however required to compile the SWIG based JavaAPI.

Optional: PostgreSQL and PostGIS

Current versions of PostgreSQL are maintained at http://yum.pgsqlrpms.org/. An overview for beginners can be found here: http://www.postgresonline.com/journal/index.php?/archives/45-An-Almost-Idiots-Guide-to-PostgreSQL-YUM.html

To use the repository, first block all others by editing the repos file. As root, edit the file (e.g.):

vim /etc/yum.repos.d/CentOS-Base.repo

add to the bottom of the file:

exclude=postgresql*

Choose a version of PostgreSQL from http://yum.pgsqlrpms.org/reporpms/repoview/pgdg-centos.html, the current version 8.3.x is recommended

Download source

Download the source code for FDO-3.3.1 and MapGuide-2.0.2:

svn checkout http://svn.osgeo.org/fdo/tags/3.3.1/ fdo-3.3.1

svn checkout http://svn.osgeo.org/mapguide/tags/MAPGUIDE2.0.2/ mapguide-2.0.2

Build and Install

FDO

Through su or as root:

mkdir /usr/local/fdo-3.3.0
cd fdo-3.3.1
source ./setenvironment.sh

nohup ./build_thirdparty.sh 2>&1 | tee build_thirdparty.log

nohup ./build_linux.sh 2>&1 | tee build_linux.log

Apache / PHP

Rev 3853

Through su or as root:

mkdir /usr/local/mapguideopensource
cd mapguide-2.0.2/Oem/LinuxApt
find . -name "*.gz" -exec tar xzf {} \;

nohup ./build_apt.sh 2>&1 | tee ../../build_apt.log

Later in the webtier the ApacheAgent will not compile if httpd has not been unpacked/built.

There is a conflict with the apr package. Installing apr-devel and a "make clean" in the apache directory seemed to have helped ...

The apache2/conf/mapguide.conf installed for the apache webserver does not enable the mapguide plugin or the mapagent.fcgi handler. This needs editing in line 8 and 30.

On Centos52 the mod_mgmapagent.so and siblings does not get installed into the apache directory in the installation. These can be copied manually from the Apache Agent subdir MgDev/web/src/ApacheAgent/.libs to /usr/local/mapguideopensource/webserverextensions/apache2/modules until this is fixed.

PHP

The PHP build fails with a missing include of evp.h if openssl-devel has not been installed!

OEM

Through su or as root:

cd mapguide-2.0.2/
nohup ./build_oem.sh 2>&1 | tee build_oem.log

MapGuide

Through su or as root:

aclocal
libtoolize --force
automake --add-missing --copy
autoconf
./configure --enable-optimized

nohup make 2>&1 | tee make_mapguide.log

nohup make install 2>&1 | tee install_mapguide.log

Final Steps

the apache module needed to be deployed by hand

1. the webconfig.ini has not been deployed in www 2. the webtier tests in mapagent dir were missing 3. the mapviewerphp directory was empty and needed filling to view a map 4. a remote connection with autodesk studio 2008 version 2.0 failed to connect 5. the resource library is empty and no map can be displayed 6. fixing all the above still only produced empty tiles.... next day