/////////////////////////////////////////////////////////////////////////////
// Improved mod_frontpage                                                  //
// for Apache 1.3.17                                                       //
// v1.5.1 - February 21, 2001                                              //
// Copyright (C) 2001 Christof Pohl <chripo+frontpage@edo.uni-dortmund.de> //
/////////////////////////////////////////////////////////////////////////////
// WorldWideWeb: http://home.edo.uni-dortmund.de/~chripo                   //
// FTP: ftp://ftp.edo.uni-dortmund.de/pub/mod_frontpage                    //
/////////////////////////////////////////////////////////////////////////////

This product includes software developed by the Apache Group for use in the
Apache HTTP server project (http://www.apache.org/).



WHAT YOU NEED
=============


Improved mod_frontpage
----------------------

That's what this is all about ... get it via FTP:

<ftp://ftp.edo.uni-dortmund.de/pub/mod_frontpage/mod_frontpage-1.5.1-1.3.17.tar.gz>

or HTTP:

<http://home.edo.uni-dortmund.de/~chripo/download/mod_frontpage-1.5.1-1.3.17.tar.gz>


The Apache HTTP Server sources
------------------------------

Of course. ;-) The Apache 1.3.17 sources are available via FTP at
<ftp://ftp.apache.de/pub/apache/apache_1.3.17.tar.gz> or HTTP
<http://www.apache.org/dist/apache_1.3.17.tar.gz>.


Microsoft FrontPage Server Extensions
-------------------------------------

You can download the Microsoft FrontPage Server Extensions SR 1.2 for UNIX
platforms at MSDN Online:

<http://msdn.microsoft.com/workshop/languages/fp/2000/unixfpse.asp>.

Get the compressed tar file named "fp40.platform.tar.Z", where platform is the
UNIX platform to which the FrontPage Server Extensions are being installed.
For example, "fp40.linux.tar.Z" is the compressed tar file for Linux servers.

You will not need to download Microsoft's installation scripts
("fp_install.sh" or "change_server.sh").


The GNU "patch" program
-----------------------

You will need a reasonabe up-to-date version of the GNU "patch" program
versions 2.5.1 or later are known to work). If you have an older version, you
can download the sources and compile them on your system.

Note that non-GNU versions of "patch" (like the "patch" program included in Sun
Solaris 6.x or 7.x) will NOT WORK!


Root access
-----------

To install the Apache HTTP Server with Improved mod_frontpage you must have
root access on the UNIX system!



NOTE FOR BSD USERS
==================

The BSD version of the "tar" command does not support the "z" option used
throughout in the following documents. Please gunzip the archives by hand
before running the "tar" commands (without the "z" option).



QUICK INSTALL
=============

**** Introduction ****

This is for the impatient. ;-) Lines starting with "#" are example commands to
be used in a bash shell. You must follow ALL of the steps described here
CLOSELY, or you will get strange errors if you want to open your FrontPage
extended web site in the FrontPage client!

If you have questions, encounter any errors, or want to get to know some
advanced tips and tricks, please read the INSTALL file! It contains a detailed
Step-By-Step Installation Guide!


Step 1: Install the FrontPage Server Extensions
-----------------------------------------------

Untar the FrontPage Server Extensions in "/usr/local/":

    # cd /usr/local
    # gzip -dc /path/to/downloaded/fp40.platform.tar.Z | tar xf -

This will create a new directory named "/usr/local/frontpage/" and some
subdirectories in it. It should be owned by user "bin" and group "bin". If
this is not the case, do a:

    # chown -R bin frontpage
    # chgrp -R bin frontpage

If you get "invalid user" or "invalid group", take a look at the detailed
Installation Guide in the INSTALL file.


Step 2: Set up your building environment
----------------------------------------

Remove an existing Apache source tree in "/usr/src", if present:

    # cd /usr/src
    # rm -Rf apache_1.3.17

Then untar this package and the Apache sources in "/usr/src/":

    # cd /usr/src
    # gzip -dc /path/to/downloaded/apache_1.3.17.tar.gz | tar xf -
    # gzip -dc /path/to/downloaded/mod_frontpage-1.5.1-1.3.17.tar.gz | tar xf -


