マニュアル » インストール » アップグレード

アップグレード

はじめに

MicroEngineのアップグレード(バージョンアップ)手順について説明します。

注意事項:バージョン1.0.0未満のBeta版からはアップグレードできません。

アップグレード作業の要点

アップグレード作業の流れ

  1. バックアップ作成
    公開サイトのコンテンツ・MicroEngineのバックアップを作成します。
    FTPソフトなどで、公開サイトのファイルをローカルにコピーすればバックアップは完了です。
    step1
    このバックアップ作業は、万が一 作業が失敗したときのためのものです。me(MicroEngine)ディレクトリだけでなく関連するコンテンツ全体のバックアップファイルを作成しくてださい。
  2. 新パッケージを展開
    新パッケージファイル(例:microengine-1.0.1.zip)を展開します。
    アプリケーションディレクトリのファイル名をリネームします。
    例:/me/admin/app を /me/admin/app_new に変更します。
    step2
  3. 新アプリケーションディレクトリをアップロード
    新アプリケーションディレクトリをFTPソフトなどを用いてサーバーにアップロードします。
    上記の例では app_new を /me/admin ディレクトリ下にアップロードします。
    step3
  4. アプリケーションディレクトリ差し替え

    公開サイトのアプリケーションディレクトリをリネームします。
    例:/me/admin/app を /me/admin/app_old に変更します。

    新アプリケーションディレクトリをリネームします。
    例:/me/admin/app_new を /me/admin/app に変更します。

    step4
  5. 動作確認
    管理画面にログインして動作を確認します。

    MicroEngineのスキーマバージョンが更新されている場合は以下のエラーが表示されます。
    エラー番号2
    このエラーが表示された場合は、アップグレードスクリプトの実行をしてください。
  6. 旧アプリケーションディレクトリの削除
    リネームした旧アプリケーションディレクトリを削除します。
    例:/me/admin/app_old を削除します。

備考:
アップグレード作業中のサービスへの影響について。
テンプレートの設定で配信方式が静的配信(デフォルト)の場合は、公開サイト側への影響はありません。
管理画面及び動的配信に設定されたページの場合は、手順4で2つのディレクトリをリネームする作業の間(おそらく数秒程度)のみサービスを利用できません。

アップグレードスクリプトの実行

アプリケーションディレクトリ差し替え後に、「エラー番号:2」が表示された場合はアップグレードスクリプトを実行します。
アップグレードスクリプトを実行するためには次のパスを開きます。
http://ホスト名/me/admin/index.php/Upgrade/index
※MicroEngineのインストール位置は環境によって異なります。index.phpの後に/Upgrade/indexを入力することでアップグレードスクリプトにアクセスできます。
アップグレードスクリプトにアクセスすると、次の画面が表示されます。

アップグレード画面

この画面で「アップグレードを実行する」ボタンをクリックすると、アップグレード処理が実行されます。
※アップグレード処理実行中はブラウザを閉じないでください。

アップグレード処理が完了すると画面下部が次のように表示されます。

アップグレード完了

「アップグレード処理完了」が表示されると、アップグレードスクリプトの実行は完了しています。管理画面に戻って動作確認をしてください。

注意事項

製品バージョンとスキーマバージョンの対応表

MicroEngineの製品バージョンとは別に、内部のデータ構造(DBやファイル構成)を表すスキーマバージョンという番号を持っています。
スキーマバージョンが変更された場合のみ、アップグレードスクリプトの実行が必要になります。

製品バージョンスキーマバージョン
1.0.01
1.0.11
1.1.02
1.1.12
1.1.22
1.1.32

別環境でのアップグレード作業のテスト

本番環境でのアップグレード作業の前に、あらかじめ別の環境でアップグレード作業について検証しておくこともできます。

公開サイトのバックアップを元に、別の環境でMicroEngineを動かします。
環境を変更する場合は、設定ファイル(me/admin/data/config/user_config.ini)のドキュメントルート項目を再設定します。

別の環境でMicroEngineを動かせれば、アップグレード手順は上記と同じ流れです。