Cosminexus V9 BPM/ESB基盤 サービスプラットフォーム リファレンス
形式
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE csc-setup-definition SYSTEM "cscsvsetup_1_3.dtd"> <!-- All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd. --> <csc-setup-definition> <cluster> <name>クラスタ名</name> <type>クラスタ種別</type> </cluster> <cosminexus-manager> <!-- Cosminexus Manager Definition --> <name>Manager名</name> <ip-address>ManagerのIPアドレスまたはホスト名</ip-address> <port>Managerのポート番号</port> <id>Management Serverの管理ユーザID</id> <password>Management Serverの管理ユーザパスワード</password> <csc-server> <!-- HCSC-Server Definition --> <name>HCSCサーバ名</name> <id>HCSCサーバが使用するデータベースのユーザID</id> <password>HCSCサーバが使用するデータベースのパスワード</password> <j2ee-server-name>HCSCサーバが使用するJ2EEサーバ名</j2ee-server-name> <setup-properties>HCSCサーバセットアップ定義ファイル名</setup-properties> </csc-server> </cosminexus-manager> <reception> <soap-reception> <!-- WebServer Definition --> <ip-address>WebサーバのIPアドレスまたはホスト名</ip-address> <port>Webサーバのポート番号</port> <protocol>プロトコル種別</protocol> </soap-reception> <jms-reception> <!-- WebServer Definition--> <ip-address>WebサーバのIPアドレスまたはホスト名</ip-address> <port>Webサーバのポート番号</port> <protocol>プロトコル種別(http or https)</protocol> <rm-service-context-root>RMのサービスコンテキストルート</rm-service-context-root> </jms-reception> <jms-physical-reception> <!-- WebServer Definition--> <ip-address>WebサーバのIPアドレスまたはホスト名</ip-address> <port>Webサーバのポート番号</port> <protocol>プロトコル種別</protocol> <rm-service-context-root>RMのサービスコンテキストルート</rm-service-context-root> </jms-physical-reception> <ejb-reception> <!-- NameServer Definition--> <ip-address>NameServerのIPアドレスまたはホスト名</ip-address> <port>NameServerのポート番号</port> </ejb-reception> </reception> </csc-setup-definition> |
機能
HCSCサーバの構成情報を設定します。
DTD
<!ELEMENT csc-setup-definition (cluster?,cosminexus-manager,reception?)> <!ELEMENT cluster (name?,display-name?,type?)> <!ELEMENT name (#PCDATA)> <!ELEMENT display-name (#PCDATA)> <!ELEMENT type (#PCDATA)> <!ELEMENT cosminexus-manager (name,display-name?,ip-address,port,id,password?,csc-server)> <!ELEMENT ip-address (#PCDATA)> <!ELEMENT port (#PCDATA)> <!ELEMENT id (#PCDATA)> <!ELEMENT password (#PCDATA)> <!ELEMENT csc-server (name?,display-name?,id?,password?,j2ee-server-name,setup-properties)> <!ELEMENT j2ee-server-name (#PCDATA)> <!ELEMENT setup-properties (#PCDATA)> <!ELEMENT reception (soap-reception?,jms-reception?,jms-physical-reception?,ejb-reception?)> <!ELEMENT soap-reception (ip-address?,port,protocol)> <!ELEMENT protocol (#PCDATA)> <!ELEMENT jms-reception (ip-address?,port,protocol,rm-service-context-root?)> <!ELEMENT rm-service-context-root (#PCDATA)> <!ELEMENT jms-physical-reception (ip-address?,port,protocol,rm-service-context-root?)> <!ELEMENT ejb-reception (ip-address?,port)> |
ファイルの格納先
<サービスプラットフォームのインストールディレクトリ>\CSC\config\manager\templates\cscsvsetup.xml
設定できる要素
(1) clusterの定義
clusterタグは省略できます。
name クラスタ名 〜<半角英数字とアンダーバー(_)> ((1−8文字))
クラスタ名を指定します。このタグを設定することで,cscsvsetupコマンドの-clusterを省略できます。
type クラスタ種別 〜<<LB>>
クラスタ種別として,次のどちらかを指定します。ロードバランスクラスタ構成の場合は,省略できます。なお,必ず大文字で指定してください。
(2) cosminexus-managerの定義
name Manager名 〜<半角英数字とアンダーバー(_)> ((1−16文字))
HCSC-ManagerがManagerを認識するためのHCSC-Manager独自の識別名を指定します。HCSC-ManagerでManager(ホスト)単位に一意になる識別名を指定します。
ip-address ManagerのIPアドレスまたはホスト名 〜((1文字以上))
Management Serverが起動しているIPアドレスまたはホスト名を指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。
port Managerのポート番号 〜((1−65535))
Management Serverのリモート管理機能への接続ポート番号を指定します。
com.cosminexus.mngsvr.management.portの値を指定します。指定がない場合は,28099を指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。
id Management Serverの管理ユーザID 〜((1文字以上))
Management Serverの管理ユーザIDを指定します。
password Management Serverの管理ユーザパスワード 〜((1文字以上))
Management Serverの管理ユーザパスワードを指定します。このタグは省略できます。省略した場合,パスワードの指定がないとみなされます。
(3) csc-serverの定義
name HCSCサーバ名 〜<半角英数字とアンダーバー(_)> ((1−8文字))
HCSCサーバ名を指定します。このタグを設定することで,cscsvsetupコマンドの-cscを省略できます。
id HCSCサーバが使用するデータベースのユーザID 〜((1文字以上))
HCSCサーバが使用するデータベースのユーザIDを指定します。文字列の最大値および指定できる文字は,使用するデータベースに依存します。データベースを使用する場合は,必ず設定します。データベースを使用しない場合は,省略できます。
password HCSCサーバが使用するデータベースのパスワード
HCSCサーバが使用するデータベースのパスワードを指定します。文字列の最大値および指定できる文字は,使用するデータベースに依存します。データベースを使用する場合は,必ず設定します。データベースを使用しない場合は,省略できます。
j2ee-server-name HCSCサーバが使用するJ2EEサーバ名 〜((1文字以上))
HCSCサーバをセットアップするJ2EEサーバ名を指定します。J2EEサーバ名は110バイト以内を推奨します。ローカルマシンにIPv6アドレスを使用している環境では,111バイト以上のJ2EEサーバ名を指定すると,プロセスインスタンスの生成でエラーが発生する可能性があります。その場合は,HCSCサーバランタイム定義のshort-processidプロパティにONを指定してください。
setup-properties HCSCサーバセットアップ定義ファイル名
HCSCサーバセットアップ定義ファイル名を相対パス,または絶対パスで指定します。
(4) soap-receptionの定義
同期サービス(Webサービス)呼び出しをする場合に指定します。同期サービス(Webサービス)呼び出しをしない場合は,soap-receptionタグを省略してください。
ip-address WebサーバのIPアドレスまたはホスト名 〜<<Managerと同じIPアドレスまたはホスト名>>
Webサーバが起動しているIPアドレスまたはホスト名を指定します。受付とManagement ServerのIPアドレス(またはホスト名)が同じ場合は,省略できます。2回目以降設定を変えて再セットアップすると,値が上書きされます。
port Webサーバのポート番号 〜((1−65535))
Webサーバの受付ポート番号を指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。
protocol プロトコル種別
Webサーバの受付プロトコルとして,次のどちらかを指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。
(5) jms-receptionの定義
クラスタ種別がHAクラスタで,非同期サービス(MDB(WS-R))呼び出しをする場合に指定します。非同期サービス(MDB(WS-R))呼び出しをしない場合は,jms-receptionタグを省略してください。クラスタ種別がロードバランスクラスタの場合は,値を指定しても無視されます。
ip-address WebサーバのIPアドレスまたはホスト名 〜<<Managerと同じIPアドレスまたはホスト名>>
Webサーバが起動しているIPアドレスまたはホスト名を指定します。受付とManagement ServerのIPアドレス(またはホスト名)が同じ場合は,省略できます。2回目以降設定を変えて再セットアップすると,値が上書きされます。
port Webサーバのポート番号 〜((1−65535))
Webサーバの受付ポート番号を指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。
protocol プロトコル種別
Webサーバの受付プロトコルとして,次のどちらかを指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。
rm-service-context-root RMのサービスコンテキストルート 〜((1文字以上))
Reliable Messagingのサービスコンテキストルート名を指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。
(6) jms-physical-receptionの定義
クラスタ種別がロードバランスクラスタで,非同期サービス(MDB(WS-R))呼び出しをする場合に指定します。非同期サービス(MDB(WS-R))呼び出しをしない場合や,Reliable Messagingを使用しない場合は,jms-physical-receptionタグを省略してください。クラスタ種別がHAクラスタの場合は,値を指定しても無視されます。
ip-address WebサーバのIPアドレスまたはホスト名 〜<<Managerと同じIPアドレスまたはホスト名>>
Webサーバが起動しているIPアドレスまたはホスト名を指定します。受付とManagement ServerのIPアドレス(またはホスト名)が同じ場合は,省略できます。2回目以降設定を変えて再セットアップすると,値が上書きされます。
port Webサーバのポート番号 〜((1−65535))
Webサーバの受付ポート番号を指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。
protocol プロトコル種別
Webサーバの受付プロトコルとして,次のどちらかを指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。
rm-service-context-root RMのサービスコンテキストルート 〜((1文字以上))
Reliable Messagingのサービスコンテキストルート名を指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。
(7) ejb-receptionの定義
SessionBeanを呼び出す場合に指定します。SessionBeanを呼び出さない場合は,ejb-receptionタグを省略してください。
ip-address NameServerのIPアドレスまたはホスト名 〜((1文字以上))<<Managerと同じIPアドレスまたはホスト名>>
ネームサーバが起動しているIPアドレスまたはホスト名を指定します。受付とManagement ServerのIPアドレス(またはホスト名)が同じ場合は,省略できます。2回目以降設定を変えて再セットアップすると,値が上書きされます。
port NameServerのポート番号 〜((1−65535))
ネームサーバの受付ポート番号を指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。
記述例
HCSCサーバ構成定義ファイルの記述例を次に示します。
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE csc-setup-definition SYSTEM "cscsvsetup_1_2.dtd"> <!-- All Rights Reserved. Copyright (C) 2006, Hitachi, Ltd. --> <csc-setup-definition> <cluster> <name>LBクラスタ</name> <type>LB</type> </cluster> <cosminexus-manager> <!-- Cosminexus Manager Definition --> <name>MNG1</name> <ip-address>10.209.114.162</ip-address> <port>28099</port> <id>admin</id> <password>admin</password> <csc-server> <!-- HCSC-Server Definition --> <id>admin</id> <password>admin</password> <j2ee-server-name>LBServer</j2ee-server-name> <setup-properties>cscsvsetup.properties</setup-properties> </csc-server> </cosminexus-manager> <reception> <soap-reception> <!-- WebServer Definition --> <ip-address>10.209.15.197</ip-address> <port>80</port> <protocol>http</protocol> </soap-reception> <jms-physical-reception> <!-- WebServer Definition--> <ip-address>10.209.114.162</ip-address> <port>80</port> <protocol>http</protocol> <rm-service-context-root>uCosminexusRM</rm-service-context-root> </jms-physical-reception> <ejb-reception> <!-- NameServer Definition--> <ip-address>10.209.114.9</ip-address> <port>900</port> </ejb-reception> </reception> </csc-setup-definition> |
使用方法
cscsvsetupコマンドの-propfileオプションの引数にHCSCサーバ構成定義ファイルを指定します。詳細については,マニュアル「サービスプラットフォーム システム構築・運用ガイド」の「3.1.3 HCSCサーバをセットアップする」を参照してください。
All Rights Reserved. Copyright (C) 2012, 2019, Hitachi, Ltd.