1 |
3032
|
perry
|
<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>
|