Mahara日本語ドキュメント/システム管理者ガイド/Maharaのインストール: Difference between revisions

Revision as of 04:29, 6 December 2013

再作成中です - mits

このガイドはMaharaのインストールに関するドキュメントです。Mahara は他のプラットフォームにもインストールすることができますが、このガイドでは主要なプラットフォーム (LinuxおよびApache) にMaharaをインストールする人をターゲットとしています。

Maharaはウェブアプリケーションです。これはあなたがダウンロードして実行できる実行形式のファイルのみを意味しているのではありません。Maharaを動作させるにはサーバが必要です (試すだけでしたら、あなたのデスクトップをサーバとして使うこともできます)。あなたはMaharaが動作するため、ApacheウェブサーバおよびPostgreSQLデータベースシステム等、他のソフトウェアもインストールする必要があります。代替手段は、共有ホスティングを利用する方法です - しかし、この方法では、あなたが管理アクセス可能なサーバと同じような自由度はありません。

あなたがDebian/Ubuntuを使用している場合、多くの必須ソフトウェアは (そして、Mahara自体でさえも)、apt-getをコマンドでインストールすることができます。また、あなたが他のLinuxディストリビューションを使用している場合、ディストリビューション特有のインストールツールを使用することもできます。

依存関係

Maharaは、主にLinux上で使用されるよう設計され、Apacheウェブサーバ、PostgreSQLデータベースサーバおよびPHPを使用します。私たちはMySQLデータベースサーバの使用もサポートしています。

加えて、コミュニティのメンバーはMaharaを Mac OSX および Windows 上で動作させることに成功して、Apacheの代わりにnginxを使用できるようにしました。Mahara開発者はこれらのプラットフォーム上での動作を妨げる発見されたバグを修正します。しかし、日々明確にテストされているわけではないため、Linuxボックス+Apacheを使用するのに比べて、あなたに幸運がもたらされる可能性は低くなります。

ハードウェア

CPU: ここ数年内に製造された速く良質な最新のCPUを使用してください。PHPページはCPUの性能に制限されます。そのため、速いCPUはレスポンスが早いことを意味します。
メモリ: 絶対最小値として256MBが必要です。1Gまたはそれ以上のメモリを推奨します。
ディスク: あなたがそれぞれのユーザに設定したいディスククオータ (使用可能なディスク容量) に大きく依存します。それぞれに250MBを割り当てた1000ユーザのサイトでは、あなたは最初に50GBは必要となるでしょう。

あなたに必要なスペックを計算するためのハードウェア条件に関する詳細情報はスケーラビリティをご覧ください。最近のエントリレベルのサーバにより、平均的な大学に十分対応することができます。多くの場合、あなたはVPSのような仮想環境により、上手く対処することができます。

ソフトウェア

Linux - どのディストリビューションでも構いません。常にテストされているDebianまたはUbuntuを推奨します。Debianにはパッケージも含まれています。
PHP - 5.1.3またはそれ以上。あなたはこれらのPHP拡張モジュールも必要です。
PostgreSQL - 8.1+ (推奨)またはInnoDBテーブルをサポートするMySQL 5.0.25+ 。
Apache - 1.3またはそれ以上。バージョン2またはそれ以上を推奨します。

代替ソフトウェアも含めて、ソフトウェア要件に関する詳細は、こちらをご覧ください。

コードを取得して、あなたのウェブサーバに置く

Maharaを動作させるには、あなたのサーバにMaharaコードのコピーを置く必要があります。Maharaのスタンダードビルドを直接ダウンロードする、またはあなたがgitの使用方法を知っている場合、gitリポジトリからプロジェクトをチェックアウトすることができます (この選択肢は主に開発者向けです)。

コードを取得した後、あなたのウェブサーバの「htdocs/」ディレクトリ内にコードをコピーしてください。以下のどちらの方法でも適切です:

ディレクトリすべてをコピーした後、「mahara」のようなディレクトリ名にリネームします - あなたのサイトは、example.org/mahara/ のようになります。

または、htdocs/ディレクトリのコンテンツを、あなたのウェブサーバのパブリックディレクトリのトップレベル (通常、htdocsまたはpublic_html) にコピーします - あなたのサイトは、example.orgのようになります。

あなたがUbuntuに詳しくなく、ファイルのインストールおよびApache設定に関する詳細説明を必要とする場合、ステップバイステップガイドをご覧ください。

データベースを作成する

あなたは、Mahara用にデータベースを作成して、そのデータベースにウェブサーバからアクセスできることを確認する必要があります。コマンドラインに関するインストラクションは下記をご覧ください。あなたがCpanelまたは類似のソフトウェアにアクセスできる場合、代わりに、それらのツールを使用してデータベースを作成してください。

