Cosminexus アプリケーションサーバ V8 リファレンス 定義編(サーバ定義)
簡易構築定義ファイルの指定内容で説明する項目と,その項目の意味を記します。
項目名 | 説明 |
---|---|
タグ名 | 設定するタグを示します。 |
出現パターン | タグが出現する回数を示します。 |
内容 | キーに定義する内容を示します。 |
指定可能値 | タグに指定できる値を示します。指定できる値がない場合はハイフン「−」を示します。 |
タグの省略 | 定義形式で示すキーが省略できるかどうかを示します。 |
値の省略 | 定義形式で示すキーの値が省略されるかどうかを示します。 |
デフォルト | キーに指定する内容が省略されている場合に有効になる指定値を示します。デフォルト値がない場合は「なし」を示します。 |
バージョン | 定義できるアプリケーションサーバのバージョンを示します。 |
タグの省略,値の省略および内容の詳細については,4.6.3以降の簡易構築定義ファイルの各定義の詳細を参照してください。
簡易構築定義ファイルについて,次の表に示します。
タグ名 | 出現パターン | 内容 | 指定可能値 | 省略値 | VR | ||||||
---|---|---|---|---|---|---|---|---|---|---|---|
<web-system> | 0回以上 | Webシステムを定義します。 複数のWebシステムを定義する場合は,<web-system>タグを複数指定します。 |
− | なし | 07-00 | ||||||
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<name> | 1回 | 必須定義。 Webシステムを識別するための名称を指定します。 |
英数字または,アンダースコア「_」およびハイフン「-」で指定した32文字以内の文字列を指定します。 | なし | 06-50 | |||||
┣ ┃ ┃ ┃ ┃ ┃ ┃ |
<display-name> | 0または1回 | Webシステムの表示名を指定します。 指定する文字に制限はありません。 |
128文字以内の任意の文字列を指定します。 | なし | 06-50 | |||||
┣ ┃ ┃ ┃ ┃ ┃ |
<description> | 0または1回 | Webシステムのコメントを指定します。 指定する文字に制限はありません。 |
1024文字以内の任意の文字列を指定します。 | なし | 06-50 | |||||
┣ ┃ ┃ ┃ ┃ ┃ |
<load-balancer> | 0または1回 | 負荷分散機を定義します。 | − | なし | 06-50 | |||||
┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<name> | 0または1回 | 負荷分散機の名称を指定します。 | 英数字または,アンダースコア「_」およびハイフン「-」で指定した32文字以内の文字列を指定します。 | なし | 06-50 | ||||
┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<load-balancer-type> | 1回 | 負荷分散機の種類を指定します。 | 指定できる文字列を次に示します。
|
なし | 06-50 | ||||
┃ ┃ ┃ ┃ ┃ ┃ |
┣ ┃ ┃ ┃ ┃ ┃ |
<display-name> | 0または1回 | 負荷分散機の表示名を指定します。 指定する文字に制限はありません。 |
128文字以内の任意の文字列を指定します。 | なし | 06-50 | ||||
┃ ┃ ┃ ┃ ┃ ┃ |
┣ ┃ ┃ ┃ ┃ ┃ |
<description> | 0または1回 | 負荷分散機のコメントを指定します。 指定する文字に制限はありません。 |
1024文字以内の任意の文字列を指定します。 | なし | 06-50 | ||||
┃ ┃ ┃ ┃ ┃ ┃ |
┣ ┃ ┃ ┃ ┃ ┃ |
<cookie-switching> | 0または1回 | 負荷分散機のCookieスイッチング機能を使用する場合に指定します。 | − | なし | 06-51 | ||||
┃ ┃ ┃ ┃ ┃ ┃ |
┃ ┃ ┃ ┃ ┃ ┃ |
┣ ┃ ┃ ┃ ┃ ┃ |
<cookie-switching-enabled> | 0または1回 | Cookieスイッチング機能を使用する場合に指定します。 | 指定できる文字列を次に示します。
|
false | 06-51 | |||
┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<cookie-name> | 0または1回 | cookieの名称を英数字またはアンダースコア「_」で指定します。 ただし,次の名前はWebコンテナが使用するため,大文字・小文字の区別なく使用できません。
|
|
CMX_SERVER_ID | 06-51 | |||
┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
┗ | <server-id-rule> | 0または1回 | 08-53以降は,このタグに値を指定しないでください。値を指定した場合,指定した値は無効になります。 | − | なし | 06-51 | |||
┃┃ ┃ ┃ ┃ ┃ ┃ ┃ |
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<management-host> | 1回 | 負荷分散機に設定した管理IPアドレスまたはホスト名を指定します。 | 指定できる文字列を次に示します。
|
なし | 07-50 | ||||
┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<redundant-management-host> | 1回 | 負荷分散機を冗長化したシステムの場合に,2台目の負荷分散機に設定した管理IPアドレスまたはホスト名を指定します。 | 指定できる文字列を次に示します。
|
なし | 07-50 | ||||
┃ ┃ |
┗ | <virtual-server> | 1回 | 仮想サーバを定義します。 | − | なし | 06-50 | ||||
┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<virtual-server-name> | 1回 | 仮想サーバ名を指定します。 複数のWebシステムで負荷分散機を共有する場合は,共有するWebシステムで仮想サーバ名が重複しないように指定してください。 |
英数字またはアンダースコア「_」,ピリオド「.」およびハイフン「-」で指定した31文字以内の文字列を指定します。 | なし | 06-50 | ||||
┃ ┃ ┃ ┃ ┃ ┃ |
┣ ┃ ┃ ┃ ┃ ┃ |
<display-name> | 0または1回 | 仮想サーバの表示名を指定します。 | 128文字以内の任意の文字列を指定します。 | なし | 06-50 | ||||
┃ ┃ ┃ ┃ ┃ ┃ |
┣ ┃ ┃ ┃ ┃ ┃ |
<description> | 0または1回 | 仮想サーバのコメントを指定します。 | 1024文字以内の任意の文字列を指定します。 | なし | 06-50 | ||||
┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<ip-address> | 1回 | 仮想サーバのIPアドレスを指定します。 複数のWebシステムで負荷分散機を共有する場合は,共有するWebシステムで仮想サーバのIPアドレスが重複しないように指定してください。 |
指定できる文字列を次に示します。
|
なし | 06-50 | ||||
┃ ┃ ┃ ┃ |
┗ | <http-port> | 1回 | 仮想サーバのhttpポート番号を1〜65535の間で指定します。 | 1〜65535の整数を指定します。 | なし | 06-50 | ||||
┣ ┃ ┃ ┃ |
<tier> | 1回以上 | 必須定義。 物理ティアを定義します。 |
− | なし | 06-50 | |||||
┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<tier-type> | 1回 | 必須定義。 物理ティアの種類を指定します。 |
指定できる文字列を次に示します。
|
なし | 06-50 | ||||
┃ ┃ ┃ ┃ ┃ ┃ |
┣ ┃ ┃ ┃ ┃ ┃ |
<j2ee-server-count> | 0または1回 | <tier-type>タグでctm-tierを指定した場合に,1ホストに配置するJ2EEサーバの数を指定します。 | 0〜32の整数を指定します。 | 1 | 07-10 | ||||
┃ ┃ ┃ ┃ ┃ ┃ |
┗ | <configuration> | 0回以上 | 物理ティアに属するすべての論理サーバに適用するコンフィグレーションを,論理サーバの種類ごとに定義します。 | − | なし | 06-50 | ||||
┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<logical-server-type> | 1回 | 必須定義。 コンフィグレーションを定義する論理サーバの種類を指定します。 |
指定できる文字列を次に示します。
|
なし | 06-50 | ||||
┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<server-no> | 0または1回 | 物理ティア内の特定のJ2EEサーバで,共通のコンフィグレーションを指定する場合に,J2EEサーバを識別するための番号を指定します。 物理ティア内で番号が重複しないように指定してください。 |
1〜<j2ee-server-count>の指定値 | なし | 07-10 | ||||
┃ ┃ ┃ ┃ ┃ |
┗ | <param> | 1回以上 | 必須定義。 論理サーバの環境を設定するパラメタを,パラメタ名と値で定義します。 |
− | なし | 06-50 | ||||
┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<param-name> | 1回 | パラメタ名を指定します。 | 指定できる値については「4.11 システムの構成パターンと定義する論理サーバ」の説明を参照してください。 | なし | 06-50 | ||||
┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
┗ | <param-value> | 1回以上 | パラメタの設定値を指定します。 | 指定できる値については「4.11 システムの構成パターンと定義する論理サーバ」の説明を参照してください。 | なし | 06-50 | ||||
┗ | <unit> | 1回以上 | 必須定義。 サービスユニットを定義します。 |
− | なし | 06-50 | |||||
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<name> | 1回 | 必須定義。 サービスユニットを識別するための名称を指定します。 |
英数字またはアンダースコア「_」,およびハイフン「-」で指定した32文字以内の文字列を指定します。 | なし | 06-50 | |||||
┣ ┃ ┃ ┃ ┃ ┃ |
<display-name> | 0または1回 | サービスユニットの表示名を指定します。指定する文字に制限はありません。 | 128文字以内の任意の文字列を指定します。 | なし | 06-50 | |||||
┣ ┃ ┃ ┃ ┃ ┃ |
<description> | 0または1回 | サービスユニットのコメントを指定します。指定する文字に制限はありません。 | 1024文字以内の任意の文字列を指定します。 | なし | 06-50 | |||||
┗ | <allocated-host> | 1回以上 | 必須定義。 サービスユニットを構成するホストのリファレンスを定義します。 |
− | なし | 06-50 | |||||
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<host-ref> | 1回 | 必須定義。 ホスト定義の<name>タグに指定したホスト名,構築済みのWebシステムで定義されているホスト名,または@myhostを指定します。 |
指定できる値を次に示します。
|
なし | 06-50 | |||||
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<hosts-for> | 1回 | 必須定義。 <host-ref>タグで指定したホストが属する物理ティアの種類を指定します。 |
指定できる文字列を次に示します。
|
なし | 06-50 | |||||
┗ | <define-server> | 0回以上 | <hosts-for>タグで指定した物理ティアに属する論理サーバごとに,コンフィグレーションを定義します。 | − | なし | 07-00 | |||||
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<logical-server-name> | 0または1回 | 論理サーバまたはクラスタを識別するための名称を指定します。 | 英数字またはアンダースコア「_」,およびハイフン「-」で指定した128文字以内の文字列を指定します。 | cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番> | 07-00 | |||||
┣ ┃ ┃ ┃ ┃ ┃ |
<display-name> | 0または1回 | 論理サーバの表示名を指定します。指定する文字に制限はありません。 | 128文字以内の任意の文字列を指定します。 | なし | 07-00 | |||||
┣ ┃ ┃ ┃ ┃ ┃ |
<description> | 0または1回 | 論理サーバのコメントを指定します。指定する文字に制限はありません。 | 1024文字以内の任意の文字列を指定します。 | なし | 07-00 | |||||
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<logical-server-type> | 1回 | 必須定義。 コンフィグレーションを定義する論理サーバの種類を指定します。 |
指定できる文字列を次に示します。
|
なし | 07-00 | |||||
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<cluster-ref> | 0または1回 | 論理サーバをクラスタのメンバにする場合に,クラスタ名を指定します。 | 英数字またはアンダースコア「_」,およびハイフン「-」で指定した128文字以内の文字列を指定します。 | なし | 07-50 | |||||
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<server-no> | 0または1回 | サービスユニット内の特定のJ2EEサーバのコンフィグレーションを指定する場合に,J2EEサーバを識別するための番号を指定します。1ホスト内で番号が重複しないように指定してください。 | 1〜<j2ee-server-count>の指定値 | なし | 07-10 | |||||
┗ | <configuration> | 0または1回 | 論理サーバごとに適用するコンフィグレーションを定義します。 | − | なし | 07-00 | |||||
┗ | <param> | 1回以上 | 必須定義。 論理サーバの環境を設定するパラメタを,パラメタ名と値で定義します。 |
− | なし | 07-00 | |||||
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<param-name> | 1回 | パラメタ名を指定します。 | 指定できる値については「4.11 システムの構成パターンと定義する論理サーバ」の説明を参照してください。 | なし | 07-00 | |||||
┗ | <param-value> | 1回以上 | パラメタの設定値を指定します。 | 指定できる値については「4.11 システムの構成パターンと定義する論理サーバ」の説明を参照してください。 | なし | 07-00 | |||||
<host> | 0回以上 | ホストを定義します。 | − | なし | 06-50 | ||||||
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<host-name> | 1回 | ホストを識別するための名称またはIPアドレスを指定します。 | 指定できる文字列を次に示します。
|
なし | 07-50 | |||||
┣ ┃ ┃ ┃ ┃ ┃ |
<display-name> | 0または1回 | ホストの表示名を指定します。指定する文字に制限はありません。 | 128文字以内の任意の文字列を指定します。 | なし | 06-50 | |||||
┣ ┃ ┃ ┃ ┃ ┃ |
<description> | 0または1回 | ホストのコメントを1,024文字以下で指定します。指定する文字に制限はありません。 | 1024文字以内の任意の文字列を指定します。 | なし | 06-50 | |||||
┣ ┃ ┃ ┃ ┃ ┃ ┃ ┃ |
<agent-host> | 0または1回 | Cosminexus運用管理エージェントのホスト名,IPアドレスまたは@myhostを指定します。 | 指定できる文字列を次に示します。
|
host-nameで指定した値 | 07-50 | |||||
┗ | <agent-port> | 0または1回 | Cosminexus運用管理エージェントのポート番号を指定します。 | 1〜65535の整数を指定します。 | 20295 | 06-50 |
All Rights Reserved. Copyright (C) 2008, 2011, Hitachi, Ltd.