付録G.3　更新インストールする場合の移行手順

(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\

(a)　07-60以降のバージョンから移行する場合の注意

07-60以降のバージョンから移行する場合，実行環境に配備するサービスアダプタおよびユーザ定義受付は，開発環境にインポートして再度パッケージングしてください。サービスアダプタを再度パッケージングしないと，メッセージKDEC03007-Eが出力されないことがあります。また，ユーザ定義受付を再度パッケージングしないと，メッセージKDEC00001-Eで不正な埋字が出力されることがあります。パッケージングの方法については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「8.2　パッケージング」を参照してください。

(b)　08-10より前のバージョンから移行する場合の注意

データ変換定義で，sequence要素またはchoice要素下に，出現回数が1回に固定されている次の要素（コンポジタ）を定義している場合，ノードの表示が変更されるため，マッピング定義ファイルで使用しているXML Schemaが変更されている旨のエラーメッセージが表示されます。

• sequence

• choice

エラーメッセージが表示された場合は，再度マッピング定義を起動し，変更を反映させてください。

(c)　09-50より前のバージョンから移行する場合の注意

• データ変換定義で次に示すスキーマを定義している場合，名前空間が変更されるため，マッピング定義ファイルで使用しているXML Schemaが変更されている旨のエラーメッセージが表示されます。

  1. インポート先で対象名前空間（targetNamespace）を定義しているスキーマを変換元ノードに指定している。

  2. 1.の名前空間が，importまたはinclude先を含むすべての名前空間宣言（xmlns[:prefix]）で定義されていない。

  エラーメッセージが表示された場合は，マッピング定義を再起動し，変更を反映させてください。

• インスタンスのプールの最小値・最大値にはデフォルト値が適用されるため，HCSCサーバランタイム定義ファイルのプロパティでxml-pooled-instance-minimumプロパティまたはxml-pooled-instance-maximumプロパティを指定している場合は，性能に影響が生じるおそれがあります。そのため，次に示すusrconf.properties（J2EEサーバ用ユーザプロパティファイル）のプロパティと指定値を合わせてください。

  内容	HCSCサーバランタイム定義ファイルのプロパティ※1	usrconf.properties（J2EEサーバ用ユーザプロパティファイル）のプロパティ※2
  最小値	xml-pooled-instance-minimum	csc.dt.pool.DocumentBuilder.initialSize
  最大値	xml-pooled-instance-maximum	csc.dt.pool.DocumentBuilder.maxSize

  注※1

  HCSCサーバランタイム定義ファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

  注※2

  これらのプロパティの指定方法については，「2.3.9(5)　XMLパーサプール機能オプションを使用する」を参照してください。

(d)　09-70より前のバージョンから移行する場合の注意

データ変換定義で次に示すスキーマを定義している場合，名前空間が変更されるため，マッピング定義ファイルで使用しているXML Schemaが変更されている旨のエラーメッセージが表示されます。

• 1つの名前空間URIに対して，複数の異なる名前空間接頭辞を指定している。

エラーメッセージが表示された場合は，マッピング定義を再起動し，変更を反映させてください。

(e)　メモリについての注意

旧バージョンのリポジトリをインポートするときは，メモリを多く必要とします。そのため，次の手順でメモリサイズが十分かどうかを確認し，メモリが不足している場合は，メモリサイズを増やしてからリポジトリをインポートしてください。

1. Eclipseのメニューから，［ウィンドウ］−［設定］を選択します。

2. ダイアログ左側のツリービューから，［一般］を選択します。

3. ダイアログ右側の［ヒープ・ステータスを表示］チェックボックスにチェックします。

4. Eclipseのウィンドウの右下のゴミ箱アイコンを選択し，ガーベッジ・コレクターを実行します。

5. ゴミ箱アイコンの左に表示されているヒープ・サイズを確認します。

6. 未使用のヒープ・サイズが不足している場合，eclipse.iniを編集し，メモリサイズ（-Xmxの値）を大きくします。eclipse.iniの編集については，マニュアル「アプリケーションサーバ アプリケーション開発ガイド」の「2.4.3　Eclipse環境のセットアップ」を参照してください。

(a)　前提条件

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

• Management Serverが起動していること

• データベースを使用している（HCSCサーバセットアップ定義ファイルにdb-use=ONを指定）場合，データベースが起動していること

• リポジトリのバージョンがインストールバージョンと一致していること

  リポジトリのバージョンがインストールバージョンと一致していない場合は，開発環境でバージョンアップしてから，運用環境に「cscrepctl -import <リポジトリZIP>」でリポジトリを更新してください。

• FTPインバウンドアダプタを使用する場合，cjrarupdateコマンド^※でのリソースアダプタのバージョンアップが完了していること

  注※

  cjrarupdateコマンドには次のオプションを指定してください。

  　-typeオプション：「rar」

  　-fオプション：「<サービスプラットフォームのインストールディレクトリ>\CSC\inbound-adapter\ftp\rar\ftp_inbound_adapter.rar」

  cjrarupdateコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjrarupdate（リソースアダプタのバージョンアップ）」を参照してください。

  なお，09-50以前のバージョンからFTPインバウンドアダプタをバージョンアップすると，FTPレスポンスに使用されるデフォルトの終端文字がOS依存の改行コードからCRLFに変更されます。終端文字をOS依存の改行コードに戻したい場合は，cjgetrarpropコマンドでFTPインバウンドアダプタのRARファイルから属性ファイルを取得したあと，定義を変更し，cjsetrarpropコマンドで属性ファイルを設定してください。属性ファイルの設定については，「3.2.3(3)　FTPインバウンドアダプタの設定」を参照してください。

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

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

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

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

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

注意事項

旧バージョンでHTTP受付を使用していた場合で，アプリケーション統合属性ファイルで次に示す要素以外を編集しているときは，その部分については移行後のアプリケーション統合属性ファイルに反映されません。

• //hitachi-application-all-property/ejb-jar/hitachi-ejb-jar-property/display-name[.='cscmsg_urecp_custom']/../../hitachi-session-bean-property/display-name[.='CSCMsgCustomServiceDelivery']/../session-runtime/stateless/pooled-instance/minimum

• //hitachi-application-all-property/ejb-jar/hitachi-ejb-jar-property/display-name[.='cscmsg_urecp_custom']/../../hitachi-session-bean-property/display-name[.='CSCMsgCustomServiceDelivery']/../session-runtime/stateless/pooled-instance/maximum

• //hitachi-application-all-property/ejb-jar/hitachi-ejb-jar-property/display-name[.='cscmsg_urecp_custom']/../../hitachi-session-bean-property/display-name[.='CSCMsgCustomServiceDelivery']/../ejb-transaction-timeout/method/method-name[.='*']/../../transaction-timeout

そのため，必要に応じてcsccompoconfigコマンドでアプリケーション統合属性ファイルを取得して内容を編集したあと，設定を反映してください。

csccompoconfigコマンドの使用方法については，マニュアル「サービスプラットフォーム リファレンス」の「csccompoconfig（HCSCコンポーネントの定義）」を参照してください。

アプリケーション統合属性ファイル（cosminexus.xml）で編集できる要素については，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「付録A.6　カスタム受付のチューニング」を参照してください。

(c)　09-71より前のバージョンから移行する場合の注意

HCSCランタイム定義ファイルの次に示すプロパティの初期値が変更されているため，メモリ使用量が増える可能性があります。HCSCサーバランタイム定義ファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

• formatdef-maxcache-num

• transformdef-maxcache-num

(d)　11-10より前のバージョンから移行する場合の注意

11-10からJ2EEサーバの互換モードで推奨モードが使用できますが，新規構築でない環境ではV9互換モードが引き継がれます。推奨モードは使用できません。