2.8 メトリック・メッセージング用Oracle VM Hostdの使用方法

2.8.1 コマンドライン・オプション
2.8.2 使用例
2.8.3 VM内のホスト統計を取得するためのvm-dump-metricsの使用方法

Oracle VMユーティリティには、SAPアプリケーションを完全にサポートおよび認定し、Oracle VM環境内で実行しているOracle Linuxゲストで確実に実行できるようにするためのツールが含まれています。これらのツールは、特定の仮想マシンをホストしているOracle VM Serverについてのホストベースの統計情報を、Oracle VM Managerにより提供されているVMメッセージング機能を介して、仮想マシン自体に送信する通信を容易にします。

重要

この機能を正常に実行するには、ゲスト仮想マシンが、Oracle VM Guest AdditionsのインストールされたOracle Linuxを実行している必要があります。詳細は、第3章「Oracle VM Guest Additionsの使用方法」を参照してください。

注意

オラクル社により公式にサポートされているのは、Oracle VMユーティリティ内のこれらのツールだけです。

これらのツールには、ovm_vmhostdおよびvm-dump-metricsスクリプトが含まれており、次のURLで提供されているPatch 16269699以上で利用できます。

http://www.oracle.com/technetwork/server-storage/vm/downloads/index.html

2.8.1 コマンドライン・オプション

ovm_vmhostdには、次のコマンドライン・オプションがあります。

  • -u Oracle VM Manager管理ユーザーのユーザー名(必須)

  • -p 管理ユーザー名に対応するパスワード(必須)

  • -h Oracle VM Managerを実行しているサーバーのホスト名(必須)

  • -X SSLを使用してOracle VM Managerに接続

  • -v 仮想マシン名

  • -U 仮想マシンのUUID (オプションの代替UUID)

2.8.2 使用例

ovm_vmhostdをOracle VM Manager上で実行するためには、次のコマンドの実行が必要な場合があります。

# ./ovm_vmhostd -u admin -p MyPassword -h localhost -v myvm

コマンドの使用例では、myvmが動作している基になるOracle VM Serverの詳細が、Oracle VM Managerを介してmyvm仮想マシンにメッセージとして送信されます。

ovm_vmhostdユーティリティは、デーモンのように動作します。最初に、仮想マシンが実行していることを検証し、次に、サーバー・メトリックをメッセージとして送信します。60秒間スリープし、その後、元のメッセージの値を更新するメッセージを送信します。この動作は、プロセスが強制終了されるまで続行します。次に、典型的な出力例を示します。

# ./ovm_vmhostd -u admin -p MyPassword -h localhost -v myvm
Oracle VM Hostd 0.6.3.
Connected.
Manager version : 3.2.1.516
VM : 'pvm1' has status :  Running.
VM: 'pvm1' is online, sending metrics.
.Sleeping 60 seconds.
.Sleeping 60 seconds.
.Sleeping 60 seconds.

2.8.3 VM内のホスト統計を取得するためのvm-dump-metricsの使用方法

vm-dump-metricsスクリプトは、メッセージを受信するゲスト仮想マシンにコピーできます。このスクリプトは、Oracle VM Serverホスト情報をXML形式で出力できる単純なシェル・スクリプトです。仮想マシン内で実行しているSAPアプリケーションは、このXMLを消費できます。

デフォルトでは、vm-dump-metricsスクリプトはデータをSTDOUTに出力しますが、スクリプトの先頭にあるOUTFILE変数を編集することにより、データをファイルに出力するよう変更できます。

vm-dump-metricsスクリプトは、ovmdに問い合せて、キーvmhostを持つメッセージを取得します。メッセージをまったく取得しない場合、ステータス1で終了します。メッセージが見付かった場合、スクリプトはそのメッセージを解析して、結果となるXMLを構築します。vm-dump-metricsスクリプトにより生成される典型的なXML出力の例を次に示します。

<metrics>
  <metric type='real64' context='host'>
    <name>TotalCPUTime</name>
    <value>2694.3596</value>
  </metric>
  <metric type='uint64' context='host'>
    <name>PagedOutMemory</name>
    <value>0</value>
  </metric>
  <metric type='uint64' context='host'>
    <name>PagedInMemory</name>
    <value>0</value>
  </metric>
  <metric type='uint64' context='host'>
    <name>UsedVirtualMemory</name>
    <value>6747</value>
  </metric>
  <metric type='uint64' context='host'>
    <name>FreeVirtualMemory</name>
    <value>9817</value>
  </metric>
  <metric type='uint64' context='host'>
    <name>FreePhysicalMemory</name>
    <value>9817</value>
  </metric>
  <metric type='uint64' context='host'>
    <name>MemoryAllocatedToVirtualServers</name>
    <value>6747</value>
  </metric>
  <metric type='uint32' context='host'>
    <name>NumberOfPhysicalCPUs</name>
    <value>4</value>
  </metric>
  <metric type='string' context='host'>
    <name>HostSystemInfo</name>
    <value>ovm3</value>
  </metric>
  <metric type='string' context='host'>
    <name>VirtProductInfo</name>
    <value>Oracle VM 3</value>
  </metric>
  <metric type='string' context='host'>
    <name>VirtualizationVendor</name>
    <value>Oracle Corporation</value>
  </metric>
  <metric type='uint64' context='host'>
    <name>Time</name>
    <value>1360606566774</value>
  </metric>
  <metric type='string' context='host'>
    <name>HostName</name>
    <value>ovm3</value>
  </metric>
  <metric type='uint64' context='vm' id='0' uuid='0004fb00-0006-0000-d72b-647e20a85939'>
    <name>PhysicalMemoryAllocatedToVirtualSystem</name>
    <value>1024</value>
  </metric>
  <metric type='uint64' context='vm' id='0' uuid='0004fb00-0006-0000-d72b-647e20a85939'>
    <name>ResourceMemoryLimit</name>
    <value>1024</value>
  </metric>
  <metric type='uint32' context='vm' id='0' uuid='0004fb00-0006-0000-d72b-647e20a85939'>
    <name>ResourceProcessorLimit</name>
    <value>1</value>
  </metric>
  <metric type='real64' context='vm' id='0' uuid='0004fb00-0006-0000-d72b-647e20a85939'>
    <name>TotalCPUTime</name>
    <value>2694.3596</value>
  </metric>
</metrics>

仮想マシン上でvm-dump-metricsスクリプトを使用しない場合は、ovmdに直接問い合せて、結果を自身で解析できます。

# ovmd -g vmhost
com.sap.host.VirtualizationVendor=Oracle Corporation;com.sap.host.VirtProductInfo=Oracle VM 3;
com.sap.host.PagedInMemory=0;com.sap.host.PagedOutMemory=0;com.sap.host.PageRates=0;
com.sap.vm.uuid=0004fb0000060000d72b647e20a85939;com.sap.host.HostName=ovm3;
com.sap.host.HostSystemInfo=ovm3;com.sap.host.NumberOfPhysicalCPUs=4;com.sap.host.NumCPUs=4;
com.sap.host.TotalPhyMem=16383;com.sap.host.UsedVirtualMemory=6747;
com.sap.host.MemoryAllocatedToVirtualServers=6747;com.sap.host.FreeVirtualMemory=9817;
com.sap.host.FreePhysicalMemory=9817;com.sap.host.TotalCPUTime=381175.97;
com.sap.host.Time=1360606887997;com.sap.vm.PhysicalMemoryAllocatedToVirtualSystem=1024;
com.sap.vm.ResourceMemoryLimit=1024;com.sap.vm.TotalCPUTime=2696.2214;
com.sap.vm.ResourceProcessorLimit=1;