.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{ . if \nF \{ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "MojoMojo::Installation 3pm" .TH MojoMojo::Installation 3pm "2010-05-11" "perl v5.20.1" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" MojoMojo::Installation \- Installation instructions for MojoMojo .SH "INSTALLING MOJOMOJO" .IX Header "INSTALLING MOJOMOJO" .SS "Step 0" .IX Subsection "Step 0" Install MojoMojo's prerequisites. See . .SS "Step 1 \- install" .IX Subsection "Step 1 - install" Install MojoMojo either using the cpan shell like this: .PP .Vb 1 \& cpan MojoMojo .Ve .PP or by downloading the tarball from and running perl Makefile.PL on it manually. If you do this, run .PP .Vb 1 \& make installdeps .Ve .PP to get all the required modules installed. .SS "Step 2 \- configure" .IX Subsection "Step 2 - configure" \&\f(CW\*(C`mojomojo.conf\*(C'\fR is the main configuration file and is in Config::General format. .PP First make sure your config file has a valid \s-1DSN\s0 for your database (You can use SQLite, MySQL or PostgreSQL \- SQLite by default). The setting you change is in the \&\f(CW\*(C`connect_info\*(C'\fR hash in the \f(CW\*(C`Model::DBIC\*(C'\fR block. .PP For instance, for MySQL: .PP .Vb 3 \& dsn dbi:mysql:database=mojomojo;host=localhost \& user db_user \& password db_password .Ve .PP or for SQLite: .PP .Vb 3 \& dsn dbi:SQLite:_\|_HOME_\|_/db/sqlite/mojomojo.db \& user db_user \& passwrd db_password .Ve .PP or for PostgreSQL: .PP .Vb 3 \& dsn dbi:Pg:dbname=mojomojo;host=localhost;port=5432 \& user db_user \& password db_password .Ve .PP For MySQL and PostgreSQL you want to create the database first (SQLite does this automatically) .PP .Vb 1 \& create database mojomojo; .Ve .PP Once the \s-1DSN\s0 is setup, we \*(L"deploy\*(R" the schema and some initial data to the mojomojo database by running the following script: .PP .Vb 1 \& ./script/mojomojo_spawn_db.pl .Ve .PP This script has sane defaults for a test install, but you can override these. Run it with \-\-help to see usage information. .SS "Step 3 \- launch" .IX Subsection "Step 3 - launch" MojoMojo is a Catalyst application and works with Catalyst's built-in web server, or with an external one. .PP \fIUsing the Catalyst built-in server\fR .IX Subsection "Using the Catalyst built-in server" .PP Catalyst includes a test server which can be started using: .PP .Vb 1 \& ./script/mojomojo_server.pl \-p 3000 .Ve .PP where 3000 is the port number and the default if no port is specified. Note that if you install it through the cpan shell, mojomojo_server will be found in your \fIbin\fR directory. .PP \fIUsing an external web server\fR .IX Subsection "Using an external web server" .PP MojoMojo has been tested with Apache, lighttpd and nginx. If you need to make a choice, nginx and lighttpd are much lighter in terms of resource consumption, and faster at serving static files, while Apache is more popular and powerful. .PP Comparison information can be found at WikiVs: .IP "\(bu" 4 .IP "\(bu" 4 .IP "\(bu" 4 .PP See for how to setup MojoMojo with various web servers. .PP Set up Apache using either mod_perl or FastCGI. .IX Subsection "Set up Apache using either mod_perl or FastCGI." .PP See http://search.cpan.org/dist/Catalyst/lib/Catalyst/Manual/Cookbook.pod#Using_FastCGI for further information on FastCGI, or you can look at Catalyst::Engine::Apache for info on setting up Catalyst apps in Apache. .PP If your server is connected to a http proxy you may need to add the following line to the main config block: .PP .Vb 1 \& using_frontend_proxy 1 .Ve .SS "Step 4 \- login" .IX Subsection "Step 4 - login" Login to your MojoMojo and change the admin password. The default login/pass is \&\f(CW\*(C`admin\*(C'\fR/\f(CW\*(C`admin\*(C'\fR. .PP For troubleshooting, see . .SS "Step 5 \- create pages" .IX Subsection "Step 5 - create pages" Create a new page. Decide what \s-1URL\s0 you would like for the page then browse to that \s-1URL. \s0 You will then be asked to add content. For example, if you want to create a page about food, go to /food.