自動アップグレード

自動アップグレードは 5.4.0.5 以降の機能です。それ以前の concrete5 を使用されている方や、サーバーに cURLや unzip などのプログラムがインストールされていない場合、ページ下の「手動アップグレード方法」をご覧ください。

「サイトバックアップの仕方」より、最低限、データベースのバックアップを行ってください。

自動アップグレードの手順

• 管理者アカウント（admin 等）でログイン
• 「管理画面」ページに訪問
• 「システム & メンテナンス」をクリック
• タブメニューの「更新」をクリック
• 新バージョンがダウンロード可能の告知の有無の確認
• 「ダウンロード」ボタンを一回だけ押して、しばらく待つ
• ダウンロード完了の文字が表示され、実際のアップグレードを行うため「更新」ボタンを一回だけ押して、しばらく待つ
• アップグレード完了
• ブラウザのキャッシュを削除（重要）

これで、アップグレードが完了します。

エラーを起こしたら

自動ダウンロードが出来ない（サーバーの問題？）

サーバー機能

サーバーのディレクトリー書き込みの設定や、zipファイルをダウンロードして（cURL）解凍できる機能（Unzip）が不足している可能性があります。

書き込み権限

サーバーが「files/tmp」「update」「config/site.php」フォルダー & ファイルの書き込み・変更ができる設定になっている（chmod 755 等）必要があります。

アップグレード後サイトがおかしい

ブラウザのキャッシュを削除

バージョンアップ前の古い Javascript ファイルが、お使いのパソコンに保存されていて、サーバーから新しいファイルを取得していない可能性があります。ブラウザのキャッシュを削除してください。

/concrete/ ディレクトリ以下は改変しちゃダメ

自動アップグレード後は「/concrete/」ディレクトリではなく「/updates/concrete5.X.X.X.ja/concrete/」以下のファイルが読み込まれます。

「/concrete/」ディレクトリ以下は今後無視されるので、該当ディレクトリ以下のファイルを変更した方は今後注意が必要です。

これを機会に、正規の改造方法であるオーバーライド機能を利用しユーザーフォルダに変更したファイルを保存されるようにしてください。詳しくは「ブロック修正の仕方と カスタムテンプレート の仕組み」や「concrete5 のシステム基本構造」を参考に。

concrete5 では古いバージョンのファイルを削除せずに、自動アップグレードをする度に「/updates/」内にディレクトリを生成して新しいバージョンの concrete5 を保存していきます。古いバージョンの concrete5 は次期新バージョンリリース後には必要なくなりますので、古いバージョンのディレクトリーを削除されても構いません。

元に戻したい場合

自動アップグレードで何らかの問題が発生したとしても、MySQLのDBを元に戻し、 /config/site.php より「DIRNAME_APP_UPDATED」の行を削除、もしくは以前バージョンのフォルダ名変更することにより、最小限のタイムロスで前バージョンを復活させることが出来ます。

具体的な自動アップグレードの動作の説明

• 管理画面より「ダウンロード」をクリック
  • 自動アップデート開始、ZIPファイルをダウンロード
  • /files/tmp フォルダーに一時的に保存
  • /updates/concrete5【バージョン番号】/ フォルダーを作成
  • そのフォルダー内に最新バージョンのファイルをZIPから展開・保存
• 管理画面より「更新」をクリック
  • アップグレードスクリプトを実行
  • MySQLデータベース内容をアップグレード
  • /config/site.php に 「DIRNAME_APP_UPDATED」という定数が追加され、最新バージョンが保存されたフォルダ名が定義されます。
• 終了

手動アップグレード方法

concrete5 を手動でアップグレードする方法をステップ毎に紹介して行きます。

このページは、5.3.2 以降のバージョンから最新版にアップグレードされる方専用です。

5.3.2 までのアップグレード方法は、こちらに移動しました。

特に初めて concrete5 をアップグレードされる方は、注意してお読み下さい。

そして今回は、特別に、よくある問題や質問（特に、Windows Server、XAMPPや、 Bitnami ユーザー様）のページ「5.3.3.1 日本語版アップグレードFAQ」を作成しました。このFAQページは 5.4.0.5 にアップグレードされるユーザー様にもある程度対応しています。

また、アップグレード作業をされる際は、サイトのバックアップをきちんとおとりになる事をお勧めします。また、アップグレードを失敗しても、昔のサイトの状態に復旧出来る様にリストア方法も事前にお調べになる事をお勧めします。詳しくは以下のリンクを参照して下さい。

• サイトバックアップの仕方
• concrete5サイトを復旧（リストア）する方法

手動アップグレード前の準備

1. 5.4.1.1 アップグレードまでの準備

• concrete5.3.2, 5.3.3.1 5.4.0.5 である
  • 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. アップグレード時にデータベースエラーが表示されます」を参照下さい 

また、サイトのバックアップをかならずおとりください。

問題が無ければ、アップグレード作業に進みます。

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. 「公開モード」に戻し、サイトのキャッシュ機能を有効に

ページを巡回され、一通りの問題がなければ、「管理画面」 - 「サイト全体の設定」 - 「デバッグ」ページにお戻り下さい。

そして、デバッグモードを「公開モード」に戻し、サイトキャッシュも有効にします。

これで、アップグレード作業が完了しました。おつかれさまでした。