
INSTALL

This is the install file for a set of modules called Musings.

The module is essencially a front-end to a MySQL database. To get
the module working you need to create the database. Here's how:

1. Create a MySQL database, say musings, using the mysqladmin
program:

  mysqladmin -uroot -p create musings

2. As the MySQL database root, update the mysql database so a
particular username/password has access to the newly created
database:

  mysqsl -uroot -p mysql

I use the following SQL command:

  GRANT ALL ON musings.* TO nobody@localhost IDENTIFIED BY 'nobody';

3. Give the database some structure using the schema file found
in the db directory of the distribution:

  mysql -unobody -pnobody musings < db/musings-schema.sql

If you get errors here, then make sure everything is correct with
Steps #1 and #2.

4. Edit the configuration file (Config.pm) found in the
lib/Musings directory. Change the values for musings, nobody, and
nobody to match the values you defined above.

5. Build, test, and install the module:

  perl Makefile.PL
  make
  make test
  make install

6. Read the documentation:

  * perldoc Musings::Config
  * perldoc Musings::DB
  * perldoc Musings::Author
  * perldoc Musings::Subject
  * perldoc Musings::Template
  * perldoc Musings::Stylesheet
  * perldoc Musings::Article

Sample applications have been written against the module, and
they are found in the cgi-admin as well as the cgi-user
directories.

Enjoy.

-- 
Eric Lease Morgan
Infomotions, Inc.
209 W. North Shore Drive
South Bend, IN 46617

eric_morgan@infomotions.com
http://infomotions.com/

November 22, 2004

