2011年12月28日

biz-Stream Web サービスサーバ機能の修正・機能追加モジュール適用による、アップデート手順についてご説明いたします。

1. biz-Stream Web サービスサーバ アップデート前の確認事項
2. メディアからのアップデート手順 【 リリースアップ または 一部のホットフィックス 】
3. ホットフィックスダウンロードで biz-Stream Webサービスサーバモジュール全体が提供されている場合の手順 【bswss-4.X.X.zip として提供】
4. ホットフィックスダウンロードで一部のライブラリのみが提供されている場合の手順 【bswss-4.X.X.zip として提供されていない】
5. 留意事項

1. biz-Stream Web サービスサーバ アップデート前の確認事項

アップデートを行う前には以下のページにて、動作環境・アップデートモジュール入手方法を確認のうえ、アップデートモジュールを入手してください。

• biz-Stream のアップデートについて

アップデートモジュールは「メディア」または「ダウンロードファイル」として提供いたします。
また、アップデートの手順は「メディア」と「ダウンロードファイル」で異なります。

さらに、ダウンロードファイルの場合、ファイルの内容は以下の提供形態があります。

• ホットフィックスダウンロードファイルで biz-Stream Webサービスサーバモジュール全体が bswss-4.X.X.zip として提供されている場合
• ホットフィックスダウンロードファイルで 一部のライブラリのみが提供され、biz-Stream Webサービスサーバモジュール全体が bswss-4.X.X.zip として提供されていない場合

このように、アップデートの手順は提供形態により3パターンありますので、入手したアップデート用のモジュールにより以下の手順に添い、アップデートを行ってください。

《 リリースアップ 》

• メディアからのアップデート手順

《 ホットフィックス 》

• メディアからのアップデート手順
• biz-Stream Webサービスサーバモジュール全体が提供されている場合の手順
• 一部のライブラリのみが提供されている場合の手順

以後の説明にて [Webサービスサーバ] と記載されているのは、biz-Stream Webサービスサーバ をインストールしたディレクトリをあらわします。

2. メディアからのアップデート手順 【 リリースアップ または 一部のホットフィックス 】

メディアからのアップデート手順をご説明いたします。

例えば現在 v4.4 をご使用で v4.6 へ変更されるなど、異なるリリースへアップデートされる場合の手順です。

1) biz-Stream Webサービスサーバ 停止

biz-Stream Webサービスサーバ を停止してください。

2) プロパティファイルのバックアップ

[Webサービスサーバ]/lib ディレクトリ以下にあるライセンスファイル(licence.properties)をバックアップします。
旧プロパティファイルでお客様で任意に変更された値があれば、[Webサービスサーバ]/lib ディレクトリ以下にあるプロパティファイル(xxxxxx.properties)をバックアップします。
biz-Stream v4.4 以降かつログ出力の設定を変更された場合には logback.xml についてもバックアップします。

3) Web サービスサーバ削除

biz-Stream Webサービスサーバ は Apache Tomcat を利用しており、各リリースのメディアに同梱されているものをご使用いただきます。biz-Stream Webサービスサーバ はリリースアップにともない Apache Tomcat についてもアップデートされたものが同梱されるため、現環境の biz-Stream Webサービスサーバ は一度アンインストールします。
ガイドの以下の章をを参照し、アンインストールしてください。

《 参照箇所 》

[biz-Stream v4.X Webサービスサーバ ユーザガイド] - [第3章 biz-Stream Webサービスサーバ のアンインストール]

4) JavaVM のインストール

biz-Stream Webサービスサーバ がサポートする Java 環境は、同リリースのメディアに同梱されている JRE です。
メディアの /jre ディレクトリ以下にある Oracle Corporation Java Runtime Environment のうち、お客様の環境に適したものをインストールしてください。

5) Apache Tomcat のインストール

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

6) biz-Stream Webサービスサーバ のインストール

メディアの /bswss ディレクトリ以下の bswss-X.X.X.zip ファイルを使用し、Web サービスサーバをインストールします。
インストール方法は『biz-Stream Webサービスサーバ ユーザガイド』に詳細がございます。ご参照ください。

《 参照箇所 》

[biz-Stream v4.X Webサービスサーバ ユーザガイド] - [第2章 biz-Stream Webサービスサーバのインストール] [2.5.3 biz-Stream Webサービスサーバ のインストール] (Windows環境)

[biz-Stream v4.X Webサービスサーバ ユーザガイド] - [第2章 biz-Stream Webサービスサーバのインストール] [2.6.3 biz-Stream Webサービスサーバ のインストール] (Linux/UNIX環境)

7) プロパティファイルの更新

