WASD yahMAIL for VMS Apache (CSWS)
February 2002, 1.5.2
WASD VMS Hypertext Services, Copyright © 1996-2002 Mark G. Daniel.
This package (all associated programs), comes with ABSOLUTELY NO WARRANTY.
This is free software, and you are welcome to redistribute it under the
conditions
of the GNU GENERAL PUBLIC LICENSE, version 2.
WASD yet another hyperMAIL
provides direct, on-line Web access to a VMS system's native Mail environment
via a standard browser. For further information see
yahMAIL Usage Guide.
Installation
Development environment was CSWS V1.0-1 (VMS Apache 3.1.12).
Installation steps:
- THIS SCRIPT REQUIRES CAREFUL CONFIGURATION
read the yahMAIL Usage Guide thoroughly first!
- build executable
- link-only:
$ @BUILD_YAHMAIL MIME LINK
- alternatively COMPILE+LINK (requires DECC 5.n or 6.n):
$ @BUILD_YAHMAIL MIME BUILD
- in a PMDF environment, to enable MIME uploads LINK:
$ @BUILD_YAHMAIL MIME PMDF LINK
- alternatively COMPILE+LINK (requires above):
$ @BUILD_YAHMAIL MIME PMDF BUILD
- copy executable and support procedure
- initial installation:
$ @INSTALL INSTALL APACHE
- subsequent update:
$ @INSTALL UPDATE APACHE
- yahMAIL script startup
- if server username is "APACHE$WWW":
$ @APACHE_ROOT:[000000]YAHMAIL_STARTUP
- if server username is something else:
$ @APACHE_ROOT:[000000]YAHMAIL_STARTUP username
- add mapping and authorization rules as described in Configuration
below
- read configuration chapter of yahMAIL Usage Guide
again then modify YAHMAIL$CONFIG against local requirements:
$ EDIT YAHMAIL$CONFIG
- It is possible to localize the language of the text and messages provided
by yahMAIL. Check the file LANG_EN.C for details.
Configuration
The startup procedure must be executed at system startup or if the software
is reinstalled or updated. Ensure this becomes part of the Web
environment's startup.
For an VMS Apache installation the files are distributed as follows:
- APACHE$COMMON:[CGI-BIN]YAHMAIL.EXE
- APACHE$COMMON:[CGI-BIN]YAHMAIL.COM
- APACHE$COMMON:[CONF]YAHMAIL.CONF
- APACHE$COMMON:[000000]YAHMAIL_STARTUP.COM
- APACHE$COMMON:[SRC.WASD.DOC]
As discussed in the documentation, private access to user email requires
authentication and authorization. Apache offers a number of mechanisms
for authentication and authorization configuration. Please consult the
relevant documentation. The following provides example
[CONF]HTTPD.CONF entries for SYSUAF authentication.
# YAHMAIL.CONF will need to have it's paths to the documentation edited!
Alias /yahmail/doc/ "/apache$common/src/yahmail/doc/"
LoadModule auth_openvms_module
/apache$common/modules/mod_auth_openvms.exe_alpha
<Location /cgi-bin/yahmail>
AuthType Basic
AuthName "OpenVMS authentication"
AuthUserOpenVMS On
require valid-user
</Location>
Mark G. Daniel
Mark.Daniel@wasd.vsm.com.au
Mark.Daniel@dsto.defence.gov.au
Demonstration & Download
http://wasd.vsm.com.au/
http://wasd.vsm.com.au/wasd/
ftp://ftp.vsm.com.au/wasd/index.html