バージョンアップ前の運用環境のリポジトリをエクスポートして，いったん退避します。複数のリポジトリを使用している場合は，すべてのリポジトリをエクスポートして退避します。

cscrepctlコマンド（-exportオプション）を運用環境で実行して，バージョンアップ前のリポジトリをエクスポートしてください。

リポジトリのエクスポート方法の詳細については，「4.2　リポジトリのエクスポート」を参照してください。

開発環境および運用環境で，09-87のサービスプラットフォームをインストールしてバージョンアップします。

開発環境は，新規インストールまたは更新インストールのどちらかの方法でインストールします。運用環境は更新インストールでインストールします。

新規にインストールする場合

「付録G.2　新規にインストールする場合の移行手順」の「(2)　HCSCコンポーネントの削除（運用環境）」〜「(6)　HCSCサーバの構築（運用環境）」の作業を実施します。

更新インストールする場合

「付録G.3　更新インストールする場合の移行手順」の「(2)　各環境の更新インストール」〜「(5)　製品のアンインストール」の作業を実施します。

開発環境および運用環境をインストールするときの前提条件を次に示します。

前提条件

• HCSCサーバがセットアップ済みであること
• サービスプラットフォームおよびReliable Messagingが停止していること
• 組み込みデータベースを使用している場合，組み込みデータベースを停止していること
• HCSCサーバ，J2EEサーバ，およびHCSCコンポーネントが停止していること

注意

更新インストールをする場合，次の点に注意してください。

• インストールする環境で，J2EEサーバ，Management Server，PRFなどのサービスプラットフォーム実行環境が稼働中の場合は，すべていったん停止してから更新インストールしてください。
• 組み込みデータベースを使用しているときは，組み込みデータベースを停止してから更新インストールしてください。

09-00より前のバージョンから移行する場合，J2EEサーバ用オプション定義ファイル（usrconf.cfg）に次に示す定義があれば削除してください。定義の変更はSmart Composer機能または運用管理ポータルの使用をお勧めします。

• add.class.path=<TP1アダプタのインストールディレクトリ>\lib\adptp1rt.jar
• add.class.path=<ファイルアダプタのインストールディレクトリ>\lib\adpffrt.jar
• add.class.path=<Object Accessアダプタのインストールディレクトリ>\lib\adpoart.jar
• add.class.path=<Object Accessアダプタのインストールディレクトリ>\usrlib\adpoaow.jar
• add.class.path=<Message Queueアダプタのインストールディレクトリ>\lib\adpmqrt.jar
• add.class.path=<FTPアダプタのインストールディレクトリ>\lib\adpftprt.jar
• add.class.path=<FTPアダプタのインストールディレクトリ>\lib\ftp_common.jar
• add.class.path=<コード変換ライブラリのインストールディレクトリ>\java\codeconv.jar
• add.class.path=<TP1/Client/Jのインストールディレクトリ>\LIB\TP1Client.jar

09-00より前で使用していたオプションアダプタを移行する場合，次の作業を実施してください。

(a)　TP1アダプタの定義ファイルの移行

TP1アダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<TP1アダプタのインストールディレクトリ>\config\*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>\CSC\custom-adapter\TP1\config\

(b)　ファイルアダプタの定義ファイルの移行

ファイルアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<ファイルアダプタのインストールディレクトリ>\config\*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>\CSC\custom-adapter\File\config\

(c)　Object Accessアダプタの定義ファイルの移行

Object Accessアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<Object Accessアダプタのインストールディレクトリ>\config\*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>\CSC\custom-adapter\OA\config\

(d)　Message Queueアダプタの定義ファイルの移行

Message Queueアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<Message Queueアダプタのインストールディレクトリ>\config\*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>\CSC\custom-adapter\MQ\config\

(e)　FTPアダプタの定義ファイルの移行

FTPアダプタコマンド定義ファイルとFTPアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<FTPアダプタのインストールディレクトリ>\config\*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>\CSC\custom-adapter\FTP\config\

09-00より前のバージョンから移行する場合，次の製品をアンインストールします。これらは09-00以降でサービスプラットフォームに同梱されるため，アンインストールすることをお勧めします。

• Service Adapter for Flat Files
• Service Adapter Architect for Flat Files
• Service Adapter for FTP
• Service Adapter Architect for FTP
• Service Adapter for Message Queue
• Service Adapter Architect for Message Queue
• Service Adapter for Object Access
• Service Adapter Architect for Object Access
• Service Adapter for TP1
• Service Adapter Architect for TP1
• コード変換 - Development Kit
• コード変換 - Server Runtime
• コード変換 - Runtime
• TP1/Client/J

「(1)　リポジトリのエクスポート（運用環境）」でエクスポートしたリポジトリ情報を開発環境にインポートします。インポートによって，古いバージョンで作成したリポジトリ情報が今バージョンに引き継がれます。そのあと，開発環境のリポジトリ情報を運用環境にインポートし，運用環境にもリポジトリ情報を引き継ぎます。

リポジトリのインポート・エクスポートで実施する作業は，「(2)　開発環境および運用環境のインストール」で開発環境をインストールした方法によって次のように異なります。

新規にインストールした場合

「付録G.2　新規にインストールする場合の移行手順」の「(7)　リポジトリのインポート（開発環境）」〜「(9)　リポジトリのインポート（運用環境）」の作業を実施します。

更新インストールした場合

「付録G.3　更新インストールする場合の移行手順」の「(6)　リポジトリのインポート（開発環境）」〜「(8)　リポジトリのインポート（運用環境）」の作業を実施します。

バージョンアップするHCSCサーバに対してリクエストを送信しないように，ロードバランサを設定します。その際，仕掛かり中のリクエストがないことを確認してください。なお，設定方法は各ロードバランサの仕様によって異なります。

