README.DynamicWorkload
1############################################################################
2# #
3# The contents of this file are subject to the WebStone Public License #
4# Version 1.0 (the "License"); you may not use this file except in #
5# compliance with the License. You may obtain a copy of the License #
6# at http://www.mindcraft.com/webstone/license10.html #
7# #
8# Software distributed under the License is distributed on an "AS IS" #
9# basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See #
10# the License for the specific language governing rights and limitations #
11# under the License. #
12# #
13# The Original Code is WebStone 2.5. #
14# #
15# The Initial Developer of the Original Code is Silicon Graphics, Inc. #
16# and Mindcraft, Inc.. Portions created by Silicon Graphics. and #
17# Mindcraft. are Copyright (C) 1995#1998 Silicon Graphics, Inc. and #
18# Mindcraft, Inc. All Rights Reserved. #
19# #
20# Contributor(s): ______________________________________. #
21# #
22############################################################################
23
24README.DynamicWorkload 2.8 98/10/05
25
26WebStone Dynamic Workload
27
28WebStone includes workloads to test server support for
29dynamically generated Web pages. These include CGI programs and
30dynamic load generating modules (LGMs) that use server-specific
31APIs like NSAPI and ISAPI.
32
33The first step is to install the LGM on the Web server to be
34tested. The module can be invoked either by calling it directly
35or by configuring the Web server to service a request using the
36LGM on the basis of the filename suffix of the requested URL.
37
38There are three basic steps in preparing for testing with dynamic
39workloads. The details differ according to the particular method.
40
411) Install the load-generating program or module. This is an
42 executable program for CGI testing, a shared library (Unix) or
43 a DLL (Windows NT) for NSAPI testing, or a DLL for ISAPI testing.
44
452) Configure the server to recognize the URL that invokes the
46 load generator as an object that generates dynamic data. This
47 usually means defining a meaning for the module's URL suffix
48 in the server's mime.types file.
49
503) Check that the WebStone URL list (filelist) for the tests has URLs
51 that properly invoke the workload, with the correct location in the
52 server's document directory and the correct URL suffix.
53 Note that the argument to the dynamic URL for WebStone 2.5
54 dynamic load requests must be an absolute filename.
55
56
57
58Here's an example configuration to allow the Netscape Enterprise
59Server 3.5.1 to serve both WebStone 2.0 and WebStone 2.5 style requests.
60First, go to the directory where the config files for your Netscape
61server are stored.
62
63 In obj.conf, add the lines:
64
65 Init fn="load-modules" funcs="nsapi-send" shlib="/ws20_ns.so"
66 NativeThread="no"
67 Init fn="load-modules" funcs="ws-nsapi-send" shlib="/ws25_ns.so"
68 NativeThread="no"
69 Service method=(GET|HEAD) fn=nsapi-send type=magnus-internal/ws20-ns
70 Service method=(GET|HEAD) fn=ws-nsapi-send type=magnus-internal/ws25-ns
71
72 In mime.types, add the lines:
73
74 type=magnus-internal/ws20-ns exts=ws20-ns
75 type=magnus-internal/ws25-ns exts=ws25-ns
76
77 Restart the Web server.
78
79Note that the tester is free to choose any text for the URL suffix.
80The only requirement is that the suffix in obj.conf and in mime.types
81match the suffix used in the filelist.
82
83Workloads included in the conf directory:
84
85 filelist-dyn-cgi-ws20 For use with the ws20_cgi Load Generating
86 filelist-dyn-cgi-ws20-win Module. This is the CGI module that was
87 used in WebStone 2.0 This workload is
88 100% dynamic content. The version with
89 the "-win" ending is for Windows systems.
90
91 filelist-dyn-cgi-ws25 For use with the ws25_cgi Load Generating
92 filelist-dyn-cgi-ws25-2in Module. This is the new WebStone 2.5 CGI
93 module. This workload is 100% dynamic
94 content. The version with the "-win"
95 ending is for Windows systems.
96
97 filelist-dyn-ws20-ns For use with the older WebStone 2.0 API
98 filelist-dyn-ws20-iis Load Generating Module. This workload is
99 100% dynamic content. The two files are
100 for Netscape ("-ns" ending) and Microsoft
101 IIS ("-iis") web servers.
102
103 filelist-dyn-ws25-ns For use with the new WebStone 2.5 API
104 filelist-dyn-ws25-iis Load Generating Module. This workload is
105 100% dynamic content. The two files are
106 for Netscape ("-ns" ending) and Microsoft
107 IIS ("-iis") web servers.
108
README_NT
1README_NT 1.4 98/07/25
2
3 README_NT: Using WebStone 2.5 on Windows NT 4.0
4
5Unpack the WebStone distribution using WinZip (available at most
6shareware web sites). You can also unpack it from a console window
7with gzip and pax:
8
9 gunzip < WS25NT40.tgz | pax -r
10
11
12WebStone requires that a remote execution server (rexecd) be running
13on each load-generating client system. We use the rexecd daemon from
14the Ataman TCP Remote Login Services product from Ataman Software Inc.,
15avaliable for purchase through <www.ataman.com>. Install it according
16to the instructions that are provided with the product. Only the
17rexecd server need be installed.
18
19The WebStone user interface uses Perl version 5. A free version of
20Perl 5 is avaliable from the Active State web site,
21<www.activestate.com/pw>.
22
23The WebStone benchmark can be run without installing Perl if you
24call webmaster directly from a console window or from a batch file.
25
26A sample configuration file script is provided, "conf/testbed.win".
27
28
29Compilation:
30
31The WebStone 2.5 source distribution includes resource files to compile
32the programs from a Microsoft Developer's Studio C++ workspace as well
33as make files that can be used to compile the programs from the
34console command line. These files are in WebStone\NT40. This
35directory also includes Makefiles and a batch script to run the
36make program.
37
38The webmaster and webclient programs need special compilation options
39to support sockets and multithreaded operation. These options are set
40in the provided compilation resource files. If you use a different
41compiler, consider these settings:
42
43 - Set the variable "_MT" for the C preprocessor.
44 - Link against the "wsock32.lib" library.
45 - Link against the "libcmt.lib" or "libcmtd.lib" (debug) library instead
46 of the default "libc.lib" or "libcd.lib", respectively. With the
47 Microsoft link editor this means explicitly hiding the default C library:
48
49 /nodefaultlib:libcd.lib
50
51
52-----------
53WebStone includes software developed by Ataman Software, Inc.
54
55