2) でバックアップした旧プロパティファイルでお客様が任意に変更された値があれば、新しいプロパティファイルにその値を設定してください。

8) ログ設定ファイルの更新

《 v4.4未満のリリースからのアップデート 》

biz-Stream v4.3 まではログ設定は default_values.properties, pdf.properties ファイルで実施していましたが、ロギングライブラリの変更により v4.4 以降では [Web サービスサーバ]/conf ディレクトリ以下の logback.properties, logback.xml にて設定するようになりました。

※logback.xml の <substitutionProperty> file 属性に、logback.properties のパスを設定してください。パスはカレントディレクトリを基準とし、絶対パス・相対パスともに設定可能です。その他の設定詳細は『biz-Stream v4.X 導入ガイド.pdf』のログ設定の章をご参照ください。

※logback.properties の log.dir= にはログ出力ディレクトリを設定します(絶対パス、相対パスともに設定可能)。

《 v4.4以降のリリースからのアップデート 》

ログ設定ファイルは [Web サービスサーバ]/conf ディレクトリ以下の logback.properties, logback.xml です。旧設定ファイルでお客様が任意に変更された値があれば、2) でバックアップした旧プロパティファイルを参考に、その値を再設定してください。

《 v4.8以降のリリースへアップデート 》

v4.8.0以降では logback.properties が廃止になりましたのでlogback.xmlに直接ログ出力先を設定してください。

9) ライセンスの配置

2) でバックアップしたライセンスファイル(licence.properties)を [Webサービスサーバ]/lib に配置してください。

10) Web サービスサーバ起動

以上の設定完了後、Web サービスサーバを起動してください。

3. ホットフィックスダウンロードで biz-Stream Webサービスサーバモジュール全体が提供されている場合の手順 【bswss-4.X.X.zip として提供】

ホットフィックスダウンロードファイルで biz-Stream Webサービスサーバモジュール全体が bswss-4.X.X.zip として提供されている場合についてのアップデート手順をご説明いたします。

1) Web サービスサーバ停止

biz-Stream Webサービスサーバ を停止してください。

2) プロパティファイルのバックアップ

[Webサービスサーバ]/lib ディレクトリ以下にあるライセンスファイル(licence.properties)をバックアップします。
旧プロパティファイルでお客様が任意に変更された値があれば、[Web サービスサーバ]/lib ディレクトリ以下にあるプロパティファイル(xxxxxx.properties)をバックアップします。
biz-Stream v4.4 以降かつログ出力の設定を変更された場合には logback.xml についてもバックアップします。

3) bswss-4.X.X.zip の解凍

ダウンロードファイルの中の bswss-4.X.X.zip を、[Web サービスサーバ] ディレクトリへ上書きで解凍してください。

4) プロパティファイルの更新

2) でバックアップした旧プロパティファイルでお客様が任意に変更された値があれば、新しいプロパティファイルにその値を設定してください。

5) ログ設定ファイルの更新

ログ設定ファイルは [Web サービスサーバ]/conf ディレクトリ以下の logback.properties, logback.xml です。旧設定ファイルでお客様が任意に変更された値があれば、2) でバックアップした旧プロパティファイルを参考に、その値を再設定してください。

6) Web サービスサーバ起動

以上の設定完了後、Web サービスサーバを起動してください。

4. ホットフィックスダウンロードで一部のライブラリのみが提供されている場合の手順
【bswss-4.X.X.zip として提供されていない】

ホットフィックスダウンロードファイルで一部のライブラリのみが提供され、biz-Stream Webサービスサーバモジュール全体が提供されていない場合のアップデート手順をご説明します。

1) ダウンロードファイルの解凍

ダウンロードファイルをパソコンのハードディスクで解凍してください。

以下ここで展開したフォルダを「更新用フォルダ」とします。

2) Web サービスサーバ停止

biz-Stream Webサービスサーバ を停止してください。

3) ライブラリの更新

更新用フォルダにあるライブラリ(xxxxx.jar) と同名の Web サービスサーバ上のファイルを削除してから、更新用フォルダからライブラリをコピーしてください。
biz-Stream のライブラリは、Web サービスサーバの以下のディレクトリにあります。すべてのディレクトリのライブラリを入れ替えてください。

• [Webサービスサーバ]/lib ディレクトリ
• [Webサービスサーバ]/webapps/axis2/WEB-INF/lib ディレクトリ
• [Webサービスサーバ]/webapps/bsadmin2/WEB-INF/lib ディレクトリ

4) Web サービスサーバ起動

以上の設定完了後、Web サービスサーバを起動してください。

5. 留意事項

リリースおよびホットフィックスには リリースノート(readme.txt)が付属しています。リリースノートにインストールの手順及び注意事項が記載されていますので、ご参照ください。