manoj 98/11/03 14:06:32
Added: htdocs/manual install-tpf.html readme-tpf.html
src Makefile.tpf
src/main Makefile.tpf
src/os/tpf Makefile.tmpl TPFExport ebcdic.c ebcdic.h
os-inline.c os.c os.h test_char.h uri_delims.h
src/os/tpf/samples linkdll.jcl loadset.jcl
Log:
Submitted by: Joe Moenich and others at IBM
Newly created files from the TPF port
Revision ChangesPath
1.1 apache-1.3/htdocs/manual/install-tpf.html
Index: install-tpf.html
===
Installing Apache on TPF
Installing the Apache 1.3 HTTP Server on TPF
[ Setup
| Compilation
| Installation
| VisualAge ]
This document outlines the steps needed to install Apache onto a TPF system.
You should first read src/os/tpf/readme.tpf.html
for basic information on the port of Apache to TPF including required PUT
level
and supported functions & modules.
Setup
Due to the use of EBCDIC on MVS OS/390 Open Edition (later referred to simply
as
"Open Edition"), we've found that the most reliable
method for loading Apache onto your system is to unzip and tar the
distribution
file on your PC, and then copy the extracted files to Open Edition via an NFS
client
capable of transferring the data in EBCDIC format.
Before moving the distribution to an
Open Edition environment, verify that the NFS drive will transfer the
filenames with upper/lower case preserved.
Since Open Edition is not the ultimate destination of the files,
the only required files and subdirectories that need to be moved to Open
Edition
are in /src.
WARNING:
If you are using a product such as WinZip on your PC, verify that
the "TAR File Smart CR/LF Conversion" option is NOT checked.
You can find this in WinZip under Options, Configuration.
Since you had to tar and unzip the file to read this document,
you need to re-tar and -unzip if the CR/LF option was checked.
This will save you lots of headaches later on.
WARNING:
Editing files on a PC before moving them to Open Edition may result
in the loss/addition of unprintable characters. Files of concern include
shell
scripts and src/Configuration. The most common problems are with tab
characters
and CR/LF characters. Most editors will handle the CR/LF problem correctly
but none seem to handle tab characters. If you need to edit files, edit them
in a UNIX editor such as vi or emacs.
Compilation
Apache supports the notion of "optional modules". However,
the server has to know which modules are compiled into it. In order for
those modules to be effective, it is necessary to generate a short bit of
code ("modules.c") which simply has a list of them. If you are using the
make and Configure utility, "modules.c" will be created for you.
The provided scripts assume a c89 compiler and have only been tested on an
Open Edition environment. If you are using a platform other that
Open Edition you may need to modify src/os/tpf/TPFExport and src/Configure
to match your environment.
Note that UNIX/Open Edition commands in this section are shown in
bold,
are case sensitive, and must be made from the "src" directory.
Overlay src/Configuration with src/Configuration.tmpl:
cp Configuration.tmpl Configuration
Edit src/Configuration. It contains the list and settings
of various "Rules" and an additional section at the bottom that determines
which modules to compile:
Adjust the Rules and EXTRA_CFLAGS|LIBS|LDFLAGS|INCLUDES
if you feel so inclined.
Comment out (by preceding the line with a "#") lines corresponding
to those modules you DO NOT wish to include.
At present the following modules MUST be commented out
as they are not yet supported on TPF: mod_actions, mod_auth,
mod_cgi, mod_env, mod_include, & mod_status.
Uncomment (by removing the initial "#", if present) lines
corresponding to those optional modules you wish
to include or add new lines corresponding to any custom modules
you have written.
The src/os/tpf/readme.tpf.html
document lists the modules that have been tested on TPF.
Overlay src/Makefile.tmpl with src/Makefile.tpf:
cp Makefile.tpf Makefile.tmpl
Overlay src/main/Makefile.tmpl with src/main/Makefile.tpf:
cp main/Makefile.tpf main/Makefile.tmpl
Set the TPF environment variables:
. os/tpf/TPFExport
(The initial period and blank on the command are required to ensure
the environment variables exist beyond the scope of the shell script.)
This script will set the environment variables required to compile the