Skip to end of metadata
Go to start of metadata

The purpose of this section is to explain how to download and install MapBuilder 

The design philosophy of MapBuilder is to minimize the server requirements, but for a web application you will need a web server to serve your pages at a minimum. (The exception to this is for applications that don't need to load XML documents from outside the web, in which case you can also load your application using the file:// protocol. For example, try loading the simple demo by double clicking on the index.html file from a directory explorer view.)

There are 2 server side scripts that may be required, depending on your application. Applications can be written so that these are not required at all; the Simple demo is one example where all XML documents are served from the same domain and there is no "save" functionality in the page.

A proxy script to bypass JavaScript security restrictions when loading documents that originate from a different domain than yours. Javascript security prevents a website at to post to another domain, eg , so instead a proxy is set up on the server like which forwards requests to

In order to enable the proxy, you should install mapbuilder into a servlet like tomcat using mapbuilder.war or alternatively ensure that the PHP module is enabled in your Apache configuration.

MapBuilder is available as .zip file for use in a Apache/PHP environment, as well as a .war file for J2EE servlet containers like Jakarta Tomcat. Installation is generally just a matter of expanding the archive into the correct directory. All server-side scripts are automatically available by installing the appropriate archive. More details on each environment are available in the following pages.

  • Tomcat environment
    Download the archive and extract the mapbuilder.war file to the Tomcat webapps directory. Depending on your Tomcat setup, you may or may not have to restart Tomcat, the default tomcat setup will expand the .war file automatically. Installation details for other servlet containers may vary.
  • Apache-PHP environment
    Download the MapBuilder zip file and unpack it into a web accessible directory. With Apache this will be the htdocs directory. Installation details for other web servers may vary.

You should then be able to try it out from this URL: http://localhost/mapbuilder/examples/complete(or perhaps http://localhost:8080/mapbuilder/complete in Tomcat).  If it doesn't work correctly, please refer to the installation Troubleshooting page.


  • No labels