Installer notes

You cannot use the windows installer to in-place upgrade an existing MapGuide Open Source 3.1.0 installation, you cannot have 3.1.0 and 3.1.2 installed side-by-side with the windows installer and you must uninstall 3.1.0 before installing 3.1.2. Use the InstantSetup? bundle if side-by-side installs are required. Be sure to back up any data and applications before carrying out the new installation.

On linux, the install path is /usr/local/mapguideopensource-3.1.2 and the FDO install path is /usr/local/fdo-4.1.0. You must uninstall 3.1.0 before installing 3.1.2. Be sure to back up any data and applications before carrying out the new installation.

Before upgrading, it is recommended that you take a backup of your existing repository (whether that is through creating MGP packages with the MapGuide Site Administrator or using the provided repository backup tools/scripts)

Sample Data

This release includes a new version of the Sheboygan Sample data set demonstrating features introduced in this and recent versions of MapGuide

Extra Files

The install packages for this release of MapGuide omit several USA-specific CS-Map grid data files which are only required if your spatial data uses a coordinate system that involves an NSRS datum. See ​CS-Map RFC 7 for more information.

As a result, our installation packages are now up to 150 MB lighter as a result of this omission.

To use the Fusion build tools, extract the zip file contents into your fusion directory and navigate to this directory in the command prompt and execute the following command:

ant compress

This will re-build fusionSF.js and fusionSF-compressed.js under fusion\lib

Due to the default installation location (under Program Files), you may need to do this under a UAC-elevated command prompt or fix the directory permissions so that normal users can create/modify files.

Windows Compatibility

OS

32-bit

64-bit

Windows 10

Yes+

Yes

Windows Vista

Maybe+

Maybe+

Windows 7

Yes

Yes

Windows Server 2008

Yes+

Yes+

Windows Server 2008 R2

N/A

Yes

Windows 8

Yes1

Yes1

Windows Server 2012

N/A

Yes1

Windows Server 2016

N/A

Yes

Windows 8.1

Maybe1

Maybe1

+ Not tested, but similar enough to Windows 7 to theoretically work

IIS configuration will probably not work. Apache config should work due to its self-contained nature

Installing msttcorefonts for your specific distro is strongly recommended to avoid the case of "hieroglyphic" labels. You can specify the path of your msttcorefonts installation in serverconfig.ini to have MapGuide load these fonts in on startup.

Using the Linux builds of MapGuide on distributions they were not built for is not supported. If you want to run MapGuide on:

Versions of Ubuntu that is not 14.04

CentOS 7 or higher

A different Linux distribution

Then consider running MapGuide in a ​docker container that is based on Ubuntu 14.04 or CentOS 6.x. This installation method is not supported and is only mentioned here for informational purposes.

The 64-bit Linux builds of MapGuide are made available for testing/feedback. These builds should still be considered experimental.

The following FDO providers may or may not not be functional in 64-bit Linux builds of MapGuide

The following FDO providers have been validated in a 64-bit Linux environment by their respective FDO unit test suites (ie. All tests pass). Feedback on these providers in 64-bit Linux still welcome/appreciated:

SDF

SQLite

GDAL

OGR

Fusion: Bing/VirtualEarth? commercial layers may conflict with Google layers if they are both specified in a Flexible Layout. If you have a Bing/VirtualEarth? layer as the default, switching to a Google layer in your Fusion application will cause the Google layer to be displaced and vice versa.

Installer may generate a providers.xml entry for the ArcSDE provider if all providers are enabled in the "Feature Selection" dialog even if the installer does not actually bundle the ArcSDE provider. You can simply remove this entry from providers.xml after installation if this is the case.

CentOS: mgserver may throw double-free errors on service startup or server shutdown. Should not affect server behaviour.

The Performance Profiler on Linux may not work due to insufficient permissions to save the generated report files. To fix this, ensure the directory /usr/local/mapguideopensource-3.1.0/webserverextensions/www/mapadmin/profilingmapxml on linux has sufficient write permissions for the user account that the PHP executable runs under.

Uninstallation can leave "ghost" IIS virtual directories behind, which currently is any virtual directory / application you create inside the mapguide virtual directory that was not created by the installer
These "ghost" directories may impact on future installations. To ensure these "ghost" directories are completely gone after uninstallation, use the appcmd.exe utility to remove these virtual directories. You can find out what virtual directories are still there by running

appcmd.exe list vdir

PHP Viewer and Developer's Guide samples will not work if the PHP viewer feature is not enabled. Likewise for .net and Java. Nothing in the installer will prevent you from making such a choice.

For the IIS configuration or Apache configuration with a custom http port, you will have to update the WFS and WMS server name configuration properties via the MapGuide Site Administrator after installation if you intend to use such features. This is currently set to localhost:8008 for both.