あなたのデータベースのエンコードをUTF8にしてください。以下のコマンドではUTF8エンコードされたデータベースを作成します。あなたがCpanel等の管理システムを使用している場合、UTF8データベースが作成されたかどうか必ず確認してください。

PostgreSQLのコマンドラインインストラクション:

# Run these commands while su'd to the 'postgres' user
  # If you need to create a database user:
  createuser -SRDP (username)
  # Actual database creation
  createdb -O (username who will be connecting) -EUTF8 (databasename)

MySQLのコマンドラインインストラクション:

mysql --user=root -p

 [enter password]

 create database (databasename) character set UTF8;

 grant all on (databasename).* to 'username'@'localhost' identified by 'password';

可能であれば、あなたのデータベースにPostgreSQLを使用してください。

データディレクトリ作成する

■■■■■■■■■■■■■■■■■■■■■■

このディレクトリは、アップロードされたファイルをMaharaが書き込む場所です。同様に、実行する必要のあるファイルも置かれる場所です。このディレクトリの主要なポイントのひとつは、ウェブサーバから書き込めるという点です。他の主要なポイントは、あなたのMaharaコードがあるディレクトリ内部に置けないという点です! 実際、あなたがpublic_htmlディレクトリを使用する場合、このディレクトリ内にデータディレクトリを置くべきではありません。

あなたのウェブサーバで、このディレクトリを作成する必要があります。あなたがpublic_htmlディレクトリを使用している場合、同じ階層にディレクトリを作成してください。あなたは、このディレクトリに「maharadata」のようなディレクトリ名を付けることができます。ディレクトリを作成した後、あなたには、以下のようなディレクトリ構造 (ファイルを省略) が見えるはずです:

.../yourusername/public_html
 .../yourusername/maharadata

あなたは、maharadataディレクトリがウェブサーバのユーザから書き込めるようにする必要があります。あなたは、オーナーをウェブサーバユーザに変更するか、777にchmodすることができます。後者は、お勧めできません。しかし、あなたが共有ホスティングを利用している場合、恐らく、そうする必要があるでしょう。FTPプログラムを使用して、あなたはディレクトリをchmodすることができます。

Maharaのconfig.phpを作成する

Maharaのhtdocsディレクトリ内にconfig-dist.phpという名称のファイルがあります。このファイルをconfig.phpという名称にコピーしてください。そのファイルを開いた後、あなたは、適切に内容を編集する必要があります。ファイルのコンテンツはコメントアウトされて、変更すべき内容は、それほど多くありません。しかし、以下の設定に関しては、十分注意してください:

データベース接続詳細情報 — $cfg->dbname、$cfg->dbuser、$cfg->dbpass、$cfg->dbprefix に適切な値を入れて、データベース詳細情報を設定してください。
- Note: Moodleとは異なり、あなたはdbprefixを設定する必要はありません。最初にdbprefixを使用せず、動作するかどうか確認してください。あなたが必要だと思った場合、dbprefixを空にして、接頭辞を$cfg->dbname および $cfg->dbuserIf に直接追加することもできます。
dataroot - ここには、あなたがウェブサーバユーザによる書き込み可能にしたディレクトリのファイルパスを設定してください。これは、ファイルシステムパスであり、Linuxでは /path/to/your/directory のように、そしてWindowsでは C:\path\to\your\directory のようになることに留意してください。これは、http://example.org/maharadata のようなウェブアドレスではありません!
ディレクトリパーミッション - あなたがrootアクセスできないサーバを使用している場合、後でバックアップおよび言語パックをインストールできるよう、ディレクトリに0700～0777または類似のパーミッションを設定してください。

Apacheの設定

メモ: あなたが共有ホスティングを使用している場合、恐らく、この設定を変更する必要がありません。ですから、このセクションは無視してください。

シンプルなApacheバーチャルホストの設定で十分です:

         ServerName example.org
         DocumentRoot /path/to/mahara/htdocs

         ErrorLog /var/log/apache2/mahara.error.log
         CustomLog /var/log/apache2/mahara.access.log combined


                 AllowOverride All

あなたのapache設定には、ServerAliases設定が含まれていないことに留意してください。Maharaには、1つのURIを通してアクセスしてください。このことにより、クッキーに正しいドメインが確実に設定され、この1つのURIに対して、ネットワーク機能のSSL証明書を生成することができます。あなたがサーバエイリアスを使用している場合、2度ログインする必要があるトラブルに遭遇する可能性があります。また、あなたの他のサイトとのSSOに問題が生じる可能性もあります。

