^{HTTP SERVER 2.1}

Category/Domain:	CommTools
Scol Engine compatibility:	V3.0 and higher
Updated:	09/2000

Function

The HTTPSERVER module is a simple HTTP server used to share HTML documents on the World Wide Web; a basic CGI application will soon be available via DMS queries. The server's configuration requires the following:

- A TCP port for HTTP: 80 (by default) or :8080 (for a web server), however, it may be the case that either the server cannot be started, or users cannot connect: ports lower than 1023 are often blocked by firewalls and/or the systems.

- A root directory for HTML documents: the server is referenced as ‘http://x.x.x.x’, where x.x.x.x represents the IP (the name of the machine can be used if it is registered in the DNS directory) and each URL will be appended in the document's root directory. For example:

‘http://x.x.x.x/my_documents/mondoc.html’ represents the file [root_directory]\my_documents\mondoc.html in the SCOL partition.

To process HTTP errors, the server can provide specific HTML pages referenced in the root directory in ‘/error/codexxx.html’. The most common HTTP error codes are:

400 Bad query

404 Page not found

501 Not implemented

The HTTPSERVER module includes a special filter used to create a valid URL from a simple HTTP path; an action (url_in) and an event (url_out) are available.

Configuration

Figure 1: Main HTTPSERVER module interface

1- Port: Used to specify the port (80 by default).

2- Root: Used to declare the HTTP root directory.

Implementation

Action	Function
module.event à httpServer.url_in	Collects the path to a html file that is stored on the server in the root folder of the module (e.g. \myfile.htm) and changes this path into a url (http:\\myIP\myfile.htm)

Event	Function
httpServer.url_out à module.action	url_out generates an action

Zone	Function	Interface	Assigned
None