1.0. Introduction

The Internet Mapping Framework for ArcIMS is a Java servlet application that runs under a variety of servlet engines, such as Apache Tomcat, ServletExec, JRun, etc. Java servlet engines are like normal web servers in that they can serve static content like HTML pages and images to a web browser, but they can also serve Java content based on pre-compiled Java class files and JSP scripts.

This page describes how to install the IMF application within a servlet engine. It assumes that you have the servlet engine installed on your server already. However, there are some pre-requisites or sytem dependencies for running IMF, so you may need to update your system first. This document also tells you how to do that.

There are also some settings required to IMF itself that need to be done before some of the IMF functions work properly, and some troubleshooting tips included on this page.

Should you have any problems getting IMF going on your server, please contact us right away for assistance.

2.0. System Requirements

IMF runs under virtually any servlet engine on any kind of server. However, the servlet engine needs to be set up to use the Java 1.4 software development kit (SDK). It is possible that your servlet engine has been set up to use an earlier version of Java, or that you have installed the Java runtime environment (JRE) instead of the SDK. The SDK is required because the JSP scripts included with IMF are compiled on your server, and the JRE doesn't include the compiler.

The most recent version of the Java 1.4 release is recommended. At the time of writing, it is v1.4.2_06. You can find the release at http://java.sun.com/.

Along with Java, you also need to install Sun's Java Advanced Imaging (JAI) on your server. It is available at http://java.sun.com/products/java-media/jai/current.html Install using the SDK installation method, if possible.

3.0. Getting the IMF distribution

Download the most recent version of the IMF from ftp.moximedia.com. Navigate to the /imf/imf-aims-v5.0 directory. The most recent version is always called imf-aims-current.tar.gz. If you are using a previous version 5.0 release of IMF for ArcIMS, you can update it using the file imf-aims-updates.tar.gz. If you want to download a specific version, it is available in the files with the numbers.

Use your assigned FTP account connection information to connect. You must use an FTP client, a Linux / UNIX terminal or the Windows command prompt to get the files. Access is restricted, so you cannot use a browser to get the files. Remember to download the files in BINARY format.

4.0 Install the software on your server