Step 3: Patch the Apache HTTP Server sources
--------------------------------------------

Do a "cd" in the Apache source directory:

    # cd /usr/src/apache_1.3.17

Apply the patch included in this distribution of Improved mod_frontpage:

    # patch -p0 < ../mod_frontpage-1.5.1-1.3.17/patch-1.5.1-1.3.17

If you get any errors (ignore reports about succeeded hunks with some fuzz
and/or offset), make sure your version of the patch program is 2.5.1 or later
(see Step-By-Step Installation Guide in file "INSTALL" for more information).


Step 4: Configure Apache
------------------------

Configure Apache using the "configure" script:

    # ./configure --prefix=/install/path/of/apache \
    # --enable-module=frontpage \
    # --server-uid=nobody \
    # --fpexec-caller=nobody

On RedHat Linux only, you must use two additional switches to the above
"configure" command:

    --fpexec-uidmin=99
    --fpexec-gidmin=99

If you want to build mod_frontpage as shared module (DSO), add
"--enable-shared=frontpage" to your "./confiugre" command. You may want to add
other configure switches (such as "--enable-module=most") as well.

Have a look at the Step-By-Step Installation Guide in file "INSTALL" for a
complete description of all the configure switches available for Improved
mod_frontpage.


Step 5: Compile and install Apache
----------------------------------

To compile and install Apache, do:

    # make
    # make install

Edit the "httpd.conf" file in your favorite text editor:

    # vi /install/path/of/apache/conf/httpd.conf

Find the "<Directory>" directive for the path specified in the "DocumentRoot"
directive:

    <Directory "/install/path/of/apache/htdocs">

You must change the "AllowOverride" directive a few lines below from "None" to
"All".


Step 6: Start the Apache HTTP Server
------------------------------------

Simply do a:

    # /install/path/of/apache/bin/apachectl start

Have a look at the "error_log" file:

    # tail /install/path/of/apache/logs/error_log

You should find something like:

    [Mon Oct 16 20:16:52 2000] [notice] Apache/1.3.17 (Unix)
    FrontPage/4.0.4.3 configured -- resuming normal operations

Please note that the term "FrontPage/4.0.4.3" is included. This means Improved
mod_frontpage was loaded correctly.


Step 7: Install the FrontPage Server Extensions to your server's root web
-------------------------------------------------------------------------

Use the "fpsrvadm.exe" utility, which is part of the FrontPage Server
Extensions, to install the FrontPage Server Extensions to the root web on your
new Apache HTTP Server:

    # /usr/local/frontpage/version4.0/bin/fpsrvadm.exe

Choose the following options when prompted:

  Please enter command:            1) install

  Please enter server type:        1) apache-fp

  Enter server config filename:    /path/to/installed/apache/conf/httpd.conf

  Enter host name for multi-hosting []: <ENTER>

  Enter UNIX username []:          nobody

  Enter UNIX group []:             nogroup

  User name to add to FrontPage group "administrators" [administrator]: fpadm

  Password for user "test":        test (you will see nothing)

  Confirm password:                test (you will see nothing)

Apache's root web will be extended to use the FrontPage Server Extensions with
this command.


Step 8: Try to open the FrontPage web with the FrontPage client
---------------------------------------------------------------

When prompted, use the FrontPage account that was created during the
installation of the FrontPage web (in the above example this was user "fpadm"
with password "test"). You should be able to create new FrontPage subwebs and
FrontPage accounts with the FrontPage client now.


Step 9: Sekt oder Selters
-------------------------

If everything works now, you might want to give a party or drink some beer or
something. ;-) If not, head over to the Step-By-Step Installation Guide
contained in the INSTALL file and try to figure out what went wrong.

If you have any suggestions concerning Improved mod_frontpage, this
documentation or the Improved mod_frontpage website, please drop me a line
<chripo+frontpage@edo.uni-dortmund.de>.

Thank you,

Christof Pohl


