h1. Install a MojoMojo Shipwright Vessel

h2. Installation Outline

Given a MojoMojo distribution file[1] named mojomojo_vessel.tar.gz that extracts to MojoMojo/

h3. Extract the files to a desired location:

cp mojomojo_vessel.tar.gz /var/www
cd /var/www/
tar xfvz mojomojo_vessel.tar.gz

One should now have all the MojoMojo parts (modules), conf, pod etc.) installed in

/var/www/MojoMojo/

h3. Make the shell environment aware of the MojoMojo distribution

Next the shell environment must be made of aware of ~~the~~ MojoMojo's location.

h4. Single Terminal Awareness

To make the current shell (terminal) aware of the MojoMojo distribution do:

cd MojoMojo
source tools/shipwright-source-bash /absolute/path/to/MojoMojo

h4. All Terminals Awareness

To have any terminal aware of the MojoMojo distribution, put the above source line into the .bashrc file.

h2. Configure MojoMojo

h3. Provide Database Connection Info

After installing the MojoMojo distribution, one needs to configure MojoMojo in particular the database connection information. This is done by editing the file mojomojo.conf[2].

h3. Initialize the Database

Once the database connection information has been configure, the database structure is initialized by executing:

bin/mojomojo_spawn_db.pl

h3. Fire up MojoMojo

Run MojoMojo with:

bin/mojomojo_server.pl -p 3000

The MojoMojo web application should now be running on your sever at port 3000. See MojoMojo INSTALL[2].

h2. Footnotes

fn1. Also known as a MojoMojo Shipwright vessel.

fn2. File may be located in: MojoMojo/lib/perl5/MojoMojo/