Plain Agent の使用例

     前  次    新しいウィンドウで目次を開く     
ここから内容の開始

WLOC リソース環境のコンフィグレーション

WLOC 環境では、リソース プールによって WLOC サービスをデプロイできる仮想環境が提供されます。各リソース プールでは、物理的コンピューティング リソース (CPU サイクル、メモリ、ディスク領域など) およびサービスが実行する必要のあるあらかじめインストールされたソフトウェアへのアクセスが提供されます。

WLOC リソース環境を確立するには、コントローラおよび 1 つまたは複数のエージェントをコンフィグレーションする必要があります。これを行うには、WLOC Configuration Wizard を使用します。エージェントのコンフィグレーションでは、リソース プールをコンフィグレーションします。Plain Agent では、エージェントがインストールされている物理マシンのコンピューティング リソースが管理されます。

コントローラのコンフィグレーションでは、リソースに関する情報を取得し、必要に応じてサービスをデプロイできるよう、コントローラをエージェントにバインドします。

また、WLOC 環境へのグラフィカルなインタフェースを提供する WLOC Administration Console もコントローラでホストされます。

この例では、Plain Agent とコントローラを同一のローカル Windows マシンにインストールおよび作成します。UNIX または Linux プラットフォームでの WLOC のインストールおよび Configuration Wizard の開始に関する手順については、以下を参照してください。

このトピックの主な手順には、以下が含まれています。

 

手順 1 : WLOC のインストール

この例では、Plain Agent とコントローラを同一のローカル Windows マシンにインストールします。完全なインストールを実行した場合は、すべての WLOC コンポーネントが自動的にインストールされています。WLOC のインストールの詳細については、WLOC インストール ガイドを参照してください。

Plain Agent が異なるマシンのリソースを管理している場合は、エージェント ソフトウェアを必ずそのマシンにインストールしてください。

この例では、WLOC を C:\WLOC_UseCase ディレクトリにインストールします。

エージェントおよびコントローラ ソフトウェアをインストールした後、WLOC Configuration Wizard を使用してそれらを作成します。

 

手順 2 : Plain Agent の作成

Plain Agent を作成するには、以下の手順を完了します。

  1. [スタート] メニューから、[スタート｜すべてのプログラム｜WebLogic Operations Control 10gR3｜WLOC Configuration Wizard] を選択します。



  2. [Welcome] ウィンドウで、[Next] をクリックします。
  3. [Choose Controller or Agent] ウィンドウで、[Create a new Agent for this host] を選択し、[Next] をクリックします。



  4. [Enter Agent Directory Location] ウィンドウでエージェントのディレクトリへのパスを指定し、[Next] をクリックします。

    5. デフォルトでは、このディレクトリは BEA_HOME\user_projects\agent1 に作成されますが、任意の名前およびディレクトリの場所を指定できます。

    WLOC ソフトウェアのインストール時に BEA_HOME ディレクトリとして C:\WLOC_UseCase を使用したため、その BEA_HOME の値がデフォルトで表示されます。

    この例では、デフォルトの場所 C:\WLOC_UseCase\user_projects を使用し、ディレクトリ名を PlainAgent に変更します。



  5. [Configure Agent Connection Details] ウィンドウで、表 2-1 に示す Plain Agent の接続情報を指定します。
    6. 注意 : この例では、エージェントとコントローラ間で SSL を使用する必要がないため、[Security mode] フィールドの [Secure] 設定を選択する必要はありません。ただし、プロダクション環境の場合は、セキュアな設定を使用し、パスワードとパスフレーズを適宜設定する必要があります。セキュアな通信の詳細については、『コンフィグレーション ガイド』の「セキュリティのコンフィグレーション」を参照してください。

    表 2-1 エージェントの接続情報 
    フィールド   
    入力する値   
    [Agent Name]
    PlainAgent
    [Agent Host]
    ホスト マシンの URL。この例では、localhost を使用します。
    [Agent Port]
    8001 (デフォルト)
    [Agent Secure Port]
    8002 (デフォルト)
    [Transfer Encryption Passphrase]
    デフォルト
    [Confirm Transfer Encryption Passphrase]
    デフォルト
    [Security Mode]
    [Unsecure] (デフォルト)



  6. 以下の 2 つのウィンドウでは、[Next] をクリックしてデフォルト値を使用します。
    • [Configure Agent Logging]
    • [Configure Agent Keystore Passwords]
  7. [Configure Agent Type] ウィンドウで、[Plain Agent] を選択し、[Next] をクリックします。



  8. [Configure Plain Agent (1 of 2)] ウィンドウで、以下の表に示す、このエージェントに関連付けられたリソース プールの名前、およびリソース プールで使用可能な CPU 能力を指定します。

    9. 表 2-2 Plain Agent リソース プールのコンフィグレーション 
    フィールド   
    入力する値   
    [Resource Pool Name]
    plain-resource-pool
    [Description]
    plain resource pool
    [CPU capacity (MHz)]
    マシンの CPU 能力。この例では、512 と指定します。
    [Stdout Directory]
    デフォルトを使用します。
    [Stderr Directory]
    デフォルトを使用します。



  9. [Configure Plain Agent (2 of 2)] ウィンドウで、リソース プールに含める必要のある使用可能なソフトウェアを指定します。この例では追加のソフトウェアは指定せずに、[Next] をクリックします。



  10. [Create Agent Configuration] ウィンドウで、[Create] をクリックします。



  11. エージェントが作成されたら、[Done] をクリックして WLOC Configuration Wizard を終了します。

