MojoMojo インストール ======== このページは、[[http://mojomojo.org/documentation/installation Installing MojoMojo]] を {{tw: bayashi}} が訳したものです。正確な情報は原典を参照願います。 {{toc 2-}} MojoMojo で推奨されるインストール方法は、GitHub からのインストールで、MojoMojo の全ファイルがひとつのディレクトリにまとめて入ってくれます。そこで、あなたが手にするのはもっとも新しい開発版です。もし、リリースバージョンを使用したいなら `git clone` したあとに `git tag` で リストをみて、tag を明示的にした上で checkout してください。: `git checkout ` ## バイナリパッケージ * On FreeBSD, install the [[http://www.freshports.org/www/p5-MojoMojo/ p5-MojoMojo package]]. * On Debian, install [[http://packages.debian.org/unstable/perl/libmojomojo-perl libmojomojo-perl]]. ## 必要なシステムの条件 * root 権限 (もしくは{{cpan: local::lib}} で MojoMojo をインストールしていれば、その限りではありません) * Perl: 5.8 以上 * {{cpan: Catalyst}}: 5.7 以上 * データベース: 理論上は {{cpan: DBIx::Class}} がサポートしていれば何でもOKです。SQLite・PostgreSQL・MySQL は実証されています。 * メモリ: Linux で FastCGI の1プロセスが 60Mb ほど必要です(wikiのデータベースバックエンドやサイズには関係ありません)。 ### 外部依存ライブラリ * Atom feeds を使用するために `libxml2` が必要です * ファイル添付機能のために次の画像ライブラリが必要です: {{cpan: Imager}}: `libpng-dev` (or `libpng12-dev`), `libgif-dev`, `libjpeg-dev` (or `libjpeg62-dev`) * {{cpan: XML::Feed}} のために、次のCライブラリも必要です: `expat`, `libexpat1-dev` and `aptitude install libxml-parser-perl` * {{cpan: MojoMojo::Formatter::DocBook}} には次のライブラリが必要です: docbook-xsl (debian package name) ## CPAN からのインストール 1. `cpan Catalyst::Runtime` 簡単! 1. 外部ライブラリのインストール. Ubuntu なら次のようなコマンド: aptitude install libxml2 libpng-dev libgif-dev libjpeg-dev expat libexpat1-dev docbook-xsl Windowsの場合、[[http://www.zlatkovic.com/pub/libxml/ http://www.zlatkovic.com/pub/libxml/]] 依存の `libxml2` のために `libxml2.dll` / `iconv.dll` / `zlib1.dll` が存在するディレクトリへの `PATH` が通ってないといけません。 1. MojoMojo をインストールします * [[http://search.cpan.org/dist/MojoMojo/ 安定版は CPAN にあります]] * [[http://github.com/marcusramberg/mojomojo/ 最新(開発)版は git にあります]] インストール時のテストが通るかどうかは [[http://deps.cpantesters.org/?module=MojoMojo;perl=latest CPAN Testers status of the MojoMojo dependencies]] を参照してください。 Catalyst アプリケーションと同じように、`mojomojo_*.pl` スクリプトは `/usr/local/bin` にインストールされます。 1. [[/perl/mojomojo/config MojoMojoの設定]] を書くとき、mojomojo.conf を上書きするのではなくて、`mojomojo_local.conf` に書いたローカル設定で `mojomojo.conf` を上書きする(そうなる)のが Catalyst アプリケーションのやり方です。 (詳細は [[http://dev.catalystframework.org/wiki/faq#What_is_the_precedence_of_various_configuration_setting_locations.3F Catalyst wiki - What is the precedence of various configuration setting locations?]] を参照してください。) MojoMojo の設定ファイルを適当に指定するには、次のようにしてください: MOJOMOJO_CONFIG=/my/other/path.conf Catalyst 用の環境変数は [[http://search.cpan.org/dist/Catalyst-Plugin-ConfigLoader/lib/Catalyst/Plugin/ConfigLoader/Manual.pod#ENVIRONMENT_VARIABLES MYAPP_CONFIG]] を参照してください。 古いバージョンの [[http://mojomojo.org/documentation/install インストール手順]] ## GitHub から最新版をインストールする手順 !!sh!! 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 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 For an example of installing the latest build from GitHub on openSuSE 11.2, see [[http://mojomojo.org/documentation/installation/installing_on_opensuse Installing on openSuSE]] ## Upgrading In general, upgrading via CPAN (or your equivalent distribution package) should be the only step required to upgrade your MojoMojo installation: !!sh!! n@fendahl:~$ sudo cpan cpan[1]> install MojoMojo Running install for module 'MojoMojo' Running make for M/MR/MRAMBERG/MojoMojo-1.00.tar.gz Running make test t/01app.t ....................... ok t/02pod.t ....................... ok t/03podcoverage.t ............... skipped: set TEST_POD to enable this test t/04context.t ................... ok [snip] All tests successful. Files=54, Tests=624, 165 wallclock secs ( 0.20 usr 0.11 sys + 99.55 cusr 5.01 csys = 104.87 CPU) Result: PASS MRAMBERG/MojoMojo-1.00.tar.gz /usr/bin/make test -- OK Running make install Prepending /home/justin/.cpan/build/MojoMojo-1.00-hLVXEf/blib/arch /home/justin/.cpan/build/MojoMojo-1.00-hLVXEf/blib/lib to PERL5LIB for 'install' Installing /usr/local/share/perl/5.10.0/MojoMojo.pm Installing /usr/local/share/perl/5.10.0/MojoMojo/mojomojo.conf [snip] Installing /usr/local/bin/mojomojo_update_db.pl Installing /usr/local/bin/mojomojo_spawn_db.pl Installing /usr/local/bin/mojomojo_fastcgi_manage.pl Installing /usr/local/bin/mojomojo_fastcgi.pl Installing /usr/local/bin/mojomojo_cgi.pl Appending installation info to /usr/lib/perl/5.10/perllocal.pod MRAMBERG/MojoMojo-1.00.tar.gz /usr/bin/make install -- OK 1.00 より前のバージョンから 1.00 にバージョンアップするときは、`mojomojo.conf` の「データベース接続の項目」を確認してください。 !!sh!! # DB User user db_user password db_password # SQLite DSN (default database type, recommended for small to medium deployments) dsn dbi:SQLite:mojomojo.db ... データベースのスキーマはいまのところ変更される予定がありませんが、`cpan MojoMojo` や `git pull` でアップデートするときは気をつけるべきです。 ## プラグイン サーバーをスタートさせる前に、もし GitHub からインストールした場合は、使う予定のないプラグインを削除した方が良いでしょう。プラグインの削除は、`/lib/MojoMojo/Formatter` ディレクトリにある該当 `.pm` ファイルを削除か移動してしまうだけです。 そんなに必要ではないかもしれないプラグイン: * Dir - formats a directory on your server as XHTML * File - formats a file as XHTML (`File.pm`, `/lib/MojoMojo/Formatter/File`) * Text - formats plain text as XHTML * DocBook - format content as DocBook (`DocBook.pm`, `/lib/MojoMojo/Formatter/DocBook`) * Defang - prevents cross-site-scripting but [[http://github.com/marcusramberg/mojomojo/issues/#issue/60 corrupts markup in the process and slows down MojoMojo by a factor of 2]] ## インストールが終わったら [[http://mojomojo.org/documentation/deployment Deployment]] を参照してください。 もし、うまくいかない場合は [[troubleshooting トラブルシューティング]] を参照してください。