Building Guide on Windows XP/7

work in progress

Environment Setup

1. Install Microsoft Visual Studio 9.0.21 Standard Version. This version has a fatal bug, you may want to get SP or higher version.

2. Checkout the source from Subversion to, for example, C:\

   cd c:\
   svn checkout http://svn.osgeo.org/mapguide/branches/2.2/MgDev mgdev
   OR 
   svn export http://svn.osgeo.org/mapguide/branches/2.2/MgDev mgdev
   

3. Download FDO 3.5 CR1 SDK tarball from ​Here to C:\mgdev\Oem\FDO\ created in step 1.

   cd C:\mgdev\Oem\FDO
   tar xvvf <tar>
   cd Bin
   mkdir Release
   

Move all contents under Bin to Release folder. The structure of fdo should be like this:

C:\mgdev\Oem\FDO\Bin\Release
C:\mgdev\Oem\FDO\Inc
C:\mgdev\Oem\FDO\Lib

Note: if you are working on a 64-bit windows machine and download the 64-bit FDO SDK, rename folder Release into Release64 and Lib into Lib64

4. Install the following dependencies.
   • JAVA SDK 1.6
   • ANT 1.7 or above
   • Apache HTTP Server or Tomcat or IIS 7.5
   • PHP 5.3.3

JAVA_HOME
ANT_HOME

Build Process

1. Build OEM tree
   • Launch Microsoft Visual Studio
   • File->Open->Project/Solution and browse to oem.sln and click Ok. this will open all 35 Oem projects in Visual Studio
   • In Solution Explorer tree, select Solution 'oem', then click Build->Build Solution, build process will start and should be successful.

2. Build CSMap. Though CSMap is under folder Oem, it is a totally different project from other Oem projects, and it should be built seperately
   • File->Open->Project/Solution and browse to Oem/CsMap/OpenSource.sln, click Ok to open CsMap project in Visual Studio
   • In Solution Explorer tree, select Solution OpenSource, then click Build->Build Solution, build process will start and should be successful.

3. Build MapGuide Server
   • File->Open->Project/Solution and browse to c:\mgdev\Server\server.sln, click Ok to open 29 server projects in Visual Studio
   • In Solution Explorer tree, select Solution Server, then click Build->Build Solution, build process will start and should be successful.

4. Build Web Extension
   • File->Open->Project/Solution and browse to c:\mgdev\Web\src\WebTier.sln, click Ok to open 30 web extension projects in Visual Studio
   • In Solution Explorer tree, select Solution Web Tier, then click Build->Build Solution, build process will start and should be successful.

Note: In Visual Studio, before each build process, make sure the configuration for these 4 build processes are consistent, i.e Release and Win32 are recommende for 32-bit windows machine, Release and x64 for 64-bit windows machine.

Install MapGuide Server

1. On 32-bit windows machine

   cd c:\mgdev
   mkdir Release
   build.bat -a=install -w=server
   

2. On 64-bit windows machine

   cd c:\mgdev
   mkdir Release64
   build64.bat -a=install -w=server
   

Note 1: these two batch files might be out-of-date, look into the file with a text editor to see what it does to decide how to install mapguide server in your system.

Note 2: After Building is done successfully, there should be bin folder under Server, installation step is not necessarily needed to run mapguide server.

Note 3: building mapguide source does not necessarily build web extensions. Web extension are third party applications and are not stored in subversion repository, as mentioned above. So, the only thing that needs to be done is to configure the web extensions.

Install and configure Web Extension

Apache2

1. Download and Install Apache2.2.16 for Windows from ​Here. Unzip the downloaded file to c:\svn\mgdev\Release\Web or c:\svn\mgdev\Release64\Web

2. edit httpd.conf

   cd c:\svn\mgdev\Release\Web\Apache2\conf
   edit httpd.conf
   

Create another config file, name it mapguide.conf with the following contents(edit it accordingly for your system)

notepad mapguide.conf

Note: Attached are sample conf files.

Tomcat

IIS

Testing Installation

1. Create a environment variable MENTOR_DICTIONARY_PATH, which points to c:\mgdev\Oem\CsMap\Dictionaries

2. Start MapGuide Server

   cd c:\mgdev\Release\Server\bin
   mgserver.exe run
   

3. Start MapGuide Web Extension

4. Open a browser to http://localhost:8008/mapguide/phpviewersample/ajaxviewersample.php