This document outlines the steps needed to install Apache onto a TPF system.

You should first read readme-tpf.html for basic information on the port of Apache to TPF including required PUT level and supported modules.
 
 

Releases of the Apache server are compressed into a "tarball" file which must be downloaded to your PC. Additionally the source code from the tarball will need to be copied onto an OS/390 UNIX System Services machine (later referred to simply as "OS/390 UNIX") for compiling. Here are all the details on how to get Apache and how to get it where it needs to be:

1. Download the compressed Apache files (the "tarball") to your PC. The file name on the web site will be something like apache_1.3.xx.tar.Z.
   TIP: Be sure to keep the .tar.Z extension when choosing the name of the PC file. 
    
2. Decompress the tarball on your PC using WinZip or some other PC decompression tool.
   TIP: If you are using WinZip verify that the "TAR File Smart CR/LF Conversion" option (under Options, Configuration) is NOT checked.
   This is what you can expect if you use WinZip: 
   • open the tarball with WinZip (this can usually be done simply by double-clicking on the downloaded tarball) 
   • you will be told that the archive contains one file (such as apache_1.3.xx.tar) - allow WinZip to decompress it to a temporary folder 
   • extract the archived files onto your PC - you'll be using files from the  conf, htdocs, and icons directories later in the install phase 
     
     
3. FTP the tarball to your OS/390 UNIX machine using binary mode: 
   • activate FTP in an MSDOS window: ftp your.os390.unix.machine.com 
   • sign in 
   • set mode to binary: binary 
   • send the file to OS/390 UNIX:
        send c:\downloaded_filename.tar.Z  os390_unix_filename.tar.Z
   • exit FTP: bye 

   TIP: UNIX file names are case sensitive. If you use an NFS client to transfer files from your PC to OS/390 UNIX (instead of using FTP as described above) verify that the NFS drive will transfer the file names with upper/lower case preserved.  

4. Decompress and extract the archived files necessary for compiling Apache:
   pax -rvzkf os390_unix_filename.tar.Z -o from=ISO8859-1,to=IBM-1047 "*/src"
    
5. Remove unnecessary subdirectories:
   • cd apache_1.3.xx/src/lib
   • rm -r expat-lite sdbm
   • cd ../os
   • rm -fr bs2000 cygwin mpeix netware os2 os390 unix win32
   • cd ..

    

VisualAge TPF can be used to generate link maps for Apache:

1. Copy the sample linkhttp.dlm file from the src/os/tpf/samples directory to your Apache src directory on OS/390 UNIX.
2. This sample file contains the components for the default configuration of Apache. Add and delete components (such as modules) as necessary so it matches your configuration of Apache. Basically, it should match your link JCL with the ".../apache/src" portion of the filenames removed.
3. Change items in angle brackets (< >) to also match your JCL. Be sure to remove the angle brackets as well.
4. In VisualAge TPF create a container with your modified dlm file as its sole contents.
5. Right click on the dlm file in your new container and choose "Build DLM".

© 2005 Active-Venture.com Web Page Hosting Service

Disclaimer: This documentation is provided only for the benefits of our hosting customers.
For authoritative source of the documentation, please refer to http://httpd.apache.org/docs/