Project

General

Profile

1
<h2>Installing mapbuilder</h2>
2

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

    
14
<p>
15
There are 2 server side scripts that may be required, depending on your 
16
application.
17
Applications can be written so that these are not required at all;
18
the Simple demo is one example where all XML documents are served from the 
19
same domain and there is no "save" functionality in the page.
20
</p>
21
<ul> 
22
<li> a proxy script to bypass JavaScript security restrictions when loading 
23
documents that originate from a different domain than yours.
24
</li>
25
<li>a script used to write XML documents back to your server.
26
</li>
27
</ul>
28

    
29
<p>
30
Mapbuilder is available as .zip file for use in a Apache/PHP environment, 
31
as well as a .war file for J2EE servlet containers like Jakarta Tomcat.
32
Installation is generally just a matter of expanding the archive into
33
the correct directory.
34
All server-side scripts are automatically available by installing the appropriate
35
archive.
36
More details on each environment are available in the following pages.
37
</p>
38

    
39
<dl class="med">
40
  <dt class="title">Tomcat environment:</dt>
41
  <dd>
42
  Download the xxx-war.zip archive and extract the mapbuilder.war file to the tomcat webapps
43
  directory. 
44
  Depending on your Tomcat setup, you may or may not have to restart Tomcat, 
45
  the default tomcat setup will expand the .war file automatically.
46
  Installation details for other servlet containers may vary.
47
  <dd>
48
  <dt class="title">Apache/PHP environment</dt>
49
  <dd>
50
  Download the mapbuilder zip file and unpack it into a web accessible directory.
51
  With Apache this will be the htdocs directory.
52
  Installation details for other web servers may vary.
53
  </dd>
54
</dl>
55

    
56
<p>
57
  You should then be able to try it out from this URL: 
58
  <a href="/mapbuilder/demo/complete">http://localhost/mapbuilder/demo/complete</a>
59
</p>
(4-4/8)