「Moodleをアップグレードする」の版間の差分

提供:MoodleDocs
移動先:案内検索
(Mitsトーク)による編集をToshihiro KITAによる直前の版へ差し戻しました)
(done.)
 
(同じ利用者による、間の6版が非表示)
1行目: 1行目:
Moodleは、どの旧バージョンからも新しいバージョンに正常なアップグレードができるよう設計されています。 アップブレードバージョンに関して配慮すべき内容は、'''[[Moodle1.6へのアップグレード]]'''、'''[[Moodle1.8へのアップグレード]]'''または'''[[Moodle1.9へのアップグレード]]'''をご覧ください。
{{Moodleのインストール}}
このページでは、Moodleのアップグレード方法を詳細に説明します。処理の概要に関しては、[[アップグレード概要]]をご覧ください。


Moodle をアップグレードする場合、下記の手順に沿って作業を行ってください:
==必要条件を確認する==


== 重要なデータをバックアップする ==
あなたのサーバが2.4の必要条件すべてに合致するかどうか、「設定 > サイト管理> サーバ > [[動作環境]]」にて確認してください。


この作業は厳密に必要なものではありません。しかし、何らかの理由で旧バージョンに戻る必要がある場合があるかもしれませんので、システムのメジャーアップグレードを行う前にバックアップを行うことは適切な考え方です。実際は、この作業を省略するために、あなたのサーバで毎日 Moodle の自動的バックアップを取ればよいでしょう。
注意: あなたはMoodle 2.2またはそれ以降のバージョンからのみ、Moodle 2.4にアップグレードすることができます。古いバージョンからアップグレードする場合、あなたは最初の段階で[https://docs.moodle.org/22/en/Upgrading_to_Moodle_2.2 2.2にアップグレード]する必要があります。


バックアップを取る必要のある部分は3箇所あります:
==プラグインの更新を確認する==


=== 1. Moodle ソフトウェアディレクトリ ===
あなたのサイトにインストールしている寄贈/カスタムプラグイン (テーマを含む) の2.4バージョンがあるかどうか、[http://moodle.org/plugins Moodleプラグインディレクトリ]にて確認してください。2.4バージョンが存在している場合、プラグインコードをダウンロードして、あなたのMoodleコード内の適切な場所にコピーしてください (詳細は[[プラグインのインストール]]をご覧ください)。


config.php やテーマ、言語等のあなたが追加したモジュールを回復できるように、事前にこのディレクトリを別の場所にコピーしてください。
プラグインのアップグレードはMoodleアップグレード処理の一部として実施されます。


=== 2. データディレクトリ ===
古いプラグインによりアップグレードが失敗する場合、通常あなたはアンインストールするより、関連データを削除しないために、そのプラグインをMoodle内から削除した方が良いでしょう。


アップロードしたコンテンツ (コース資料や学生の課題) が入っていますので、このディレクトリのバックアップは非常に重要です。アップグレードにより、時々データディレクトリ内のディレクトリが、リネームされたり移動される場合があります。
注意: あなたが非標準ブロックをインストールしている場合、未定義のブロックケイパビリティに関して、下記をご覧ください。


=== 3. データベース ===
==あなたのサイトを実際にアップグレードする前に==


ほとんどの場合 Moodle のアップグレードでは、フィールドの追加または変更によりデータベーステーブルの更新が行われます。それぞれのデータベースシステムでは異なる方法でバックアップを行います。MySQL データベースでバックアップを取る1つの方法は単一のSQLファイルに「dump」することです。 次の例はUnixコマンドで"moodle"という名称のデータベースを dump しています:
'''予想どおりに動作するかどうか確認するため、最初にあなたの実運用サイトのコピーを使ったアップグレードのテストをお勧めします。


mysqldump -u username -p -C -Q -e -a moodle > moodle-backup-2002-10-26.sql
== 重要なデータをバックアップする ==
 
ユーザ名の代わりに、あなたのデータベースアカウントを使用してください。'''-p''' フラグは、あなたが '''-u''' で指定したユーザ名に対するパスワードの入力を求めます。


バックアップコマンドを実行するホスト (通常、ウェブサーバ) とデータベースホストが異なる場合、mysqldumpu コマンドに '''-h''' オプションでホストを指定してください:
アップグレード前にバックアップすべき対象が3つあります:
#Moodleソフトウェア (例: サーバ/htdocs/moodle内のすべて)
#Moodleにアップロードされたファイル (例: サーバ/moodledata)
#Moodleデータベース (例: MySQLまたはPostgresデータベース)


mysqldump -u username -p -h databasehost -C -Q -e -a moodle > moodle-backup-2002-10-26.sql
詳細は[[サイトバックアップ]]をご覧ください。


すべてのプラットフォームで同じインターフェースを提供する Moodle の「MySQL Admin」の「エクスポート」機能を使用することもできます。Moodleの「MySQL Admin」は、http://download.moodle.org/modules/integrations.php でダウンロードすることができます。このプログラムは、PHPMyAdmin と Moodle の管理画面を統合したものです。
==あなたのサイトをメンテナンスモードにする==
あなたのサイトをアップグレードする前、非管理者ユーザのログインを止めるため、[[メンテナンスモード]]に切り替えてください。


== 新しい Moodle ソフトウェアをインストールする ==
== 新しいMoodleソフトウェアをインストールする ==


=== ダウンロードアーカイブを使用する ===
=== 標準インストールパッケージ ===


自分が何をやっているのか分からない場合は、古いバージョンに上書きしないでください ... 時々古いファイルが新しいバージョンに問題を生じさせる場合があります。一番良い方法は、現在の Moodle ディレクトリを他の名前にリネームして、新しい Moodle アーカイブを元の場所に解凍する方法です。
# あなたの古いMoodleプログラムファイルを別の場所に移動してください。古いファイルの上に新しいファイルをコピーしないでください。
# サーバ内の古いファイルが配置されていた場所に新しいMoodleソフトウェアプログラムのファイルを配置するため、アップグレードファイルを解凍してください。アップグレードに必要であれば、MoodleはSQLおよびmoodledataを調整します。
# あなたの古い[[設定ファイル|config.phpファイル]]を新しいMoodleディレクトリにコピーしてください。
# 上記で言及したとおり、あなたのサイトにカスタムプラグインをインストールしている場合、それらを新しいコードに追加してください。あなたが最新バージョンのMoodleを取得していることを確認することは大切なことです。特に新しいバージョンのコードに上書きしないよう、十分に注意してください。


====Linux====
  mv moodle moodle.backup
  mv moodle moodle.backup
  tar xvzf moodle-1.1.tgz
  tar xvzf moodle-2.4.tgz


次に、あなたのconfig.phpやオリジナルテーマ等のプラグインをコピーします:
次に、あなたのconfig.php、すべての独自プラグイン、そして作成している場合は .htaccessファイルをコピーしてください (最初にカスタムプラグインがあなたの新しいMoodleに合致した新しいバージョンであることをチェックしてください):


  cp moodle.backup/config.php moodle
  cp moodle.backup/config.php moodle
  cp -pr moodle.backup/theme/mytheme moodle/theme/mytheme
  cp -pr moodle.backup/theme/mytheme moodle/theme/mytheme
cp -pr moodle.backup/mod/mymod moodle/mod/mymod


=== CVSを使用する ===
忘れずに、あなたのサーバから moodle/config.php (および他のソースコード) を読めるようにしてください。理想的には、あなたのサーバからファイルに書き込みできないようにすべきです。


Moodle のアップデート、アップグレードに CVS を使用することができます。
あなたがcronを使用している場合、cron.phpに実行権が与えられていること、それから正しいphpコマンドを使用していることに注意してください:
最初に、(空の) Moodle ルートディレクトリで CVS チェックアウトを実行してください。
chmod 740 admin/cli/cron.php (some configurations need chmod 750 or chmod 755)


[[:en:CVS_for_Administrators#CVS_Servers|CVS のミラーサーバ]] を使用することができます。下記の SERVER.cvs.moodle.org の部分をお好きなミラーサーバ名に置き換えて下さい。
必要であれば、cron.phpの最初の行をコピーしてください (最初の行が '#!/usr/local/bin/php' または '#!/usr/local/bin/php5.3' のようでしたら、'<?php' をコピーする必要はありません)。


''Linuxユーザは'''
=== Gitを使用する===


Moodle を CVS チェックアウトするには、最初に MoodleCVS サーバにログインしてください。
あなたのMoodleの更新またはアップグレードのためにGitを使用することができます。詳細は[[管理者用Git]]をご覧ください。


  <nowiki>cvs -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle login</nowiki>
===コマンドラインアップグレード===
  anonymous にはパスワードは不要ですので、Enter ボタンを押してください。


Moodle ルートディレクトリを作成したい場所に移動して、下記のコマンドを入力してください。
Linuxサーバにおいて、Moodle 2.4はウェブブラウザ経由のアップグレードだけではなく、[[コマンドライン経由の管理|コマンドラインからのアップグレード]]もサポートします。特定の大規模サイトでは、コマンドラインからのアップグレードの方が信頼できると考えられます。


  <nowiki>cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle</nowiki>
== アップグレードを終了する ==
  (MOODLE_19_STABLE をチェックアウトしたい場合)


アップデートするには、Moodle ルートディレクトリに移動して、下記のコマンドで新しいファイルにアップデートしてください:
最後のステップでは、Moodle内でアップグレード処理を始動させます。


  cvs update -dP
この処理を始動するには、「設定 > サイト管理 > 通知」にアクセスしてください。


必要に応じて新しいディレクトリを作成するように、「d」パラメータを使用してください。また、「P」パラメータは空のディレクトリを削除します。
Moodleは新しいバージョンを自動的に検知して、必要なすべてのSQLデータベースまたはファイルシステムのアップグレードを実行します。極めて稀なケースですが、アップグレードを実行できない場合、あなたが何をすべきか伝えるメッセージが表示されます。


'''Windows ユーザは'''
すべてが (エラーメッセージなしに) 正常終了した場合、あなたの新しいバージョンのMoodleを使って、新しい機能を楽しんでください!


初期のチェックアウトおよびアップデートに、[http://www.tortoisecvs.org/ Tortoise CVS] を使用することができます。
注意: あなたが複数サーバを動作させている場合、すべてのサーバのアップグレードを完了した後、すべてのキャッシュを手動でクリアしてください (「設定 > サイト管理 > 開発 > すべてのキャッシュを削除する」)。


Moodle ファイルを編集している場合、コンフリクトがないか慎重に確認してください。あなたがカスタマイズしたテーマやスタンダードでな無いプラグインは、CVSによる影響を受けません。
==アップグレードの後で==


CVS によるアップデート処理が終わった後、忘れずに管理ページへアクセスしてください。
あなたの2.2または2.3インストレーションのconfig.phpでも正常に動作しますが、Moodle 2.4に同梱されているconfig-dist.phpを確認してみると、さらに異なる利用可能なオプションがあります (例 データベースドライバおよび設定)。2.4のconfig-dist.phpを基に、あなたの古いconfig.phpの設定を新しいconfig.phpに設定するのは良いアイデアです。
 
== アップグレードを終了する ==


最後に Moodle のアップグレードプロセスを実行します。
==Moodle 2.4において、あなたに影響する可能性のある問題==


これを行うには、インストールの管理者ページにアクセスしてください。例. ''<nowiki>http://example.com/moodle/admin</nowiki>''
=== ブロックケイパビリティ未定義 ===


        http://example.com/moodle/admin
あなたが寄贈/カスタムブロックをインストールしている場合、インストール後にブロックケイパビリティが定義されていないというメッセージが表示されることがあります。例えば、次のようになります:


これは、admin でログインしているかどうかは関係ありません。
The block <blockname> does not define the standard capability block/<blockname>:myaddinstance


Moodle は新バージョンを検出して、必要なデータベースまたはファイルシステムのアップグレードを行います。もし、アップグレードが正常に行われない場合 (非常に稀です) は、何をする必要があるのか知らせてくれるメッセージが表示されます。
Moodle 2.4において、[[ブロック管理_(管理者)|ブロック使用の管理]]のために、「addinstance」および「myaddinstance」ケイパビリティが追加されました。これらのケイパビリティを寄贈ブロックに定義する場合、[[:dev:Blocks|ブロック開発ドキュメント (英語)]]の「[[:dev:Blocks#Ready.2C_Set.2C_Go.21|Ready, Set, Go!]]」セクションをご覧ください。


すべてが正常 (エラーなし) に終了した場合、新しい Moodle を使うことができます。新しい機能をお楽しみください!
=== Moodle 2.3での改善点 ===


== 関連情報 ==
あなたがMoodle 2.2から2.4にアップグレードする場合、[https://docs.moodle.org/23/en/Upgrading Moodle 2.3へのアップグレードドキュメント (英語)]の「Possible issues that may affect you in Moodle 2.3」セクションをご覧ください。


*Using Moodle [http://moodle.org/mod/forum/view.php?id=28 Installation problems] forum
==関連情報==
*[[Moodle 1.6へのアップグレード]]
*[[Moodleのインストール]]
*[[インストールFAQ]]
*[[AMPのインストール|Apache、MySQLおよびPHPのインストール]]
*[[Windowsのためのステップバイステップ・インストールガイド]]
*[[RedHatのためのステップバイステップ・インストールガイド]]
*[[Debian GNU/Linuxのためのステップバイステップ・インストールガイド]]
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=26731&parent=125858 Using cvs] forum discussion


[[Category:コア]]
* Using Moodle [http://moodle.org/mod/forum/view.php?id=28 インストールの問題フォーラム (Installation problems forum)] - 英語
[[Category:管理者]]
* [[dev:Moodle 2.4 release notes|Moodle 2.4リリースノート]] - 英語
[[Category:インストール]]
* [[dev:Upgrade API|APIをアップグレードする]] - 英語


[[en:Upgrading]]
[[en:Upgrading]]
[[es:Actualización de moodle]]
[[zh:升级]]

2013年4月30日 (火) 21:54時点における最新版


このページでは、Moodleのアップグレード方法を詳細に説明します。処理の概要に関しては、アップグレード概要をご覧ください。

必要条件を確認する

あなたのサーバが2.4の必要条件すべてに合致するかどうか、「設定 > サイト管理> サーバ > 動作環境」にて確認してください。

注意: あなたはMoodle 2.2またはそれ以降のバージョンからのみ、Moodle 2.4にアップグレードすることができます。古いバージョンからアップグレードする場合、あなたは最初の段階で2.2にアップグレードする必要があります。

プラグインの更新を確認する

あなたのサイトにインストールしている寄贈/カスタムプラグイン (テーマを含む) の2.4バージョンがあるかどうか、Moodleプラグインディレクトリにて確認してください。2.4バージョンが存在している場合、プラグインコードをダウンロードして、あなたのMoodleコード内の適切な場所にコピーしてください (詳細はプラグインのインストールをご覧ください)。

プラグインのアップグレードはMoodleアップグレード処理の一部として実施されます。

古いプラグインによりアップグレードが失敗する場合、通常あなたはアンインストールするより、関連データを削除しないために、そのプラグインをMoodle内から削除した方が良いでしょう。

注意: あなたが非標準ブロックをインストールしている場合、未定義のブロックケイパビリティに関して、下記をご覧ください。

あなたのサイトを実際にアップグレードする前に

予想どおりに動作するかどうか確認するため、最初にあなたの実運用サイトのコピーを使ったアップグレードのテストをお勧めします。

重要なデータをバックアップする

アップグレード前にバックアップすべき対象が3つあります:

  1. Moodleソフトウェア (例: サーバ/htdocs/moodle内のすべて)
  2. Moodleにアップロードされたファイル (例: サーバ/moodledata)
  3. Moodleデータベース (例: MySQLまたはPostgresデータベース)

詳細はサイトバックアップをご覧ください。

あなたのサイトをメンテナンスモードにする

あなたのサイトをアップグレードする前、非管理者ユーザのログインを止めるため、メンテナンスモードに切り替えてください。

新しいMoodleソフトウェアをインストールする

標準インストールパッケージ

  1. あなたの古いMoodleプログラムファイルを別の場所に移動してください。古いファイルの上に新しいファイルをコピーしないでください。
  2. サーバ内の古いファイルが配置されていた場所に新しいMoodleソフトウェアプログラムのファイルを配置するため、アップグレードファイルを解凍してください。アップグレードに必要であれば、MoodleはSQLおよびmoodledataを調整します。
  3. あなたの古いconfig.phpファイルを新しいMoodleディレクトリにコピーしてください。
  4. 上記で言及したとおり、あなたのサイトにカスタムプラグインをインストールしている場合、それらを新しいコードに追加してください。あなたが最新バージョンのMoodleを取得していることを確認することは大切なことです。特に新しいバージョンのコードに上書きしないよう、十分に注意してください。

Linux

mv moodle moodle.backup
tar xvzf moodle-2.4.tgz

次に、あなたのconfig.php、すべての独自プラグイン、そして作成している場合は .htaccessファイルをコピーしてください (最初にカスタムプラグインがあなたの新しいMoodleに合致した新しいバージョンであることをチェックしてください):

cp moodle.backup/config.php moodle
cp -pr moodle.backup/theme/mytheme moodle/theme/mytheme
cp -pr moodle.backup/mod/mymod moodle/mod/mymod

忘れずに、あなたのサーバから moodle/config.php (および他のソースコード) を読めるようにしてください。理想的には、あなたのサーバからファイルに書き込みできないようにすべきです。

あなたがcronを使用している場合、cron.phpに実行権が与えられていること、それから正しいphpコマンドを使用していることに注意してください:

chmod 740 admin/cli/cron.php (some configurations need chmod 750 or chmod 755)

必要であれば、cron.phpの最初の行をコピーしてください (最初の行が '#!/usr/local/bin/php' または '#!/usr/local/bin/php5.3' のようでしたら、'<?php' をコピーする必要はありません)。

Gitを使用する

あなたのMoodleの更新またはアップグレードのためにGitを使用することができます。詳細は管理者用Gitをご覧ください。

コマンドラインアップグレード

Linuxサーバにおいて、Moodle 2.4はウェブブラウザ経由のアップグレードだけではなく、コマンドラインからのアップグレードもサポートします。特定の大規模サイトでは、コマンドラインからのアップグレードの方が信頼できると考えられます。

アップグレードを終了する

最後のステップでは、Moodle内でアップグレード処理を始動させます。

この処理を始動するには、「設定 > サイト管理 > 通知」にアクセスしてください。

Moodleは新しいバージョンを自動的に検知して、必要なすべてのSQLデータベースまたはファイルシステムのアップグレードを実行します。極めて稀なケースですが、アップグレードを実行できない場合、あなたが何をすべきか伝えるメッセージが表示されます。

すべてが (エラーメッセージなしに) 正常終了した場合、あなたの新しいバージョンのMoodleを使って、新しい機能を楽しんでください!

注意: あなたが複数サーバを動作させている場合、すべてのサーバのアップグレードを完了した後、すべてのキャッシュを手動でクリアしてください (「設定 > サイト管理 > 開発 > すべてのキャッシュを削除する」)。

アップグレードの後で

あなたの2.2または2.3インストレーションのconfig.phpでも正常に動作しますが、Moodle 2.4に同梱されているconfig-dist.phpを確認してみると、さらに異なる利用可能なオプションがあります (例 データベースドライバおよび設定)。2.4のconfig-dist.phpを基に、あなたの古いconfig.phpの設定を新しいconfig.phpに設定するのは良いアイデアです。

Moodle 2.4において、あなたに影響する可能性のある問題

ブロックケイパビリティ未定義

あなたが寄贈/カスタムブロックをインストールしている場合、インストール後にブロックケイパビリティが定義されていないというメッセージが表示されることがあります。例えば、次のようになります:

The block <blockname> does not define the standard capability block/<blockname>:myaddinstance

Moodle 2.4において、ブロック使用の管理のために、「addinstance」および「myaddinstance」ケイパビリティが追加されました。これらのケイパビリティを寄贈ブロックに定義する場合、ブロック開発ドキュメント (英語)の「Ready, Set, Go!」セクションをご覧ください。

Moodle 2.3での改善点

あなたがMoodle 2.2から2.4にアップグレードする場合、Moodle 2.3へのアップグレードドキュメント (英語)の「Possible issues that may affect you in Moodle 2.3」セクションをご覧ください。

関連情報