
----------------- RELEASE TERMS ------------------
This is the beta version of the dbadmin toolkit. Most functionality is
available and stable. This is NOT being released under a public license.
If you intend to use this program at a commercial site, you must register
your copy and pay the license fee. If you use this program at an educational
institution, it is of course free! Please send me a note with comments on
the product! And the standard disclaimer applies: I make no claims as to the
usability or functionality of this product. USE AT YOUR OWN RISK.

All that said, this product should prove very usable, even under beta release.
Anyone who pays for a license now will obviously be entitled to all updates
in the dbadmin1.x tree. I intend to be fixing bugs as fast as they come in.
(At least I'll try...)


----------------- COMPILE NOTES -------------------
If the mSQL owner is the same as the WWW (httpd) owner, then all should
make very smoothly. (YOU MAY NEED TO LINK A NEWER COPY OF msql.h into 
the source directory. Edit the makefile to reflect your particular system.)
 
1) Type "make" to build the application.
2) "su" to the mSQL owner ID
3) type "make install" to put the cgi in the right location
4) make a bookmark to "/cgi-bin/dbadmin/dbadmin" 
5) password protect that directory! (use a .htaccess file!!!!!)
6) ensure that the directory is "ScriptAliased" in the httpd configurations

If the owner of mSQL is not the same as the WWW owner, here are the things
you must accomplish to get the product running.

1) Move the dbadmin binary to the appropriate "ScriptAliased" directory.
2) Change the owner of the binary to that of the mSQL owner.
3) chmod 4755 on the binary

The CGI must run as the owner of mSQL to allow creating and removing
databases. If you run your own web server, this will be little trouble. If
you are running on someone else's machine (ie: service provider), then you
will have to insist that they allow setuid on particular CGI's. Some admins
may consider this a security risk...

------------------ OTHER AREAS OF INTEREST -------------

Currently, the "CONNECT SERVER" option is non-functional. I left it there
to entice myself into getting it done; and to entice users into suggesting
to me the correct methods of doing that... If you have a good solution there,
please let me know... Some issues to be overcome:

1) User ID
2) UsEr Id
3) USer iD
etc.

Exactly what "server" does that specify; A different httpd server, or a
different mSQL server... 

------------------ CREDITS STUFF -----------------------

MSQL: what do I need to say here? Good work, Bambi. The first license fees
I collect will go straight to the Man himself. 

The CGI lobrary included with the program is copyrighted ...

>cgic License Terms
>------------------
>
>Basic License
>-------------
>
>cgic, copyright 1996 by Thomas Boutell. Permission is granted to use cgic 
>in any application, commercial or noncommercial, at no cost. HOWEVER,
>this copyright paragraph must appear on a "credits" page accessible in 
>the public online and offline documentation of the program. Modified 
>versions of the cgic library should not be distributed without the 
>attachment of a clear statement regarding the author of the 
>modifications, and this notice may in no case be removed. 
>Modifications may also be submitted to the author for inclusion 
>in the main cgic distribution.                                 

Done. If several people register their distributions, I will be able to send
this guy a well deserved check for the ability to remove that credits notice.
(Excellent package BTW)


-------------- MOST IMPORTANTLY ----------------

PLEASE SEND ME FEEDBACK ON THE USE OF THIS PRODUCT! I hope to be actively
updating it, as the primary reason I developed it was because I needed it!
I figured you might want it as well...

James E. Harrell, Jr.
April 23, 1996
jharrell@emi.net

