concrete5.4.0.5 アップグレード方法
concrete5 をアップグレードする方法をステップ毎に紹介して行きます。
このページは、5.3.2 もしくは 5.3.3.1 から 5.4.0.5 にアップグレードされる方専用です。5.3.2 までのアップグレード方法は、こちらに移動しました。
特に初めて concrete5 をアップグレードされる方は、注意してお読み下さい。
そして今回は、特別に、よくある問題や質問（特に、Windows Server、XAMPPや、 Bitnami ユーザー様）のページ「5.3.3.1 日本語版アップグレードFAQ」を作成しました。このFAQページは 5.4.0.5 にアップグレードされるユーザー様にもある程度対応しています。
また、アップグレード作業をされる際は、サイトのバックアップをきちんとおとりになる事をお勧めします。また、アップグレードを失敗しても、昔のサイトの状態に復旧出来る様にリストア方法も事前にお調べになる事をお勧めします。詳しくは以下のリンクを参照して下さい。
アップグレード前の準備
1. 5.4.0.5 アップグレードまでの準備
- concrete5.3.2 か 5.3.3.1 である
- 5.4.0.5 へのアップグレードは、5.3.2 以降のサイトから対応しています
- ダウンロードページ下の「concrete5 過去バージョン」より、5.3.2 までアップグレードして下さい。
- MySQL のテーブル名 に大文字の使用が許可されていることを確認
- 以下に該当する方はアップグレード時に不具合が発生します
- 特に Windows Server、XAMPP、Bitnami ユーザー
- MySQLの設定で「--lower-case-table-names=1」の設定がされているサーバーを使っている方
- phpMyAdmin などを使い、concrete5 がインストールされているデータベースを確認し、データベースのテーブルの名前が、きちんと大文字になっているかどうかを確認して下さい。
- そうでない場合の解決策は
- 5.3.3.1日本語版へのアップグレードに関するトラブルシューティング
「Q2. アップグレード時にデータベースエラーが表示されます」を参照下さい
- 5.3.3.1日本語版へのアップグレードに関するトラブルシューティング
- 以下に該当する方はアップグレード時に不具合が発生します
また、サイトのバックアップをかならずおとりください。
問題が無ければ、アップグレード作業に進みます。
2. 管理画面にログイン - 「サイト全体の設定」をクリック
http://【concrete5 のアドレス】/index.php/login
に行き、「admin」ユーザーとしてログインします。
3. 「アクセス権限」に行き、サイトを「メンテナンスモード」にします
4. 「デバッグ」を選択
5. 「開発モード」に移行し、キャッシュを無効にし、既存のキャッシュを全て削除
これで、 concrete5 サイトのアップグレードの準備ができました。
アップグレード作業
1. 最新バージョンをダウンロード
当 concrete5 ダウンロードページから最新バージョンの concrete5 をダウンロードします
2. /concrete/ ディレクトリーと /language/ディレクトリー内のファイルのみをFTP等を使い、上書きアップロード
concrete5 は 本体ファイルが全て /concrete/ ディレクトリー内、日本語翻訳ファイルは /languages/に保存され、ユーザー様の情報はトップの各ディレクトリー内に保存されています。
ですので、各バージョンのリリースノートで特に明記されていない限り、 /concrete/ ディレクトリーと /language/ ディレクトリーに含まれているファイルのみをサーバーにアップロードして下さい。
また、FTPソフトを使ってファイルをアップロードされる方は、更新するファイルの数が多いので、アップロードエラーが発生し、ファイルが全て更新されずにアップグレードがうまく行かない場合がありますので、全てのファイルがアップロードされたかをきちんと確認下さい。
3. /updates/ ディレクトリーを作成し、サーバーが書き込みできるように権限を設定する
5.4.0 より、自動アップグレード機能が搭載されました。「updates」という名前のからのディレクトリーを作成し、サーバーで書き込みができるように権限を設定して下さい。
また、cURLなどの機能も必要になります。
4. アップグレードページに直接訪問
5.3.3.1 では、データベースの構造を大幅に変更されたため、ファイルをアップロードした直後はエラー画面が表示される事があります。
ですので、今回のアップグレード時には、直接アップグレードページのアドレスを入力し、訪問する必要があります。
http://【concrete5のURL】/index.php/tools/required/upgrade.php
を直接、お使いのブラウザーのアドレスバーに入力して下さい。以下のページが表示されます。
5. データベースのアップグレード作業、「アップグレード」をクリック
今回は、今までのアップグレードに比べ、より時間がかかる場合があります。
問題がなければ、以下のような画面が表示され、アップグレードが正常に完了されます。
＊5.3.3.1アップグレードでは、ブロック等のデータの総数が3000エントリーを超える場合、アップグレードスクリプトが停止する様になっています。停止した場合は、上記のアップグレードアドレスから、再びアップグレードボタンを押すことにより、アップグレードの続きが再会される様になっています。
※この画面で「削除してください」と言われているファイルは、「/concrete/controllers/upgrade.php」です。
これで、concrete5 自体のアップグレードが終了しましたが、まだ全て完了していません。アップグレード後の作業をきちんと行って下さい。
アップグレード後の作業
1. ブラウザのキャッシュを削除 (重要)
concrete5 のソフトの中には、 Javascript という、お使いのブラウザーに機能をダウンロードして実行するソフトが含まれています。以下の情報は、2009年5月時点のやり方です。
【重要】またこのブラウザのキャッシュ削除は、concrete5 で、特に編集作業をされているユーザー全員のPCで行われる事を徹底されて下さい。
Internet Explorer をお使いの方
ウィンドウ上部のテキストメニューから、 [ツール] - [インターネットオプション] - [全般] タブ - [インターネット一時ファイル] - [ファイルを削除]をクリックして下さい
Firefox をお使いの方
Windows版 Firefox では、ウインドウ上部のテキストメニューから、[ツール] - [オプション] - [プライバシー] タブ - [プライバシー情報の消去] - [今すぐ消去]をクリック
Mac OS X版 Firefox では、[Firefox]メニュー - [環境設定] - [プライバシー] タブ - [プライバシー情報の消去] - [今すぐ消去]をクリック
Safari (Mac) をお使いの方
画面左上の、[Safari]メニュー - [キャッシュを空にする]をクリック
でお使いのブラウザーに一時的に保存されているファイルを削除します。
concrete5 では、アップグレードの際に、使用している Javascript プログラムもアップグレードしている場合があります。
しかし、これらの Javascript プログラムは、お使いのPCにダウンロードされて実行されます。
ブラウザには、一度ダウンロードされた Javascript プログラムを再びダウンロードせず、PCに一時保存して、時間短縮できる機能があります。
ですので、 concrete5 アップグレード後、新しい Javascript のプログラムと、古い javascript のプログラムがお使いのPC内で混同してしまい、 concrete5 が正常に動かなくなる可能性がありますので、このステップは、絶対にしてくださるようお願いします。
＊なお、5.3.0 から 5.3.1.1 へアップグレード時、ブラウザのキャッシュを削除されないと、記事ブロックで画像が正常に挿入出来ない症状が出ることをを確認しています。これは、5.3.0から5.3.1.1へのアップグレードで、画像を挿入する仕組みを更新したためです。
2. 「メンテナンスモード」を解除
http://【concrete5のURL】/index.php/dashboard
の「管理画面」にログイン、「サイト全体の設定」 - 「アクセス権限」 - 「メンテナンスモード」に行き、「メンテナンスモード」を無効に設定し、サイトを公開させます。
3. サイトのページを一通り回って、不具合がないかを確認
一通り、サイトのページを巡回して、表示に不具合がないかを確認されて下さい。
また、「開発モード」にされている方は、迷惑メッセージ対策の、Captchaキャプチャの画像が正常に表示されない場合がありますが、これはバグではありません。次項で「公開モード」にすることにより、キャプチャが正常に表示されると思われます。
4. 「公開モード」に戻し、サイトのキャッシュ機能を有効に
ページを巡回され、一通りの問題がなければ、「管理画面」 - 「サイト全体の設定」 - 「デバッグ」ページにお戻り下さい。
そして、デバッグモードを「公開モード」に戻し、サイトキャッシュも有効にします。
これで、アップグレード作業が完了しました。おつかれさまでした。