** Installation procedure for HTTPi
** Copyright 1998-2001 Cameron Kaiser

1. Check that all files are present. Make sure you have Perl 5 installed.
   You only need the executable, not the standard distribution in full.
   If you aren't sure if you have all the files, look in the Manifest file
   (it's an ls -lR of the development directory, minus, of course, the
   Manifest file itself) and compare it with an ls -lR of your directory.

2. Read the LICENSE file.

3. Read the LICENSE file.

4. Read the ... have you read it yet?

5. Determine which configure file you should be running on your platform.
It is *highly* recommended that your Perl include support for alarm(), though
grudgingly no longer required. (For all these installations, you might need
to know your AF_INET socket constant, although HTTPi probably knows it
already. On Linux, AIX, SCO, HP/UX and Solaris, and probably every other
Unixy thing, it's invariably 2. Demonic will try to autodetect it.)

Demonic installation:

configure.demonic	For Demonic HTTPi, the daemonised version. You'll
			either need Socket.pm, a C compiler, or a list of
			your system's socket constants (these are only
			needed for constants, not execution). Your Perl must
			also support fork().

Some sort of inetd installation:

configure.inetd		Most Unix boxen. Use this if you use the vanilla
			inetd. Will autoconfigure your files for you if root.

configure.xinetd	For users of the inetd clone http://synack.net/xinetd/
			Will autoconfigure your files for you. Tres cool.

Others:

configure.generic	Don't know what inetd you have, or one I don't support
			yet. You'll have to connect HTTPi to your inetd
			yourself.

demonic is the fastest and easiest to set up (you don't need to be root), but
requires some special care and feeding. See the documentation. Most people
prefer it. So will you.

xinetd is vewwy vewwy fast. If you have the means, I highly recommend it. (To
quote Ferris Bueller.) You'll realise about a 25% speed increase with it,
at least according to my numbers. It assumes, however, that your .conf file
is /etc/xinetd.conf, which is xinetd's default.

Some of you will be running configure.inetd, so for backwards compatibility
it's still named configure (just a symlink to configure.inetd).

Make sure that consubs.pl and conquests.pl are in the current directory.

6. Run that config file.

$ perl configure.demonic # most unices that don't want inetd installation
$ perl configure.inetd	 # most unices that want inetd installation
$ perl configure.xinetd	 # smart unices/sysadmins that want inetd installation
$ perl configure.generic # others

Do *not* use the Makefile. The Makefile is not intended for installation;
it's used for rolling your own distributions.

NOTE TO (x)inetd INSTALLERS:
If you're on a Unix box, you must run as root for full install options.
Any user can build an object, but only root can modify your (x)inetd's
configuration files.

7. Follow the handy and verbose prompts. The configure program may have
   additional directions to follow. Follow them.

8. If configure bombs, feel free to contact me with the error message at

	httpi@floodgap.com

9. DO NOT TOAST THE INSTALL DIRECTORY. If you make config changes, etc.,
   you will need these files again. Don't lose them.

10. Enjoy your new, small and extremely sexy web server.

--
Cameron Kaiser