エージェントのディレクトリ構造

Plain Agent のインストールおよび作成が完了すると、C:\WLOC_UseCase\user_projects\PlainAgent ディレクトリに以下のディレクトリ構造が作成されます。

表 2-2 に、これらのディレクトリの内容を示します。

表 2-3 エージェント ディレクトリの説明 
ディレクトリ
説明
bin
エージェントの開始、および Windows サービスとしてのエージェントのインストールと削除のためのコマンド。
config
エージェント コンフィグレーション ファイル。
keys
クリア テキスト パスワードの暗号化に使用される暗号キー。
logs
エージェント ログ ファイル。
ssl
コントローラとの SSL 通信に使用されるエージェントの内部デジタル証明書およびキーストア。

エージェント コンフィグレーション ファイル

WLOC Configuration Wizard を使用してエージェントを作成すると、loc-agent-config.xml という XML ファイルにコンフィグレーションが永続化されます。この例では、以下のディレクトリにファイルが作成されます。

C:\WLOC_UseCase\user_projects\PlainAgent\config

入力項目は以下のとおりです。

WLOC_UseCase は、インストールされた WLOC が含まれる BEA ホーム ディレクトリです。PlainAgent は、Configuration Wizard でエージェント ディレクトリの場所に指定した名前です。

Configuration Wizard を使用してエージェントを作成した後、Administration Console を使用するか、またはコンフィグレーション ファイルを直接編集することで、これを変更できます。

この例で作成された loc-agent-config.xml ファイルを コード リスト 2-1 に示します。