上記と同様に、2番目のバーチャルホストディレクティブを使用する場合、あなたは、example.orgおよびwww.example.orgの両者をサイトアクセスに使用することができます:

     ServerName www.example.org
     # You _can_ add ServerAliases here if you want more than one URL to
     # redirect to your main site
     # ServerAlias foo.example.org

     Redirect Permanent / http://example.org/

あなたのPHP設定を調整する

あなたのphp.iniファイル内 (通常 /etc/php5/apache2/php.ini) に下記の設定があることを確認してください:

register_globals off
 magic_quotes_runtime off
 magic_quotes_sybase off
 magic_quotes_gpc off
 log_errors on
 allow_call_time_pass_reference off
 upload_max_filesize 50M
 post_max_size 50M

基本的なウェブインストーラーを実行する

config.php (おおよびApacheの設定、共有ホスティングの場合は不要) の設定を完了した後、ウェブブラウザを使用して、あなたは、Maharaインストールを実行することができます。インストール画面では、Maharaの使用条件が表示され、同意が求められます。あなたは使用条件に同意した場合、「同意」をクリックすることで、あなたのデータベースにMaharaがインストールされます。「続ける」をクリックした後、あなたは、管理者パスワードの変更を求められます。そして、あなたは、新しいMaharaにログインすることになります。おめでとうございます!

メモ: 管理者のパスワード名は、「admin」です。Mahara 1.2以前のバージョンでは、あなたがパスワードを変更するには、ログインする必要がありました。その管理者デフォルトパスワードは、「mahara」です。

コマンドラインインターフェースインストーラーを実行する

バージョン1.5.0以降、Maharaではウェブベースのインストーラに代えることのできる素晴らしいコマンドラインのインストールおよびアップグレート用ツールを提供しています。

ドキュメントルート内で数多くのディレクトリを作成して、ファイルの所有権を設定するため、あなたのウェブサーバと同じユーザでコマンドラインインターフェース (CLI - Command Line Interface) を実行する必要があります。

mahara/htdocsディレクトリに移動して、次のコマンドを実行します: php admin/cli/install.php --adminpassword='examplepassword' --adminemail=youremailaddress

実際のインストールプロセスを表示するため、あなたは任意で--verboseオプションを使用することができます。また、インストーラのオプションの補足説明のため、--helpを使用することもできます。

インストール処理がエラーで終了してしまったら?

しばしば、この状態が発生します。通常、このエラーは、あなたのシステムの設定ミスに起因します - 例えば、あなたのデータベースユーザにテーブルを作成する権限を与えていなかったり、十分なバージョンのデータベースを使用していないことが考えられます(詳細は、依存関係をご覧ください)。時々、このエラーは、Maharaインストーラーのバグに起因することもあります。原因を探すには、あなたのウェブサーバのエラーログを確認してください。バグが発生した場合、Maharaは、詳細情報をエラーログに出力します。

メッセージは、あなたの設定に問題があることを示すであろうと思われますが、仮に、Maharaの問題であると思われる場合、私たちが修正できるよう、あなたのログを含んだ情報をバグレポートに投稿してください。

あなたが問題を解決できた場合、データベースをドロップ (削除) して、再度作成してください。これにより、前回のインストールで使用したテーブルが、新たなインストールに影響することを防ぎます。

最後の仕事 (忘れずに!): Cron Job

毎分、htdocs/lib/cron.phpを実行するため、あなたはcronジョブを設定する必要があります。Maharaは独自のcronを内部に実装しているため、すべてを動作させるには、毎分cronを実行させることで十分です。

あなたがcronジョブを設定しない場合、RSSフィードの更新、通知メールの送信、フォーラム投稿のメール通知が処理されません。

あなたは、コマンドを使用するか、lynxまたはw3mのようなコマンドラインウェブブラウザを使用して、cronスクリプトの実行を設定することができます。

次のようなcrontabファイルの記述で十分です:

* * * * * curl http://your-mahara-site.org/lib/cron.php

curlを使用してcronを実行している場合、cronアウトプットは、あなたのApacheエラーログに記録されます。あなたがログをApacheログと分けたい場合 (特に良い考え方ですが、セットアップに少々難しさがあります)、separate article about Mahara's cronをご覧ください。

私のMaharaがインストールされました - それでは?

あなたのMaharaのインストール完了、おめでとうございます! それでは、次のステップをお読みください - 例えば、新しい言語およびテーマに関する説明等が説明されています。

そして、あなたがまだMaharaコニュニティに入っていないのでしたら、参加するには良いタイミングです - あなたのMaharaに関して、世界中の熱心なMaharaコミュニティのユーザから、助けてもらったり、アイデアを得ることができます。フォーラムでお会いしましょう!

トラブルシューティング

Maharaのインストール時、あなたにトラブルが発生した場合、一般的な問題に関する回答を含んだ、トラブルシューティングページをご覧ください。