HCSCサーバ構成定義ファイル

形式

<?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>Cosminexus manager名</name>
   <ip-address>Cosminexus managerのIPアドレス</ip-address>
   <port>Cosminexus 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>
     <rm-service-name>RMのサービス名</rm-service-name>
   </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>
     <rm-service-name>RMのサービス名</rm-service-name>
   </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,rm-service-name?)>
<!ELEMENT rm-service-context-root (#PCDATA)>
<!ELEMENT rm-service-name (#PCDATA)>
<!ELEMENT jms-physical-reception (ip-address?,port,protocol,rm-service-context-root,rm-service-name?)>
<!ELEMENT ejb-reception (ip-address?,port)>

ファイルの格納先

<Cosminexusのインストールディレクトリ>¥CSC¥config¥manager¥templates¥cscsvsetup.xml

設定できる要素

(1) clusterの定義

clusterタグは省略できます。

name クラスタ名 ~<半角英数字とアンダーライン(_)> ((1-8文字))

クラスタ名を指定します。このタグを設定することで,cscsvsetupコマンドの-clusterを省略できます。

type クラスタ種別 ~<<LB>>

クラスタ種別として,次のどちらかを指定します。ロードバランスクラスタ構成の場合は,省略できます。なお,必ず大文字で指定してください。

(2) cosminexus-managerの定義

name Cosminexus manager名 ~<半角英数字とアンダーライン(_)> ((1-16文字))

HCSC-ManagerがCosminexus Managerを認識するためのHCSC-Manager独自の識別名を指定します。HCSC-ManagerでCosminexus Manager(ホスト)単位に一意になる識別名を指定します。

ip-address Cosminexus managerのIPアドレス ~((1文字以上))

Management Serverが起動しているIPアドレスを指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。

port Cosminexus managerのポート番号 ~((1-65535))

Cosminexus Managerのリモート管理機能への接続ポート番号を指定します。

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サーバ名を指定します。

setup-properties HCSCサーバセットアップ定義ファイル名

HCSCサーバセットアップ定義ファイル名を相対パス,または絶対パスで指定します。

(4) soap-receptionの定義

同期サービス(Webサービス)呼び出しをする場合に指定します。同期サービス(Webサービス)呼び出しをしない場合は,soap-receptionタグを省略してください。

ip-address WebサーバのIPアドレス ~<<Cosminexus managerと同じIPアドレス>>

Webサーバが起動しているIPアドレスを指定します。受付の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アドレス ~<<Cosminexus managerと同じIPアドレス>>

Webサーバが起動しているIPアドレスを指定します。受付のIPアドレスとManagement ServerのIPアドレスが同じ場合は,省略できます。2回目以降設定を変えて再セットアップすると,値が上書きされます。

port Webサーバのポート番号 ~((1-65535))

Webサーバの受付ポート番号を指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。

protocol プロトコル種別

Webサーバの受付プロトコルとして,次のどちらかを指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。

rm-service-context-root RMのサービスコンテキストルート ~((1文字以上))

Cosminexus RMのサービスコンテキストルート名を指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。

rm-service-name RMのサービス名 ~((1文字以上))<<services/HRMReceiver>>

Cosminexus RMのサービス名として,services/HRMReceiverを指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。

(6) jms-physical-receptionの定義

クラスタ種別がロードバランスクラスタで,非同期サービス(MDB(WS-R))呼び出しをする場合に指定します。非同期サービス(MDB(WS-R))呼び出しをしない場合は,jms-physical-receptionタグを省略してください。クラスタ種別がHAクラスタの場合は,値を指定しても無視されます。

ip-address WebサーバのIPアドレス ~<<Cosminexus managerと同じIPアドレス>>

Webサーバが起動しているIPアドレスを指定します。受付のIPアドレスとManagement ServerのIPアドレスが同じ場合は,省略できます。2回目以降設定を変えて再セットアップすると,値が上書きされます。

port Webサーバのポート番号 ~((1-65535))

Webサーバの受付ポート番号を指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。

protocol プロトコル種別

Webサーバの受付プロトコルとして,次のどちらかを指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。

rm-service-context-root RMのサービスコンテキストルート ~((1文字以上))

Cosminexus RMのサービスコンテキストルート名を指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。

rm-service-name RMのサービス名 ~((1文字以上))<<services/HRMReceiver>>

Cosminexus RMのサービス名として,services/HRMReceiverを指定します。2回目以降設定を変えて再セットアップすると,値が上書きされます。

(7) ejb-receptionの定義

SessionBeanを呼び出す場合に指定します。SessionBeanを呼び出さない場合は,ejb-receptionタグを省略してください。

ip-address NameServerのIPアドレス ~((1文字以上))<<Cosminexus managerと同じIPアドレス>>

ネームサーバが起動しているIPアドレスを指定します。受付のIPアドレスとManagement ServerIPアドレスが同じ場合は,省略できます。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サーバをセットアップする」を参照してください。