Mahara日本語ドキュメント/システム管理者ガイド/Maharaのアップグレード

このドキュメントでは、あなたがインストール済みMaharaをどのようにすればアップグレードできるのか記しています。0.9から1.0へのようなメジャーバージョンアップまたはマイナーバージョンアップ (例 1.0.5 → 1.0.6) に関わらず、処理自体は多くの部分で同じです。

基本的な処理は:

あなたのサイトを選択してください。
あなたのデータおよび変更されたコードをバックアップしてください。
新しいコードを配置してください。
データベースアップグレードを実行してください。
あなたのサイトにアクセスしてください。

1. あなたのMaharaサイトを選択する

アップグレードを実行している間、あなたはMaharaが動作に必要とするファイルをコピーしたり、恐らく一時的にでも削除することもあるでしょう。また、あなたが新しいコードを適切に置いていながら、まだデータベースをアップグレードしていないこともあるでしょう。これらの場合、Maharaは適切に動作しません。Mahara 1.1以降、この状況はMaharaによって検出され、あなたのサイトは自動的に閉じられます。インストール済みの1.0では、.htaccess * ファイルであなたのサイトを閉じる必要があります。または、システムが使用されていない時間帯をあなたが知っている場合、その時間帯にアップグレードを実施してください。

* あなたがApacheを使用している場合、代わりに以下の行を追加することで、あなたのサイトへのトラフィックを、例えばメンテナンスページにリダイレクトします:

RewriteEngine on (onにされていない場合)
redirectMatch 301 ^(.*)$ http://www.domain.com

2. あなたのデータベースおよびdatarootディレクトリをバックアップする

Maharaは、あなたの大切なユーザデータを2つの場所に保存します:

データベースは、ユーザプロファイル、アーティファクトデータ、グループ情報、ビューを含む、ほとんどの情報が保存される場所です。
datarootディレクトリは、イメージ、ビデオ、プロファイルアイコンおよび他のファイルが保存されるサーバ内ディレクトリです。Maharaは、ここにセッションファイルも保存します。

これら2つの場所でのみ、あなたはデータを保存できます - アップブレードされたコードベースには再度適用する必要はありますが、あなたはコードをカスタマイズすることができます。あなたがカスタマイズの記録を保持することで、この作業は簡単になります - カスタマイズの記録に関する最良の方法は、あなたのコードをバージョンコントロールで管理することです。これは、このドキュメントの範囲を超えていますが、あなたのコード変更をgitリポジトリのブランチ (branch) で保持することは、賢明であり簡単な管理方法です。また、Maharaのステイブルブランチ (stable branch) をトラック (track 追跡) することで、最新のバグフィックスも適用することができます。

サイトを閉じた後、あなたのユーザがデータを失うことがないよう、Maharaに関するすべてのデータをバックアップすることに留意してください。

3. 新しいコードを配置する

あなたのMaharaに修正を加えていない場合、最良の方法はアーカイブを解凍した後、古いフォルダを違う場所に移動して、古いフォルダがあった場所に新しいフォルダを移動することです。この作業により、削除すべきファイルを確実に削除することができます。

古いコードの上で新しいアーカイブを解凍することは、お勧めできません - この作業により、削除されるべき不要なファイルが削除されることはありません。そして、あなたが変更したコードによりコースが吹き飛ばされることになります。安全に作業しましょう - 古いコードを別の場所に移動して、新しいコードを適切な場所に配置してください。あなたが問題を発見した場合、この準備により簡単に古いコードへ「ロールバック」することもできます - または、少なくとも古いコードと新しいコードを同時に調査する機会をあなたに与えることができます。

あなたが変更を加えている場合、変更を含むパッチを作成して、新しいフォルダに適用しても良いでしょう。この作業により、あなたの変更内容をアップグレードが壊さないことを確実にして、あなたのパッチと新しいコードに関するすべてのコンフリクトを指摘できます。

4. データベースをアップグレードする

あなたのブラウザで、admin/upgrade.phpにアクセスしてください。データベースのアップグレードを確認してください。あなたのシステム規模が大きい場合、アップグレードには、1分またはそれ以上かかることに留意してください。残念ですが、現在のところプログレスインディケータ (進捗表示) はありません - 進捗を監視するベストな方法は、tailコマンドでエラーログを確認して、問題発生に注意することです。

5. ユーザにあなたのサイトを利用できるようにする

あなたのサイトは正常にアップグレードされました。忘れずに再度サイトを公開してください! Mahara 1.1では、サイトが自動的に閉じられた場合、データベースのアップグレード終了後、再度自動的に公開されます。

トラブルシューティング

Q: アップグレードに失敗しました! :(

A: アップグレードプロセスは、常に十分にテストされますので、通常このようなことは起こりません。しかし、アップグレードに失敗した場合、フォーラムまたは #mahara IRCチャンネルで私たちにお知らせください - お尋ねする場合がありますので、あなたのデータベースのダンプおよびエラーメッセージのコピーをご準備ください。

あなた自身で問題を発見した場合、問題に関連する情報をバグレポートに投稿してください。可能な限り迅速に対応させていただきます!

Q: どのようにすればアップグレードが実行されたか/どのよにすれば私のサイトにMaharaの新しいバージョンが入っていると分かりますか?

A: バージョンは、管理セクションページ最下部に表示されています。

Q: テーマが壊れたようです?

A: あなたのブラウザを強制リロード (hard reload) してください (通常、Ctrl+R/Apple+R)。