View source for Mahara日本語ドキュメント/システム管理者ガイド/Maharaのインストール

再作成中です - [[User:Mits|mits]]

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

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

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

<div id="section_1">

==依存関係==

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

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

<div id="section_2">

===ハードウェア===

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

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

</div><div id="section_3">

===ソフトウェア===

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

代替ソフトウェアも含めて、[[System Administrator's Guide/Requirements#Software|ソフトウェア要件に関する詳細は、こちらをご覧ください]] 。

</div></div><div id="section_4">

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

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

コードを取得した後、あなたのウェブサーバの「htdocs/」ディレクトリ内にコードをコピーしてください。以下のどちらの方法でも適切です:
* ディレクトリすべてをコピーした後、「mahara」のようなディレクトリ名にリネームします - あなたのサイトは、<code>example.org/mahara/</code> のようになります。

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

あなたがUbuntuに詳しくなく、ファイルのインストールおよびApache設定に関する詳細説明を必要とする場合、[[Mahara日本語ドキュメント/システム管理者ガイド/Maharaのインストール/UbuntuにMaharaをインストールする|ステップバイステップガイドをご覧ください]]。

</div><div id="section_5">

==データベースを作成する==

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

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

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

 <nowiki># 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)</nowiki>

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

 mysql --user=root -p
 
  [enter password]
 
  create database (databasename) character set UTF8;
 
  grant all on (databasename).* to 'username'@'localhost' identified by 'password';

可能であれば、[[System Administrator's Guide/PostgreSQL or MySQL%3f|あなたのデータベースにPostgreSQLを使用してください]]。

</div><div id="section_6">

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

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

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

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

 <code>.../yourusername/public_html</code>
  <code>.../yourusername/maharadata</code>

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

</div><div id="section_7">

==Maharaのconfig.phpを作成する==

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

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

</div><div id="section_8">

==Apacheの設定==

<span style="background-color: rgb(255, 204, 153)">'''メモ:''' あなたが共有ホスティングを使用している場合、恐らく、この設定を変更する必要がありません。ですから、このセクションは無視してください。</span>

シンプルな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/
 

</div><div id="section_9">

==あなたの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

</div><div id="section_10">

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

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

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

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

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

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

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

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

<div id="section_11">

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

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

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

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

</div></div><div id="section_12">

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

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

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

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

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

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

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

</div><div id="section_13">

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

あなたのMaharaのインストール完了、おめでとうございます! それでは、[[Mahara%e6%97%a5%e6%9c%ac%e8%aa%9e%e3%83%89%e3%82%ad%e3%83%a5%e3%83%a1%e3%83%b3%e3%83%88/%e3%82%b7%e3%82%b9%e3%83%86%e3%83%a0%e7%ae%a1%e7%90%86%e8%80%85%e3%82%ac%e3%82%a4%e3%83%89/%e6%ac%a1%e3%81%ae%e3%82%b9%e3%83%86%e3%83%83%e3%83%97|次のステップ]]をお読みください - 例えば、新しい言語およびテーマに関する説明等が説明されています。

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

</div><div id="section_14">

==トラブルシューティング==

Maharaのインストール時、あなたにトラブルが発生した場合、一般的な問題に関する回答を含んだ、[[Mahara%e6%97%a5%e6%9c%ac%e8%aa%9e%e3%83%89%e3%82%ad%e3%83%a5%e3%83%a1%e3%83%b3%e3%83%88/%e3%82%b7%e3%82%b9%e3%83%86%e3%83%a0%e7%ae%a1%e7%90%86%e8%80%85%e3%82%ac%e3%82%a4%e3%83%89/Mahara%e3%81%ae%e3%82%a4%e3%83%b3%e3%82%b9%e3%83%88%e3%83%bc%e3%83%ab/%e3%83%88%e3%83%a9%e3%83%96%e3%83%ab%e3%82%b7%e3%83%a5%e3%83%bc%e3%83%86%e3%82%a3%e3%83%b3%e3%82%b0|トラブルシューティング]]ページをご覧ください。

</div>

===Subpages===

* [[Mahara日本語ドキュメント/システム管理者ガイド/Maharaのインストール/Mac_OS_XにMaharaをインストールする|Mac OS XにMaharaをインストールする]]
* [[Mahara日本語ドキュメント/システム管理者ガイド/Maharaのインストール/UbuntuにMaharaをインストールする|UbuntuにMaharaをインストールする]]
* [[Mahara日本語ドキュメント/システム管理者ガイド/Maharaのインストール/WAPMサーバを使用したインストールに関するインストラクション|WAMPサーバにMaharaをインストールする]]
* [[Mahara日本語ドキュメント/システム管理者ガイド/Maharaのインストール/トラブルシューティング|トラブルシューティング]]