1. Oracle VM Server for SPARC ソフトウェアの概要
A. Oracle VM Server for SPARC 物理から仮想への変換ツール
B. Oracle VM Server for SPARC Configuration Assistant
C. Logical Domains Manager の検出
D. Logical Domains Manager での XML インタフェースの使用
Logical Domains Manager のリソースおよびプロパティー
仮想ディスクサーバーボリューム (vds_volume) リソース
物理 I/O デバイス (physio_device) リソース
仮想データプレーンチャネルサービス (vdpcs) リソース
ここでは、Logical Domains Manager のリソースと、リソースごとに定義できるプロパティーを示します。XML の例では、リソースおよびプロパティーは太字で示されています。これらの例は、バインド出力ではなくリソースを示しています。制約出力は、Logical Domains Manager の処理の入力を作成する場合に使用できます。ただし、ドメイン移行の出力は例外です。「ドメインの移行」 を参照してください。各リソースは、<Section> の OVF セクションで定義され、<rasd:OtherResourceType> タグによって指定されます。
例 D-6 ldom_info の XML 出力の例
<Envelope> <References/> <Content xsi:type="ovf:VirtualSystem_Type" id="primary"> <Section xsi:type="ovf:ResourceAllocationSection_type"> <Item> <rasd:OtherResourceType>ldom_info</rasd:OtherResourceType> <rasd:Address>00:03:ba:d8:ba:f6</rasd:Address> <gprop:GenericPropertykey="hostid">83d8baf6</gprop:GenericProperty> <gprop:GenericProperty key="master">plum</gprop:GenericProperty> <gprop:GenericProperty key="failure-policy">reset</gprop:GenericProperty> <gprop:GenericProperty key="progress">45%</gprop:GenericProperty> <gprop:GenericProperty key="status">ongoing</gprop:GenericProperty> <gprop:GenericProperty key="source">dt90-319</gprop:GenericProperty> </Item> </Section> </Content> </Envelope>
ldom_info リソースは、<Content> セクション内に必ず含まれます。ldom_info リソース内の次のプロパティーは、省略可能です。
<rasd:Address> タグ。ドメインに割り当てる MAC アドレスを指定します。
<gprop:GenericPropertykey="failure-policy"> タグ。マスタードメインに障害が発生した場合のスレーブドメインの動作を指定します。デフォルト値は ignore です。次に、有効なプロパティー値を示します。
ignore は、マスタードメインの障害を無視します。スレーブドメインは影響を受けません。
panic は、マスタードメインに障害が発生した場合、すべてのスレーブドメインにパニックを発生させます。
reset は、マスタードメインに障害が発生した場合、すべてのスレーブドメインをリセットします。
stop は、マスタードメインに障害が発生した場合、すべてのスレーブドメインを停止します。
<gprop:GenericPropertykey="hostid"> タグ。ドメインに割り当てるホスト ID を指定します。
<gprop:GenericPropertykey="master"> タグ。最大 4 つのマスタードメイン名をコンマで区切って指定します。
<gprop:GenericPropertykey="progress"> タグ。コマンドの進捗の割合を指定します。
<gprop:GenericPropertykey="source"> タグ。コマンドの進捗を報告するマシンを指定します。
<gprop:GenericPropertykey="status"> タグ。コマンドの状態 (done、failed、または ongoing) を指定します。
add-vcpu、set-vcpu、および remove-vcpu XML 要求処理と同等の機能で、次のように <gpropGenericProperty key="wcore"> タグの値を設定します。
-c オプションを使用する場合、指定された全体のコア数を wcore プロパティーに設定します。
-cオプションを使用しない場合、0 を wcore プロパティーに設定します。
cpu リソースの割り当て単位プロパティーの <rasd:AllocationUnits> では、コアの数ではなく仮想 CPU の数を常に指定します。
例 D-7 cpu の XML の例
次の例は、ldm add-vcpu -c 1 ldg1 コマンドと同等の XML 要求を示しています。
<?xml version="1.0"?> <LDM_interface version="1.2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="./schemas/combined-v3.xsd" xmlns:ovf="./schemas/envelope" xmlns:rasd="./schemas/CIM_ResourceAllocationSettingData" xmlns:vssd="./schemas/CIM_VirtualSystemSettingData" xmlns:gprop="./schemas/GenericProperty" xmlns:bind="./schemas/Binding"> <cmd> <action>add-vcpu</action> <data version="3.0"> <Envelope> <References/> <Content xsi:type="ovf:VirtualSystem_Type" ovf:id="ldg1"> <Section xsi:type="ovf:VirtualHardwareSection_Type"> <Item> <rasd:OtherResourceType>cpu</rasd:OtherResourceType> <rasd:AllocationUnits>8</rasd:AllocationUnits> <gprop:GenericProperty key="wcore">1</gprop:GenericProperty> </Item> </Section> </Content> </Envelope> </data> </cmd> </LDM_interface>
cpu リソースは、<Content> セクション内に必ず含まれます。
注 - mau リソースは、サポートされているサーバーでサポートする暗号化装置です。現在、モジュラー演算ユニット (Modular Arithmetic Unit、MAU) と Control Word Queue (CWQ) の 2 つの暗号化装置がサポートされています。
例 D-8 mau の XML の例
<Envelope> <References/> <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1"> <Section xsi:type="ovf:VirtualHardwareSection_Type"> <Item> <rasd:OtherResourceType>mau</rasd:OtherResourceType> <rasd:AllocationUnits>1</rasd:AllocationUnits> </Item> </Section> </Content> </Envelope>
mau リソースは、<Content> セクション内に必ず含まれます。プロパティーは <rasd:AllocationUnits> タグのみで、MAU またはその他の暗号化装置の数を指定します。
例 D-9 memory の XML の例
<Envelope> <References/> <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1"> <Section xsi:type="ovf:VirtualHardwareSection_Type"> <Item> <rasd:OtherResourceType>memory</rasd:OtherResourceType> <rasd:AllocationUnits>4G</rasd:AllocationUnits> </Item> </Section> </Content> </Envelope>
メモリーリソースは、<Content> セクション内に必ず含まれます。プロパティーは <rasd:AllocationUnits> タグのみで、メモリーの量を指定します。
例 D-10 vds の XML の例
<Envelope> <References/> <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1"> <Section xsi:type="ovf:VirtualHardwareSection_Type"> <Item> <rasd:OtherResourceType>vds</rasd:OtherResourceType> <gprop:GenericProperty key="service_name">vdstmp</gprop:GenericProperty> </Item> </Section> </Content> </Envelope>
仮想ディスクサーバー (vds) リソースは、ドメイン記述の一部として <Content> セクションに含まれることも、単独で <Envelope> セクションに記述されることもあります。プロパティーは <gprop:GenericProperty> タグのみです。このタグには、"service_name" というキーがあり、記述される vds リソースの名前が含まれています。
例 D-11 vds_volume の XML の例
<Envelope> <References/> <Section xsi:type="ovf:VirtualHardwareSection_Type"> <Item> <rasd:OtherResourceType>vds_volume</rasd:OtherResourceType> <gprop:GenericProperty key="vol_name">vdsdev0</gprop:GenericProperty> <gprop:GenericProperty key="service_name">primary-vds0</gprop:GenericProperty> <gprop:GenericProperty key="block_dev"> opt/SUNWldm/domain_disks/testdisk1</gprop:GenericProperty> <gprop:GenericProperty key="vol_opts">ro</gprop:GenericProperty> <gprop:GenericProperty key="mpgroup">mpgroup-name</gprop:GenericProperty> </Item> </Section> </Envelope>
vds_volume リソースは、ドメイン記述の一部として <Content> セクションに含まれることも、単独で <Envelope> セクションに記述されることもあります。次のキーを持つ <gprop:GenericProperty> タグが必要です。
vol_name - ボリュームの名前
service_name - このボリュームをバインドする仮想ディスクサーバーの名前
block_dev – このボリュームに関連付けるファイルまたはデバイスの名前
任意で、vds_volume リソースに次のプロパティーも設定できます。
vol_opts – {ro,slice,excl} のように、これらの項目の 1 つ以上がコンマで区切られて、1 つの文字列となっているもの
mpgroup – マルチパス (フェイルオーバー) グループの名前
例 D-12 disk の XML の例
<Envelope> <References/> <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1"> <Section xsi:type="ovf:VirtualHardwareSection_Type"> <Item> <rasd:OtherResourceType>disk</rasd:OtherResourceType> <gprop:GenericProperty key="vdisk_name">vdisk0</gprop:GenericProperty> <gprop:GenericProperty key="service_name">primary-vds0</gprop:GenericProperty> <gprop:GenericProperty key="vol_name">vdsdev0</gprop:GenericProperty> <gprop:GenericProperty key="timeout">60</gprop:GenericProperty> </Item> </Section> </Content> </Envelope>
disk リソースは、<Content> セクション内に必ず含まれます。次のキーを持つ <gprop:GenericProperty> タグが必要です。
vdisk_name - 仮想ディスクの名前
service_name - この仮想ディスクをバインドする仮想ディスクサーバーの名前
vol_name - この仮想ディスクを関連付ける仮想ディスクサービスデバイス
任意で、disk リソースに timeout プロパティーも含めることができます。このプロパティーは、仮想ディスククライアント (vdc) と仮想ディスクサーバー (vds) の間に接続を確立するためのタイムアウト値です (秒単位)。複数の仮想ディスク (vdisk) パスがある場合、vdc は、別の vds への接続を試みることができます。また、タイムアウトによって、いずれかの vds への接続が指定の時間内に確実に行われます。
例 D-13 vsw の XML の例
<Envelope> <References/> <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1"> <Section xsi:type="ovf:VirtualHardwareSection_Type"> <Item> <rasd:OtherResourceType>vsw</rasd:OtherResourceType> <gprop:GenericProperty key="service_name">vsw1-ldg1</gprop:GenericProperty> <gprop:GenericProperty key="dev_path">bge0</gprop:GenericProperty> <gprop:GenericProperty key="linkprop">phys-state</gprop:GenericProperty> <rasd:Address>00:14:4f:fc:00:01</rasd:Address> <gprop:GenericProperty key="mode">sc</gprop:GenericProperty> <gprop:GenericProperty key="pvid">12345678</gprop:GenericProperty> <gprop:GenericProperty key="vid">87654321</gprop:GenericProperty> </Item> </Section> </Content> </Envelope>
vsw リソースは、ドメイン記述の一部として <Content> セクションに含まれることも、単独で <Envelope> セクションに記載されることもあります。次のキーを持つ <gprop:GenericProperty> タグが必要です。
service_name - 仮想スイッチに割り当てる名前。
linkprop – 仮想デバイスが物理リンクステータスの更新を取得するかどうかを指定します。値が phys-state の場合、仮想デバイスは物理リンクステータスの更新を取得します。値が空白の場合、仮想デバイスは物理リンクステータスの更新を取得しません。デフォルトでは、仮想デバイスは物理リンクステータスの更新を取得しません。
dev_path – この仮想スイッチに関連付けるネットワークデバイスのパス
任意で、vsw リソースに次のプロパティーも設定できます。
<rasd:Address> - MAC アドレスを仮想スイッチに割り当てます。
pvid - ポート仮想ローカルエリアネットワーク (Virtual Local Area Network、VLAN) 識別子 (ID)。仮想ネットワークをメンバーにする必要のある VLAN をタグなしモードで指定します。
vid - 仮想ローカルエリアネットワーク (Virtual Local Area Network、VLAN) 識別子 (ID)。仮想ネットワークおよび仮想スイッチをメンバーにする必要のある VLAN をタグ付きモードで指定します。
mode ? Oracle Solaris Cluster のハートビートサポートの場合は sc。
例 D-14 network の XML の例
<Envelope> <References/> <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1"> <Section xsi:type="ovf:VirtualHardwareSection_Type"> <Item> <rasd:OtherResourceType>network</rasd:OtherResourceType> <gprop:GenericProperty key="linkprop">phys-state</gprop:GenericProperty> <gprop:GenericProperty key="vnet_name">ldg1-vnet0</gprop:GenericProperty> <gprop:GenericProperty key="service_name">primary-vsw0</gprop:GenericProperty> <rasd:Address>00:14:4f:fc:00:01</rasd:Address> </Item> </Section> </Content> </Envelope>
network リソースは、<Content> セクション内に必ず含まれます。次のキーを持つ <gprop:GenericProperty> タグが必要です。
linkprop – 仮想デバイスが物理リンクステータスの更新を取得するかどうかを指定します。値が phys-state の場合、仮想デバイスは物理リンクステータスの更新を取得します。値が空白の場合、仮想デバイスは物理リンクステータスの更新を取得しません。デフォルトでは、仮想デバイスは物理リンクステータスの更新を取得しません。
vnet_name - 仮想ネットワーク (vnet) の名前
service_name - この仮想ネットワークをバインドする仮想スイッチ (vswitch) の名前
任意で、network リソースに次のプロパティーも設定できます。
<rasd:Address> - MAC アドレスを仮想スイッチに割り当てます。
pvid - ポート仮想ローカルエリアネットワーク (Virtual Local Area Network、VLAN) 識別子 (ID)。仮想ネットワークをメンバーにする必要のある VLAN をタグなしモードで指定します。
vid - 仮想ローカルエリアネットワーク (Virtual Local Area Network、VLAN) 識別子 (ID)。仮想ネットワークおよび仮想スイッチをメンバーにする必要のある VLAN をタグ付きモードで指定します。
mode - 仮想ネットワークに対してハイブリッド I/O を有効にする場合は hybrid。
例 D-15 vcc の XML の例
<Envelope> <References/> <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1"> <Section xsi:type="ovf:VirtualHardwareSection_Type"> <Item> <rasd:OtherResourceType>vcc</rasd:OtherResourceType> <gprop:GenericProperty key="service_name">vcc1</gprop:GenericProperty> <gprop:GenericProperty key="min_port">6000</gprop:GenericProperty> <gprop:GenericProperty key="max_port">6100</gprop:GenericProperty> </Item> </Section> </Content> </Envelope>
vcc リソースは、ドメイン記述の一部として <Content> セクションに含まれることも、単独で <Envelope> セクションに記述されることもあります。次のキーを持つ <gprop:GenericProperty> タグを使用できます。
service_name - 仮想コンソール端末集配信装置サービスに割り当てる名前
min_port - この vcc に関連付ける最小ポート番号
max_port - この vcc に関連付ける最大ポート番号
例 D-16 var の XML の例
<Envelope> <References/> <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1"> <Section xsi:type="ovf:VirtualHardwareSection_Type"> <Item> <rasd:OtherResourceType>var</rasd:OtherResourceType> <gprop:GenericProperty key="name">test_var</gprop:GenericProperty> <gprop:GenericProperty key="value">test1</gprop:GenericProperty> </Item> </Section> </Content> </Envelope>
var リソースは、<Content> セクション内に必ず含まれます。次のキーを持つ <gprop:GenericProperty> タグを使用できます。
name - 変数の名前
value - 変数の値
例 D-17 physio_device の XML の例
<Envelope> <References/> <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1"> <Section xsi:type="ovf:VirtualHardwareSection_Type"> <Item> <rasd:OtherResourceType>physio_device</rasd:OtherResourceType> <gprop:GenericProperty key="name">pci@780</gprop:GenericProperty> </Item> </Section> </Content> </Envelope>
physio_device リソースは、<Content> セクション内に必ず含まれます。プロパティーは、<gprop:GenericProperty> タグのみです。このタグには、"name" というキープロパティー値があり、記述される I/O デバイスの名前が含まれています。
例 D-18 spconfig の XML の例
<Envelope> <Section xsi:type="ovf:ResourceAllocationSection_type"> <Item> <rasd:OtherResourceType>spconfig</rasd:OtherResourceType> <gprop:GenericProperty key="spconfig_name">primary</gprop:GenericProperty> <gprop:GenericProperty key="spconfig_status">current</gprop:GenericProperty> </Item> </Section> </Envelope>
サービスプロセッサ (Service Processor、SP) 構成 (spconfig) リソースは、必ず単独で <Envelope> セクションに記述されます。次のキーを持つ <gprop:GenericProperty> タグを使用できます。
spconfig_name - SP に格納されている構成の名前。
spconfig_status - 特定の SP 構成の現在の状態。このプロパティーは、ldm list-spconfig コマンドの出力で使用されます。
例 D-19 vdpcs の XML の例
<Envelope> <References/> <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1"> <Section xsi:type="ovf:VirtualHardwareSection_Type"> <Item> <rasd:OtherResourceType>vdpcs</rasd:OtherResourceType> <gprop:GenericProperty key="service_name">dg1-vdpcs</gprop:GenericProperty> </Item> </Section> </Content> </Envelope>
このリソースは、Netra DPS 環境でのみ意味を持ちます。vdpcs リソースは、ドメイン記述の一部として <Content> セクションに含まれることも、単独で <Envelope> セクションに記述されることもあります。プロパティーは、<gprop:GenericProperty> タグのみです。このタグには、"service_name" というキープロパティー値があり、記述される仮想データプレーンチャネルサービス (vdpcs) リソースの名前が含まれています。
例 D-20 vdpcc の XML の例
<Envelope> <References/> <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1"> <Section xsi:type="ovf:VirtualHardwareSection_Type"> <Item> <rasd:OtherResourceType>vdpcc</rasd:OtherResourceType> <gprop:GenericProperty key="vdpcc_name">vdpcc</gprop:GenericProperty> <gprop:GenericProperty key="service_name">ldg1-vdpcs</gprop:GenericProperty> </Item> </Section> </Content> </Envelope>
このリソースは、Netra DPS 環境でのみ意味を持ちます。仮想データプレーンチャネルクライアントリソースは、<Content> セクション内に必ず含まれます。次のキーを持つ <gprop:GenericProperty> タグを使用できます。
vdpcc_name - 仮想データプレーンチャネルクライアント (vdpcc) の名前
service_name - この vdpcc をバインドする仮想データプレーンチャネルサービス (vdpcs) の名前
例 D-21 console の XML の例
<Envelope> <References/> <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1"> <Section xsi:type="ovf:VirtualHardwareSection_Type"> <Item> <rasd:OtherResourceType>console</rasd:OtherResourceType> <gprop:GenericProperty key="port">6000</gprop:GenericProperty> <gprop:GenericProperty key="service_name">vcc2</gprop:GenericProperty> <gprop:GenericProperty key="group">group-name</gprop:GenericProperty> </Item> </Section> </Content> </Envelope>
console リソースは、<Content> セクション内に必ず含まれます。次のキーを持つ <gprop:GenericProperty> タグを使用できます。
port - この仮想コンソール (console) の変更先のポート
service_name - この console をバインドする仮想コンソール端末集配信装置 (vcc) サービス
group - この console をバインドするグループの名前
次の例は、migrate-domain サブコマンドの <data> セクションの内容を示しています。
例 D-22 migrate-domain の <data> セクションの例
<Envelope> <References/> <Content xsi:type="ovf:VirtualSystem_Type" ovf:id="ldg1"/> <Content xsi:type="ovf:VirtualSystem_Type" ovf:id="ldg1"/> <Section xsi:type="ovf:ResourceAllocationSection_Type"> <Item> <rasd:OtherResourceType>ldom_info</rasd:OtherResourceType> <gprop:GenericProperty key="target">target-host</gprop:GenericProperty> <gprop:GenericProperty key="username">user-name</gprop:GenericProperty> <gprop:GenericProperty key="password">password</gprop:GenericProperty> <Item> </Section> </Content> </Envelope>
各エントリの内容は次のとおりです。
1 番めの <Content> ノード (<ldom_info> セクションなし) は、移行元のソースドメインです。
2 番めの <Content> ノード (<ldom_info> セクションあり) は、移行先のターゲットドメインです。ソースドメインとターゲットドメインの名前は同じにすることができます。
ターゲットドメインの <ldom_info> セクションには、移行先のマシンおよびこのマシンへの移行に必要な詳細情報が記述されます。
target-host は、移行先のターゲットマシンです。
user-name は、ターゲットマシンのログインユーザー名です。SASL 64 ビットで符号化する必要があります。
password は、ターゲットマシンへのログインに使用するパスワードです。SASL 64 ビットで符号化する必要があります。
注 - Logical Domains Manager では、sasl_decode64() を使用してターゲットのユーザー名およびパスワードを復号化し、sasl_encode64() を使用してこれらの値を符号化します。SASL 64 符号化は、base64 符号化に相当します。