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

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つあります:

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

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

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

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

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

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

あなたの古いMoodleプログラムファイルを別の場所に移動してください。古いファイルの上に新しいファイルをコピーしないでください。
サーバ内の古いファイルが配置されていた場所に新しいMoodleソフトウェアプログラムのファイルを配置するため、アップグレードファイルを解凍してください。アップグレードに必要であれば、MoodleはSQLおよびmoodledataを調整します。
あなたの古いconfig.phpファイルを新しいMoodleディレクトリにコピーしてください。
上記で言及したとおり、あなたのサイトにカスタムプラグインをインストールしている場合、それらを新しいコードに追加してください。あなたが最新バージョンの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」セクションをご覧ください。

@@ 1行目: / 1行目: @@
 {{Moodleのインストール}}
-再作成中です - [[利用者:Mitsuhiro Yoshida|Mitsuhiro Yoshida]]
-'''Before you do anything else, read [[Upgrading to Moodle 2.2]]'''
+このページでは、Moodleのアップグレード方法を詳細に説明します。処理の概要に関しては、[[アップグレード概要]]をご覧ください。
-Moodle is designed to upgrade itself from one version to the next. The procedure is
+==必要条件を確認する==
-# [[Site backup|Back up everything]].
-# Replace the old version of the code with the new one.
-# Log in to your Moodle site and go to ''Settings > Site administration > Notifications'' which will then trigger Moodle to self-update.
-These steps are explained in more detail below.
-Sometimes there are specific considerations when upgrading to a particular version.  See the [[dev:Releases|Releases page]] for more information on this.  You also have to be more careful if you have installed additional plug-ins or customised the code.
+あなたのサーバが2.4の必要条件すべてに合致するかどうか、「設定 > サイト管理> サーバ > [[動作環境]]」にて確認してください。
-See this tutorial if you are [http://ic.eflclasses.org/tutorials/howtoupgrademoodlewithcpanel.swf upgrading Moodle on cpanel]. It is a bit rough around the edges and is a little dated, but you should get the idea.
+注意: あなたはMoodle 2.2またはそれ以降のバージョンからのみ、Moodle 2.4にアップグレードすることができます。古いバージョンからアップグレードする場合、あなたは最初の段階で[https://docs.moodle.org/22/en/Upgrading_to_Moodle_2.2 2.2にアップグレード]する必要があります。
-There is also a separate page about [[Ubuntu_Debian_Upgrades|upgrading Moodle if you installed it using the Ubuntu/Kubuntu/Debian package manager]].
+==プラグインの更新を確認する==
-__TOC__
+あなたのサイトにインストールしている寄贈/カスタムプラグイン (テーマを含む) の2.4バージョンがあるかどうか、[http://moodle.org/plugins Moodleプラグインディレクトリ]にて確認してください。2.4バージョンが存在している場合、プラグインコードをダウンロードして、あなたのMoodleコード内の適切な場所にコピーしてください (詳細は[[プラグインのインストール]]をご覧ください)。
-When upgrading a Moodle installation you should follow these steps:
+プラグインのアップグレードはMoodleアップグレード処理の一部として実施されます。
-==あなたのサイトを実際にアップグレードする前に==
+古いプラグインによりアップグレードが失敗する場合、通常あなたはアンインストールするより、関連データを削除しないために、そのプラグインをMoodle内から削除した方が良いでしょう。
-You are strongly advised to make a copy of your entire Moodle site onto another computer (see [[Moodle migration]]) and run the upgrade there to verify it will work. If you decide not to do this, make sure you have good backups. If the upgrade fails you will need the backups to go back.
+注意: あなたが非標準ブロックをインストールしている場合、未定義のブロックケイパビリティに関して、下記をご覧ください。
+==あなたのサイトを実際にアップグレードする前に==
-==必要条件を確認する==
+'''予想どおりに動作するかどうか確認するため、最初にあなたの実運用サイトのコピーを使ったアップグレードのテストをお勧めします。
-あなたのサーバが2.4の必要条件すべてに合致するかどうか、「設定 > サイト管理> サーバ > [[動作環境]]」にて確認してください。
-注意: あなたはMoodle 2.2またはそれ以降のバージョンからのみ、Moodle 2.4にアップグレードすることができます。古いバージョンからアップグレードする場合、あなたは最初の段階で[https://docs.moodle.org/22/en/Upgrading_to_Moodle_2.2 2.2にアップグレード]する必要があります。
 == 重要なデータをバックアップする ==
@@ 48行目: / 39行目: @@
 === 標準インストールパッケージ ===
-Having read the cautions about backups, download a copy of the standard install package. Here is a set of simple instructions for an average site.
+# あなたの古いMoodleプログラムファイルを別の場所に移動してください。古いファイルの上に新しいファイルをコピーしないでください。
-*It is probably a good idea to use the [[Site administration block]]>Server>Maintenance mode to prevent user activity as the site upgrades.
+# サーバ内の古いファイルが配置されていた場所に新しいMoodleソフトウェアプログラムのファイルを配置するため、アップグレードファイルを解凍してください。アップグレードに必要であれば、MoodleはSQLおよびmoodledataを調整します。
-*Having moved your old Moodle software program files to another location, unzip or unpack the upgrade file so that all new the Moodle software program files are in the location the old files used to be in on the server.  Moodle will adjust SQL and [[Moodledata directory|moodledata]] if it needs to in the upgrade.
+# あなたの古い[[設定ファイル|config.phpファイル]]を新しいMoodleディレクトリにコピーしてください。
-*Copy your old [[Configuration file|config.php file]] back to the new Moodle directory. If you've defined individual blocks for new courses you have to delete 'admin' block definition and replace by 'settings' for the new block.
+# 上記で言及したとおり、あなたのサイトにカスタムプラグインをインストールしている場合、それらを新しいコードに追加してください。あなたが最新バージョンのMoodleを取得していることを確認することは大切なことです。特に新しいバージョンのコードに上書きしないよう、十分に注意してください。
-*If you had added any custom plugins or themes into your Moodle you can add them to the new code. It is important to check that you get the correct version for your new version of Moodle. You should check in the optional plugins database. Be particularly careful that you do not overwrite any code in the new version of Moodle. If you are upgrading to Moodle 2.0 or newer, note that all optional plugins and themes required a significant rewrite and some do not have 2.0 versions (yet).
-*Use the notification link in the site administration to start the upgrade process. You will see a series of lines or screens indicating progress.
-*After a successful upgrade, turn off the maintenance mode, so your users can get into the site.
-=== Using a downloaded archive ===
-In some installs, the site administrator may overwrite the Moodle code with a backup copy.  Or create a new clean install copy of Moodle, then restore an archive (via a compressed file or parts of a saved set of Moodle code files and folders).
-*Do not overwrite an old installation unless you know what you are doing ... sometimes old files can cause problems in new or "cleaned" installations. The best way is to rename the current Moodle code directory (for example rename "moodle" to "moodleold"), then unpack the new Moodle archive into the old location (for example, a new directory called "moodle").
 ====Linux====
@@ 81行目: / 64行目: @@
 あなたのMoodleの更新またはアップグレードのためにGitを使用することができます。詳細は[[管理者用Git]]をご覧ください。
+===コマンドラインアップグレード===
+Linuxサーバにおいて、Moodle 2.4はウェブブラウザ経由のアップグレードだけではなく、[[コマンドライン経由の管理|コマンドラインからのアップグレード]]もサポートします。特定の大規模サイトでは、コマンドラインからのアップグレードの方が信頼できると考えられます。
 == アップグレードを終了する ==
@@ 86行目: / 73行目: @@
 最後のステップでは、Moodle内でアップグレード処理を始動させます。
-この処理を実行するには、「設定 > サイト管理 > 通知」に移動してください。
+この処理を始動するには、「設定 > サイト管理 > 通知」にアクセスしてください。
-Moodleは新しいバージョンを自動的に検知して、必要なすべてのSQLデータベースまたはファイルシステムアップグレードを実行します。極めて稀なケースですが、アップグレードを実行できない場合、あなたが何をすべきか伝えるメッセージが表示されます。
+Moodleは新しいバージョンを自動的に検知して、必要なすべてのSQLデータベースまたはファイルシステムのアップグレードを実行します。極めて稀なケースですが、アップグレードを実行できない場合、あなたが何をすべきか伝えるメッセージが表示されます。
-すべてが (エラーメッセージなしに) 正常に修了した場合、あなたの新しいバージョンのMoodleを使って、新しい機能を楽しんでください!
+すべてが (エラーメッセージなしに) 正常終了した場合、あなたの新しいバージョンのMoodleを使って、新しい機能を楽しんでください!
 注意: あなたが複数サーバを動作させている場合、すべてのサーバのアップグレードを完了した後、すべてのキャッシュを手動でクリアしてください (「設定 > サイト管理 > 開発 > すべてのキャッシュを削除する」)。
@@ 96行目: / 83行目: @@
 ==アップグレードの後で==
-あなたの2.2または2.3インストレーションからのconfig.phpは正常に動作しますが、Moodle 2.4に同梱されているconfig-dist.phpを確認してみると、さらに異なる利用可能なオプションがあります (例 データベースドライバおよび設定)。2.4のconfig-dist.phpを基に、あなたの古いconfig.phpの設定を新しいconfig.phpに設定するのは良いアイデアです。
+あなたの2.2または2.3インストレーションのconfig.phpでも正常に動作しますが、Moodle 2.4に同梱されているconfig-dist.phpを確認してみると、さらに異なる利用可能なオプションがあります (例 データベースドライバおよび設定)。2.4のconfig-dist.phpを基に、あなたの古いconfig.phpの設定を新しいconfig.phpに設定するのは良いアイデアです。
+==Moodle 2.4において、あなたに影響する可能性のある問題==
+=== ブロックケイパビリティ未定義 ===
+あなたが寄贈/カスタムブロックをインストールしている場合、インストール後にブロックケイパビリティが定義されていないというメッセージが表示されることがあります。例えば、次のようになります:
-==Upgrading more than one version==
+ The block <blockname> does not define the standard capability block/<blockname>:myaddinstance
-Normally you can upgrade directly from any Moodle version to any later version. So, for example you could upgrade from 2.0 to 2.1, or from 1.9 to 2.2.
+Moodle 2.4において、[[ブロック管理_(管理者)|ブロック使用の管理]]のために、「addinstance」および「myaddinstance」ケイパビリティが追加されました。これらのケイパビリティを寄贈ブロックに定義する場合、[[:dev:Blocks|ブロック開発ドキュメント (英語)]]の「[[:dev:Blocks#Ready.2C_Set.2C_Go.21|Ready, Set, Go!]]」セクションをご覧ください。
-However, every so often, this general rule gets broken, because supporting really large jumps (for example Moodle 1.6 to 2.2 in one step) would be impossible. Recent break points have been:
+=== Moodle 2.3での改善点 ===
-* You must have upgraded to version 1.9.x before you can upgrade to a later 2.x version.
-* You must have upgraded to version 2.2.x before you can upgrade to 2.3 or later.
-If you are upgrading from a pre-1.6 version it is recommended that you upgrade first to the latest 1.6.x, then to the latest 1.9.x and finally to the latest 2.x. See Petr's forum post [http://moodle.org/mod/forum/discuss.php?d=197602#p861964 Re: Continuing on Upgrade docs] for further information.
+あなたが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」セクションをご覧ください。
 ==関連情報==

Documentation