5.2.4 管理ユニットへの定義ディレクトリの取り込み

5.2.3 定義ディレクトリへ格納する定義ファイルの作成」で作成した定義ファイルを定義ディレクトリに正しい構成で配置し,管理ユニットに取り込みます。

ポイント
作業を実施するユーザ:システム構築者

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

<この項の構成>
(1) 定義ファイルとアプリケーションの配置
(2) 管理ユニットへの取り込み

(1) 定義ファイルとアプリケーションの配置

定義ディレクトリを仮想化システム管理用サーバマシンの任意の場所に作成します。

定義ディレクトリの構成を次の図に示します。

図5-1 定義ディレクトリの構成

<定義ディレクトリ>
 ├vmi
 │ ├unit.properties
 │ └unitlb.properties
 ├hook
 │ ├pre-setup.bat※1
 │ └pre-setup※1
 ├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※1
      │     ├usrconf※1
      │     └usrconf.properties
      ├manager
      │ └config
      │   ├adminagent.properties
      │   ├cmxclient.properties
      │   ├manager.cfg
      │   ├mngsvrutilcl.properties
      │   ├mserver.properties
      │   └AdminAgentrc
      ├WebFront.xml
      ├DB_Connector_for_Oracle.xml※2
      ├DB_Connector_for_HiRDB_Type4.xml※2
      ├DB_Connector_for_SQLServer2005.xml※2
      ├rasetup.properties
      └version.properties

(凡例)
app名:アプリケーション名
注※1
ゲストOSに対応するファイルを指定します。
注※2
使用するデータベースに対応するファイルを指定します。

定義ディレクトリを構成する各ファイルの詳細を次の表に示します。各ファイルの作成方法については,「5.2.3 定義ディレクトリへ格納する定義ファイルの作成」を参照してください。

表5-5 定義ディレクトリを構成する各ファイルの詳細

ディレクトリまたはファイル設定の要否※1説明
vmiunit.properties必須管理ユニットプロパティファイルです。
unitlb.properties任意管理ユニットごとの負荷分散機接続設定プロパティファイルです。
hookpre-setup.bat任意フックスクリプトファイルです。Windowsの場合に指定するファイルです。
pre-setup任意フックスクリプトファイルです。Linuxの場合に指定するファイルです。
app<app名>.ear任意アプリケーションファイルです。アプリケーションの数分配置します。
config※2Cosminexus<app名>META-INFcosminexus.xml任意Cosminexusアプリケーション属性ファイルです。アプリケーションごとに必ず配置します。
CCadminusrconfusrconf.bat必須サーバ管理コマンド用オプション定義ファイルです。Windowsの場合に指定するファイルです。
usrconf必須サーバ管理コマンド用オプション定義ファイルです。Linuxの場合に指定するファイルです。
usrconf.properties必須サーバ管理コマンド用システムプロパティファイルです。
managerconfigadminagent.properties必須運用管理エージェントプロパティファイルです。
cmxclient.properties必須Smart Composer機能で使用するコマンドのクライアント共通設定プロパティファイルです。
manager.cfg必須Manager設定ファイルです。
mngsvrutilcl.properties必須mngsvrutilコマンドのクライアント側共通定義ファイルです。
mserver.properties必須Management Server環境設定ファイルです。
AdminAgentrc必須運用管理エージェント自動起動用設定ファイルです。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の場合に必ず指定します。なお,Windowsの場合にこのファイルを指定しても無視されます。
version.properties必須インタフェースバージョン定義ファイルです。
注※1
設定の要否が「必須」のファイルがない場合は,定義ディレクトリの取り込み,または登録済み定義ディレクトリとの比較時にエラーとなります。また,ここで説明していないファイルやディレクトリを設定した場合,それらは無視されます。無視されたファイルは,警告メッセージで通知されます。
注※2
configディレクトリ以下に指定するファイルが使用する文字エンコーディングや改行コードは,仮想サーバのアプリケーションサーバで使用できる必要があります。仮想サーバにインストールしたApplication Server Enterpriseから,ファイルをコピーする場合やファイルを編集する場合には,注意してください。

(2) 管理ユニットへの取り込み

「(1) 定義ファイルとアプリケーションの配置」で任意の場所に作成した定義ディレクトリを管理ユニットへ取り込みます。

  1. 管理用端末マシンから仮想化システム管理用サーバマシンにリモート接続します。
  2. vmiunitコマンドのサブコマンド「import」を使用して,指定したパスにある定義ディレクトリを管理ユニットへ取り込みます。
    ここでは,管理ユニット「gyoumu_a」に定義ディレクトリ「<任意のディレクトリ>」を取り込む場合のコマンドの実行例を示します。

    vmiunit import -unit gyoumu_a -dir <任意のディレクトリ>