5.2.3　定義ディレクトリへ格納する定義ファイルの作成

(a)　作成規則

• 簡易構築定義ファイルのファイル名は，「DefModel.xml」を使用してください。

• Webシステムの属性定義（<web-system>タグの定義）は1回だけ指定してください。

• 負荷分散機の定義（<load-balancer>タグの定義）は指定できません。

• 物理ティアの定義（<tier>タグの定義）は1回だけ指定してください。

  • <tier-type>タグ（物理ティアの種類）には，「combined-tier」，「http-tier」，「j2ee-tier」，または「ctm-tier」を指定してください。

• サービスユニットの定義（<unit>タグの定義）は1回だけ指定してください。

• 物理ティアの定義で<tier-type>タグ（物理ティアの種類）に「ctm-tier」を指定する場合，論理サーバの定義（<define-server>）は，物理ティアの定義で<j2ee-server-count>タグ（1ホストに配置するJ2EEサーバの数）に指定した数分指定してください。この場合，J2EEサーバごとの論理サーバの定義（<define-server>）では次のタグを必ず指定してください。

  • <logical-server-name>タグ（論理サーバを識別するための名称）

  • <logical-server-type>タグ（論理サーバの種類）

  • <server-no>タグ（J2EEサーバを識別するための番号）

• ホストの定義（<host>タグの定義）は1回だけ指定してください。

  • <host-name>タグ（ホストを識別するための名称）には，「localhost」を指定してください。

  • <agent-host>タグ（運用管理エージェントのホスト名）には，「localhost」を指定してください。

(b)　簡易構築定義ファイルで指定できる置換文字列

複数のティアを管理している管理ユニットで，ティア間の関連づけをする場合に，関連元のティアの簡易構築定義ファイルでは，関連先のティアで使用される仮想サーバに関する情報を置換文字列で記述できます。置換文字列で記述できる仮想サーバに関する情報を次に示します。

• 仮想サーバ識別子

• 仮想サーバの業務用IPアドレス

• 仮想サーバのサーバ通信エージェントのポート番号

これらの情報を置換文字列で記述した場合，仮想サーバグループ情報ファイルから読み込まれます。

置換文字列の記述形式，記述内容および記述例を次に示します。

記述形式

###<ティア識別子>:<パラメタ>###

記述内容

<ティア識別子>

関連先のティアのティア識別子を指定します。

<パラメタ>

仮想サーバグループ情報ファイルの指定値と置き換えるパラメタを指定します。

• ip

  仮想サーバグループ情報ファイルで指定している，仮想サーバ識別子と置き換えます。

• serviceip

  仮想サーバグループ情報ファイルで指定している，仮想サーバの業務用IPアドレスと置き換えます。

• port

  仮想サーバグループ情報ファイルで指定している，仮想サーバのサーバ通信エージェントのポート番号と置き換えます。

記述例

http-tierとj2ee-tier構成の場合に，関連元（http-tier）の簡易構築定義ファイルで，関連先（j2ee-tier）の仮想サーバの業務用IPアドレス（serviceip）を置換文字列で設定する例を次に示します。

http-tierの簡易構築定義ファイルの例

：
<tier>
  <tier-type>http-tier</tier-type>
  <configuration>
    <logical-server-type>web-server</logical-server-type>
    <param>
      <param-name>AppendDirectives</param-name>
      <param-value>
        <![CDATA[
          ProxyPass / http://###j2ee-tier-01:serviceip###:8008/
          HWSProxyPassReverseCookie /
        ]]>
      </param-value>
    </param>
：

仮想サーバグループ情報ファイルの例

：
<group name="set_001">
  <virtualserver tier="http-tier" ip="111.111.111.101" port="20580" serviceip="111.111.155.101"/>
  <virtualserver tier="j2ee-tier-01" ip="111.111.222.101" port="20580" serviceip="111.111.166.101"/>
</group>
<group name="set_002">
  <virtualserver tier="http-tier" ip="111.111.111.102" port="20580" serviceip="111.111.155.102"/>
  <virtualserver tier="j2ee-tier-01" ip="111.111.222.102" port="20580" serviceip="111.111.166.102"/>
</group>
：

この例では，簡易構築定義ファイルの「###j2ee-tier-01:serviceip###」は，仮想サーバグループ「set_001」の場合は「111.111.166.101」に，仮想サーバグループ「set_002」の場合は「111.111.166.102」に置き換えられます。

(c)　注意事項

• ゲストOSがWindowsの場合に，JP1連携を自動設定するフックスクリプトでテンプレートを使用し，かつJP1/Baseのログファイルトラップを有効にしているとき，J2EEサーバとHTTP Serverのログの出力先は，簡易構築定義ファイルおよびフックスクリプトで同じ値を設定し，かつデフォルト値以外を設定してください。詳細は，「7.7.2(3)　注意事項」を参照してください。

• http-tierとj2ee-tier構成の場合，各ティアの簡易構築定義ファイルでは，次の点に注意して設定してください。

  • http-tierの簡易構築定義ファイルの場合

    http-tierとj2ee-tierを関連づけるために，論理Webサーバ（web-server）の<configuration>タグ内に次の表に示すパラメタを指定します。

    表5‒2　http-tierの簡易構築定義ファイルに指定するパラメタ

    パラメタ	説明	指定例	j2ee-tierの簡易構築定義ファイルとの対応
    AppendDirectives	追加するディレクティブとして，転送先URLにj2ee-tierのIPアドレスを指定したProxyPassディレクティブと，HWSProxyPassReverseCookieディレクティブを指定します。 param-valueの値はCDATAセクションで指定してください。	<![CDATA[ ProxyPass / http://###j2ee-tier-01:serviceip###:8008/ HWSProxyPassReverseCookie / ]]>	ProxyPassに指定する転送先URLのポート番号は，論理J2EEサーバ（j2ee-server）の<configuration>タグ内のwebserver.connector.nio_http.portパラメタの指定値に対応

    注　運用管理ポータルの「論理サーバの環境設定」で，論理Webサーバの定義の次に示す画面は操作しないでください。

    • ［リバースプロキシの設定］画面