This is the second attempt at an install document.  Feedback is
encouraged.

You'll need to change these if your database has a different name or
permissions. 

1) Untar Webliographer in your DocumentRoot. 

     cd /your/www/root/directory
     tar xfz webliographer-VERSION.tar.gz

NOTE: For webliographer to be able to create new database itself, it
needs to have write access to wwwroot.  You might want to "chmod 1777
." too.  This assumes that you trust those using your system not to
create extra stuff in your wwwroot.  If wwwroot is owned by the group
of your www user, "chmod 1775 ." would do it.  You can change where
webliographer tries to create links to new Webliographers in the local
configuration step below.

2) Symlink it to webliographer

     ln -s webliographer-VERSION webliographer

NOTE: The "default" Webliographer, which lists the Webliographers on
your server must be in the webliographer directory.  If you don't like
this then you'll have to wait for a new version, because a link to
/webliographer is still hard-coded.  This *is* a first release.

NOTE: Windows users should rename or copy webliographer-VERSION to
"webliographer" 

3) Do local configuration.  Copy or rename local.php3-dist to
   local.php3. 

     cd webliographer
     cp local.php3-dist local.php3

Now edit according to your needs (database name, mysql user, &
password etc).

4) Create a database to hold Webliographer's stuff

     mysqladmin create webliographer

5) Define initial tables and such

     mysql webliographer < init.sql

6) Create an account for yourself

Go to http://your.host/webliographer/, follow the "how to participate"
link and request an account for yourself.  Your password will be
mailed to you immediately.

7) See if you're really the admin

Click on the "home" link on the page where you just requested your
userid.  You should see "Admin: youruserid" at the top of the page. 

8) Change defaults for your webliographer

Follow the "edit view" link.  Be sure to change "email contact" to
yourself. 

9) Make sure you can add a new Webliographer.  You'll be emailed
    instructions for creating an symlink or alias.

10) Let me know if this worked.  

Jay Pfaffman                           pfaffman@relax.com
+1-615-343-1720 (office)               +1-615-460-9299 (home) 
http://relax.ltc.vanderbilt.edu/~pfaffman/

----------------------------------------

Notes on upgrading after 1/22/03.  The new search feature requires
ISAM tables.  If you created your Webliographer database before MySQL
supported this new table type, you'll need to convert at least your
URL table.  You'll also need to create the fulltext index.  These
commands will do it (assuming you're connected to your webliographer
database with appropriate permissions).

mysql> alter table urls type=MyISAM;
mysql> create fulltext index url_index on urls (url, name, title, description);