コード リスト 2-1 サンプル loc-agent-config.xml ファイル 
<?xml version="1.0" encoding="UTF-8"?><loc-agent xmlns="bea.com/loc/agent" xmlns:loc="http://bea.com/loc">
  <name>PlainAgent</name>
  <description>PlainAgent</description>
  <network>
    <loc:host>localhost</loc:host>
    <loc:components>
      <loc:component>
        <loc:name>ListenPorts</loc:name>
        <loc:description>ListenPorts</loc:description>
        <loc:port>8001</loc:port>
        <loc:secure-port>8002</loc:secure-port>
      </loc:component>
    </loc:components>
  </network>
  <use-secure-connections>false</use-secure-connections>
  <logging>
    <loc:file-severity>Info</loc:file-severity>
    <loc:base-file-name>C:\WLOC_UseCase/user_projects/PlainAgent/logs/Agent.log</loc:base-file-name>
    <loc:rotation-type>BySize</loc:rotation-type>
    <loc:rotation-size>5000</loc:rotation-size>
    <loc:rotation-time>00:00</loc:rotation-time>
    <loc:file-rotation-dir>./logs/logrotdir</loc:file-rotation-dir>
    <loc:number-of-files-limited>true</loc:number-of-files-limited>
    <loc:rotated-file-count>5</loc:rotated-file-count>
    <loc:rotation-time-span>24</loc:rotation-time-span>
    <loc:rotation-time-span-factor>3500000</loc:rotation-time-span-factor>
    <loc:rotation-on-startup-enabled>true</loc:rotation-on-startup-enabled>
    <loc:stdout-severity>Info</loc:stdout-severity>
  </logging>
  <audit>
    <loc:base-file-name>./logs/audit.log</loc:base-file-name>
    <loc:rotation-type>BySize</loc:rotation-type>
    <loc:rotation-size>300</loc:rotation-size>
    <loc:rotation-time>00:00</loc:rotation-time>
    <loc:file-rotation-dir>./logs/logrotdir</loc:file-rotation-dir>
    <loc:number-of-files-limited>true</loc:number-of-files-limited>
    <loc:rotated-file-count>50</loc:rotated-file-count>
    <loc:rotation-time-span>24</loc:rotation-time-span>
    <loc:rotation-time-span-factor>50</loc:rotation-time-span-factor>
    <loc:rotation-on-startup-enabled>true</loc:rotation-on-startup-enabled>
    <loc:enabled>true</loc:enabled>
    <loc:scope>
      <loc:type>All</loc:type>
    </loc:scope>
  </audit>
  <work-managers>
    <loc:work-manager>
      <loc:name>WM</loc:name>
      <loc:description>WM</loc:description>
      <loc:max-threads-constraint>64</loc:max-threads-constraint>
      <loc:min-threads-constraint>3</loc:min-threads-constraint>
    </loc:work-manager>
    <loc:work-manager>
      <loc:name>ResourceBrokerAgent-WM</loc:name>
      <loc:description>ResourceBrokerAgent-WM</loc:description>
      <loc:max-threads-constraint>15</loc:max-threads-constraint>
      <loc:min-threads-constraint>3</loc:min-threads-constraint>
    </loc:work-manager>
    <loc:work-manager>
      <loc:name>AgentRuntime-WM</loc:name>
      <loc:description>AgentRuntime-WM</loc:description>
      <loc:max-threads-constraint>15</loc:max-threads-constraint>
      <loc:min-threads-constraint>3</loc:min-threads-constraint>
    </loc:work-manager>
  </work-managers>
  <encryption>
    <password>{Salted-3DES}8U+L9mNDmAFoUayTkWaFOQ==</password>
  </encryption>
  <resource-pools>
    <plain-resource-pool>
      <name>resource-resource-pool</name>
      <description>plain resource pool</description>
      <cpu-capacity>512</cpu-capacity>
      <stdout-dir>C:\WLOC_UseCase\user_projects\PlainAgent\stdout</stdout-dir>
      <stderr-dir>C:\WLOC_UseCase\user_projects\PlainAgent\stderr</stderr-dir>
    </plain-resource-pool>
  </resource-pools>
</loc-agent>

loc-agent-config.xml エージェント コンフィグレーション ファイルの各要素に関する情報については、エージェント コンフィグレーション スキーマ リファレンスを参照してください。

 

手順 3 : コントローラの作成

それぞれの WLOC 環境には、1 つのコントローラと、1 つまたは複数のエージェントが含まれています。コントローラは、オペレーティング環境に関するデータをエージェントから収集する中心的なコンポーネントです。コントローラは収集されたデータを使用して、新しいサービスを適切にデプロイし、環境内のすべてのサービスのポリシーを評価および適用します。また、コントローラでは WLOC Administration Console もホストされます。

エージェントとコントローラは異なる物理マシンにインストールできますが、この例では、「手順 1 : WLOC のインストール」で説明しているように、コントローラは完全なインストールの一部としてローカル マシンにインストールされています。コントローラをインストールした後は、WLOC Configuration Wizard を使用して作成できます。

