MOWS Configuration

This document describes the configuration of MOWS. The URL of this document is: http://mows.rz.uni-mannheim.de/mows/config.html

1. General

The default configuration file is placed in the etc directory at the MOWS home directory as center.conf. It is an ASCII file with a syntax similar to that of LISP. The outer most list must begin with 'MOWSCenter' followed by '1.0'. In this list, the process specific information is specified. Within this process, several server threads may be created by adding a list that begins with 'MOWS'. In this list, the server specific information is specified.

2. MOWSCenter

The generic syntax of MOWSCenter configuration is:

(MOWSCenter 1.0
  (Host hostname)
  (User userid)
  (Group groupid)
  (MOWS ...)
  (MOWS ...)
  ...)
The 'Host' parameter denotes the hostname of the server. The 'User' and 'Group' parameters may be used for Unix systems that use a privileged mode to listen to a certain port. In this case, the server can be started with the privileged mode and change its IDs to the specified numbers after acquiring the port. The native library for Solaris and Linux OS that implements this feature is included in the lib directory. For other systems, these parameters are ignored. In the specification of MOWSCenter, several MOWS servers may be defined.

3. MOWServer

The generic syntax of MOWS server configuration is:

  (MOWS mowsname
    (Port portnumber)
    (Module ...)
    (Module ...)
    ...)

  (MOWS mowsname
    (VirtualHost hostname)
    (Port portnumber)
    (Module ...)
    (Module ...)
    ...)
The 'Port' parameter specifies the port number which the server listens to. The 'VirtualHost' prameter allows non-IP based multi-hosting. Several servers with different module configurations may listen to the same port. A set of modules may be included in the MOWS specification which characterizes the behavior of the server. These modules are loaded to the server dynamically. Modules may be loaded from the local system or from a remote system over the network.

4. Modules

The list of available modules and their usage are described in the page MOWS modules.


version: 19970321