Dwarf HTTP Server 1.3.3

Installation

Content

• Requirements
  
• Installation
• Configuration

Requirements

Since the Dwarf HTTP Server is a Dwarf-based application, the base Dwarf Server Framework distribution must be installed first on your computer.

The following additional extensions are required:

• Java Servlets 2.2
  (http://java.sun.com/products/)

These extensions are bundled with the distribution package by default.

The Java™ 2 Software Development Kit (JDK) is needed only if you are going to use Java Server Pages, because the Jasper compiler used in Dwarf HTTP Server requires it. An alternative is to use the open source Jikes compiler instead.

Installation

1. Install the base Dwarf Server Framework distribution. In order to do it, you will need a base Dwarf distribution zipfile whose version matches the version of the Dwarf HTTP Server distribution file. The distribution files are typically named dwarf-X.Y.Z and dwarf_http-X.Y.Z, where X.Y is the matching version number. You can download all distribution files from the Gnome Ltd.'s web site.
   
   
2. Extract the Dwarf HTTP Server distribution to the directory where you extracted the base Dwarf distribution previously.
   
   
3. All required extensions should reside in the "lib/ext/" subdirectory of the Dwarf installation. Locate the "tools.jar" file from the JDK installation and copy it to the "lib/ext/" subdirectory of the Dwarf installation home. This step is required only for compiling the Java Server Pages. If there is no JDK available, you may configure the server to use the open source Jikes compiler instead. Details of this process are covered by the Configuration Guide.
   
   NOTE: all sample JSP-based applications included in the distribution require the "tools.jar" file to be in the classpath. You must re-configure them manually to use the Jikes compiler instead.
   
   
4. The "conf/" subdirectory of the Dwarf installation home is a place for the production configuration files, used by the Dwarf-based applications. It is empty by default. The common sample configuration files related to the HTTP server can be found in the "conf/samples/http/" subdirectory.This directory contains also several subdirectories with configuration files required by the particular sample web applications.
   
   
5. Run one of the sample applications with the "run.bat" command on Windows or the "run.sh" command on Unix system:

       C:\Dwarf> run.bat conf/samples/http/welcome/main.xml
   
       -- or --
   
       localhost:/usr/dwarf# ./run.sh conf/samples/http/welcome/main.xml
       

   Run your favorite web browser and open the "http://127.0.0.1:8080" location. You should get a simple welcome page sent by the Dwarf HTTP Server, indicating that the server application has been configured and started properly.
   
   You can also quickly try out some of the included examples by running the "examples.bat" or "examples.sh" file.
   
   
6. The application log files, including the HTTP transfer logs, can be found in the "log/" subdirectory of the Dwarf installation home.

Configuration

See the HTTP Server Configuration Guide for more information about the server configuration.

Return to the main page.