コントローラを作成するには、以下の手順を完了します。

  1. [スタート] メニューから、[スタート｜すべてのプログラム｜WebLogic Operations Control 10gR3｜WLOC Configuration Wizard] を選択します。



  2. [Welcome] ウィンドウで、[Next] をクリックします。
  3. [Choose Controller or Agent] ウィンドウで、[Create the Controller or extend the existing Controller for this host] を選択し、[Next] をクリックします。



  4. [Enter Controller Directory Location] ウィンドウでコントローラのデフォルトのパスおよびファイル名を使用し、[Next] をクリックします。



  5. [Enter Controller Connection Data] ウィンドウで、コントローラの以下の接続情報を指定します。

    6. 表 2-4 コントローラの接続情報 
    フィールド   
    入力する値   
    [Controller Host]
    localhost
    [Console Port]
    9001 (デフォルト)
    [Console Secure Port]
    9002 (デフォルト)
    [Console Mode]
    [Both]
    [Internal Port]
    9003 (デフォルト)
    [Internal Secure Port]
    9004 (デフォルト)
    [Security Mode]
    [Unsecure] (デフォルト)



  6. 以下のウィンドウでは、デフォルトのオプションを使用して [Next] をクリックします。
    • [Configure Controller Logging]
    • [Configure Controller Notifications (1 of 3)]
    • [Configure Controller Notifications (2 of 3)]
    • [Configure Controller Notifications (3 of 3)]
  7. [Configure Agents for this Controller] ウィンドウで、[Add] をクリックして、作成した Plain Agent をこのコントローラにバインドします。各フィールドはマシンのデフォルト データを使用して設定されます。フィールドを以下のように編集します。
    8. 注意 : フィールドを編集するには、フィールドの値をダブルクリックする必要があります。
    1. [Name] フィールドに [PlainAgent] と入力します。
    2. [Agent’s Hostname] フィールドに [localhost] と入力します。
    3. 残りのフィールドではデフォルトを使用します。
    4. [Next] をクリックします。

      5. ここで指定するパスフレーズは、エージェントの作成時に定義したパスフレーズと一致している必要があります。エージェントの作成時にはデフォルトを使用したため、ここでも同じデフォルトを使用できます。



  8. [Use SSH for WLOC ESX Agents] ウィンドウで、[Next] をクリックします。この例では、Plain Agent のみがコンフィグレーションされます。
  9. [Enter User Data] ウィンドウで、起動ユーザのユーザ名とパスワードを指定します。この例では、デフォルトを使用します。
    10. 注意 : デフォルトのユーザ名は WLOCBootUser、デフォルトのパスワードは changeit です。



  10. [Configure Controller KeyStore Passwords] でデフォルトのパスワードを使用し、[Next] をクリックします。
    11. 注意 : デフォルトのパスワードは changeit です。



  11. [Create Controller Configuration] ウィンドウで、[Create] をクリックします。



  12. コントローラが作成されたら、[Done] をクリックして WLOC Configuration Wizard を終了します。

コントローラのディレクトリ構造

コントローラのインストールおよび作成が完了すると、C:\WLOC_UseCase\user_projects\controller ディレクトリに以下のディレクトリ構造が作成されます。

表 2-2 に、これらのディレクトリの内容を示します。

表 2-5 コントローラ ディレクトリの説明 
ディレクトリ
説明
bin
コントローラの開始、および Windows サービスとしてのコントローラのインストールと削除のためのコマンド。
config
コントローラ コンフィグレーション ファイル。
keys
クリア テキスト パスワードおよびデータの暗号化に使用される暗号キー。
logs
コントローラ ログ ファイル。
ssl
エージェントとの SSL 通信に使用されるコントローラの内部デジタル証明書およびキーストア。

コントローラ コンフィグレーション ファイル

WLOC Configuration Wizard を使用してコントローラを作成すると、loc-controller-config.xml という XML ファイルにコンフィグレーションが永続化されます。この例では、以下のディレクトリにファイルが作成されます。

C:\WLOC_UseCase\user_projects\controller\config

入力項目は以下のとおりです。

