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 (i.e MapGuide Web Application)
   • 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, if you are working on trunk code, the chances are bugs or issues might be introduced by developers, so look into the file with a text editor to see what it does to decide how to use it to install mapguide server in your system. The baseline for installation is just regrouping files around.

Note 2: After Building is done successfully, there should be bin folder under Server, installation is not necessarily needed since you are working on the source code.

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
   

or if you skip the Install step

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

3. Configure and Start Web Extensions

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