Utility directory read-me

A small collection of utilities (and in some cases, scripts) useful in the adminstration of a WASD site.

Some are covered in greater detail in Features and Facilities document, Utilities and Facilities section.

Name Source Code Comment

Apache Bench ab.c Ancient server stress-test and benchmarking tool, as used in the (rather older) Apache Distribution(s). Later versions cannot be utilised as they have increasing Apache source code dependencies. Plain HTTP/1.1 only. Into the twenty-first century, tools such as nghttp and h2load are required and recommended.

Calogs calogs.c Consolidate access logs (pronounced the same as the breakfast cereal brand :-) merges multiple HTTP server common and combined format access logs into a single log file with records in time-order.

HTAdmin htadmin.c Command-line administration of the WASD .$HTA authentication databases.

HTTPdMon httpdmon.c One of the fundamental tools for monitoring the status of the WASD server. This command-line utility continuously displays a number of key server process quotas, server counters and latest request data.

Proxy Cache pcache.c This program can act as a command-line utility or CGI(plus)-compliant script. It is used to access the information about or contents of a WASD proxy cache file.

Proxy Munge proxymunge.c Script that munges (rewrites) URIs/URLs to provide a more effective reverse-proxy.

Quick and Dirty
Log Statistics qdlogstats.c Useful command-line and script utility to generate quick snapshots and elementary statistics of server usage from access logs. Intended for those moments when we think "I wonder how many times that new archive has been downloaded?", "How much data was transfered during November?", "How often is such-and-such a client using the authenticated so-and-so service?", "How much has the mail service been used?" ... and want the results in a matter of seconds (or at least a few tens of seconds :-)

Random Seed randseed.c Small utility designed to populate a file with 2048 bytes of PRNG seed data. The seed should be high entropy.

Security .ch Army Knife sechan.c (Pronounced "session") is used by SECURE.COM and associated procedures to ensure package file system security settings are appropriate. It is also available for direct use by the site administrator.

WASD Bench wb.c An historical utility and analogue to Apache Bench used for similar purposes (testing, exercising and generating performance metrics). It also has the significant performance and granularity advantage of using the underlying $QIO services and not the socket API, and is AST event driven. Plain HTTP/1.1 only. As with AB.C, into the twenty-first century, tools such as nghttp and h2load are required and recommended.

Wot's Up? wotsup.c The WASD Over-The-Shoulder Uptime Picket is designed to monitor WASD in a production environment for the purpose of alerting operations staff to conditions which might cause that production to be adversely impacted. The utility runs in a detached process and monitors the server environment by periodically polling various server data. Alert reports can be delivered via any combination of OPCOM message, MAIL, site-specific DCL command, and log file entry.

Name	Source Code	Comment
Apache Bench	ab.c	Ancient server stress-test and benchmarking tool, as used in the (rather older) Apache Distribution(s). Later versions cannot be utilised as they have increasing Apache source code dependencies. Plain HTTP/1.1 only. Into the twenty-first century, tools such as nghttp and h2load are required and recommended.
Calogs	calogs.c	Consolidate access logs (pronounced the same as the breakfast cereal brand `:-)` merges multiple HTTP server common and combined format access logs into a single log file with records in time-order.
HTAdmin	htadmin.c	Command-line administration of the WASD .$HTA authentication databases.
HTTPdMon	httpdmon.c	One of the fundamental tools for monitoring the status of the WASD server. This command-line utility continuously displays a number of key server process quotas, server counters and latest request data.
Proxy Cache	pcache.c	This program can act as a command-line utility or CGI(plus)-compliant script. It is used to access the information about or contents of a WASD proxy cache file.
Proxy Munge	proxymunge.c	Script that munges (rewrites) URIs/URLs to provide a more effective reverse-proxy.
Quick and Dirty Log Statistics	qdlogstats.c	Useful command-line and script utility to generate quick snapshots and elementary statistics of server usage from access logs. Intended for those moments when we think "I wonder how many times that new archive has been downloaded?", "How much data was transfered during November?", "How often is such-and-such a client using the authenticated so-and-so service?", "How much has the mail service been used?" ... and want the results in a matter of seconds (or at least a few tens of seconds `:-)`
Random Seed	randseed.c	Small utility designed to populate a file with 2048 bytes of PRNG seed data. The seed should be high entropy.
Security .ch Army Knife	sechan.c	(Pronounced "session") is used by SECURE.COM and associated procedures to ensure package file system security settings are appropriate. It is also available for direct use by the site administrator.
WASD Bench	wb.c	An historical utility and analogue to Apache Bench used for similar purposes (testing, exercising and generating performance metrics). It also has the significant performance and granularity advantage of using the underlying $QIO services and not the socket API, and is AST event driven. Plain HTTP/1.1 only. As with AB.C, into the twenty-first century, tools such as nghttp and h2load are required and recommended.
Wot's Up?	wotsup.c	The WASD Over-The-Shoulder Uptime Picket is designed to monitor WASD in a production environment for the purpose of alerting operations staff to conditions which might cause that production to be adversely impacted. The utility runs in a detached process and monitors the server environment by periodically polling various server data. Alert reports can be delivered via any combination of OPCOM message, MAIL, site-specific DCL command, and log file entry.