=============
ISPUTIL HOWTO
=============

ISPutil 0.6
-----------

As of version 0.6, the use of WWWutil package is no longer at all
optional. That is because new user creation, accepting of payments from
users, and purchase of hours and months by users is all now done via the
web; the web-forms for doing these things are all in the WWWutil package.

So in order to use this package you need the BBSutil package (which is
basically ACUA 1.14 compiled to reside in /var/lib/BBSutil and with one or
two added executables which hopefully will soon be phased out to allow use
of un-customised ACUA in the future) and the WWWutil package.

The BBSutil package resides in /var/lib/BBSutil
The ISPutil package resides in /var/lib/ISPutil
The WWWutil package resides in /var/lib/WWWutil

The webserver used is assumed to be Roxen, with the following directories
configured: 

Path			Description	URL
----			-----------	---
/var/lib/www/pub	Public docs	/
/var/lib/www/pubcgi	Public CGIs	/cgi-bin/
/var/lib/www/members	Members docs	/members/
/var/lib/www/memercgi	Members CGIs	/members/cgi-bin/
/var/lib/www/staff	Staff docs	/staff/
/var/lib/www/staffcgi	Staff CGIs	/staff/cgi-bin/

It is assumed that only valid users can access the /members/ and
/members/cgi-bin/ areas and only staffpersons can access the /staff/ and
/staff/cgi-bin/ areas.

Online docs for these packages is assumed to be placed in
/var/lib/www/pub/ISPutil and /var/lib/www/pub/WWWutil

However, the subdirs of /var/lib/www are found in /var/lib/WWWutil so as
not to have to overwrite the live stuff if not desired. Thus you can
either copy them to /var/lib/www or use symbolic links, depoending upon
whether you are content to let new installs of WWWutil overwrite the live
pages. (i.e. did you customise any pages or CGIs?)


