The recommended way install is to follow the GitHub installation steps, so that all MojoMojo files end up in one directory, and you have the latest developer version. If you want to use a release version, after
git clone, you can list the tags with
git tag, and then checkout a specific tag:
git checkout <tag_name>.
- root privileges. Otherwise, you can still install MojoMojo using local::lib.
- Perl 5.8+ and Catalyst 5.7+
- database: in theory, any database back-end supported by DBIx::Class. MojoMojo has been successfully tested with SQLite, PostgreSQL and MySQL.
- memory requirements: on Linux, 60Mb per FastCGI process, regardless of the wiki database size or back-end type
libxml2for Atom feeds
- image manipulation libraries for attachment support, required by Imager:
aptitude install libxml-parser-perlfor XML::Feed
- docbook-xsl (debian package name) for MojoMojo::Formatter::DocBook
install Catalyst. This can be as easy as
install the external libraries. For example on Ubuntu, run:
aptitude install libxml2 libpng-dev libgif-dev libjpeg-dev expat libexpat1-dev docbook-xsl
On Windows, you can find
libxml2and its dependencies at http://www.zlatkovic.com/pub/libxml/. You'll need
zlib1.dllin a directory listed in
To see how likely the installation tests are to succeed, check the CPAN Testers status of the MojoMojo dependencies.
As with any Catalyst application,
mojomojo_*.plscripts will be installed installed in
configure MojoMojo. Usually, you'll want to add a local configuration file overriding values from mojomojo.conf. Since MojoMojo is a Catalyst application, it conforms to the naming convention for such configuration files and settings you add to
mojomojo_local.confwill override those in
mojomojo.conf(details at the Catalyst wiki - What is the precedence of various configuration setting locations?.
To point MojoMojo to an arbitrary configuration file, set
MYAPP_CONFIG is also a Catalyst-style environment variable name.
Here is an older example installation progress.
aptitude install libxml2 libpng-dev libgif-dev libjpeg-dev expat libexpat1-dev make aptitude install libxslt1-dev libgdbm-dev docbook-xsl docbook-xsl-doc-html aptitude install git-arch git clone git://github.com/marcusramberg/mojomojo.git # optional: git tag ; git checkout <a release tag> cpan -i Module::Install cd mojomojo perl Makefile.PL make make test # change mojomojo.conf if necessary script/mojomojo_spawn_db.pl # creates database script/mojomojo_server.pl # launch development server
If you come from a pre-1.00 version to 1.00, please check
mojomojo.conf for updates to the database connection info. The section should look like this:
<Model::DBIC> <connect_info> # DB User user db_user password db_password # SQLite DSN (default database type, recommended for small to medium deployments) dsn dbi:SQLite:mojomojo.db ... </connect_info> </Model::DBIC>
Other than that, there are no database schema changes planned as of yet, and a
cpan MojoMojo (or
git pull) should take care of upgrading.
TODO: document where files end up after installation.
Showing changes from previous revision.