WLOC_UseCase は、インストールされた WLOC が含まれる BEA ホーム ディレクトリです。controller は、Configuration Wizard でコントローラ ディレクトリの場所に指定した名前です。

Configuration Wizard を使用してコントローラを作成した後、Administration Console を使用するか、またはコンフィグレーション ファイルを直接編集することで、これを変更できます。

この例で作成された loc-controller-config.xml ファイルを コード リスト 2-2 に示します。

コード リスト 2-2 サンプル loc-controller-config.xml ファイル 
<?xml version="1.0" encoding="UTF-8"?><loc-controller xmlns="bea.com/loc/controller" xmlns:loc="http://bea.com/loc">
  <network>
    <loc:host>localhost</loc:host>
    <loc:components>
      <loc:component>
        <loc:name>Console</loc:name>
        <loc:description>Console</loc:description>
        <loc:port>9001</loc:port>
        <loc:secure-port>9002</loc:secure-port>
      </loc:component>
      <loc:component>
        <loc:name>InternalCommunication</loc:name>
        <loc:description>InternalCommunication</loc:description>
        <loc:port>9003</loc:port>
        <loc:secure-port>9004</loc:secure-port>
      </loc:component>
    </loc:components>
  </network>
  <use-secure-connections>false</use-secure-connections>
  <console-mode>BOTH</console-mode>
  <logging>
    <loc:file-severity>Info</loc:file-severity>
    <loc:base-file-name>C:/WLOC_UseCase/user_projects/controller/logs/Controller.log</loc:base-file-name>
    <loc:rotation-type>BySize</loc:rotation-type>
    <loc:rotation-size>500</loc:rotation-size>
    <loc:rotation-time>00:00</loc:rotation-time>
    <loc:file-rotation-dir>./logs/logrotdir</loc:file-rotation-dir>
    <loc:number-of-files-limited>true</loc:number-of-files-limited>
    <loc:rotated-file-count>5</loc:rotated-file-count>
    <loc:rotation-time-span>24</loc:rotation-time-span>
    <loc:rotation-time-span-factor>3500000</loc:rotation-time-span-factor>
    <loc:rotation-on-startup-enabled>true</loc:rotation-on-startup-enabled>
    <loc:stdout-severity>Info</loc:stdout-severity>
  </logging>
  <audit>
    <loc:base-file-name>./logs/audit.log</loc:base-file-name>
    <loc:rotation-type>BySize</loc:rotation-type>
    <loc:rotation-size>300</loc:rotation-size>
    <loc:rotation-time>00:00</loc:rotation-time>
    <loc:file-rotation-dir>./logs/logrotdir</loc:file-rotation-dir>
    <loc:number-of-files-limited>true</loc:number-of-files-limited>
    <loc:rotated-file-count>50</loc:rotated-file-count>
    <loc:rotation-time-span>24</loc:rotation-time-span>
    <loc:rotation-time-span-factor>50</loc:rotation-time-span-factor>
    <loc:rotation-on-startup-enabled>true</loc:rotation-on-startup-enabled>
    <loc:enabled>true</loc:enabled>
    <loc:scope>
      <loc:type>ControllerConfiguration</loc:type>
      <loc:type>ServiceConfiguration</loc:type>
      <loc:type>Rules</loc:type>
      <loc:type>ControllerAction</loc:type>
      <loc:type>Adjudication</loc:type>
      <loc:type>AgentConfiguration</loc:type>
    </loc:scope>
  </audit>
  <work-managers>
    <loc:work-manager>
      <loc:name>WM</loc:name>
      <loc:description>WM</loc:description>
      <loc:max-threads-constraint>64</loc:max-threads-constraint>
      <loc:min-threads-constraint>3</loc:min-threads-constraint>
    </loc:work-manager>
    <loc:work-manager>
      <loc:name>ResourceBroker-WM</loc:name>
      <loc:description>ResourceBroker-WM</loc:description>
      <loc:max-threads-constraint>15</loc:max-threads-constraint>
      <loc:min-threads-constraint>3</loc:min-threads-constraint>
    </loc:work-manager>
    <loc:work-manager>
      <loc:name>Action-Purge-WM</loc:name>
      <loc:description>Action-Purge-WM</loc:description>
      <loc:max-threads-constraint>15</loc:max-threads-constraint>
      <loc:min-threads-constraint>3</loc:min-threads-constraint>
    </loc:work-manager>
    <loc:work-manager>
      <loc:name>ExecuteEngine-WM</loc:name>
      <loc:description>ExecuteEngine-WM</loc:description>
      <loc:max-threads-constraint>15</loc:max-threads-constraint>
      <loc:min-threads-constraint>3</loc:min-threads-constraint>
    </loc:work-manager>
    <loc:work-manager>
      <loc:name>ProcessRuntime-WM</loc:name>
      <loc:description>ProcessRuntime-WM</loc:description>
      <loc:max-threads-constraint>15</loc:max-threads-constraint>
      <loc:min-threads-constraint>3</loc:min-threads-constraint>
    </loc:work-manager>
    <loc:work-manager>
      <loc:name>Actions-WM</loc:name>
      <loc:description>Actions-WM</loc:description>
      <loc:max-threads-constraint>15</loc:max-threads-constraint>
      <loc:min-threads-constraint>3</loc:min-threads-constraint>
    </loc:work-manager>
  </work-managers>
  <heartbeat-interval>20</heartbeat-interval>
  <reconnect-attempts>3</reconnect-attempts>
  <agents>
    <agent>
      <name>PlainAgent</name>
      <host>localhost</host>
      <port>8001</port>
      <secure-port>8002</secure-port>
      <state>Enabled</state>
      <password>{Salted-3DES}P6sAuDdtOnRp7Q/eDWnhKg==</password>
    </agent>
  </agents>
  <lvm-ssh-config>
    <public-key-file/>
  </lvm-ssh-config>
  <notification>
    <smtp>
      <name>LOC EMail Notification Service</name>
      <description>LOC EMail Notification Service</description>
      <to-address>bogus</to-address>
      <from-address>bogus</from-address>
      <smtp-server>bogus</smtp-server>
      <enabled>false</enabled>
    </smtp>
    <jms>
      <name>LOC JMS Notification Service</name>
      <description>LOC JMS Notification Service</description>
      <destination-jndi-name>com.bea.adaptive.loc.notification.JMSNotifier</destination-jndi-name>
      <connection-factory-jndi-name>QueueConnectionFactory</connection-factory-jndi-name>
      <jndi-properties>
        <initial-factory>org.mom4j.jndi.InitialCtxFactory</initial-factory>
        <provider-url>bogus</provider-url>
        <security-principal>bogus</security-principal>
        <password>{Salted-3DES}ZlcPX6S/hpM=</password>
      </jndi-properties>
      <enabled>false</enabled>
    </jms>
    <jmx>
      <name>JMX Notification Service</name>
      <description>JMX Notification Service</description>
      <enabled>false</enabled>
    </jmx>
    <snmp>
      <name>LOC SNMP Notification Service</name>
      <description>LOC SNMP Notification Service</description>
      <agent>
        <name>MySNMPAgent</name>
        <description>MySNMPAgent</description>
        <host>bogus</host>
        <port>5555</port>
        <trap-version>SNMPv2</trap-version>
        <enable-inform>false</enable-inform>
      </agent>
      <trap-destinations>
        <destination>
          <name>testTrapDest</name>
          <description>testTrapDest</description>
          <host>bogus</host>
          <port>5555</port>
          <community>public</community>
          <security-level>noAuthNoPriv</security-level>
        </destination>
      </trap-destinations>
      <enabled>false</enabled>
    </snmp>
  </notification>
</loc-controller>

loc-controller-config.xml コントローラ コンフィグレーション ファイルの各要素に関する情報については、コントローラ コンフィグレーション スキーマ リファレンスを参照してください。

 

次の作業

Plain Agent とコントローラをインストールおよび作成した後は、エージェント、コントローラ、および WLOC Administration Console の開始方法について説明する「WLOC 実行時環境の確立」に進みます。


  ページの先頭       前  次