############################################################################
#                                                                          #
# The contents of this file are subject to the WebStone Public License     #
# Version 1.0 (the "License"); you may not use this file except in         #
# compliance with the License. You may obtain a copy of the License        #
# at http://www.mindcraft.com/webstone/license10.html                      #
#                                                                          #
# Software distributed under the License is distributed on an "AS IS"      #
# basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See      #
# the License for the specific language governing rights and limitations   #
# under the License.                                                       #
#                                                                          #
# The Original Code is WebStone 2.5.                                       #
#                                                                          #
# The Initial Developer of the Original Code is Silicon Graphics, Inc.     #
# and Mindcraft, Inc.. Portions created by Silicon Graphics. and           #
# Mindcraft. are Copyright (C) 1995#1998 Silicon Graphics, Inc. and        #
# Mindcraft, Inc. All Rights Reserved.                                     #
#                                                                          #
# Contributor(s): ______________________________________.                  #
#                                                                          #
############################################################################

README.DynamicWorkload 2.8 98/10/05

WebStone Dynamic Workload

WebStone includes workloads to test server support for
dynamically generated Web pages.  These include CGI programs and
dynamic load generating modules (LGMs) that use server-specific
APIs like NSAPI and ISAPI.

The first step is to install the LGM on the Web server to be
tested.  The module can be invoked either by calling it directly
or by configuring the Web server to service a request using the
LGM on the basis of the filename suffix of the requested URL.

There are three basic steps in preparing for testing with dynamic
workloads.  The details differ according to the particular method.

1) Install the load-generating program or module.  This is an
   executable program for CGI testing, a shared library (Unix) or
   a DLL (Windows NT) for NSAPI testing, or a DLL for ISAPI testing.

2) Configure the server to recognize the URL that invokes the
   load generator as an object that generates dynamic data.  This
   usually means defining a meaning for the module's URL suffix
   in the server's mime.types file.

3) Check that the WebStone URL list (filelist) for the tests has URLs
   that properly invoke the workload, with the correct location in the
   server's document directory and the correct URL suffix.
   Note that the argument to the dynamic URL for WebStone 2.5
   dynamic load requests must be an absolute filename.

	

Here's an example configuration to allow the Netscape Enterprise 
Server 3.5.1 to serve both WebStone 2.0 and WebStone 2.5 style requests.
First, go to the directory where the config files for your Netscape
server are stored.

    In obj.conf, add the lines:

      Init fn="load-modules" funcs="nsapi-send" shlib="/ws20_ns.so" 
          NativeThread="no"
      Init fn="load-modules" funcs="ws-nsapi-send" shlib="/ws25_ns.so" 
          NativeThread="no"
      Service method=(GET|HEAD) fn=nsapi-send type=magnus-internal/ws20-ns
      Service method=(GET|HEAD) fn=ws-nsapi-send type=magnus-internal/ws25-ns

    In mime.types, add the lines:

    	type=magnus-internal/ws20-ns        exts=ws20-ns
    	type=magnus-internal/ws25-ns        exts=ws25-ns

    Restart the Web server.

Note that the tester is free to choose any text for the URL suffix.
The only requirement is that the suffix in obj.conf and in mime.types
match the suffix used in the filelist.

Workloads included in the conf directory:

    filelist-dyn-cgi-ws20          For use with the ws20_cgi Load Generating
    filelist-dyn-cgi-ws20-win      Module.  This is the CGI module that was
				   used in WebStone 2.0  This workload is
				   100% dynamic content.  The version with
				   the "-win" ending is for Windows systems.

    filelist-dyn-cgi-ws25          For use with the ws25_cgi Load Generating
    filelist-dyn-cgi-ws25-2in	   Module.  This is the new WebStone 2.5 CGI
				   module.  This workload is 100% dynamic 
				   content.  The version with the "-win"
				   ending is for Windows systems.

    filelist-dyn-ws20-ns           For use with the older WebStone 2.0 API 
    filelist-dyn-ws20-iis          Load Generating Module.  This workload is
				   100% dynamic content.  The two files are 
				   for Netscape ("-ns" ending) and Microsoft 
				   IIS ("-iis") web servers.

    filelist-dyn-ws25-ns           For use with the new WebStone 2.5 API 
    filelist-dyn-ws25-iis          Load Generating Module.  This workload is
				   100% dynamic content.  The two files are 
				   for Netscape ("-ns" ending) and Microsoft 
				   IIS ("-iis") web servers.
