For these examples, we assume you've built in: /usr/local/htdb
and that apache's at: /usr/local/apache

Recommended Settings:

	./configure --with-mysql --without-libfcgi --without-libdbi --prefix=/usr/local/htdb

Database Setup:

	1) make sure you've got the mysql database software running
	   somewhere accessible to the web server that's going to be
	   running the HTDB-based CGI applications.

	2) add a new mysql account, reload the grant priviledges

	3) create the database tables needed by htdb, using the creation
	   script in sql/create.sql

FastCGI:

	If you're going to be running a site that does more than a
	handful of pages per minute, you'll want to upgrade your apache
	web server to include mod_fastcgi (download from fastcgi.com).
	If you're just playing around, and can accept the performance penalty
	of running in stand-alone cgi mode, do it.  It makes for
	a simpler installation.

	1) If you choose to use FastCGI:

	   ./configure --with-libfcgi=PATH_TO_LIBFCGI

Compiling:

	1) make

	2) make install

Configuring HTDB:

	per the apache config, the htdb applications are expected to reside in a
	place that matches the apache config.

	1) copy the core htdb script and config files to their new home:

		mkdir /usr/local/apache/htdb
		cp /usr/local/htdb/etc/*.htdb /usr/local/apache/htdb
		cp /usr/local/htdb/docs/examples/*.htdb /usr/local/apache/htdb

	2) in the INSTALLED version of etc/config.htdb, put the mysql username/passwords
	   created above into the appropriate places
	   (confDatabase[*]->username & confDatabase[*]->password)

	   NOTE: there are several other settings in the etc/config.htdb
	   file that you will need to change!

Configuring Apache:

	1) see the code example in the INSTALLED version of docs/httpd.conf
	   edit paths to suit your environment

	2) HUP your webserver

Did it work?

	using a web browser, access the URL:
		http://localhost:/htdb
	(substitute localhost for wherever you installed htdb)

Yes?

	play around with the .htdb files in /usr/local/apache/htdb
	look at everything in /usr/local/htdb/docs
	especially /usr/local/htdb/docs/language_primer.txt

No?

	does it run from the command line?

	/usr/local/htdb/bin/htdb /usr/local/apache/htdb

	it may be that it cannot talk to the database - debug things in this order:

		* make sure that /usr/local/apache/htdb exists; permissions are good
		* look inside /usr/local/apache/htdb/config.htdb and make sure that
		  all paths are sane, and that the database username and password
		  match the mysql account you set up
		* HUP the database - maybe the account didn't get picked up
		* send me email!

Wed May 12 22:44:47 PDT 2004
del@adjective.com
