First you need to obtain the source code and download it to the machine you want to deploy WIAB on. Either obtain the most recent release from the downloads section of the google code project or check out the bleeding edge code from the subversion repository:
svn checkout http://websiteinabox.googlecode.com/svn/ WIAB
If you don't have Catalyst now is the time to install it. If you are using linux, check to see if there is a package for Catalyst (version 5.7007 or later is recommended). After this, the best way to install it is from the cat-install script provided by Shadowcat systems.
Once this is taken care of from the WIAB root directory, type this:
perl Makefile.PL
Now follow the prompts to install any missing dependencies from cpan. Note that there are reports of URI::Fetch failing to install without force (this is needed for the RSS feed functionality). Therefore, this step has the potential to be a bit fiddly. If things start going wrong here, you might want to start installing CPAN modules by hand.
Once catalyst and other WIAB dependencies are installed, you're ready to test that everything is going to work for you live on the internet. You will probably want to test to see that WIAB is going to work for you in your chosen configuration. Issue the following command from the prompt at the WIAB root directory:
prove -l t
You should receive a message saying "all tests successful" at the end of this process, and this confirms that catalyst is working for you. Please report any failing tests which you think are not caused by your configuration issues at the Google Code Site
Next you need to decide how you are going to deploy WIAB. The reccommended deployment engine is FastCGI, and The supported web server options are:
Pick a deployment route and run the appropriate test harness
LIGHTTPD_BIN=`which lighttpd` perl t/optional_lighttpd-fastcgi.plLIGHTTPD_BIN=`which lighttpd` perl t/optional_lighttpd-fastcgi-non-root.plperl t/optional_apache-fastcgi.plIf lighttpd is not in your $PATH, you will need to find it youself and so it will read something like: LIGHTTPD_BIN=/usr/local/sbin/lighttpd
Note that the apache test only tests deployment on a non root location. To modify this you need to change the file t/conf/extra.conf.in:
ScriptAlias /fastcgi @ServerRoot/../script/wiab_fastcgi.pl@
should read
Script@Alias / @ServerRoot/../script/wiab_fastcgi.pl@
This lets you know if there are any problems with your web server prior to deployment. Again you should see the message "all tests successful" at the end of the test run.
Finally you need to prepare your application for launch by configuring it.
Remove the file wiab_local.yml from your application root (probably moving to a different name would be best - if you need to run the tests they require this file). Edit the wiab.yml with a test editor (i.e. Notepad, not Word!). Modify the following values to suit your needs. leave the others untouched.
admin_email: diment@gmail.com
copyright_owner_email: diment@gmail.com
copyright_owner_name: Kieren Diment
description: Total Data Solution
gsm_ping: 0
name: Total Data Solution
owner_email: diment@gmail.com
owner_name: Kieren Diment
owner_org: Total Data Solution
owner_url: http://www.totaldatasolution.com
Now we're ready for deployment so that you can install your application to the wild.