実行環境で，09-87のサービスプラットフォームをインストールしてバージョンアップします。

実行環境は，新規インストールまたは更新インストールのどちらかの方法でインストールします。

新規にインストールする場合

「付録G.2　新規にインストールする場合の移行手順」の「(2)　HCSCコンポーネントの削除（運用環境）」〜「(6)　HCSCサーバの構築（運用環境）」の作業を実施します。

更新インストールする場合

「付録G.3　更新インストールする場合の移行手順」の「(2)　各環境の更新インストール」〜「(5)　製品のアンインストール」の作業を実施します。

次の手順でサービスプラットフォームおよびReliable Messagingを移行してください。09-00より前のバージョンから移行する場合は，次の作業も必要です。

• 移行コマンド（mngenvupdateコマンド）の実行
• mserver.properties（Management Server環境設定ファイル）へのプロパティの追加
  次のプロパティを追加してください。追加しないでManagement Serverを起動すると，cscで始まるコマンドがエラーになる場合があります。プロパティの追加方法については，「2.1.6(1)　mserver.properties（Management Server環境設定ファイル）の設定」を参照してください。
  

  ejbserver.naming.port
  ejbserver.server.edition.settingforce

サービスプラットフォームの移行方法の詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「10.　旧バージョンのアプリケーションサーバからの移行（J2EEサーバモードの場合）」を参照してください。

運用環境から実行環境のバージョンアップを実施します。

(a)　前提条件

実行環境をバージョンアップするには，次の条件を満たしている必要があります。

• Management Serverが起動していること
• 組み込みデータベースを使用している場合，組み込みデータベースが起動していること
• リポジトリのバージョンがインストールバージョンと一致していること
  リポジトリのバージョンがインストールバージョンと一致していない場合は，開発環境でバージョンアップしてから，運用環境に「cscrepctl -import <リポジトリZIP>」でリポジトリを更新してください。
  

前提条件を満たしていない場合，上記の順番で起動，停止，およびバージョンアップを実施してください。

(b)　バージョンアップ方法

cscenvupdateコマンドを実行して，リポジトリとHCSCサーバをバージョンアップします。

 
cscenvupdate -csc <バージョンアップするHCSCサーバ名>
 

バージョンアップしたHCSCサーバを起動します。

「(10)　実行環境のバージョンアップ（運用環境）」で起動したHCSCサーバに配備されているHCSCコンポーネントを開始します。

バージョンアップしたHCSCサーバに対してリクエストを送信するように，ロードバランサを設定します。なお，設定方法は各ロードバランサの仕様によって異なります。

ロードバランスクラスタを構成しているすべてのHCSCサーバに対して，「(7)　リクエストの送信制御（ロードバランサ）」〜「(13)　リクエストの送信制御の解除（ロードバランサ）」の作業を実施します。

なお，旧バージョンで使用していたリポジトリ情報を開発環境でバージョンアップ前後に変更し，そのリポジトリ情報を使用して運用する場合のバージョンアップ方法については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「付録A　旧バージョンからの移行」を参照してください。

(a)　08-70以前にローリングアップデートする場合

次の条件がすべて該当すると，cscenvupdateコマンドの実行時に異常終了することがあります。

• データベースおよびReliable Messagingがある構成でセットアップしている場合で，データベースにはHiRDBを使用している。
• ビジネスプロセスを使用している。
• クラスタ内で最初のアップデートである。
• 08-70以前からのローリングアップデートである。

この場合に，正常に運用する方法および運用例を次に示します。

• 運用方法
  稼働しているすべてのHCSCサーバに対して，次に示す1.〜4.の操作を実行してください。
  
  1. 実行履歴参照コマンドおよび運用操作をするGUIを停止する。
  2. HCSCサーバにリクエストを送信しないようにする。
  3. HCSCサーバの受付（標準受付およびユーザ定義受付）を停止する。
  4. すべてのリソースアダプタのプールを破棄する（cjclearpoolコマンドを利用）。
  この操作を実行した状態で，バージョンアップしたHCSCサーバに対してcscenvupdateコマンドを実行してください。2台目以降のアップデートは，1.〜4.の手順を実行する必要はありません。また，1回目のcscenvupdateコマンドの正常終了を確認したあとに，1.〜3.の手順で停止した各機能は，2台目以降の操作タイミングとは無関係に再開可能となります。
  
• 運用例
  次に示す構成およびバージョンアップを想定します。
  
  • 3台のクラスタ構成（HCSCサーバA，HCSCサーバB，HCSCサーバC）で運用している。
  • HCSCサーバBおよびHCSCサーバCが稼働中に，HCSCサーバAに対してcscenvupdateコマンドを実行する。
  この場合に，正常に運用する方法を次に示します。
  
  1. 実行履歴参照コマンドおよび運用操作をするGUIを停止する。
  2. HCSCサーバBおよびHCSCサーバCにリクエストを送信しないようにする。
  3. HCSCサーバB，HCSCサーバCの受付（標準受付およびユーザ定義受付）を停止する。
  4. cjclearpoolコマンドを利用して，HCSCサーバBおよびHCSCサーバCのすべてのリソースアダプタのプールを破棄する。
  5. HCSCサーバAに対してcscenvupdateコマンドを実行する。

(b)　09-00以降にローリングアップデートする場合

次の条件がすべて該当すると，cscenvupdateコマンドの実行時に異常終了することがあります。

• データベースおよびReliable Messagingがある構成でセットアップしている。
• ビジネスプロセスを使用している。
• クラスタ内で最初のアップデートである。

この場合，オンラインを停止させてから「付録H.4　ローリングアップデートで運用環境のリポジトリを移行する手順」に示す手順でローリングアップデートしてください。