Contentment::Manual::Install - The installation guide for Contentment perl Build.PL ./Build ./Build test ./Build install The procedure given in the "SYNOPSIS" will give you the base install. If you're using CPAN, you can also: cpan Contentment or: perl -MCPAN 'install Contentment' depending on the availability of the cpan script. After the base is installed, you will need to configure your Contentment installation. As of this writing, this is a non-trivial process, but I'm curently working on a script to automate it. WARNING: I am serious. These instructions are not for the faint of heart! Older individuals, pregnant women, and anyone who might be at risk for heart related problems should stop here.

CONFIGURING APACHE
These instructions assume you are using Apache web server (the version matters very little), but any CGI capable web server is sufficient, assuming you can adapt these instructions to those web servers. The files you need to get started with are in the htdocs folder. You need to copy these files somewhere Apache will find them. You can either copy these files into your web root or you can tweak the httpd.conf of your web server. Finally, you need something like the following in a file named .htaccess within the directory where you copied htdocs, or the equivalent information inside of your httpd.conf: Options FollowSymLinks RewriteEngine on RewriteRule "^$" "cgi-bin/contentment.cgi/index.html" [L] RewriteRule "(.*)$" "cgi-bin/contentment.cgi/$1" [L] and in the .htaccess file for htdocs/cgi-bin: RewriteEngine off Options ExecCGI AddHandler cgi-script .cgi

CONTENTMENT INIT CONFIGURATION
Before running Contentment, you need to create a file named init.yml in the same directory as contentment.cgi. This file should contain at least three directives in YAML format: "dbi_database", "plugins_dir", and "vfs". Depending on your setup, you'll probably also want "dbi_username" and "dbi_password". dbi_database: dbi:mysql:exampledb dbi_username: example dbi_password: secret plugins_dir: /var/www/localhost/plugins vfs: - Real - root - /var/www/localhost/htdocs

READY TO ROLL
Assuming these instructions are at all correct and useful. You should now be able to open your Contentment index.html. Andrew Sterling Hanenkamp, <hanenkamp@cpan.org> Copyright 2005 Andrew Sterling Hanenkamp. All Rights Reserved. Contentment is distributed under the same terms as Perl itself.