Cosminexus V9 BPM/ESB基盤 サービスプラットフォーム リファレンス

[目次][用語][索引][前へ][次へ]

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>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サーバをセットアップする」を参照してください。