[Inso Home Page] [Home] [Collection] [Book] [Expand] [Collapse] [Search Forms] [Previous Section with Hits] [Next Section with Hits] [Clear Search] [Preferences] [Print] [Help]

 inside  Expand Search


   Server Logs   [Table of Contents]    The NSAPIProtocolModule Directives

DynaWeb Publishers Guide

[-] Appendix B: The DynaWeb Internet Server
[-] Configuration Directives

Configuration Directives

Overview of the dwhttpd.cfg File

The dwhttpd.cfg file is used to configure various components of the DynaWeb Internet Server. The file is a text file and can be read with any text editor. The file also supports TCL constructs such as variable and command substitution and conditional branching to simplify various aspects of the server's configuration.

The dwhttpd.cfg file is located in the data/config directory beneath the server's installation directory.

The following sections will describe some of the directives you can modify to change your server's behavior.

PidLog

Note: This is only used on UNIX platforms.

Syntax

PidLog <pid-log-filename>

Description

The PidLog directive specifies the name of the log file which will contain the process ids of the various server processes as well as the path to that file.

Example

PidLog /pro/server/sunos5s/bin/pid.log

MainLog

Syntax

MainLog <main-log-filename>

Description

The MainLog directive specifies the name and location of the main server log file. The main log file serves as the log file for the server controller process.

Example

MainLog /pro/server/logs/main.log

Services

Syntax

Services {
     name1  type1
     name2  type2
     ...
     nameN  typeN 
}

Description

The Services directive allows the administrator to configure which services the server will start at startup. The "name" parameter is a human-recognizable service name, and the "type" determines the type of service "name" is. Currently the only "type" allowed is "NSAPIProtocolModule" which tells the server that this service's definition is supplied by the NSAPIProtocolModule directive.

Example

Services {
   http-8000  NSAPIProtocolModule 
}

ReReadCfgOnRestart (UNIX only)

Syntax

ReReadCfgOnRestart [yes | no | true | false]

Description

The ReReadCfgOnRestart directive tells the DynaWeb Internet Server whether it should reload its configuration file (dwhttpd.cfg) on restart. The directive should be placed in the dwhttpd.cfg file. Currently, it only reads the nsapi.cfg file on restart.

A value of "yes" or "true" tells the server to read the dwhttpd.cfg file on restart. A value of "no" or "false" tells the server to only read the nsapi.cfg file (the current behavior).

Example

ReReadCfgOnRestart yes

NSAPIProtocolModule

Syntax

NSAPIProtocolModule <name> {
   <nsapi-protocol-module-subdirectives>
}

Description

This directive allows the server administrator to configure the different modules specified in the Services directive listed above. The "name" parameter is the name of the specific module that is being configured. The "nsapi-protocol-module-subdirectives" are the list of directives that can be set for each module. The following directives are supported.

These directives will be covered in detail in the following sections.

Example

NSAPIProtocolModule http-8000 {
   ServerName  www.inso.com
   ServerUser  nobody
   Port        8000
   MaxThreads  32
   NumRequests 100000
   AccessLog   /pro/server/logs/access.log
   ErrorLog    /pro/server/logs/errors.8000 
   MimeMap     /pro/server/data/config/mime.typ
   ObjectFile  /pro/server/data/config/nsapi.cfg
   ErrorPath   /pro/server/data/error 
}

   Server Logs   [Table of Contents]    The NSAPIProtocolModule Directives