WagbyR7をアップグレードする場合の手順を説明します。ここでは、現在稼働している Web アプリケーションを「現行システム」と呼びます。新しくビルドした Web アプリケーションを「新システム」と呼びます。
Wagbyのバージョンアップに際しては、次の手順を行ってください。(同じバージョンの Wagby を使って再ビルドする場合、この手順はスキップして、次節へ進みます。)
現行システムのリポジトリのバックアップを取得します。wrb_ ではじまる zip ファイルとなります。これをダウンロードし、任意の作業用フォルダに保持しておきます。
現行バージョンの Wagby Designer ならびにビルドしたアプリケーションを停止します。
1台の開発機に、複数のバージョンのWagbyをインストールすることができます。フォルダ名をそれぞれ変えてインストールします。(例 Wagby-7.0.0 と Wagby-7.5.0)
ご購入者の方は、インストール後に開発者キットのライセンスキーを適用してください。複数のバージョンのWagbyに同じライセンスキーを適用できます。
新バージョンの Wagby Desinger を起動します。1. で取得したリポジトリを読み込みます。
旧版で作成したcustomizeフォルダの内容を、そのまま新版のcustomizeフォルダ内にコピーします。
新版のWagbyDesignerを起動します。ブラウザのキャッシュを消去してからWagbyDesignerにログオンし、フルビルドを行ってください。
本番運用サーバで、現行システムから新システムへの入れ替えを行う手順を説明します。新システムはフルビルドによって生成されたものとします。具体的な入れ替え手順は次の通りです。
以下、詳細を説明します。
Windowsサービスへ登録している場合は、Windows の [管理ツール] から停止し、サービスを削除して下さい。 Windowsサービスに登録していない場合は wagbyapp\bin\shutdown.bat を実行して下さい。
次のケースに1つでも該当する場合、本手順を行って下さい。[詳細...]
エクスポートはコマンドラインでの操作を行ってください。
現行システムのフォルダ名「wagbyapp」を「wagbyapp.old」に変更して下さい。 「wagbyapp.old」がすでにある場合は、「wagbyapp.old20170301」のように重複しないフォルダ名を使用して下さい。
ビルドした新システムをサーバマシンへコピーします。旧システムと同じフォルダ名にしてください。これによって Apache や IIS と連携していた場合でも、同じ環境を引き継いで利用できます。
「2. 現行システムに含まれているすべてのデータをエクスポートする」を行なった場合は以下の手順を実行して下さい。
「ファイル型」項目に対してアップロードを行ったファイルは、現行システムの upload_dir フォルダ以下に保存されています。同フォルダ以下を新システムに移動(またはコピー)します。
現行システムの「ライセンスキーファイル」を、新システムにコピーしてください。ライセンスキーファイルは wagbyapp\webapps\$(APPNAME)\WEB-INF\classes にある appschema-licensekey.xml です。
この手順は不要です。次へ進みます。
Windowsサービスとして起動する場合は、Windows サービスの登録を行い、Windows管理ツールから起動して下さい。
そうでない場合はwagbyapp\bin\startup.batを実行して下さい。
Web ブラウザから所定のアドレスを入力します。特定のアカウントでログオンし、メニューが表示されることを確認して下さい。
ログオン処理に失敗する場合は、データベース接続が失敗している可能性があります。いったん新システムを停止したのち、wagbyapp/logs フォルダの system.log を開き、エラーメッセージが含まれていないか、確認してください。
次の設計情報の変更は、テーブル定義に影響を与えることがあります。
これらの設定変更(設定の解除を含む)を行った場合、テーブル定義が変更されます。この場合はデータのエクスポートとインポート処理が必要になります。
現在の稼働環境のwagbyapp\webapps\$(APPNAME)\WEB-INF\export\conf\createddl と、バージョンアップ版でビルドした後の wagbyapp の同フォルダ内のファイルに差分があるかどうかをご確認ください。差分がなければテーブルをそのまま利用できます。
export_db.bat や import_db.bat は全てのテーブルを対象とします。これらのコマンドの実体は InitLoader.jar というものです。InitLoader.jar を直接操作することで、テーブルを限定した操作を行うことができます。
新しいモデルを追加した場合、データ復元の考え方は次の通りです。
新システムに対して、現行システムでバックアップ(export)したデータを復元(import)します。importコマンドによって、追加モデルのテーブルも用意されます。
1. で、現行システムから復元したデータには、追加した選択肢モデルの初期値が含まれていません。そこで追加分については、初期データ (data_init) フォルダを指定して、個別にインポートを行います。このタイミングでテーブルも作成されます。