Cosminexus V9 BPM/ESB基盤 サービスプラットフォーム システム構築・運用ガイド
(1) リポジトリのエクスポート(運用環境)
バージョンアップ前の運用環境のリポジトリをエクスポートして,いったん退避します。複数のリポジトリを使用している場合,必要なリポジトリをすべてエクスポートして,退避します。
cscrepctlコマンド(-exportオプション)を運用環境で実行して,バージョンアップ前のリポジトリをエクスポートしてください。
リポジトリのエクスポート方法の詳細については,「4.2 リポジトリのエクスポート」を参照してください。
(2) 各環境の更新インストール
開発環境,運用環境,実行環境で09-87のサービスプラットフォームを更新インストールしてバージョンアップします。HCSC簡易セットアップ機能を利用してセットアップしたテスト環境の場合は,更新インストールの前にHCSC簡易セットアップ機能を利用してアンセットアップを実行し,更新インストール後に再セットアップしてください。
各環境を更新インストールするときの前提条件を次に示します。
- 前提条件
- HCSCサーバがセットアップ済みであること
- サービスプラットフォームおよびReliable Messagingが停止していること
- 組み込みデータベースを使用している場合,組み込みデータベースを停止していること
- HCSCサーバ,J2EEサーバ,およびHCSCコンポーネントが停止していること
- 注意
- アンインストールする場合の注意
- J2EEサーバ,Management Server,PRFなど実行環境の構成要素を停止してから更新インストールしてください。
- 組み込みデータベースを使用している場合,組み込みデータベースを停止してから更新インストールしてください。
- 開発環境をバージョンアップする場合の注意
- 開発環境では,バージョンアップ前にHCSCTEプロジェクトをいったん削除し,バージョンアップ後に新しく作成し直してください。
- バージョン09-87より前のバージョンから移行する場合,次に示すディレクトリ配下の情報を必要に応じて退避してから更新インストールしてください。
<サービスプラットフォームのインストールディレクトリ>\CSCTE\Samples
なお,更新インストールでは次のファイルを除いて上書きされます。
- <サービスプラットフォームのインストールディレクトリ>\CSC\config\manager\csccmd.properties
- <サービスプラットフォームのインストールディレクトリ>\CSC\config\manager\cscmng.properties
- <サービスプラットフォームのインストールディレクトリ>\CSC\config\msg\cmdconf.bat
- <サービスプラットフォームのインストールディレクトリ>\CSC\inbound-adapter\ftp\config\command\log4j.xml
- <サービスプラットフォームのインストールディレクトリ>\CSC\inbound-adapter\ftp\config\FTP_Inbound_Resource_Adapter\serverstatus.properties
- <サービスプラットフォームのインストールディレクトリ>\CSC\inbound-adapter\ftp\config\FTP_Inbound_Resource_Adapter\users.properties
- <サービスプラットフォームのインストールディレクトリ>\CSC\system\manager\setup\input.properties
(3) J2EEサーバのクラスパスの変更
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
(4) 旧オプションアダプタの定義ファイルの移行
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\
(5) 製品のアンインストール
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
(6) リポジトリのインポート(開発環境)
「(1) リポジトリのエクスポート(運用環境)」でエクスポートしたリポジトリ情報を開発環境にインポートします。旧バージョンのリポジトリをインポートすると,パッケージングおよび配備定義が自動で実施され,リポジトリ情報が今バージョンに引き継がれます。なお,パッケージングおよび配備定義が自動で実施されるのは,旧バージョンでパッケージングおよび配備定義したサービスアダプタ,ビジネスプロセスおよびユーザ定義受付だけです。
(a) 07-60以降のバージョンから移行する場合の注意
07-60以降のバージョンから移行する場合,実行環境に配備するサービスアダプタおよびユーザ定義受付は,開発環境にインポートして再度パッケージングしてください。サービスアダプタを再度パッケージングしないと,メッセージKDEC03007-Eが出力されないことがあります。また,ユーザ定義受付を再度パッケージングしないと,メッセージKDEC00001-Eで不正な埋字が出力されることがあります。パッケージングの方法については,マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「7.2 パッケージング」を参照してください。
(b) 08-10より前のバージョンから移行する場合の注意
データ変換定義で,sequence要素またはchoice要素下に,出現回数が1回に固定されている次の要素(コンポジタ)を定義している場合,ノードの表示が変更されるため,マッピング定義ファイルで使用しているXML Schemaが変更されている旨のエラーメッセージが表示されます。
エラーメッセージが表示された場合は,再度マッピング定義を起動し,変更を反映させてください。
(c) 09-50より前のバージョンから移行する場合の注意
- データ変換定義で次に示すスキーマを定義している場合,名前空間が変更されるため,マッピング定義ファイルで使用しているXML Schemaが変更されている旨のエラーメッセージが表示されます。
- インポート先で対象名前空間(targetNamespace)を定義しているスキーマを変換元ノードに指定している。
- 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サーバランタイム定義ファイルについては,マニュアル「サービスプラットフォーム リファレンス」の「HCSCサーバランタイム定義ファイル」を参照してください。
- 注※2
- これらのプロパティの指定方法については,「2.3.9(5) XMLパーサプール機能オプションを使用する」を参照してください。
(d) 09-70より前のバージョンから移行する場合の注意
データ変換定義で次に示すスキーマを定義している場合,名前空間が変更されるため,マッピング定義ファイルで使用しているXML Schemaが変更されている旨のエラーメッセージが表示されます。
- 1つの名前空間URIに対して,複数の異なる名前空間接頭辞を指定している。
エラーメッセージが表示された場合は,マッピング定義を再起動し,変更を反映させてください。
(e) メモリについての注意
旧バージョンのリポジトリをインポートするときは,メモリを多く必要とします。そのため,次の手順でメモリサイズが十分かどうかを確認し,メモリが不足している場合は,メモリサイズを増やしてからリポジトリをインポートしてください。
- Eclipseのメニューから,[ウィンドウ]−[設定]を選択します。
- ダイアログ左側のツリービューから,[一般]を選択します。
- ダイアログ右側の[ヒープ・ステータスを表示]チェックボックスにチェックします。
- Eclipseのウィンドウの右下のゴミ箱アイコンを選択し,ガーベッジ・コレクターを実行します。
- ゴミ箱アイコンの左に表示されているヒープ・サイズを確認します。
- 未使用のヒープ・サイズが不足している場合,eclipse.iniを編集し,メモリサイズ(-Xmxの値)を大きくします。eclipse.iniの編集については,マニュアル「アプリケーションサーバ アプリケーション開発ガイド」の「2.4.3 Eclipse環境のセットアップ」を参照してください。
(7) リポジトリのエクスポート(開発環境)
(8) リポジトリのインポート(運用環境)
(9) サービスプラットフォームおよびReliable Messagingの移行(実行環境)
次の手順でサービスプラットフォームおよび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サーバモードの場合)」を参照してください。
(10) 実行環境のバージョンアップ(運用環境)
運用環境から実行環境のバージョンアップを実施します。
実行環境をバージョンアップするには,次の条件を満たしている必要があります。
- 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-87より前のバージョンから移行する場合の注意
09-87にバージョンアップする場合,次のHCSCランタイム定義ファイルのプロパティの初期値が変更されているため,メモリ使用量が増える可能性があります。HCSCサーバランタイム定義ファイルについては,マニュアル「サービスプラットフォーム リファレンス」の「HCSCサーバランタイム定義ファイル」を参照してください。
- formatdef-maxcache-num
- transformdef-maxcache-num
All Rights Reserved. Copyright (C) 2012, 2019, Hitachi, Ltd.