HomeArrowHead
 

Installing ArrowHead

This How-To describes installing ArrowHead into a Java Servlet Server
0.2.3 by Terence Haddock

Overview

This How-To describes installing ArrowHead into a Java Servlet Server

Prerequisites

  • JDK 1.4.2 - Tested with 1.4.2. Available Here.
  • Java Servlet Server - Tested with Jakarta Tomat version 5.0.27. Available Here.
  • Log4j - Tested with 1.2.8. Available Here.
  • JRegEx - Tested with 1.2_01. Available Here.
  • Java Activation Framework (JAF) - Tested with version 1.0.2. Available Here.
  • JavaMail - Tested with version 1.3.1. Available Here.
  • JDom - Tested with version Beta 9. Available Here.
  • OSCache - Tested with version 2.0.2. Available Here.

Steps

Create a webapp

Note

This example uses Tomcat as the Java servlet server. If another servlet server is used, please follow the instructions for your servlet server for creating and installing a webapp.
  • Assuming Tomcat is installed under /usr/share/tomcat, the following commands (as the tomcat user or the root user) will create a webapp directory: $ cd /usr/share/tomcat/webapps $ mkdir aspfiles $ mkdir aspfiles/WEB-INF $ mkdir aspfiles/WEB-INF/lib
  • Copy the web.xml file (sample downloaded from home page) into asfiles/WEB-INF: $ cp /home/user/downloads/web.xml /usr/share/tomcat/webapps/aspfiles/WEB-INF

Copy required libraries

  • Copy the required JAR files downloaded from the locations described above.
  • At the minimum there should be: aspfiles/WEB-INF/lib/arrowhead-0.x.x.jar aspfiles/WEB-INF/lib/log4j-1.2.8.jar aspfiles/WEB-INF/lib/jregex1.2.01.jar
  • For CDONTS Email there should also be: aspfiles/WEB-INF/lib/activation.jar aspfiles/WEB-INF/lib/mail.jar
  • For the MSDOM interface there should also be: aspfiles/WEB-INF/lib/jdom.jar
  • For OSCache compiled script caching there should also be: aspfiles/WEB-INF/lib/oscache-2.0.2-22Jan04.jar aspfiles/WEB-INF/lib/commons-collections.jar aspfiles/WEB-INF/lib/commons-logging.jar

Copy the ASP files to the webapp

Note

If ArrowHead is running on a system where the file system is case sensitive (Linux, for example), the ASP files will be case sensitive. This is an important difference from ASP scripts running on Windows.
  • Copy the ASP files of the webapp to: aspfiles
  • If there are no existing ASP files to copy, or for a quick test, create the file "test.asp", with the following contents: <% Response.Write("Hello from ASP!") %>

Re-start Tomcat

  • Re-start Tomcat, then browse to the ASP file created, for example: http://localhost:8080/aspfiles/test.asp
  • The script test.asp should display just the text: Hello from ASP!

Note

The web.xml sample distributed with ArrowHead contains mapping for default.asp, Default.asp, and index.asp as welcome files.

by Terence Haddock