Cosminexus アプリケーションサーバ V8 仮想化システム構築・運用ガイド

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

6.4 アプリケーションサーバ情報ディレクトリへの定義ファイルの配置

アプリケーションサーバを定義する各ファイルを作成したあと,アプリケーションとともにアプリケーションサーバ情報ディレクトリに配置します。ここで説明する作業は,すべてのシステム構成パターンで実施します。

仮想化システムで動作できるアプリケーションは,J2EEアプリケーションです。ここで説明するJ2EEアプリケーションは作成済みであることを前提としています。また,cosminexus.xmlがあるアプリケーションであることを前提としています。J2EEアプリケーションは,アプリケーション開発時に作成しておいてください。アプリケーションの作成については,マニュアル「Cosminexus アプリケーションサーバ アプリケーション開発ガイド」を参照してください。

アプリケーションサーバ情報ディレクトリは,仮想サーバ運用管理ホストの任意の場所に作成します。このファイルのパスは管理ユニット作成時に指定します。図6-1に示す構成に従って,必要なアプリケーションや定義ファイルを配置します。

各定義ファイルのアプリケーションサーバ情報ディレクトリへの配置手順を次に示します。

  1. 6.2.2(5) 定義ファイルの取得」で取得した定義ファイルのテンプレートを配置します。
  2. 6.3 アプリケーションサーバで使用する定義ファイルの作成」で作成した定義ファイルを上書きまたは配置します。
  3. アプリケーションのEARファイルとcosminexus.xmlを配置します。

アプリケーションサーバ情報ディレクトリの構成を次の図に示します。

図6-1 アプリケーションサーバ情報ディレクトリの構成

 
<アプリケーションサーバ情報ディレクトリ>
  ├vmx
  │└virtualserver.properties
  ├app
  │ ├<app名1>.ear
  │ :
  │ └<app名n>.ear
  └config
    └Cosminexus
       ├<app名1>
       │ └META-INF
       │   └cosminexus.xml
       :
       ├<app名n>
       │ └META-INF
       │   └cosminexus.xml
       ├CC
       │ └admin
       │   └usrconf
       │     ├usrconf.bat
       │     ├usrconf
       │     └usrconf.properties
       ├manager
       │ └config
       │   ├adminagent.properties
       │   ├cmxclient.properties
       │   ├manager.cfg
       │   ├mngsvrutilcl.properties
       │   ├mserver.properties
       │   ├lb.properties
       │   ├vmxlog.conf
       │   └AdminAgentrc
       ├WebFront.xml
       ├DB_Connector_for_Oracle.xml
       ├DB_Connector_for_HiRDB_Type4.xml
       ├DB_Connector_for_SQLServer2005.xml
       ├rasetup.properties
       └version.properties
 

(凡例)
app名:アプリケーション名

注※
使用するデータベースに対応するファイルを指定します。

アプリケーションサーバ情報ディレクトリを構成する各ファイルの詳細を次の表に示します。

表6-17 アプリケーションサーバ情報ディレクトリを構成する各ファイルの詳細

ディレクトリまたはファイル 設定の要否 説明
vmx virtualserver.properties 必須 仮想サーバ構築用プロパティファイルです。
このファイルがない場合は,管理ユニット作成時にエラーメッセージを出力して,異常終了します。
app <app名>.ear 任意 アプリケーションファイルです。アプリケーションの数分配置します。
config※1 Cosminexus <app名> META-INF cosminexus.xml 任意 Cosminexusアプリケーション属性ファイルです。アプリケーションごとに必ず配置します。
CC admin usrconf usrconf.bat※2 必須 サーバ管理コマンド用オプション定義ファイルです。Windowsの場合に指定するファイルです。
usrconf※2 必須 サーバ管理コマンド用オプション定義ファイルです。Linuxの場合に指定するファイルです。
usrconf.properties※2 必須 J2EEサーバ用ユーザプロパティファイルです。
manager config adminagent.properties※2 必須 運用管理エージェントプロパティファイルです。
cmxclient.properties※2 必須 クライアント共通設定プロパティファイルです。
manager.cfg※2 必須 Manager設定ファイルです。
mngsvrutilcl.properties※2 必須 mngsvrutilコマンドのクライアント側共通定義ファイルです。
mserver.properties※2 必須 Management Server環境設定ファイルです。
lb.properties※2 任意 負荷分散機定義プロパティファイルです。負荷分散機を使用する場合に必要なファイルです。
vmxlog.conf※2 任意 仮想サーバのアプリケーションサーバログ収集対象設定ファイルです。仮想サーバ停止時のログを収集する場合には必ず指定します。このファイルがない場合は,仮想サーバ停止時のログは収集されません。
AdminAgentrc※2 必須 運用管理エージェント自動起動用設定ファイルです。Linuxの場合に指定するファイルです。
WebFront.xml 必須 簡易構築定義ファイルです。
このファイルがない場合は,管理ユニット作成時にエラーメッセージを出力して,異常終了します。
DB_Connector_for_Oracle.xml 必須 DB ConnectorのConnector属性ファイルです。データベース(Oracle,HiRDB,SQL Server)を使用する場合に必要なファイルです。
データベースを使用する場合は,対応するデータベースのファイルを指定します。これらのファイルを複数指定した場合は,管理ユニット作成時にエラーメッセージを出力して,異常終了します。
DB_Connector_for_HiRDB_Type4.xml
DB_Connector_for_SQLServer2005.xml
rasetup.properties 必須 Component Container管理者およびManagement Server管理グループを設定するファイルです。Linuxの場合に指定するファイルです。このファイルは必ず指定します。
Linuxの場合に,このファイルがないときは,管理ユニット作成時にエラーメッセージを出力して,異常終了します。
なお,Windowsの場合にこのファイルが指定されても無視されます。
version.properties 必須 インタフェースバージョン定義ファイルです。

(凡例)
app名:アプリケーション名

各ファイルの詳細については,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」またはマニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」を参照してください。

注※1
configディレクトリ以下に指定するファイルが使用する文字エンコーディングや改行コードは,マスタ仮想サーバのアプリケーションサーバで使用できる必要があります。マスタ仮想サーバにインストールしたApplication Server Enterpriseからファイルをコピーする場合や,ファイルを編集する場合には,注意してください。

注※2
CCディレクトリ,およびmanagerディレクトリ内のファイルは,マスタ仮想サーバにインストールしたApplication Server Enterpriseからコピーして配置し,必要に応じてファイルの内容を変更してください。