Dwarf HTTP Server
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
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
- 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.
- Extract the Dwarf HTTP Server distribution to the directory where you extracted the
base Dwarf distribution previously.
- 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
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.
- 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.
- 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.
- The application log files, including the HTTP transfer logs, can be found
in the "log/" subdirectory of the Dwarf installation home.
See the HTTP Server Configuration
Guide for more information about the server configuration.
Return to the main page.
Copyright (c) 1999-2005, Gnome Ltd. All rights reserved.