biz-Streamマニュアル Webサービスサーバ ガイド 第3章 環境の移行 3.1 バージョンアップ・リリースアップの手順 【bswss-X.X.X.zip(tar.gz) の提供がある場合】

3.1 バージョンアップ・リリースアップの手順 【bswss-X.X.X.zip(tar.gz) の提供がある場合】

ここでは、biz-Stream のバージョンアップまたはリリースアップをする場合の手順について説明します。
事前に「2.1 biz-Stream Webサービスサーバのインストール (事前確認)」をご確認ください。

ここで説明する手順は、Webサービスサーバモジュール全体が bswss-X.X.X.zip(tar.gz)として提供されている場合の手順となります。

Webサービスサーバでは Apache Tomcat を利用しており、各リリースに同梱されているものを使用していただく必要があります。そのため、Webサービスサーバ全体(Apache Tomcat 自体)を一度削除し、再インストールし直す必要があります。

  1. Webサービスサーバ停止
    Webサービスサーバを停止してください。 手順については「Web サービスサーバの停止方法」を参照してください。

  2. Web サービスサーバのバックアップ
    事前にbiz-Stream Webサービスサーバ(Apache Tomcat 自体) をバックアップしておきます。

  3. Web サービスサーバ削除
    現環境のWebサービスサーバ(Apache Tomcat) は一度アンインストールします。
    ガイドの「7.1 biz-Stream Webサービスサーバのアンインストール」を参照しアンインストールしてください。

  4. JavaVM のインストール
    Webサービスサーバがサポートする Java 環境は「1.4 biz-Stream Webサービスサーバのサポート環境」を参照してください。
    インストールメディアの /bswss/jre にもサポート対象のJavaが同梱されていますので、お客様の環境に適したものをインストールしてください。

  5. Apache Tomcat のインストール
    メディアの /bswss/tomcat ディレクトリ以下にある Apache Tomcat のうち、お客様の環境に適したものをインストールしてください。

  6. biz-Stream Webサービスサーバ のインストール
    メディアの /bswss ディレクトリ以下の bswss-X.X.X.zip(tar.gz) ファイルを使用し、Web サービスサーバをインストールします。
    以下ここで展開したフォルダを「更新用フォルダ」とします。

    上記のJava VM、Apache Tomcat、bswss-X.X.X.zip(tar.gz) のそれぞれのインストール方法は「第2章 biz-Stream Webサービスサーバのインストール」を参照してください。

    • 機能追加・修正・削除によって、旧リリースに以前存在したライブラリが削除されたり、新規ライブラリが追加されたりする場合があるため、旧ファイルは完全に削除して混在しないようにご注意ください。
    • 上書きインストールは誤作動の原因となるため行わないでください。

  7. プロパティファイルの再設定
    プロパティファイルは <bsws_server_home>/lib に配置されています。
    設定項目はライブラリ共通ガイド「第3章 プロパティファイル」をご参照ください。
    旧プロパティファイルで任意に変更された値があれば、更新後の新しいプロパティファイルにその値を反映させてください。
    この再設定の意味は、ファイルの上書きを意味しません。初期出荷時以外の値に変更されている項目のみ、バージョンアップ前のファイルからコピーして変更してください。
    新リリースでは、新たなプロパティファイル項目またはプロパティファイル内の設定値が変更されている場合がありますのでご注意ください。
    • v4.2 までに存在していた ja_JP ロケールのファイル(xxxxx_ja_JP.properties) は、v4.3 以降不要となり削除されています。

  8. ライセンスの配置
    ライセンスファイル(licence.properties)を<bsws_server_home>/libディレクトリに配置してください。 ライセンスファイルの入手手順は「2.3 biz-Streamライセンスのセットアップ」を参照してください。
    • biz-Stream v4.x 以前の licence.properties は v5.x で使用できません。再度ライセンスを申請してください。

  9. Webサービスサーバ インストール後の設定
    お客様環境に応じて必要な設定があれば「2.6 biz-Stream Webサービスサーバ インストール後の設定」を参照し、設定を行ってください。

  10. Web サービスサーバ起動
    以上の設定完了後、Web サービスサーバを起動してください。 手順については「Web サービスサーバの起動方法」を参照してください。

  11. インストール結果の確認
    Webサービスサーバが正しくインストールされたことを確認します。「2.8 インストール結果の確認」を参照し確認を行ってください。

  12. ログファイルの確認
    <bsws_server_home>/logsディレクトリにログが出力されるようになっています。
    ログについては「5.2 Webサービスサーバで出力されるログ一覧」をご参照ください。
    動作確認や調査のために一時的にログレベルを変更する場合は「5.5 ログレベルの変更方法」を参照してください。