アップデート

目次

主なアップデート方法

主なアップデート方法は2種類あります。「オンラインアップデート」と「手動アップデート」です。
また、各アップデート時にはテンプレート修正が必要なバージョンがありますので、アップデート時には対象のバージョンだった場合ご対応の上、アップデートをお願いいたします。

オンラインアップデート

オンラインアップデートは管理画面からマイナーバージョンと、パッチバージョンのアップデートする方法です。Ver. 2.8.0 から利用可能です。
バックアップを取ったのちアップデートを行いますので安心して利用できます。特に意図がない場合は、オンラインアップデートの利用を推奨します。

オプション

管理画面 > コンフィグ > 機能設定 の 「オンラインアップデート」にオプションがあります

  • パッチバージョンのみ（デフォルト）
  • マイナーバージョンも含める
  • 更新メニューを非表示

デフォルトのパッチバージョンのみ

不具合修正のバージョンのみアップデートを行います。仕様変更などは含まれませんので、安心してアップデートできます。

マイナーバージョンも含める

Ver. 2.8 から Ver. 2.9 へのアップデートのようにマイナーバージョンアップの更新も出来るようになります。

更新メニューを非表示

管理メニューに更新メニューを出さないようにします。お客様に引き渡す時に、あまり触ってほしくない場合などに便利です。

デフォルトのパッチバージョンのみ パッチバージョン（=不具合修正のバージョン）のみアップデートを行います。パッチバージョンには仕様変更が行われたバージョンは含まれませんので、安心してアップデートできます。
マイナーバージョンも含める たとえば Ver.2.8 から Ver.2.9 へのアップデートのようにマイナーバージョンアップの更新も出来るようになります。マイナーバージョンアップには仕様変更が行われたバージョンも含まれます。
更新メニューを非表示 管理メニューに更新メニューを出さないようにします。例えば、納品後に更新者にアップデートしてほしくない場合などに便利です。

手動アップデート

基本的にはオンラインアップデートを推奨しておりますが、オンラインアップデートが対応していない環境（メジャーバージョンアップやVer. 2.7以下からのアップデートの場合）では手動アップデートをお使いください。

手動アップデートの際には簡単アップデートの利用を推奨しています。 以前は、FTPソフトを利用して多くのファイルを上書きする必要がありましたが、現在では 簡単アップデート （バージョンアップ作業の簡略化をする PHP ファイル）を用意しております。このプログラムを利用することで、利用環境に合わせたパッケージのダウンロードから、解凍、ファイルの更新、旧ファイルのバックアップまでを自動化できます。

1. 簡単アップデート のダウンロード

ダウンロードの簡単アップデート よりアップデート用のプログラム「2.x バージョンアップ版」をダウンロードします。

2. update.php ファイルのアップロード

バージョンアップをする a-blog cms が動作しているサーバーのディレクトリに1ファイル update.php ファイルのみ、a-blog cms の index.php が設置されている同じディレクトリにアップロードします。

バージョンの指定

サーバーの最新版を自動で判定してダウンロードするようになっておりますが、サーバーによってはエラーになる環境もあります。もし、実行時にエラーになるような時には 14行目の # を外してアップデートしたいバージョンを個別に指定してください。

#$ablogcmsVersion = "2.11.43";

テーマディレクトリの設定

update.php のファイルには利用しているテーマ名を設定できる場所が用意されています。ここに利用しているテーマを設定することでテーマディレクトリを既存のファイルを利用するように設定できます。

#$useThemes = "blog2020"; # "site2020|blog2020";

最初の # が付いているとコメント扱いとなり、設定が有効になりませんので注意してください。

例1) site2020 と sp@site2020 を利用している場合
$useThemes = “site2020”;

継承しているテーマは自動的に利用する設定になります。

例2) site2020 と blog2020 を利用している場合
$useThemes = "site2020|blog2020";

| で区切って複数指定も可能です。

3. update.php ファイルの実行

update.phpを設置したURL（例：http://domain.com/update.php）にブラウザからアクセスするとアップデートが実行されます。
具体的には、以下の処理が自動で行われます。

  1. 変更するファイルのバックアップ
  2. サーバーのPHPのバージョンにあわせて a-blog cms のパッケージをダウンロード&解凍
  3. インストールファイルを置くべき場所への移動
  4. バックアップファイルから戻すべきファイルやディレクトリ（ 指定したテーマ、/php/ACMS/User、/php/AAPP、/private/config.system.yaml）を移動
  5. ダウンロードした必要の無いファイルの削除

※ バップアップについては、backup_年月日時分秒 の形式のディレクトリが作成されます。

4. メンテナンス画面からアップデート開始

サイトにアクセスし、メンテナンス画面が表示されることを確認してください。 メンテナンス画面で ユーザーID もしくは メールアドレスとパスワードを入力しログインします。

システムがバージョンアップの必要だと判定された際には「メンテナンスプログラムはアップデートの必要性を検出しました」と表示され「アップデート実行画面へ」のリンクが表示されます。

5. データベースの更新

セットアップ画面の[データベースの更新処理を実行]ボタンを押します。

6. セットアップディレクトリのリネーム

アップデートプログラムの実行が終了したら、FTPソフト等を利用して setup ディレクトリを推測されない名前に変更をしてください。削除しても構いませんが、場合によってインストールされている時と同様のバージョンの setup ディレクトリをアップロードする必要がある場合があります。

setup ディレクトリが存在するまではメンテナンスページが表示されます。

7. 表示確認と公開

a-blog cmsを設置しているアドレスにアクセスします。各ページの表示を確認し、問題が無ければ公開となります。 必要に応じてデバッグモードをONにすることで、各種エラーメッセージが表示されたり、キャッシュ機能が無効となるなど、動作確認のための状態となります。 サーバ上のファイル config.server.php 内の記述 「DEBUG_MODE」の値を確認の上、変更を行う場合は再度アップロードしてください。

デバッグモードON デバッグモードOFF
define('DEBUG_MODE', 1); define('DEBUG_MODE', 0);

以上でアップデートは完了です。

テンプレート修正が必要なバージョンとライセンス

テーマ内にあるテンプレートファイルについては自動変更されません。以下のドキュメントを参考にテンプレートファイルの修正をお願いします。

バージョンごとのアップデート方法

ライセンス別のアップデート方法