ナビゲーションリンクをスキップ | |
印刷ビューの終了 | |
Oracle VM Server for SPARC 2.2 リファレンスマニュアル Oracle VM Server for SPARC (日本語) |
- Logical Domains Manager 用のコマンド行インタフェース
ldm または ldm --help [subcommand] ldm -V ldm add-domain -i file ldm add-domain [cpu-arch=generic|native] [mac-addr=num] [hostid=num] [failure-policy=ignore|panic|reset|stop] [extended-mapin-space=on] [master=master-ldom1,...,master-ldom4] [max-cores=[num|unlimited]] [uuid=uuid] [threading=max-ipc] ldom ldm add-domain ldom... ldm set-domain -i file ldm set-domain [cpu-arch=generic|native] [mac-addr=num] [hostid=num] [failure-policy=ignore|panic|reset|stop] [extended-mapin-space=[on|off]] [master=[master-ldom1,...,master-ldom4]] [max-cores=[num|unlimited]] [threading=[max-throughput|max-ipc]] ldom ldm remove-domain -a ldm remove-domain ldom... ldm list-domain [-e] [-l] [-o format] [-p] [ldom...] ldm migrate-domain [-f] [-n] [-p filename] source-ldom [user@]target-host[:target-ldom] ldm add-vcpu [-c] number ldom ldm set-vcpu [-c] number ldom ldm remove-vcpu [-c] number ldom ldm add-core num ldom ldm add-core cid=core-ID[,core-ID[,...]] ldom ldm set-core num ldom ldm set-core cid=[core-ID[,core-ID[,...]]] ldom ldm remove-core [-f] num ldom ldm remove-core cid=core-ID[,core-ID[,...]] ldom ldm add-crypto number ldom ldm set-crypto [-f] number ldom ldm remove-crypto [-f] number ldom ldm add-memory [--auto-adj] size[unit] ldom ldm add-memory mblock=PA-start:size[,PA-start:size[,...]] ldom ldm set-memory [--auto-adj] size[unit] ldom ldm set-memory mblock=[PA-start:size[,PA-start:size[,...]]] ldom ldm remove-memory [--auto-adj] size[unit] ldom ldm remove-memory mblock=PA-start:size[,PA-start:size[,...]] ldom ldm start-reconf ldom ldm cancel-reconf ldom ldm cancel-operation (migration | reconf | memdr) ldom ldm add-io (bus | device | vf-name) ldom ldm set-io name=value [name=value ...] pf-name ldm set-io [mac-addr=num] [alt-mac-addrs=[auto|num1,[auto|num2,...]]] [pvid=[pvid]] [vid=[vid1,vid2,...]] [mtu=size] [name=value...] vf-name ldm remove-io (bus | device | vf-name) ldom ldm list-io [-l] [-p] [pf-name] ldm list-io -d pf-name ldm add-vsw [-q] [default-vlan-id=vlan-id] [pvid=port-vlan-id] [vid=vlan-id1,vlan-id2,...] [linkprop=phys-state] [mac-addr=num] [net-dev=device] [mode=sc] [mtu=size] [id=switch-id] [inter-vnet-link=on|off] vswitch-name ldom ldm set-vsw [-q] [pvid=port-vlan-id] [vid=vlan-id1,vlan-id2,...] [mac-addr=num] [net-dev=device] [linkprop=[phys-state]] [mode=[sc]] [mtu=size] [inter-vnet-link=[on|off]] vswitch-name ldm remove-vsw [-f] vswitch-name ldm add-vnet [mac-addr=num] [mode=hybrid] [pvid=port-vlan-id] [vid=vlan-id1,vlan-id2,...] [linkprop=phys-state] [id=network-id] [mtu=size] if-name vswitch-name ldom ldm set-vnet [mac-addr=num] [vswitch=vswitch-name] [mode=[hybrid]] [pvid=port-vlan-id] [linkprop=[phys-state]] [vid=vlan-id1,vlan-id2,...] [mtu=size] if-name ldom ldm remove-vnet [-f] if-name ldom ldm add-vds service-name ldom ldm remove-vds [-f] service-name ldm add-vdsdev [-f] [-q] [options={ro,slice,excl}] [mpgroup=mpgroup] backend volume-name@service-name ldm set-vdsdev [-f] options=[{ro,slice,excl}] [mpgroup=mpgroup] volume-name@service-name ldm remove-vdsdev [-f] volume-name@service-name ldm add-vdisk [timeout=seconds] [id=disk-id] disk-name volume-name@service-name ldom ldm set-vdisk [timeout=seconds] [volume=volume-name@service-name] disk-name ldom ldm remove-vdisk [-f] disk-name ldom ldm add-vdpcs vdpcs-service-name ldom ldm remove-vdpcs [-f] vdpcs-service-name ldm add-vdpcc vdpcc-name vdpcs-service-name ldom ldm remove-vdpcc [-f] vdpcc-name ldom ldm add-vcc port-range=x-y vcc-name ldom ldm set-vcc port-range=x-y vcc-name ldm remove-vcc [-f] vcc-name ldm set-vcons [port=[port-num]] [group=group] [service=vcc-server] ldom ldm create-vf [mac-addr=num] [alt-mac-addrs=[auto|num1,[auto|num2,...]]] [pvid=pvid] [vid=vid1,vid2,...] [mtu=size] [name=value...] pf-name ldm destroy-vf vf-name ldm add-variable var-name=[value]... ldom ldm set-variable var-name=[value]... ldom ldm remove-variable var-name... ldom ldm list-variable [var-name...] ldom ldm start-domain (-a | -i file | ldom...) ldm stop-domain [-f] (-a | ldom...) ldm panic-domain ldom ldm bind-domain [-f] [-q] (-i file | ldom) ldm unbind-domain ldom ldm list-bindings [-e] [-p] [ldom...] ldm add-spconfig config-name ldm add-spconfig -r autosave-name [new-config-name] ldm set-spconfig config-name ldm set-spconfig factory-default ldm remove-spconfig [-r] config-name ldm list-spconfig [-r [autosave-name]] ldm list-constraints ([-x] | [-e] [-p]) [ldom...] ldm list-devices [-a] [-p] [core] [cpu] [crypto] [memory] [io] ldm list-services [-e] [-p] [ldom...] ldm add-policy [enable=yes|no] [priority=value] [attack=value] [decay=value] [elastic-margin=value] [sample-rate=value] [tod-begin=hh:mm[:ss]] [tod-end=hh:mm[:ss]] [util-lower=percent] [util-upper=percent] [vcpu-min=value] [vcpu-max=value] name=policy-name ldom... ldm set-policy [enable=[yes|no]] [priority=[value]] [attack=[value]] [decay=[value]] [elastic-margin=[value]] [sample-rate=[value]] [tod-begin=[hh:mm:ss]] [tod-end=[hh:mm:ss]] [util-lower=[percent]] [util-upper=[percent]] [vcpu-min=[value]] [vcpu-max=[value]] name=policy-name ldom... ldm remove-policy [name=]policy-name... ldom ldm init-system [-frs] -i file
論理ドメインは、独自のオペレーティングシステム、資源、および単一のコンピュータシステム内での識別情報を持つ個別の論理グループです。各論理ドメインは、サーバーの電源の再投入を必要とせずに、作成、削除、再構成、およびリブートを単独で行うことができます。セキュリティー上の理由から、論理ドメインを使用してさまざまなアプリケーションを異なるドメインで動作させて、アプリケーションの独立性を維持できます。
論理ドメインはすべて同じですが、論理ドメインに対して指定する役割に基づいてそれぞれ区別できます。論理ドメインが実行できる役割は、次のとおりです。
ハイパーバイザと通信することによって、ほかの論理ドメインおよびサービスを作成および管理します。
仮想ネットワークスイッチ、仮想ディスクサービスなどのサービスをほかの論理ドメインに提供します。
PCI EXPRESS (PCIe) コントローラ内のネットワークカードなどの物理 I/O デバイスまたは SR-IOV (Single Root I/O Virtualization) 仮想機能に直接アクセスできます。I/O ドメインは PCIe ルートコンプレックスを所有するか、直接 I/O (Direct I/O、DIO) 機能を使用して PCIe スロットまたはオンボードの PCIe デバイスを所有でき、SR-IOV 機能を使用して SR-IOV 仮想機能を所有できます。
I/O ドメインは、I/O ドメインがサービスドメインとしても使用される場合に、仮想デバイスの形式でほかのドメインと物理 I/O デバイスを共有できます。
PCIe ルートコンプレックスが割り当てられます。このドメインは、PCIe ファブリックとすべての接続されているデバイスを所有し、ファブリックのエラー処理などのファブリック関連のサービスをすべて提供します。ルートドメインはすべての SR-IOV 物理機能を所有し、それらから仮想機能を作成して I/O ドメインに割り当てることができます。ルートドメインは I/O ドメインでもあり、物理 I/O デバイスを所有し、それらに直接アクセスできます。
保持できるルートドメインの数は、プラットフォームアーキテクチャーによって決まります。たとえば、オラクルの Sun SPARC Enterprise T5440 サーバーを使用している場合、最大で 4 つのルートドメインを保持できます。
I/O ドメインおよびサービスドメインのサービスを使用し、制御ドメインによって管理されます。
Logical Domains Manager を使用して、ドメイン間の依存関係を確立できます。
1 つ以上のドメインが依存しているドメインです。マスタードメインは、マスタードメインに障害が発生した場合にそのスレーブドメインによって適用される障害ポリシーを指定します。たとえば、マスタードメインに障害が発生した場合、マスタードメインの障害ポリシーに基づき、スレーブドメインに対して、放置、パニックの発生、リブート、または停止を行うことができます。
他のドメインに依存しているドメインです。ドメインは、1 つ以上のマスタードメインに障害が発生した場合に障害ポリシーを適用するように指示するマスタードメインを、最大 4 つ指定できます。
サポートされているサブコマンドとその説明および各サブコマンドに必要な権限は、次のとおりです。ユーザーアカウントの承認の設定については、『Oracle VM Server for SPARC 2.2 管理ガイド』の「権利プロファイルと役割の使用」を参照してください。
|
注 - すべてのサブコマンドが、すべての資源タイプでサポートされているわけではありません。
次の表に、ldm サブコマンドの 3 種類の別名を示します。
|
注 - このマニュアルページの以降の構文および例では、省略形式の処理の別名および資源の別名を使用します。
次の資源がサポートされています。
CPU コア。
サポートされているサーバー上でサポートされている暗号化装置。現在、モジュラー演算ユニット (Modular Arithmetic Unit、MAU) と Control Word Queue (CWQ) の 2 つの暗号化装置がサポートされています。
PCIe ルートコンプレックスなどの I/O デバイスと、それらに接続されているアダプタとデバイス。ダイレクト I/O 割り当て可能デバイスおよび PCIe SR-IOV 仮想機能でもあります。
バイト単位のデフォルトのメモリーサイズ。つまり、G バイト (G)、K バイト (K)、または M バイト (M) を指定します。ゲストドメインに割り当てることができる、サーバーの仮想化されたメモリーです。
ゲストドメインの作成時に各ゲストドメインに割り当てるための特定範囲の TCP ポートを持つ、仮想コンソール端末集配信装置 (コンセントレータ) サービス。
システムレベルのメッセージにアクセスするための仮想コンソール。接続は、特定のポートで制御ドメイン上の vconscon サービスに接続することによって実現します。
各仮想 CPU は、サーバーの 1 つの CPU スレッドを表します。たとえば、8 コアの Sun SPARC Enterprise T5120 サーバーには、論理ドメイン間で割り当てることができる 64 の CPU スレッド (仮想 CPU) があります。
仮想ディスクは、さまざまな種類の物理デバイス、ボリューム、またはファイルで構成される総称的なブロック型デバイスです。仮想ディスクは SCSI ディスクと同義ではありません。そのため、ディスク名内のターゲット ID (tN) は除外されます。論理ドメインの仮想ディスクの形式は、cNdNsN です。cN は仮想コントローラ、dN は仮想ディスク番号、および sN はスライスを示します。
ほかの論理ドメインに仮想ディスクをエクスポートできる仮想ディスクサーバー。
仮想ディスクサーバーがエクスポートしたデバイス。このデバイスには、ディスク全体、ディスクのスライス、ファイル、またはディスクボリュームを指定できます。
仮想データプレーンのチャンネルクライアント。Netra Data Plane Software (NDPS) 環境でのみ使用されます。
仮想データプレーンのチャンネルサービス。Netra Data Plane Software (NDPS) 環境でのみ使用されます。
仮想 Ethernet デバイスを実装し、仮想ネットワークスイッチ (vsw) を使用するシステム内のほかの vnet デバイスと通信する仮想ネットワークデバイス。
仮想ネットワークデバイスを外部ネットワークに接続し、仮想ネットワークデバイス間でのパケットの切り替えも行う仮想ネットワークスイッチ。
次の種類のリストがサポートされています。
論理ドメインにバインドされている資源のリスト。
サービスプロセッサ (Service Processor、SP) 上に格納される論理ドメインの構成を一覧表示します。SPARC T3 ベースのサーバーでは、作成日の古いものから新しいものへ順番に構成が表示されます。
論理ドメインの作成に使用される制約のリスト。
サーバー用の使用されていないすべてのデバイスの一覧表示。
論理ドメインによってエクスポートされるすべてのサービスの一覧表示。
次の表に、ldm コマンドのオプションを示します。適用可能な場合、オプションの省略形式に続いて長形式を示します。
|
注 - さまざまな ldm set-* コマンドで、空の値を指定してプロパティーをデフォルト値にリセットできます。たとえば、次の ldm set-policy コマンドを実行すると、attack プロパティーをデフォルト値にリセットできます。
# ldm set-policy attack= high-policy ldom1
次のプロパティーがサポートされています。
代替 MAC アドレスをコンマで区切ったリストを指定します。有効な値は数値 MAC アドレスと auto キーワードで、これを 1 回以上使用して代替 MAC アドレスの生成をシステムに要求できます。auto キーワードと数値 MAC アドレスが混在してもかまいません。
いずれか 1 つの資源制御サイクル中に追加する資源の最大数を指定します。使用可能な資源の数が指定した値よりも少ない場合は、使用可能な資源がすべて追加されます。使用可能な CPU スレッドをできるだけ多く追加できるよう、デフォルトでは attack に制限はありません。有効な値は、1 から、システムで使用していない CPU スレッドの数までです。
ドメインに割り当てるかドメインから削除する物理コア ID を指定します。すべての名前付きコアを削除するには、ldm set-core cid= コマンドを実行して、cid プロパティーの core-ID 値を省略します。
cid プロパティーは、構成するシステムのトポロジに精通している管理者だけが使用するようにしてください。この高度な構成機能は、特定の割り当て規則を強制するため、システムの全体的なパフォーマンスに影響を与える可能性があります。
次の値のいずれかを指定します。
generic は、一般的な CPU ハードウェア機能を使用して、CPU の種類に依存しないゲストドメインの移行を実行できるようにします。
native は、CPU 固有のハードウェア機能を使用して、同じ種類の CPU を備えたプラットフォーム間でのみゲストドメインの移行を実行できるようにします。デフォルト値は native です。
generic 値を使用すると、native 値に比べてパフォーマンスが低下することがあります。これが発生するのは、新しい種類の CPU だけにある機能をゲストドメインが使用しないためです。generic 設定では、このような機能を使用しないため、新しい種類と古い種類の CPU を使用するシステム間でドメインの移行を柔軟に行うことができます。
いずれか 1 つの資源制御サイクル中に削除する資源の最大数を指定します。このプロパティーで指定されている値のほうが大きい場合でも、現在バインドされている CPU スレッドの数から vcpu-min の値を引いた数だけが削除できます。デフォルトでは、値は 1 です。有効な値は、1 から、CPU スレッドの合計数より 1 少ない数までです。
仮想ネットワークデバイスまたは仮想スイッチをメンバーにする必要があるデフォルトの仮想ローカルエリアネットワーク (VLAN) を、タグ付きモードで指定します。最初の VLAN ID (vid1) は、この default-vlan-id に予約されています。
util-lower と使用していない CPU スレッド数の間のバッファー領域の量を指定して、CPU スレッドの数を減らした場合の変動を回避します。有効な値は、0 から 100 までです。デフォルト値は 5 です。
個々のドメインの資源管理を有効または無効にします。デフォルトでは、enable=yes です。
ドメインの拡張されたマップイン領域を有効または無効にします。デフォルトでは extended-mapin-space=off に設定されています。
拡張されたマップイン領域は、追加の LCD 共有メモリー空間を参照します。このメモリー空間は、直接マップされた共有メモリーを使用する多数の仮想 I/O デバイスをサポートするために必要となります。この拡張されたマップイン領域も、パフォーマンスとスケーラビリティーを向上するために仮想ネットワークデバイスによって使用されます。
マスタードメインの障害ポリシーを指定します。このポリシーは、マスタードメインに障害が発生した場合のスレーブドメインの動作を制御します。このプロパティーは、マスタードメインで設定します。デフォルト値は ignore です。次に、有効なプロパティー値を示します。
ignore は、マスタードメインの障害を無視します。スレーブドメインは影響を受けません。
panic は、マスタードメインに障害が発生した場合、すべてのスレーブドメインにパニックを発生させます。
reset は、マスタードメインに障害が発生した場合、すべてのスレーブドメインをリセットします。
stop は、マスタードメインに障害が発生した場合、すべてのスレーブドメインを停止します。
コンソールを接続するグループを指定します。グループ引数を使用すると、同一の TCP 接続上で複数のコンソールを多重化できます。
特定のドメインのホスト ID を指定します。ホスト ID を指定しない場合、Logical Domains Manager により一意のホスト ID が各ドメインに割り当てられます。
新しい仮想ディスクデバイス、仮想ネットワークデバイス、および仮想スイッチデバイスの ID をそれぞれ指定します。
仮想ネットワークデバイス間でチャネルを割り当てるかどうかを指定します。デフォルト値は on です。
inter-vnet-link=on の場合、Logical Domains Manager は、ゲスト間のパフォーマンスを向上するために、同じ仮想スイッチに接続している仮想ネットワークデバイスの各ペア間にチャネルを割り当てます。
inter-vnet-link=off の場合、Logical Domains Manager は、仮想ネットワークデバイスと仮想スイッチ間の通信に対してのみチャネルを割り当てます。このとき、ゲスト間の通信トラフィックは仮想スイッチを経由します。この設定を使用すると、仮想ネットワークデバイスに使用されるチャネルの数が減少します。そのため、システムに追加できる仮想デバイスの最大数が増加します。
配下の物理ネットワークデバイスに基づいて、仮想デバイスがリンクステータスをレポートするかどうかを指定します。コマンドラインで linkprop=phys-state を指定すると、仮想デバイスのリンクステータスは物理リンクステータスを反映します。デフォルトでは、仮想デバイスのリンクステータスは物理リンクステータスを反映しません。
MAC アドレスを定義します。番号は、標準のオクテット記述法で指定する必要があります。たとえば、80:00:33:55:22:66 とします。
1 つのスレーブドメインに対して最大 4 つのマスタードメインの名前を指定します。このプロパティーは、スレーブドメインで設定します。デフォルトでは、ドメインに対してマスタードメインは設定されていません。ldm add-domain 操作の前に、そのドメインが存在している必要があります。
注 - Logical Domains Manager では、依存サイクルが生じるドメイン関係を作成することはできません。
ドメインに割り当てることができるコアの最大数を指定します。値が unlimited の場合、割り当てることができる CPU コアの数に制約はありません。
ドメインに割り当てるかドメインから削除する 1 つ以上の物理メモリーブロックを指定します。PA-start は、メモリーブロックの開始物理アドレスを 16 進形式で指定します。size は、ドメインに割り当てるかドメインから削除するメモリーブロックのサイズで、単位を含みます。すべての名前付きメモリーブロックを削除するには、ldm set-memory mblock= コマンドを実行して、mblock プロパティーから PA-start size 値を省略します。
mblock プロパティーは、構成するシステムのトポロジに精通している管理者だけが使用するようにしてください。この高度な構成機能は、特定の割り当て規則を強制するため、システムの全体的なパフォーマンスに影響を与える可能性があります。
add-vsw および set-vsw サブコマンドの場合:
ゲストドメインで Oracle Solaris クラスタ ソフトウェアが動作していない場合は、仮想ネットワークのパフォーマンスに影響を与える可能性があるため、このオプションを指定しないでください。
そうでない場合は、次のいずれかを指定します。
Logical Domains 環境で Oracle Solaris クラスタ ハートビートパケットの処理を優先順位付けするために、仮想ネットワークのサポートを有効にするには、mode=sc を指定します。
ハートビートパケット用の特別な処理を停止するには、set-vsw サブコマンドの mode= 引数を空白のままにします。
add-vnet および set-vnet サブコマンドの場合:
NIU ハイブリッド I/O を使用しない場合は、このオプションを省略します。
そうでない場合は、次のいずれかを指定します。
mode=hybrid を設定して、可能な場合には NIU ハイブリッド I/O を使用するようにシステムに要求します。可能でない場合は、システムにより仮想 I/O に戻されます。『Oracle VM Server for SPARC 2.2 管理ガイド』の「NIU ハイブリッド I/O の使用」を参照してください。
NIU ハイブリッド I/O を無効にするには、set-vnet サブコマンドの mode= 引数を空白のままにします。
複数の仮想ディスクサーバーデバイス (vdsdev) のマルチパスグループ名を定義します。したがって、仮想ディスクが仮想ディスクサーバーデバイスと通信できない場合、マルチパスグループ内のほかの仮想ディスクサーバーデバイスに対してフェイルオーバーが開始されます。
仮想スイッチ、その仮想スイッチにバインドされている仮想ネットワークデバイス、またはその両方の最大転送単位 (Maximum Transmission Unit、MTU) を指定します。有効な値の範囲は 1500 - 16000 です。無効な値を指定すると、ldm コマンドでエラーが発生します。
資源管理ポリシー名を指定します。
実際のネットワークデバイスのパス名を定義します。
特定の仮想ディスクサーバーデバイスに、次のオプションのすべてまたはサブセットを指定します。2 つ以上のオプションは、空白文字を入れずにコンマで区切って、ro,slice,excl のように指定します。
ro - 読み取り専用アクセスを指定
slice - 単一スライスのディスクとしてバックエンドをエクスポート
excl - 排他的なディスクアクセスを指定
add-vdsdev サブコマンドの options= 引数を指定しないか空白のままにすると、デフォルト値であるディスク、非排他的、および読み取り/書き込みになります。以前に指定したオプションをオフにするには、set-vdsdev サブコマンドの options= 引数を空白のままにします。
特定のポート番号を指定するか、空白のままにして、Logical Domains Manager によるポート番号の設定を可能にします。
TCP ポートの範囲を定義します。
Dynamic Resource Management (DRM) ポリシーの優先順位を指定します。優先順位の値は、単一ドメイン内の DRM ポリシー間の関係、および単一システム内の DRM 対応ドメイン間の関係を決定するために使用されます。数値が低いほど、優先度は高く (良く) なります。有効な値は、1 から 9999 までです。デフォルト値は 99 です。
priority プロパティーの動作は、次に示すように、使用していない CPU リソースプールが使用可能であるかどうかによって異なります。
使用していない CPU リソースがプール内にあります。この場合、priority プロパティーは、1 つのドメインに対して複数の重複するポリシーが定義されている場合に、どの DRM ポリシーが有効であるかを決定します。
使用していない CPU リソースがプール内にありません。この場合、priority プロパティーは、同じシステム内の優先順位の低いドメインから優先順位の高いドメインへリソースを動的に移動できるかどうかを指定します。ドメインの優先順位は、そのドメインで有効になっている DRM ポリシーによって指定された優先順位です。
たとえば、優先順位の高いドメインは、優先順位の低い DRM ポリシーを持つ別のドメインから CPU リソースを取得できます。このリソース取得機能は、DRM ポリシーが有効になっているドメインのみに適用されます。priority 値が等しいドメインは、この機能の影響を受けません。そのため、すべてのポリシーに対してデフォルトの優先順位が使用されている場合、ドメインは優先順位の低いドメインからリソースを取得できません。この機能を活用するには、値が等しくならないように priority プロパティーの値を調整します。
仮想ネットワークデバイスをメンバーにする必要のある VLAN をタグなしモードで指定します。
DRM のサンプリングレートとなるサイクル時間を秒で指定します。有効な値の範囲は、1 - 9999 です。推奨値はデフォルトの 10 です。
コンソール接続を処理する既存の仮想コンソール端末集配信装置の名前を指定します。
threading プロパティーは、ドメインのワークフローのスループットを指定します。
threading プロパティーの有効な値は次のとおりです。
max-ipc。ドメインに割り当てられている各 CPU コアでスレッドが 1 つだけアクティブになり、サイクルあたりの命令数が最大になります。このモードを選択するには、ドメインに whole-core 制約も設定されている必要があります。add-vcpu および set-vcpu サブコマンドの説明を参照してください。
max-throughput。ドメインに割り当てられているすべてのスレッドをアクティブにし、スループットを最大にします。このモードはデフォルトで使用され、モードを指定しない (threading=) 場合にも選択されます。
仮想ディスククライアント (vdc) と仮想ディスクサーバー (vds) の間の接続を確立する際の秒数を定義します。複数の仮想ディスク (vdisk) パスがある場合、vdc は、別の vds への接続を試みることができます。また、タイムアウトによって、いずれかの vds への接続が指定の時間内に確実に行われます。0 を指定すると set-vdisk サブコマンドのタイムアウトは無効になります。
ポリシーの有効開始時刻を指定します。単位は時、分、秒 (オプション) です。この時間は、午前 0 時から 23:59:59 の範囲で、tod-end で指定された時間よりも早い時間に設定する必要があります。デフォルト値は 00:00:00 です。
ポリシーの有効停止時刻を指定します。単位は時、分、秒 (オプション) です。この時間は、午前 0 時から 23:59:59 の範囲で、tod-begin で指定された時間よりも遅い時間に設定する必要があります。デフォルト値は 23:59:59 です。
ポリシー分析がトリガーされる使用率の下限レベルを指定します。有効な値は、1 から、util-upper より 1 少ない数までです。デフォルト値は 60 です。
ポリシー分析がトリガーされる使用率の上限レベルを指定します。有効な値は、util-lower に 1 を足した数から 99 までです。デフォルト値は 85 です。
ドメインの汎用一意識別子 (Universally Unique Identifier、UUID) を指定します。uuid は 12345678-1234-abcd-1234-123456789abc などの 16 進文字列で、ダッシュで区切られた 5 つの 16 進数から成ります。各数には、次のように、指定された数 (8、4、4、4、および 12) の 16 進数字を含める必要があります。
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ドメインの CPU スレッド資源の最大数を指定します。デフォルトでは、CPU スレッドの最大数に制限はありません。有効な値は、vcpu-min に 1 を足した数から、システムで使用していない CPU スレッドの合計数までです。
ドメインの CPU スレッド資源の最小数を指定します。有効な値は、1 から、vcpu-max より 1 少ない数までです。デフォルト値は 1 です。
仮想ネットワークデバイスまたは仮想スイッチをメンバーにする必要がある VLAN を、タグ付きモードで指定します。
仮想ディスクのボリューム名を変更します。
仮想ネットワークの仮想スイッチ名を変更します。
次に、list サブコマンド出力内のフラグの定義を示します。
可変部分
制御ドメイン
遅延再構成
エラー
通常
進行中のメモリー DR
列 1 - 起動または停止
列 6 - ソースドメイン
列 2 - 切り替え
列 6 - ターゲットドメイン
仮想 I/O サービスドメイン
リストフラグ値は位置に依存します。次に、左から順に 5 つの列のそれぞれに表示される可能性のある値を示します。
表 1 リストフラグの位置
|
この節では、サポートされているコマンド行インタフェース (Command-Line Interface、CLI) のすべての処理、つまり、すべてのサブコマンドと資源の組み合わせについて説明します。
このサブコマンドは、1 つ以上の論理ドメイン名を指定するかまたは XML 構成ファイルを使用して、1 つ以上の論理ドメインを追加します。MAC アドレス、ホスト ID、マスタードメインのリスト、障害ポリシーなど、ドメインをカスタマイズするためのプロパティー値を指定することもできます。これらのプロパティー値を指定しない場合、Logical Domains Manager により自動的にデフォルト値が割り当てられます。
ldm add-dom -i file ldm add-dom [cpu-arch=generic|native] [mac-addr=num] [hostid=num] [failure-policy=ignore|panic|reset|stop] [extended-mapin-space=on] [master=master-ldom1,...,master-ldom4] [max-cores=[num|unlimited]] [uuid=uuid] [threading=max-ipc] ldom ldm add-dom ldom...
各表記の意味は次のとおりです。
-i file は、論理ドメインの作成に使用する XML 構成ファイルを指定します。
cpu-arch=generic|native は、次の値のいずれかを指定します。
generic は、CPU の種類に依存しない移行を実行できるようにゲストドメインを構成します。
native は、同じ種類の CPU を備えたプラットフォーム間でのみ移行を実行できるようにゲストドメインを構成します。デフォルト値は native です。
mac-addr=num は、このドメインの MAC アドレスです。番号は、標準のオクテット記述法で指定する必要があります。たとえば、80:00:33:55:22:66 とします。
hostid は、特定のドメインのホスト ID を指定します。ホスト ID を指定しない場合、Logical Domains Manager により一意のホスト ID が各ドメインに割り当てられます。
failure-policy は、マスタードメインの障害ポリシーを指定します。このポリシーは、マスタードメインに障害が発生した場合のスレーブドメインの動作を制御します。このプロパティーは、マスタードメインで設定します。デフォルト値は ignore です。次に、有効なプロパティー値を示します。
ignore は、マスタードメインの障害を無視します。スレーブドメインは影響を受けません。
panic は、マスタードメインに障害が発生した場合、すべてのスレーブドメインにパニックを発生させます。
reset は、マスタードメインに障害が発生した場合、すべてのスレーブドメインをリセットします。
stop は、マスタードメインに障害が発生した場合、すべてのスレーブドメインを停止します。
extended-mapin-space=on は、指定したドメインで拡張されたマップイン領域を有効にします。デフォルトでは、拡張マップイン領域は無効になっています。
master には、1 つのスレーブドメインに対して最大 4 つのマスタードメインの名前を指定します。このプロパティーは、スレーブドメインで設定します。デフォルトでは、ドメインに対してマスタードメインは設定されていません。ldm add-domain 操作の前に、マスタードメインが存在している必要があります。
注 - Logical Domains Manager では、依存サイクルが生じるドメイン関係を作成することはできません。
threading プロパティーを設定することにより、ドメインのワークフローのスループットを指定します。
threading プロパティーの有効な値は次のとおりです。
max-ipc。ドメインに割り当てられている各 CPU コアでスレッドが 1 つだけアクティブになり、サイクルあたりの命令数が最大になります。このモードを選択するには、ドメインに whole-core 制約も設定されている必要があります。add-vcpu および set-vcpu サブコマンドの説明を参照してください。
max-throughput。ドメインに割り当てられているすべてのスレッドをアクティブにし、スループットを最大にします。このモードはデフォルトで使用され、モードを指定しない (threading=) 場合にも選択されます。
uuid=uuid は、ドメインの汎用一意識別子 (Universally Unique Identifier、UUID) を指定します。uuid は 12345678-1234-abcd-1234-123456789abc などの 16 進文字列で、ダッシュで区切られた 5 つの 16 進数から成ります。各数には、次のように、指定された数 (8、4、4、4、および 12) の 16 進数字を含める必要があります。
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
max-cores=[num|unlimited] は、ドメインに割り当てることができるコアの最大数を指定します。値が unlimited の場合、割り当てることができる CPU コアの数に制約はありません。
ldom は、追加する論理ドメインを指定します。
このサブコマンドでは、各ドメインの mac-addr、hostid、failure-policy、extended-mapin-space、master、max-cores、および threading プロパティーのみを変更できます。このコマンドをリソースのプロパティーを更新するために使用することはできません。
注 - スレーブドメインがバインドされている場合、ldm set-domain コマンドを呼び出す前に、指定したすべてのマスタードメインもバインドしておく必要があります。
ldm set-dom -i file ldm set-dom [cpu-arch=generic|native] [mac-addr=num] [hostid=num] [failure-policy=ignore|panic|reset|stop] [extended-mapin-space=[on|off]] [master=[master-ldom1,...,master-ldom4]] [max-cores=[num|unlimited]] [threading=[max-throughput|max-ipc]] ldom
各表記の意味は次のとおりです。
-i file は、論理ドメインの作成に使用する XML 構成ファイルを指定します。
XML ファイルで指定された ldom_info ノードのみが解析されます。vcpu、mau、memory などのリソースノードは無視されます。
cpu-arch=generic|native は、次の値のいずれかを指定します。
generic は、CPU の種類に依存しない移行を実行できるようにゲストドメインを構成します。
native は、同じ種類の CPU を備えたプラットフォーム間でのみ移行を実行できるようにゲストドメインを構成します。デフォルト値は native です。
mac-addr=num は、このドメインの MAC アドレスです。番号は、標準のオクテット記述法で指定する必要があります。たとえば、80:00:33:55:22:66 とします。
hostid は、特定のドメインのホスト ID を指定します。ホスト ID を指定しない場合、Logical Domains Manager により一意のホスト ID が各ドメインに割り当てられます。
failure-policy は、マスタードメインの障害ポリシーを指定します。このポリシーは、マスタードメインに障害が発生した場合のスレーブドメインの動作を制御します。このプロパティーは、マスタードメインで設定します。デフォルト値は ignore です。次に、有効なプロパティー値を示します。
ignore は、マスタードメインの障害を無視します。スレーブドメインは影響を受けません。
panic は、マスタードメインに障害が発生した場合、すべてのスレーブドメインにパニックを発生させます。
reset は、マスタードメインに障害が発生した場合、すべてのスレーブドメインをリセットします。
stop は、マスタードメインに障害が発生した場合、すべてのスレーブドメインを停止します。
extended-mapin-space は、指定したドメインで拡張されたマップイン領域を有効または無効にすることができます。デフォルトでは、extended-mapin-space=off に設定されています。これは、extended-mapin-space= と同等の設定です。
master には、1 つのスレーブドメインに対して最大 4 つのマスタードメインの名前を指定します。このプロパティーは、スレーブドメインで設定します。デフォルトでは、ドメインに対してマスタードメインは設定されていません。この操作の前に、マスタードメインが存在している必要があります。
注 - Logical Domains Manager では、依存サイクルが生じるドメイン関係を作成することはできません。
threading プロパティーを設定することにより、ドメインのワークフローのスループットを指定します。
threading プロパティーの有効な値は次のとおりです。
max-ipc。ドメインに割り当てられている各 CPU コアでスレッドが 1 つだけアクティブになり、サイクルあたりの命令数が最大になります。このモードを選択するには、ドメインに whole-core 制約も設定されている必要があります。add-vcpu および set-vcpu サブコマンドの説明を参照してください。
max-throughput。ドメインに割り当てられているすべてのスレッドをアクティブにし、スループットを最大にします。このモードはデフォルトで使用され、モードを指定しない (threading=) 場合にも選択されます。
max-cores=[num|unlimited] は、ドメインに割り当てることができるコアの最大数を指定します。値が unlimited の場合、割り当てることができる CPU コアの数に制約はありません。
ldom は、オプションを設定する論理ドメインの名前を指定します。
このサブコマンドは、1 つ以上の論理ドメインを削除します。
ldm rm-dom -a ldm rm-dom ldom...
各表記の意味は次のとおりです。
-a は、制御ドメインを除くすべての論理ドメインを削除します。
ldom は、削除する論理ドメインを指定します。
破棄するドメインがマスタードメインとして指定されている場合は、このドメインへの参照がすべてのスレーブドメインから削除されます。
このサブコマンドは、ドメインをある場所から別の場所に移行します。
ldm migrate-domain [-f] [-n] [-p filename] source-ldom [user@]target-host[:target-ldom]
各表記の意味は次のとおりです。
-f は、ドメインの移行を強制的に行なおうとします。
-n は、移行が成功するかどうかを判別するために、移行の予行演習を行います。ドメインの移行が実際に行われるわけではありません。
-p filename を使用すると、ターゲットマシンで必要なパスワードを filename の先頭行から読み取ることができます。このオプションでは、ターゲットマシンのパスワードをプロンプトで入力する必要がない非対話型のマイグレーションを実行できます。
この方法でパスワードを格納する場合は、ファイルのアクセス権の設定が 400 または 600 であること、つまり root 所有者 (特権ユーザー) のみがファイルの読み取りまたは書き込みを許可されていることを確認します。
source-ldom は、移行対象の論理ドメインです。
user は、ターゲットホスト上で Logical Domains Manager の実行を承認されているユーザー名です。ユーザー名を指定しない場合、デフォルトで、このコマンドを実行しているユーザーの名前が使用されます。
target-host は、target-ldom の配置先のホストです。
target-ldom は、ターゲットマシンで使用する論理ドメイン名です。デフォルトでは、ソースドメイン (source-ldom) で使用されているドメイン名が保持されます。
Logical Domains は次の種類の再構成処理をサポートしています。
動的再構成 (Dynamic Reconfiguration、DR) 処理。DR は、アクティブなドメインに対してリソースの追加、設定、または削除を行う機能です。特定の種類のリソースの動的再構成を実行できるかどうかは、論理ドメインで動作している特定のバージョンの OS でサポートされているかどうかに依存します。制御ドメインでは、DR を実行できない場合には、代わりに遅延再構成処理が実行されます。また、ldm start-reconf primary コマンドを実行することにより、制御ドメイン上で遅延再構成モードに手動で切り替えることもできます。
遅延再構成 (Delayed reconfiguration、DR) 処理。ただちに有効になる DR 処理とは対照的に遅延再構成処理は次回の OS のリブート後に有効になるか、OS が動作していない場合は論理ドメインの停止および起動後に有効になります。遅延再構成処理は、制御ドメインでのみ実行できます。動的に構成できない資源を変更する前に、ほかのドメインを停止する必要があります。
動的再構成と遅延再構成の詳細については、『Oracle VM Server for SPARC 2.2 管理ガイド』の「リソースの再構成」を参照してください。
CPU スレッドまたは CPU コアのどちらかをドメインに割り当てることができます。CPU スレッドを割り当てるには、add-vcpu、set-vcpu、および remove-vcpu サブコマンドを使用します。CPU コアを割り当てるには、add-core、set-core、および remove-core サブコマンドを使用します。
CPU スレッドの追加このサブコマンドは、指定された数の CPU スレッドまたは CPU コアを論理ドメインに追加します。ドメインに CPU コアと CPU スレッドを同時に構成することはできません。CPU コアの構成と CPU スレッドの構成は相互排他的です。
ldm add-vcpu [-c] number ldom
各表記の意味は次のとおりです。
-c は、次に示す個別の CPU 操作を実行します。
まだ設定されていない場合は、ドメインの割り当て単位をスレッドからコアに設定し、指定された数のコアをドメインに追加します。
ドメインがアクティブでない場合は、ドメインがバインドされるかアクティブになったときに割り当てることのできるコア数の上限を設定します。primary ドメインに上限が設定されるのは、ドメインが遅延再構成モードの場合のみです。
割り当て要求の結果、上限よりも多くのコアがドメインに割り当てられる場合、そのコマンドは失敗します。
このオプションは、Oracle VM Server for SPARC システムのハードパーティションを構成します。『Oracle VM Server for SPARC 2.2 管理ガイド』の「ハードパーティションによるシステムの構成」を参照してください。
割り当て単位をコアからスレッドに変更したり、上限を削除したりできます。これらの変更を行うには、アクティブでないドメインまたは遅延再構成モードの primary ドメインで、add-vcpu、set-vcpu、または rm-vcpu コマンドを -c オプションなしで発行します。
Oracle VM Server for SPARC 2.2 リリース以降、CPU 上限と CPU コアの割り当ては個別のコマンドで処理されます。これらのコマンドを使用して、CPU コアの割り当て、上限の設定、またはその両方を独立して行うことができます。上限が設定されていない場合でも、割り当て単位をコアに設定できます。ただし、Oracle VM Server for SPARC システムでハードパーティションを構成する場合、このモードでシステムを実行することはできません。
指定した数の CPU コアをドメインに割り当てるには、add-core、set-core、および rm-core サブコマンドを使用します。
上限を設定するには、create-domain または set-domain サブコマンドを使用して max-cores プロパティー値を指定します。
-c オプションが指定されていない場合、number は論理ドメインに追加される CPU スレッドの数です。-c オプションが指定されている場合、number は論理ドメインに追加される CPU コアの数です。
ldom は、CPU スレッドを追加する論理ドメインを指定します。
このサブコマンドは、論理ドメインで設定するCPU スレッドの数または CPU コアの数を指定します。ドメインに CPU コアと CPU スレッドを同時に構成することはできません。CPU コアの構成と CPU スレッドの構成は相互排他的です。
ldm set-vcpu [-c] number ldom
各表記の意味は次のとおりです。
-c は、次に示す個別の CPU 操作を実行します。
まだ設定されていない場合は、ドメインの割り当て単位をスレッドからコアに設定し、割り当てを指定された数のコアに設定します。
ドメインがアクティブでない場合は、ドメインがバインドされるかアクティブになったときに割り当てることのできるコア数の上限を設定します。primary ドメインに上限が設定されるのは、ドメインが遅延再構成モードの場合のみです。
割り当て要求の結果、上限よりも多くのコアがドメインに割り当てられる場合、そのコマンドは失敗します。
このオプションは、Oracle VM Server for SPARC システムのハードパーティションを構成します。『Oracle VM Server for SPARC 2.2 管理ガイド』の「ハードパーティションによるシステムの構成」を参照してください。
割り当て単位をコアからスレッドに変更したり、上限を削除したりできます。これらの変更を行うには、アクティブでないドメインまたは遅延再構成モードの primary ドメインで、add-vcpu、set-vcpu、または rm-vcpu コマンドを -c オプションなしで発行します。
Oracle VM Server for SPARC 2.2 リリース以降、CPU 上限と CPU コアの割り当ては個別のコマンドで処理されます。これらのコマンドを使用して、CPU コアの割り当て、上限の設定、またはその両方を独立して行うことができます。上限が設定されていない場合でも、割り当て単位をコアに設定できます。ただし、Oracle VM Server for SPARC システムでハードパーティションを構成する場合、このモードでシステムを実行することはできません。
指定した数の CPU コアをドメインに割り当てるには、add-core、set-core、および rm-core サブコマンドを使用します。
上限を設定するには、create-domain または set-domain サブコマンドを使用して max-cores プロパティー値を指定します。
-c オプションが指定されていない場合、number は論理ドメインに対して設定される CPU スレッドの数です。-c オプションが指定されている場合、number は論理ドメインに対して設定される CPU コアの数です。
ldom は、CPU スレッドの数を設定する論理ドメインです。
このサブコマンドは、指定された数の CPU スレッドまたは CPU コアを論理ドメインから削除します。ドメインに CPU コアと CPU スレッドを同時に構成することはできません。CPU コアの構成と CPU スレッドの構成は相互排他的です。
ldm rm-vcpu [-c] number ldom
各表記の意味は次のとおりです。
-c は、次に示す個別の CPU 操作を実行します。
まだ設定されていない場合は、ドメインの割り当て単位をスレッドからコアに設定し、指定された数のコアをドメインから削除します。
ドメインがアクティブでない場合は、ドメインがバインドされるかアクティブになったときに割り当てることのできるコア数の上限を設定します。primary ドメインに上限が設定されるのは、ドメインが遅延再構成モードの場合のみです。
割り当て要求の結果、上限よりも多くのコアがドメインに割り当てられる場合、そのコマンドは失敗します。
このオプションは、Oracle VM Server for SPARC システムのハードパーティションを構成します。『Oracle VM Server for SPARC 2.2 管理ガイド』の「ハードパーティションによるシステムの構成」を参照してください。
割り当て単位をコアからスレッドに変更したり、上限を削除したりできます。これらの変更を行うには、アクティブでないドメインまたは遅延再構成モードの primary ドメインで、add-vcpu、set-vcpu、または rm-vcpu コマンドを -c オプションなしで発行します。
Oracle VM Server for SPARC 2.2 リリース以降、CPU 上限と CPU コアの割り当ては個別のコマンドで処理されます。これらのコマンドを使用して、CPU コアの割り当て、上限の設定、またはその両方を独立して行うことができます。上限が設定されていない場合でも、割り当て単位をコアに設定できます。ただし、Oracle VM Server for SPARC システムでハードパーティションを構成する場合、このモードでシステムを実行することはできません。
指定した数の CPU コアをドメインに割り当てるには、add-core、set-core、および rm-core サブコマンドを使用します。
上限を設定するには、create-domain または set-domain サブコマンドを使用して max-cores プロパティー値を指定します。
-c オプションが指定されていない場合、number は論理ドメインから削除される CPU スレッドの数です。-c オプションが指定されている場合、number は論理ドメインから削除される CPU コアの数です。
ldom は、CPU スレッドを削除する論理ドメインを指定します。
このサブコマンドは、指定された数の CPU コアを論理ドメインに追加します。CPU コアの数を指定した場合、割り当てられるコアは自動的に選択されます。ただし、cid プロパティーに core-ID 値を指定すると、指定したコアが明示的に割り当てられます。
cid プロパティーは、構成するシステムのトポロジに精通している管理者だけが使用するようにしてください。この高度な構成機能は、特定の割り当て規則を強制するため、システムの全体的なパフォーマンスに影響を与える可能性があります。
電源管理でエラスティックポリシーを使用していないかぎり、ドメインにコアを明示的に割り当てることができます。
ldm add-core num ldom ldm add-core cid=core-ID[,core-ID[,...]] ldom
各表記の意味は次のとおりです。
num は、ドメインに割り当てる CPU コアの数を指定します。
cid=core-ID[,...] は、ドメインに割り当てる 1 つ以上の物理 CPU コアを指定します。
ldom は、CPU コアを割り当てるドメインを指定します。
このサブコマンドは、ドメインに割り当てる CPU コアの数を指定します。CPU コアの数を指定した場合、割り当てられるコアは自動的に選択されます。ただし、cid プロパティーに core-ID 値を指定すると、指定したコアが明示的に割り当てられます。
電源管理でエラスティックポリシーを使用していないかぎり、ドメインにコアを明示的に割り当てることができます。
ldm set-core num ldom ldm set-core cid=[core-ID[,core-ID[,...]]] ldom
各表記の意味は次のとおりです。
num は、ドメインに割り当てる CPU コアの数を指定します。
cid=core-ID[,...] は、ドメインに割り当てる 1 つ以上の物理 CPU コアを指定します。cid= は、すべての名前付き CPU コアを削除します。
ldom は、CPU コアを割り当てるドメインを指定します。
このサブコマンドは、ドメインから削除する CPU コアの数を指定します。CPU コアの数を指定した場合、削除されるコアは自動的に選択されます。ただし、cid プロパティーに core-ID 値を指定すると、指定したコアが明示的に削除されます。
電源管理でエラスティックポリシーを使用していないかぎり、ドメインからコアを明示的に削除できます。
ldm remove-core [-f] num ldom ldm remove-core cid=[core-ID[,core-ID[,...]]] ldom
各表記の意味は次のとおりです。
-f は、アクティブドメインからの 1 つ以上のコアの削除を強制的に試行します。
num は、ドメインから削除する CPU コアの数を指定します。
cid=core-ID[,...] は、ドメインから削除する 1 つ以上の物理 CPU コアを指定します。
ldom は、CPU コアを削除するドメインを指定します。
暗号化装置のサブコマンドは、個別の暗号化装置を備えた SPARC プラットフォームのみに適用されます。
暗号化装置の追加このサブコマンドは、論理ドメインに追加する暗号化装置の数を指定します。現在、サポートされているサーバー上でサポートされている暗号化装置は、モジュラー演算ユニット (Modular Arithmetic Unit、MAU) および Control Word Queue (CWQ) です。
ldm add-crypto number ldom
各表記の意味は次のとおりです。
number は、論理ドメインに追加する暗号化装置の数です。
ldom は、暗号化装置を追加する論理ドメインを指定します。
このサブコマンドは、論理ドメインで設定する暗号化装置の数を指定します。アクティブなドメインからすべての暗号化装置を削除する場合は、-f オプションを指定する必要があります。
ドメインがアクティブなときに primary ドメインから最後の暗号化装置を削除する場合は、次のいずれかの操作を実行します。
DR を使用して -f オプションを指定
遅延再構成を使用
ldm set-crypto [-f] number ldom
各表記の意味は次のとおりです。
number が 0 の場合に -f を指定すると、ドメイン内の最後の暗号化装置が強制的に削除されます。
-f オプションは次の状況でのみ必要となります。
ゲストドメインがアクティブな場合
primary ドメイン上 (ただし、システム上にアクティブなゲストドメインが 1 つ以上存在する場合のみ)
number は、論理ドメインで設定する暗号化装置の数です。
ldom は、暗号化装置の数を設定する論理ドメインを指定します。
このサブコマンドは、指定した数の暗号化装置を論理ドメインから削除します。アクティブなドメインからすべての暗号化装置を削除する場合は、-f オプションを指定する必要があります。
ドメインがアクティブなときに primary ドメインから最後の暗号化装置を削除する場合は、次のいずれかの操作を実行します。
DR を使用して -f オプションを指定
遅延再構成を使用
ldm rm-crypto [-f] number ldom
各表記の意味は次のとおりです。
-f は、number がドメイン内の暗号化装置の数と等しい場合に、ドメイン内の最後の暗号化装置を強制的に削除します。
-f オプションは次の状況でのみ必要となります。
ゲストドメインがアクティブな場合
primary ドメイン上 (ただし、システム上にアクティブなゲストドメインが 1 つ以上存在する場合のみ)
number は、論理ドメインから削除する暗号化装置の数です。
ldom は、暗号化装置を削除する論理ドメインを指定します。
このサブコマンドは、指定された量のメモリーをドメインに追加します。メモリーブロックサイズを指定した場合、割り当てられるメモリーブロックは自動的に選択されます。ただし、mblock プロパティーに PA-start:size 値を指定すると、指定したメモリーブロックが明示的に割り当てられます。
mblock プロパティーは、構成するシステムのトポロジに精通している管理者だけが使用するようにしてください。この高度な構成機能は、特定の割り当て規則を強制するため、システムの全体的なパフォーマンスに影響を与える可能性があります。
ldm add-mem [--auto-adj] size[unit] ldom ldm add-mem mblock=PA-start:size[,PA-start:size[,...]] ldom
各表記の意味は次のとおりです。
--auto-adj は、アクティブドメインに追加されるメモリーの量を自動的に 256M バイト単位に揃えることを指定します。これにより、要求されるメモリーサイズが増える場合があります。ドメインがアクティブでないか、バインドされているか、遅延再構成の状態にある場合、このオプションでは、次の 256M バイト境界に切り上げることにより、ドメインの結果として得られるサイズを自動的に揃えます。
size は、論理ドメインに追加するメモリーのサイズです。
unit は測定単位です。デフォルトはバイト単位です。測定単位を変更する場合、次のいずれかを指定します。unit では、大文字と小文字が区別されません。
G は G バイト
K は K バイト
M は M バイト
mblock=PA-start:size は、ドメインに割り当てる 1 つ以上の物理メモリーブロックを指定します。PA-start は、メモリーブロックの開始物理アドレスを 16 進形式で指定します。size は、ドメインに割り当てるメモリーブロックのサイズで、単位を含みます。
ldom は、メモリーを追加する論理ドメインを指定します。
このサブコマンドは、ドメインで一定量のメモリーを設定します。指定したメモリーの量に応じて、このサブコマンドは add-memory または remove-memory 操作として扱われます。
メモリーブロックサイズを指定した場合、割り当てられるメモリーブロックは自動的に選択されます。ただし、mblock プロパティーに PA-start:size 値を指定すると、指定したメモリーブロックが明示的に割り当てられます。
ldm set-mem [--auto-adj] size[unit] ldom ldm set-mem mblock=PA-start:size[,PA-start:size[,...]] ldom
各表記の意味は次のとおりです。
--auto-adj は、アクティブドメインで設定されるメモリーの量を 自動的に 256M バイト単位に揃えることを指定します。これにより、要求されるメモリーサイズが増す場合があります。ドメインがアクティブでないか、バインドされているか、遅延再構成の状態にある場合、このオプションでは、次の 256M バイト境界に切り上げることにより、ドメインの結果として得られるサイズを自動的に揃えます。
size は、論理ドメインで設定するメモリーのサイズです。
unit は測定単位です。デフォルトはバイト単位です。測定単位を変更する場合、次のいずれかを指定します。unit では、大文字と小文字が区別されません。
G は G バイト
K は K バイト
M は M バイト
mblock=PA-start:size は、ドメインに割り当てる 1 つ以上の物理メモリーブロックを指定します。PA-start は、メモリーブロックの開始物理アドレスを 16 進形式で指定します。size は、ドメインに割り当てるメモリーブロックのサイズで、単位を含みます。
ldom は、メモリーを変更する論理ドメインを指定します。
このサブコマンドは、指定された量のメモリーを論理ドメインから削除します。メモリーブロックサイズを指定した場合、削除されるメモリーブロックは自動的に選択されます。ただし、mblock プロパティーに PA-start:size 値を指定すると、指定したメモリーブロックが明示的に削除されます。
ldm rm-mem [--auto-adj] size[unit] ldom ldm rm-mem mblock=PA-start:size[,PA-start:size[,...]] ldom
各表記の意味は次のとおりです。
--auto-adj は、アクティブドメインから削除されるメモリーの量を自動的に 256M バイト単位に揃えることを指定します。これにより、要求されるメモリーサイズが増える場合があります。ドメインがアクティブでないか、バインドされているか、遅延再構成の状態にある場合、このオプションでは、次の 256M バイト境界に切り上げることにより、ドメインの結果として得られるサイズを自動的に揃えます。
size は、論理ドメインから削除するメモリーのサイズです。
unit は測定単位です。デフォルトはバイト単位です。測定単位を変更する場合、次のいずれかを指定します。unit では、大文字と小文字が区別されません。
G は G バイト
K は K バイト
M は M バイト
mblock=PA-start:size は、ドメインから削除する 1 つ以上の物理メモリーブロックを指定します。PA-start は、メモリーブロックの開始物理アドレスを 16 進形式で指定します。size は、ドメインから削除するメモリーブロックのサイズで、単位を含みます。
ldom は、メモリーを削除する論理ドメインを指定します。
このサブコマンドは、ドメインの遅延再構成モードへの切り替えを有効にします。primary は、ldom の唯一の有効な値です。
ldm start-reconf ldom
このサブコマンドは、遅延再構成を取り消します。primary は、ldom の唯一の有効な値です。
ldm cancel-reconf ldom
このサブコマンドは、論理ドメインに対する遅延再構成 (reconf)、メモリー DR 削除 (memdr)、またはドメイン移行 (migration) を取り消します。reconf 操作の場合、primary は ldom の唯一の有効な値です。
ldm cancel-op migration ldom ldm cancel-op reconf ldom ldm cancel-op memdr ldom
このサブコマンドは、指定された論理ドメインに PCI バスまたはデバイスを追加します。
ldm add-io (bus | device | vf-name) ldom
各表記の意味は次のとおりです。
bus、device、および vf-name は、それぞれ、PCIe バス、ダイレクト I/O 割り当て可能デバイス、および PCIe SR-IOV 仮想機能です。オペランドにはデバイスパスまたは仮名を指定できますが、デバイス仮名を使用することをお勧めします。仮名は、対応する I/O カードスロットを識別するためにシャーシに記載されている ASCII ラベルに基づき、プラットフォーム固有です。
デバイス名に関連付けられた仮名の例を次に示します。
PCIe バス。pci_0 仮名は pci@400 デバイスパスと一致します。
ダイレクト I/O 割り当て可能デバイス。PCIE1 仮名は pci@400/pci@0/pci@c デバイスパスと一致します。
PCIe SR-IOV 仮想機能。/SYS/MB/NET0/IOVNET.PF0.VF0 仮名は pci@400/pci@2/pci@0/pci@6/network@0 デバイスパスと一致します。
指定されたゲストドメインは、アクティブでない状態またはバインドされた状態である必要があります。primary ドメインを指定した場合、このコマンドは遅延再構成を開始します。
ldom は、バスまたはデバイスを追加する論理ドメインを指定します。
このサブコマンドは、プロパティー値を変更するか新しいプロパティーを渡すことにより、仮想機能の現在の構成を変更します。このコマンドでは、クラス固有のプロパティーとデバイス固有のプロパティーの両方を変更できます。
ネットワーククラス固有のプロパティーのほとんどは、primary ドメインをリブートせずに変更できます。mtu プロパティーを変更した場合はリブートが必要です。仮想機能の MAC アドレスを変更する場合は、ドメインを停止する必要があります。
デバイス固有のプロパティーはすべて、遅延再構成を開始して、物理機能のデバイスドライバの接続処理中にそれらのプロパティーが更新されるようにします。その結果、primary ドメインをリブートする必要があります。
このコマンドが成功するのは、結果として得られる構成が物理機能のドライバで正常に検証できた場合のみです。
ldm set-io [mac-addr=num] [alt-mac-addrs=[auto|num1,[auto|num2,...]]] [pvid=[port-vlan-id]] [vid=[vlan-id1,vlan-id2,...]] [mtu=size] [name=value...] vf-name
各表記の意味は次のとおりです。
name=value は、設定するプロパティーの名前と値の組み合わせです。
vf-name は、仮想機能の名前です。
このサブコマンドは、物理機能の構成を変更します。物理機能のデバイス固有のプロパティーだけがサポートされています。プロパティーは物理機能のデバイスドライバの接続処理中に適用されるため、プロパティーに変更を加えると遅延再構成が行われます。
プロパティーの値は整数または文字列でなければなりません。プロパティー値の型、および特定のプロパティーが設定可能かどうかを調べるには、ldm list-io -d コマンドを実行します。
ldm set-io コマンドが成功するのは、結果として得られる構成が物理機能のドライバで正常に検証された場合のみです。
ldm set-io name=value [name=value...] pf-name
各表記の意味は次のとおりです。
name=value は、設定するプロパティーの名前と値の組み合わせです。
pf-name は、物理機能の名前です。
このサブコマンドは、指定された論理ドメインから PCI バスまたはデバイスを削除します。
ldm rm-io (bus | device | vf-name) ldom
各表記の意味は次のとおりです。
bus、device、および vf-name は、それぞれ、PCIe バス、ダイレクト I/O 割り当て可能デバイス、および PCIe SR-IOV 仮想機能です。オペランドにはデバイスパスまたは仮名を指定できますが、デバイス仮名を使用することをお勧めします。仮名は、対応する I/O カードスロットを識別するためにシャーシに記載されている ASCII ラベルに基づき、プラットフォーム固有です。
デバイス名に関連付けられた仮名の例を次に示します。
PCIe バス。pci_0 仮名は pci@400 デバイスパスと一致します。
ダイレクト I/O 割り当て可能デバイス。PCIE1 仮名は pci@400/pci@0/pci@c デバイスパスと一致します。
PCIe SR-IOV 仮想機能。/SYS/MB/NET0/IOVNET.PF0.VF0 仮名は pci@400/pci@2/pci@0/pci@6/network@0 デバイスパスと一致します。
指定されたゲストドメインは、アクティブでない状態またはバインドされた状態である必要があります。primary ドメインを指定した場合、このコマンドは遅延再構成を開始します。
ldom は、バスまたはデバイスを削除する論理ドメインを指定します。
このサブコマンドは、指定した論理ドメインに仮想スイッチを追加します。
ldm add-vsw [-q] [default-vlan-id=vlan-id] [pvid=port-vlan-id] [vid=vlan-id1,vlan-id2,...] [linkprop=phys-state] [mac-addr=num] [net-dev=device] [mode=sc] [mtu=size] [id=switch-id] [inter-vnet-link=on|off] vswitch-name ldom
各表記の意味は次のとおりです。
-q は、net-dev プロパティーで指定されたネットワークデバイスのパスの検証を無効にします。特に論理ドメインがフル構成ではない場合に、このオプションによってコマンドをより迅速に実行できるようになります。
default-vlan-id=vlan-id は、仮想スイッチとそれに関連する仮想ネットワークデバイスが暗黙にタグなしモードで属するデフォルトの VLAN を指定します。これは、仮想スイッチおよび仮想ネットワークデバイスのデフォルトのポート VLAN ID (pvid) として機能します。このオプションを指定しない場合、このプロパティーのデフォルト値は 1 です。通常、このオプションを指定する必要はありません。このオプションは、単にデフォルト値の 1 を変更する手段として用意されています。
pvid=port-vlan-id には、仮想スイッチデバイスをメンバーにする必要のある VLAN をタグなしモードで指定します。このプロパティーは、set-vsw サブコマンドにも適用されます。『Oracle VM Server for SPARC 2.2 管理ガイド』の「VLAN のタグ付けの使用」を参照してください。
linkprop=phys-state では、配下の物理ネットワークデバイスに基づいて、仮想デバイスがリンクステータスをレポートするかどうかを指定できます。コマンドラインで linkprop=phys-state を指定すると、仮想デバイスのリンクステータスは物理リンクステータスを反映します。デフォルトでは、仮想デバイスのリンクステータスは物理リンクステータスを反映しません。
vid=vlan-id は、仮想ネットワークデバイスまたは仮想スイッチをメンバーにする必要がある 1 つ以上の VLAN を、タグ付きモードで指定します。このプロパティーは、set-vsw サブコマンドにも適用されます。詳細については、『Oracle VM Server for SPARC 2.2 管理ガイド』の「VLAN のタグ付けの使用」を参照してください。
mac-addr=num は、このスイッチが使用する MAC アドレスです。番号は、標準のオクテット記述法で指定する必要があります。たとえば、80:00:33:55:22:66 とします。MAC アドレスを指定しない場合、スイッチには、Logical Domains Manager に割り当てられる公開 MAC アドレスの範囲からアドレスが自動的に割り当てます。
net-dev=device は、このスイッチが動作するネットワークデバイスへのパスです。システムは、-q オプションが指定されない場合、パスが実際のネットワークデバイスを参照していることを検証します。
mode=sc は、Logical Domains 環境で Oracle Solaris クラスタ ハートビートパケットの処理を優先順位付けするために、仮想ネットワークのサポートを有効にします。Oracle Solaris クラスタ などのアプリケーションでは、輻輳した仮想ネットワークおよびスイッチデバイスによって高優先度のハートビートパケットがドロップされないようにする必要があります。このオプションを使用して、Oracle Solaris クラスタ のハートビートフレームが優先され、これらのフレームが信頼性の高い方法で転送されるようにします。
Oracle Solaris クラスタ を Logical Domains 環境で実行し、ゲストドメインを Oracle Solaris クラスタ ノードとして使用している場合にこのオプションを設定する必要があります。ゲストドメインで Oracle Solaris クラスタ ソフトウェアを実行していない場合には、仮想ネットワークのパフォーマンスに影響を与える可能性があるため、このオプションを設定しないでください。
mtu=size は、仮想スイッチデバイスの最大転送単位 (Maximum Transmission Unit、MTU) を指定します。有効な値の範囲は 1500 - 16000 です。
id=switch-id は、新しい仮想スイッチデバイスの ID です。デフォルトでは ID 値は自動的に生成されるため、OS で既存のデバイス名に一致させる必要がある場合に、このプロパティーを設定します。
inter-vnet-link=on|off を使用して、同じ仮想スイッチに接続した仮想ネットワークデバイスの各ペア間にチャネルを割り当てるかどうかを指定します。この動作は、ゲスト間のパフォーマンスを向上させます。デフォルト値は on です。
vswitch-name は、サービスとしてエクスポートされるスイッチの一意の名前です。クライアント (ネットワーク) は、このサービスに接続できます。
ldom は、仮想スイッチを追加する論理ドメインを指定します。
このサブコマンドは、すでに追加されている仮想スイッチのプロパティーを変更します。
ldm set-vsw [-q] [pvid=port-vlan-id] [vid=vlan-id1,vlan-id2,...] [mac-addr=num] [net-dev=device] [linkprop=[phys-state]] [mode=[sc]] [mtu=size] [inter-vnet-link=[on|off]] vswitch-name
各表記の意味は次のとおりです。
-q は、net-dev プロパティーで指定されたネットワークデバイスのパスの検証を無効にします。特に論理ドメインがフル構成ではない場合に、このオプションによってコマンドをより迅速に実行できるようになります。
pvid=port-vlan-id には、仮想スイッチデバイスをメンバーにする必要のある VLAN をタグなしモードで指定します。『Oracle VM Server for SPARC 2.2 管理ガイド』の「VLAN のタグ付けの使用」を参照してください。
vid=vlan-id は、仮想ネットワークデバイスまたは仮想スイッチをメンバーにする必要がある 1 つ以上の VLAN を、タグ付きモードで指定します。『Oracle VM Server for SPARC 2.2 管理ガイド』の「VLAN のタグ付けの使用」を参照してください。
mac-addr=num は、スイッチで使用される MAC アドレスです。番号は、標準のオクテット記述法で指定する必要があります。たとえば、80:00:33:55:22:66 とします。
net-dev=device は、このスイッチが動作するネットワークデバイスへのパスです。システムは、-q オプションが指定されない場合、パスが実際のネットワークデバイスを参照していることを検証します。
linkprop=phys-state では、配下の物理ネットワークデバイスに基づいて、仮想デバイスがリンクステータスをレポートするかどうかを指定できます。コマンドラインで linkprop=phys-state を指定すると、仮想デバイスのリンクステータスは物理リンクステータスを反映します。デフォルトでは、仮想デバイスのリンクステータスは物理リンクステータスを反映しません。linkprop プロパティーを指定していない場合や、linkprop= 引数を使用して ldm set-vsw コマンドを実行する場合は、デフォルトの状態になります。
mode=sc は、Logical Domains 環境で Oracle Solaris クラスタ ハートビートパケットの処理を優先順位付けするために、仮想ネットワークのサポートを有効にします。Oracle Solaris クラスタ などのアプリケーションでは、輻輳した仮想ネットワークおよびスイッチデバイスによって高優先度のハートビートパケットがドロップされないようにする必要があります。このオプションを使用して、Oracle Solaris クラスタ のハートビートフレームが優先され、これらのフレームが信頼性の高い方法で転送されるようにします。
mode= (空白のまま) では、 ハートビートパケットの特殊処理が停止されます。
Oracle Solaris クラスタ を Logical Domains 環境で実行し、ゲストドメインを Oracle Solaris クラスタ ノードとして使用している場合にこのオプションを設定する必要があります。ゲストドメインで Oracle Solaris クラスタ ソフトウェアを実行していない場合には、仮想ネットワークのパフォーマンスに影響を与える可能性があるため、このオプションを設定しないでください。
mtu=size は、仮想スイッチデバイスの最大転送単位 (Maximum Transmission Unit、MTU) を指定します。有効な値の範囲は 1500 - 16000 です。
inter-vnet-link=on|off を使用して、同じ仮想スイッチに接続した仮想ネットワークデバイスの各ペア間にチャネルを割り当てるかどうかを指定します。この動作は、ゲスト間のパフォーマンスを向上させます。デフォルト値は on です。
vswitch-name は、サービスとしてエクスポートされるスイッチの一意の名前です。クライアント (ネットワーク) は、このサービスに接続できます。
このサブコマンドは、仮想スイッチを削除します。
ldm rm-vsw [-f] vswitch-name
各表記の意味は次のとおりです。
-f は、仮想スイッチの強制削除を試行します。削除は失敗することがあります。
vswitch-name は、サービスとして削除されるスイッチの名前です。
このサブコマンドは、指定した論理ドメインに仮想ネットワークデバイスを追加します。
ldm add-vnet [mac-addr=num] [mode=hybrid] [pvid=port-vlan-id] [vid=vlan-id1,vlan-id2,...] [linkprop=phys-state] [id=network-id] [mtu=size] if-name vswitch-name ldom
各表記の意味は次のとおりです。
mac-addr=num は、このネットワークデバイスの MAC アドレスです。番号は、標準のオクテット記述法で指定する必要があります。たとえば、80:00:33:55:22:66 とします。
mode=hybrid は、可能な場合に、この vnet で NIU ハイブリッド I/O を使用するようにシステムに要求します。可能でない場合は、システムは仮想 I/O に戻ります。このハイブリッドモードを制御ドメイン上のアクティブな vnet で設定した場合、このモードは遅延再構成とみなされます。『Oracle VM Server for SPARC 2.2 管理ガイド』の「NIU ハイブリッド I/O の使用」を参照してください。
pvid=port-vlan-id には、仮想ネットワークデバイスをメンバーにする必要のある VLAN をタグなしモードで指定します。『Oracle VM Server for SPARC 2.2 管理ガイド』の「VLAN のタグ付けの使用」を参照してください。
vid=vlan-id は、仮想ネットワークデバイスがタグ付きモードでメンバーとして属する必要のある 1 つ以上の VLAN を指定します。『Oracle VM Server for SPARC 2.2 管理ガイド』の「VLAN のタグ付けの使用」を参照してください。
mtu=size は、仮想ネットワークデバイスの最大転送単位 (Maximum Transmission Unit、MTU) を指定します。有効な値の範囲は 1500 - 16000 です。
linkprop=phys-state では、配下の物理ネットワークデバイスに基づいて、仮想ネットワークデバイスがリンクステータスをレポートするかどうかを指定できます。コマンドラインで linkprop=phys-state を指定すると、仮想ネットワークデバイスのリンクステータスは物理リンクステータスを反映します。デフォルトでは、仮想ネットワークデバイスのリンクステータスは物理リンクステータスを反映しません。
id=network-id は、新しい仮想ネットワークデバイスの ID です。デフォルトでは ID 値は自動的に生成されるため、OS で既存のデバイス名に一致させる必要がある場合に、このプロパティーを設定します。
if-name は、後続の set-vnet または rm-vnet サブコマンドで参照するためにこの仮想ネットワークデバイスのインスタンスに割り当てられる、論理ドメインで一意のインタフェース名です。
vswitch-name は、接続する既存のネットワークサービス (仮想スイッチ) の名前です。
ldom は、仮想ネットワークデバイスを追加する論理ドメインを指定します。
このサブコマンドは、指定した論理ドメインで仮想ネットワークデバイスのオプションを設定します。
ldm set-vnet [mac-addr=num] [vswitch=vswitch-name] [mode=[hybrid]] [pvid=port-vlan-id] [linkprop=[phys-state]] [vid=vlan-id1,vlan-id2,...] [mtu=size] if-name ldom
各表記の意味は次のとおりです。
mac-addr=num は、このネットワークデバイスの MAC アドレスです。番号は、標準のオクテット記述法で指定する必要があります。たとえば、80:00:33:55:22:66 とします。
vswitch=vswitch-name は、接続する既存のネットワークサービス (仮想スイッチ) の名前です。
mode=hybrid を指定すると、この vnet での NIU ハイブリッド I/O 操作が有効になります。このオプションを制御ドメイン上のアクティブな vnet で設定した場合、遅延再構成とみなされます。NIU ハイブリッド I/O を無効にするには、mode= 引数を空白のままにします。
pvid=port-vlan-id には、仮想ネットワークデバイスをメンバーにする必要のある VLAN をタグなしモードで指定します。『Oracle VM Server for SPARC 2.2 管理ガイド』の「VLAN のタグ付けの使用」を参照してください。
linkprop=phys-state では、配下の物理ネットワークデバイスに基づいて、仮想デバイスがリンクステータスをレポートするかどうかを指定できます。コマンドラインで linkprop=phys-state を指定すると、仮想デバイスのリンクステータスは物理リンクステータスを反映します。デフォルトでは、仮想デバイスのリンクステータスは物理リンクステータスを反映しません。linkprop プロパティーを指定していない場合や、linkprop= 引数を使用して ldm set-vnet コマンドを実行する場合は、デフォルトの状態になります。
vid=vlan-id は、仮想ネットワークデバイスがタグ付きモードでメンバーとして属する必要のある 1 つ以上の VLAN を指定します。『Oracle VM Server for SPARC 2.2 管理ガイド』の「VLAN のタグ付けの使用」を参照してください。
mtu=size は、仮想ネットワークデバイスの最大転送単位 (Maximum Transmission Unit、MTU) を指定します。有効な値の範囲は 1500 - 16000 です。
if-name は、設定する仮想ネットワークデバイスに割り当てられた一意のインタフェース名です。
ldom は、仮想ネットワークデバイスを変更する論理ドメインを指定します。
このサブコマンドは、指定した論理ドメインから仮想ネットワークデバイスを削除します。
ldm rm-vnet [-f] if-name ldom
各表記の意味は次のとおりです。
-f は、論理ドメインからの仮想ネットワークデバイスの強制削除を試行します。削除は失敗することがあります。
if-name は、削除する仮想ネットワークデバイスに割り当てられた一意のインタフェース名です。
ldom は、仮想ネットワークデバイスを削除する論理ドメインを指定します。
このサブコマンドは、指定した論理ドメインに仮想ディスクサーバーを追加します。
ldm add-vds service-name ldom
各表記の意味は次のとおりです。
service-name は、仮想ディスクサーバーのこのインスタンスのサービス名です。この service-name は、サーバー上のすべての仮想ディスクサーバーインスタンスの中で一意である必要があります。
ldom は、仮想ディスクサーバーを追加する論理ドメインを指定します。
このサブコマンドは、仮想ディスクサーバーを削除します。
ldm rm-vds [-f] service-name
各表記の意味は次のとおりです。
-f は、仮想ディスクサーバーの削除を強制的に試行します。削除は失敗することがあります。
service-name は、仮想ディスクサーバーのこのインスタンスの一意のサービス名です。
注意 - -f オプションを指定すると、削除前にすべてのクライアントのバインド解除が試行されます。書き込みが進行中の場合は、ディスクデータが失われる可能性があります。 |
このサブコマンドは、仮想ディスクサーバーにデバイスを追加します。このデバイスには、ディスク全体、ディスクのスライス、ファイル、またはディスクボリュームを指定できます。『Oracle VM Server for SPARC 2.2 管理ガイド』の第 7 章「仮想ディスクの使用」を参照してください。
ldm add-vdsdev [-f] [-q] [options={ro,slice,excl}] [mpgroup=mpgroup] backend volume-name@service-name
各表記の意味は次のとおりです。
-f は、すでに別の仮想ディスクサーバーに属しているブロックデバイスパスを指定する場合に、追加の仮想ディスクサーバーの作成を強制的に試行します。-f オプションを指定する場合は、引数リストの先頭に指定する必要があります。
-q は、backend オペランドで指定された仮想ディスクのバックエンドの検証を無効にします。特に論理ドメインまたはバックエンドがフル構成ではない場合に、このオプションによってコマンドをより迅速に実行できるようになります。
options= は、次の値を指定します。
ro - 読み取り専用アクセスを指定
slice - 単一スライスのディスクとしてバックエンドをエクスポート
excl - 排他的なディスクアクセスを指定
options= 引数を指定しないと、デフォルト値であるディスク、非排他的、および読み取り/書き込みになります。options= 引数を追加する場合は、特定の仮想ディスクサーバーデバイスに 1 つ以上のオプションを指定する必要があります。2 つ以上のオプションは、空白文字を入れずにコンマで区切って、ro,slice,excl のように指定します。
mpgroup=mpgroup は、仮想ディスクのフェイルオーバーをサポートするために使用されるディスクのマルチパスグループ名です。現在使用中の仮想ディスクサーバーデバイスへの接続に障害が発生した場合に備えて、仮想ディスクの複数の冗長パスを割り当てることができます。それには、複数の仮想ディスクサーバーデバイス (vdsdev) を 1 つのマルチパスグループ (mpgroup) にまとめます。すべての仮想ディスクサーバーデバイスが同じ mpgroup 名を持つことになります。仮想ディスクがマルチパスグループ内の仮想ディスクサーバーデバイスのいずれかにバインドされると、その仮想ディスクは、mpgroup に属するすべての仮想ディスクサーバーデバイスにバインドされます。
backend は、仮想ディスクのデータが格納される場所です。バックエンドには、ディスク、ディスクのスライス、ファイル、ボリューム (ZFS、Solaris Volume Manager、VxVM など)、または任意の擬似ディスクデバイスを指定できます。ディスクラベルには、SMI VTOC、EFI、またはラベルなしを指定できます。バックエンドは、バックエンドをサービスドメインからエクスポートする際に slice オプションを設定するかどうかに応じて、フルディスクまたは 1 つのスライスディスクのいずれかとしてゲストドメインに表示されます。デバイスを追加する場合、volume-name を backend と組み合わせる必要があります。システムは、-q オプションが指定されない場合、backend で指定された場所が存在し、仮想ディスクのバックエンドとして使用できることを検証します。
volume-name は、仮想ディスクサーバーに追加するデバイスに指定する必要がある一意の名前です。volume-name は、仮想ディスクサーバーのこのインスタンスで一意である必要があります。この名前は、追加のために仮想ディスクサーバーによってクライアントにエクスポートされるためです。デバイスを追加する場合、volume-name を backend と組み合わせる必要があります。
service-name は、このデバイスを追加する仮想ディスクサーバーの名前です。
このサブコマンドは、仮想ディスクサーバーのオプションを設定します。『Oracle VM Server for SPARC 2.2 管理ガイド』を参照してください。
ldm set-vdsdev [-f] options=[{ro,slice,excl}] [mpgroup=mpgroup] volume-name@service-name
各表記の意味は次のとおりです。
-f は、同じ論理ドメイン内の複数のボリュームが読み取り専用モード (option=ro) で同一のブロックデバイスパスを共有している場合に、読み取り専用制限を解除します。-f オプションを指定する場合は、引数リストの先頭に指定する必要があります。
options= は、次の値を指定します。
ro - 読み取り専用アクセスを指定
slice - 単一スライスのディスクとしてバックエンドをエクスポート
excl - 排他的なディスクアクセスを指定
以前に指定したオプションをオフにするには、options= 引数を空白のままにします。特定の仮想ディスクサーバーデバイスに、次のオプションのすべてまたはサブセットを指定できます。2 つ以上のオプションは、空白文字を入れずにコンマで区切って、ro,slice,excl のように指定します。
mpgroup=mpgroup は、仮想ディスクのフェイルオーバーをサポートするために使用されるディスクのマルチパスグループ名です。現在使用中の仮想ディスクサーバーデバイスへの接続に障害が発生した場合に備えて、仮想ディスクの複数の冗長パスを割り当てることができます。それには、複数の仮想ディスクサーバーデバイス (vdsdev) を 1 つのマルチパスグループ (mpgroup) にまとめます。すべての仮想ディスクサーバーデバイスが同じ mpgroup 名を持つことになります。仮想ディスクがマルチパスグループ内の仮想ディスクサーバーデバイスのいずれかにバインドされると、その仮想ディスクは、mpgroup に属するすべての仮想ディスクサーバーデバイスにバインドされます。
volume-name は、service-name で指定したサービスによってエクスポートされた既存のボリュームの名前です。
service-name は、変更する仮想ディスクサーバーの名前です。
このサブコマンドは、仮想ディスクサーバーからデバイスを削除します。
ldm rm-vdsdev [-f] volume-name@service-name
各表記の意味は次のとおりです。
-f は、仮想ディスクサーバーのデバイスの削除を強制的に試行します。削除は失敗することがあります。
volume-name は、仮想ディスクサーバーから削除するデバイスの一意の名前です。
service-name は、このデバイスを削除する仮想ディスクサーバーの名前です。
注意 - -f オプションを指定しない場合、デバイスがビジーだと rm-vdsdev サブコマンドは仮想ディスクサーバーのデバイスの削除を許可しません。-f オプションを指定した場合は、開いているファイルのデータが失われる可能性があります。 |
このサブコマンドは、指定した論理ドメインに仮想ディスクを追加します。仮想ディスクサーバーとの接続を確立することができない場合、オプションのタイムアウトプロパティーを使用すると、仮想ディスクのタイムアウトを指定できます。
ldm add-vdisk [timeout=seconds] [id=disk-id] disk-name volume-name@service-name ldom
各表記の意味は次のとおりです。
timeout=seconds は、仮想ディスククライアント (vdc) と仮想ディスクサーバー (vds) の間の接続を確立する際の秒数です。複数の仮想ディスク (vdisk) パスがある場合、vdc は、別の vds への接続を試みることができます。また、タイムアウトによって、いずれかの vds への接続が指定の時間内に確実に行われます。
timeout= 引数を指定しないか、または timeout=0 を設定すると、仮想ディスクは無制限に待機します。
id=disk-id は、新しい仮想ディスクデバイスの ID です。デフォルトでは ID 値は自動的に生成されるため、OS で既存のデバイス名に一致させる必要がある場合に、このプロパティーを設定します。
disk-name は、仮想ディスクの名前です。
volume-name は、接続する既存の仮想ディスクサーバーデバイスの名前です。
service-name は、接続する既存の仮想ディスクサーバーの名前です。
ldom は、仮想ディスクを追加する論理ドメインを指定します。
このサブコマンドは、指定した論理ドメインで仮想ディスクのオプションを設定します。仮想ディスクサーバーとの接続を確立することができない場合、オプションのタイムアウトプロパティーを使用すると、仮想ディスクのタイムアウトを指定できます。
ldm set-vdisk [timeout=seconds] [volume=volume-name@service-name] disk-name ldom
各表記の意味は次のとおりです。
timeout=seconds は、仮想ディスククライアント (vdc) と仮想ディスクサーバー (vds) の間の接続を確立する際の秒数です。複数の仮想ディスク (vdisk) パスがある場合、vdc は、別の vds への接続を試みることができます。また、タイムアウトによって、いずれかの vds への接続が指定の時間内に確実に行われます。
タイムアウトを無効にするには、timeout=0 と設定します。
timeout= 引数で、仮想ディスクが無制限に待機するように指定しないでください。
volume=volume-name は、接続する仮想ディスクサーバーデバイスの名前です。service-name は、接続する仮想ディスクサーバーの名前です。
disk-name は、既存の仮想ディスクの名前です。
ldom は、以前にこの仮想ディスクを追加した既存の論理ドメインを指定します。
このサブコマンドは、指定した論理ドメインから仮想ディスクを削除します。
ldm rm-vdisk [-f] disk-name ldom
各表記の意味は次のとおりです。
-f は、仮想ディスクの削除を強制的に試行します。削除は失敗することがあります。
disk-name は、削除する仮想ディスクの名前です。
ldom は、仮想ディスクを削除する論理ドメインを指定します。
このサブコマンドは、指定した論理ドメインに仮想データプレーンのチャンネルサービスを追加します。このサブコマンドは、Netra Data Plane Software (NDPS) 環境でのみ使用してください。
ldm add-vdpcs vdpcs-service-name ldom
各表記の意味は次のとおりです。
vdpcs-service-name は、追加する仮想データプレーンのチャンネルサービスの名前です。
ldom は、仮想データプレーンのチャンネルサービスを追加する論理ドメインを指定します。
このサブコマンドは、仮想データプレーンのチャンネルサービスを削除します。このサブコマンドは、Netra Data Plane Software (NDPS) 環境でのみ使用してください。
ldm rm-vdpcs [-f] vdpcs-service-name
各表記の意味は次のとおりです。
-f は、仮想データプレーンのチャンネルサービスの削除を強制的に試行します。削除は失敗することがあります。
vdpcs-service-name は、削除する仮想データプレーンのチャンネルサービスの名前です。
このサブコマンドは、指定した論理ドメインに仮想データプレーンのチャンネルクライアントを追加します。このサブコマンドは、Netra Data Plane Software (NDPS) 環境でのみ使用してください。
ldm add-vdpcc vdpcc-name vdpcs-service-name ldom
各表記の意味は次のとおりです。
vdpcc-name は、仮想データプレーンのチャンネルサービスクライアントの一意の名前です。
vdpcs-service-name は、このクライアントに接続する仮想データプレーンのチャンネルサービスの名前です。
ldom は、仮想データプレーンのチャンネルクライアントを追加する論理ドメインを指定します。
このサブコマンドは、指定した論理ドメインから仮想データプレーンのチャンネルクライアントを削除します。このサブコマンドは、Netra Data Plane Software (NDPS) 環境でのみ使用してください。
ldm rm-vdpcc [-f] vdpcc-name ldom
各表記の意味は次のとおりです。
-f は、仮想データプレーンのチャンネルクライアントの削除を強制的に試行します。削除は失敗することがあります。
vdpcc-name は、削除する仮想データプレーンのチャンネルクライアントに割り当てられた一意の名前です。
ldom は、仮想データプレーンのチャンネルクライアントを削除する論理ドメインを指定します。
このサブコマンドは、指定した論理ドメインに仮想コンソール端末集配信装置を追加します。
ldm add-vcc port-range=x-y vcc-name ldom
各表記の意味は次のとおりです。
port-range=x-y は、仮想コンソール端末集配信装置でコンソール接続に使用される TCP ポートの範囲です。
vcc-name は、追加する仮想コンソール端末集配信装置の名前です。
ldom は、仮想コンソール端末集配信装置を追加する論理ドメインを指定します。
このサブコマンドは、特定の仮想コンソール端末集配信装置のオプションを設定します。
ldm set-vcc port-range=x-y vcc-name
各表記の意味は次のとおりです。
port-range=x-y は、仮想コンソール端末集配信装置でコンソール接続に使用される TCP ポートの範囲です。変更後のポートの範囲には、端末集配信装置のクライアントに割り当てられているすべてのポートが含まれている必要があります。
vcc-name は、設定する仮想コンソール端末集配信装置の名前です。
このサブコマンドは、指定した論理ドメインから仮想コンソール端末集配信装置を削除します。
ldm rm-vcc [-f] vcc-name
各表記の意味は次のとおりです。
-f は、仮想コンソール端末集配信装置の削除を強制的に試行します。削除は失敗することがあります。
vcc-name は、削除する仮想コンソール端末集配信装置の名前です。
注意 - -f オプションを指定すると、削除前にすべてのクライアントのバインド解除が試行されます。書き込みが進行中の場合は、データが失われる可能性があります。 |
このサブコマンドは、指定した論理ドメインで特定のポート番号とグループを設定します。また、接続されているコンソールのサービスを設定することもできます。このサブコマンドは、ドメインがアクティブでない場合にのみ使用できます。
ldm set-vcons [port=[port-num]] [group=group] [service=vcc-server] ldom
各表記の意味は次のとおりです。
port=port-num は、このコンソールで使用する特定のポートです。Logical Domains Manager で自動的にポート番号を割り当てるには、port-num を空白のままにします。
group=group は、このコンソールに接続する新しいグループです。グループ引数を使用すると、同一の TCP 接続上で複数のコンソールを多重化できます。この概念については、Oracle Solaris OS vntsd(1M) マニュアルページを参照してください。グループを指定した場合は、サービスも指定する必要があります。
service=vcc-server は、コンソール接続を処理する既存の仮想コンソール端末集配信装置の名前です。グループを指定した場合は、サービスを指定する必要があります。
ldom は、仮想コンソール端末集配信装置を設定する論理ドメインを指定します。
PCIe SR-IOV (Single Root I/O Virtualization) 規格を使用すると、I/O ドメイン間で PCIe デバイスを効率的に共有できます。この規格は、ネイティブに近い I/O パフォーマンスを実現するために、ハードウェアに実装されます。SR-IOV では、物理デバイスまたは物理機能の仮想化されたインスタンスである仮想機能がいくつか作成されます。仮想機能は I/O ドメインに直接割り当てられて、これらのドメインが関連付けられた物理デバイスを共有し、CPU およびハイパーバイザのオーバーヘッドなしで I/O を実行できるようにします。
PCIe 物理機能は、ハードウェアに完全にアクセスでき、仮想機能の作成、構成、および管理のための SR-IOV 機能を提供します。システムボード上の PCIe コンポーネントまたは PCIe プラグインカードには、1 つ以上の物理機能があります。Oracle Solaris ドライバは、SR-IOV 機能へのアクセスを提供する物理機能と相互に作用します。
PCIe 仮想機能には、データの移動に必要な資源が含まれています。仮想機能を持つ I/O ドメインは、Oracle Solaris 仮想機能ドライバを介してハードウェアにアクセスし I/O を直接実行できます。この動作により、I/O ドメインで実行されるアプリケーションとルートドメインの物理 I/O デバイスの間の通信パスにおけるボトルネックが除去され、仮想 I/O 機能に関連するオーバーヘッドと待ち時間が回避されます。
これらのコマンドの一部では、物理機能または仮想機能の識別子を次のように指定する必要があります。
pf-name ::= pf-pseudonym | pf-path vf-name ::= vf-pseudonym | vf-path
対応するデバイスを参照するときは仮名形式を使用します。これは、ldm list-io の出力の NAME 列に表示される名前の形式です。ldm list-io -l コマンドを実行した場合は、パス形式の名前が出力に表示されます。ldm list-io -p の出力には、alias= トークンの値として仮名形式、dev= トークンの値としてパス形式が表示されます。
仮想機能の作成このサブコマンドは、指定された物理機能に含まれる仮想機能の数を 1 だけ増分することにより、指定された物理機能から仮想機能を作成します。新しい仮想機能には、連続する仮想機能番号の中で最大の番号が割り当てられます。新しい仮想機能を作成すると、primary ドメインの遅延再構成が開始されます。
ネットワーククラスの仮想機能には MAC アドレスが割り当てられる必要があり、これはデフォルトで割り当てられます。デフォルトの MAC アドレス値を上書きするには、mac-addr プロパティーに別の値を指定します。
仮想機能の作成時に、クラス固有のプロパティーとデバイス固有のプロパティーを設定することもできます。このコマンドが成功するのは、結果として得られる構成が物理機能のドライバで正常に検証された場合のみです。デフォルトでは、新しい仮想機能はどのドメインにも割り当てられません。primary ドメインがリブートされ、仮想機能がハードウェア内でインスタンス化されたあとでのみ、仮想機能を I/O ドメインに割り当てる (バインドする) ことができます。複数の仮想機能を作成するかどうかを事前に計画してください。その場合は、リブートを複数回実行することを避けるために、1 つずつ続けて作成します。
デバイス固有のプロパティーは、物理機能ドライバによってエクスポートされるプロパティーに依存します。詳細を調べるには、ldm list-io -d コマンドを使用します。コマンドが成功すると、遅延再構成に関するメッセージが表示されます。
ldm create-vf [mac-addr=num] [alt-mac-addrs=auto|num1,[auto|num2,...]] [pvid=port-vlan-id] [vid=vlan-id1,vlan-id2,...] [mtu=size] [name=value...] pf-name
各表記の意味は次のとおりです。
mac-addr=num は、仮想機能のプライマリ MAC アドレスです。
alt-mac-addrs=auto|num1,[auto|num2,...] は、代替 MAC アドレスをコンマで区切ったリストです。有効な値は数値 MAC アドレスと auto キーワードで、これを 1 回以上使用して代替 MAC アドレスの生成をシステムに要求できます。auto キーワードと数値 MAC アドレスが混在してもかまいません。
pvid=port-vlan-id は、ポートの VLAN ID (デフォルト値なし) です
vid=vlan-id1,vlan-id2... は、VLAN ID をコンマで区切ったリストです。
mtu=size は、仮想機能の最大転送単位 (バイト単位) です。
name=value は、指定するプロパティーの名前と値の組み合わせです。
pf-name は、物理機能の名前です。
このサブコマンドは、指定された物理機能から仮想機能を破棄します。このコマンドが成功するのは、次が成り立つ場合のみです。
指定された仮想機能が、現在どのドメインにも割り当てられていない。
指定された仮想機能が、対応する物理機能の最後の仮想機能である。
結果として得られる構成が物理機能のドライバで正常に検証される。
仮想機能の数の変更はリブートの一環としてのみ実行できるため、処理が成功すると遅延再構成が開始される。詳細については、create-vf サブコマンドを参照してください。
ldm destroy-vf vf-name
この vf-name は、仮想機能の名前です。
このサブコマンドは、論理ドメインに 1 つ以上の変数を追加します。
ldm add-var var-name=[value]... ldom
各表記の意味は次のとおりです。
var-name=value は、追加する変数の名前と値の組み合わせです。値は省略可能です。
ldom は、変数を追加する論理ドメインを指定します。
このサブコマンドは、論理ドメインの変数を設定します。
ldm set-var var-name=[value]... ldom
各表記の意味は次のとおりです。
var-name=value は、設定する変数の名前と値の組み合わせです。値は省略可能です。
ldom は、変数を設定する論理ドメインを指定します。
注 - value を空白のままにすると、var-name は値なしに設定されます。
このサブコマンドは、論理ドメインの変数を削除します。
ldm rm-var var-name... ldom
各表記の意味は次のとおりです。
var-name は、削除する変数の名前です。
ldom は、変数を削除する論理ドメインを指定します。
このサブコマンドは、1 つ以上の論理ドメインを起動します。
ldm start -a ldm start -i file ldm start ldom...
各表記の意味は次のとおりです。
-a は、バインドされているすべての論理ドメインを起動します。
-i file は、論理ドメインの起動に使用する XML 構成ファイルを指定します。
ldom は、起動する 1 つ以上の論理ドメインを指定します。
このサブコマンドは、1 つ以上の動作中の論理ドメインを停止します。Oracle Solaris OS が起動している場合、このサブコマンドは論理ドメインに uadmin 要求を送信します。より「正常な」方法でドメインを停止するには、停止するドメインで shutdown または init 操作を実行します。shutdown(1M) および init(1M) のマニュアルページを参照してください。
ldm stop [-f] -a ldm stop [-f] ldom...
各表記の意味は次のとおりです。
-f は、動作中の論理ドメインの停止を強制的に試行します。ドメインをその他の手段で停止できない場合にのみ使用してください。
-a は、制御ドメインを除く動作中のすべての論理ドメインを停止します。
ldom は、停止する 1 つ以上の動作中の論理ドメインを指定します。
このサブコマンドは、指定された論理ドメイン上の Oracle Solaris OS でパニックを発生させます。これによりバックトレースおよびクラッシュダンプが提供されます (Oracle Solaris OS をそのように設定した場合)。dumpadm(1M) コマンドは、クラッシュダンプを構成する手段を提供します。
ldm panic ldom
ldom は、パニックを発生させる論理ドメインを指定します。
ヘルプ情報の表示このサブコマンドは、すべてのサブコマンドまたは指定したサブコマンドの使用法を表示します。また、ldm コマンドを単独で使用することでも、すべてのサブコマンドの使用法を表示できます。
ldm --help [subcommand]
subcommand は、使用法についての情報を表示する ldm サブコマンドを指定します。
バージョン情報の表示このサブコマンドは、バージョン情報を表示します。
ldm --version ldm -Vドメインへの資源のバインド
このサブコマンドは、論理ドメインに構成済みの資源をバインド (接続) します。
ldm bind-dom [-f] [-q] -i file ldm bind-dom [-f] [-q] ldom
各表記の意味は次のとおりです。
-f は、無効なネットワークデバイスまたはディスクバックエンドデバイスが検出されても、ドメインのバインディングを強制的に実行しようとします。
-q は、ネットワークデバイスまたはディスクバックエンドデバイスの検証を無効にするため、コマンドをより迅速に実行できるようになります。
-i file は、論理ドメインのバインドに使用する XML 構成ファイルを指定します。
ldom は、資源をバインドする論理ドメインを指定します。
このサブコマンドは、構成された論理ドメインにバインドされている資源を解放します。
ldm unbind-dom ldom
ldom は、資源のバインドを解除する論理ドメインを指定します。
このサブコマンドは、現在アクティブな構成または以前に自動保存された構成に基づいて、論理ドメイン構成を追加します。この構成は、サービスプロセッサ (Service Processor、SP) に格納されます。
ldm add-config config-name ldm add-config -r autosave-name [new-config-name]
各表記の意味は次のとおりです。
config-name は、追加する論理ドメイン構成の名前です。
-r autosave-name は、自動保存構成データを次のいずれかに適用します。
SP 上の同じ名前の構成
SP 上に存在しない、新たに作成される構成 (new-config-name)
対象の構成が SP に存在していない場合は、その名前の構成が、対応する自動保存構成の内容に基づいて作成され、SP に保存されます。自動保存構成データが適用されたあと、これらの自動保存ファイルは、制御ドメインから削除されます。autosave-name が現在選択している構成を示していない場合、または new-config-name を指定した場合は、SP 上の現在の構成の状態や、制御ドメイン上のその構成の自動保存ファイルには影響がありません。
破損していることがわかっている自動保存構成を回復するには、-r new-config-name を指定する必要があります。破損していることがわかっている構成で既存の構成を上書きすることはできません。
new-config-name は、追加する論理ドメイン構成の名前です。
このサブコマンドを使用すると、使用する論理ドメイン構成を指定できます。この構成は、SP に格納されます。
ldm set-config config-name
config-name は、使用する論理ドメイン構成の名前です。
デフォルトの構成名は、factory-default です。デフォルトの構成を指定するには、次のサブコマンドを使用します。
ldm set-config factory-default論理ドメイン構成の削除
このサブコマンドは、SP に格納されている論理ドメイン構成を削除し、対応する自動保存構成を制御ドメインから削除します。
ldm rm-config [-r] config-name
各表記の意味は次のとおりです。
-r は、自動保存構成だけを制御ドメインから削除します。
config-name は、削除する論理ドメイン構成の名前です。
このサブコマンドは、論理ドメインおよびその状態のリストを表示します。論理ドメインを指定しない場合、すべての論理ドメインが表示されます。
ldm ls-dom [-e] [-l] [-o format] [-p][ [ldom...]
各表記の意味は次のとおりです。
-e は、自動的に設定されるサービスおよびデバイスを含む拡張リストを生成します。これは制御できません。
-l は、長いリストを生成します。
-o は、出力の format を、次に示すサブセットのうち 1 つ以上に制限します。複数の形式を指定する場合は、各形式をコンマで区切ります。スペースは入れません。
console - 出力には、仮想コンソール (vcons) および仮想コンソール端末集配信装置 (vcc) サービスが含まれます。
core – 出力には、コア、コア ID、および物理 CPU セットに関する情報が含まれます。
cpu – 出力には、CPU スレッド (vcpu)、物理 CPU (pcpu)、およびコア ID (cid) に関する情報が含まれます。
crypto - 暗号化装置の出力には、モジュラー演算ユニット (Modular Arithmetic Unit、mau)、およびサポートされているその他の暗号化装置 (Control Word Queue、CWQ) などが含まれます。
disk - 出力には、仮想ディスク (vdisk) および仮想ディスクサーバー (vds) が含まれます。
domain – 出力には、変数 (var)、ホスト ID (hostid)、ドメインの状態、フラグ、汎用一意識別子 (Universally Unique Identifier、UUID)、ソフトウェアの状態、利用率 (%)、スレーブのマスタードメイン、およびマスタードメインの障害ポリシーが含まれます。
memory - 出力には、メモリー (memory) が含まれます。
network - 出力には、メディアアクセス制御 (mac) アドレス、仮想ネットワークスイッチ (vsw)、および仮想ネットワーク (vnet) デバイスが含まれます。
physio - 物理入出力には、Peripheral Component Interconnect (pci) およびネットワークインタフェースユニット (niu) が含まれます。
resmgmt – 出力は、DRM ポリシー情報を含み、現在実行中のポリシーを示し、whole-core、max-core、および threading 制約が有効であるかどうかを示します。
serial - 出力には、仮想論理ドメインチャンネル (vldc) サービス、仮想論理ドメインチャンネルクライアント (vldcc)、仮想データプレーンチャンネルクライアント (vdpcc)、および仮想データプレーンチャンネルサービス (vdpcs) が含まれます。
status - 出力には、移行中のドメインの状態が含まれます。
-p は、解析可能でマシンが読み取り可能な形式でリストを生成します。
ldom は、状態情報を表示する論理ドメインの名前です。
このサブコマンドは、論理ドメインのバインドのリストを表示します。論理ドメインを指定しない場合、すべての論理ドメインが表示されます。
ldm ls-bindings [-e] [-p] [ldom...]
各表記の意味は次のとおりです。
-e は、自動的に設定されるサービスおよびデバイスを含む拡張リストを生成します。これは制御できません。
-p は、解析可能でマシンが読み取り可能な形式でリストを生成します。
ldom は、バインド情報を取得する論理ドメインの名前です。
このサブコマンドは、論理ドメインによってエクスポートされるすべてのサービスのリストを表示します。論理ドメインを指定しない場合、すべての論理ドメインが表示されます。
ldm ls-services [-e] [-p] [ldom...]
各表記の意味は次のとおりです。
-e は、自動的に設定されるサービスおよびデバイスを含む拡張リストを生成します。これは制御できません。
-p は、解析可能でマシンが読み取り可能な形式でリストを生成します。
ldom は、サービス情報を取得する論理ドメインの名前です。
このサブコマンドは、1 つ以上の論理ドメインを作成するための制約のリストを表示します。論理ドメインを指定しない場合、すべての論理ドメインが表示されます。
ldm ls-constraints [-x] [ldom...] ldm ls-constraints [-e] [-p] [ldom...]
各表記の意味は次のとおりです。
-x は、XML 形式の制約の出力を標準出力 (stdout) 形式で書き込みます。この出力は、バックアップとして使用できます。
ldom は、制約を表示する論理ドメインの名前です。
-e は、自動的に設定されるサービスおよびデバイスを含む拡張リストを生成します。これは制御できません。
-p は、解析可能でマシンが読み取り可能な形式で制約の出力を書き込みます。
このサブコマンドは、使用していない (バインドされていない) 資源またはすべてのサーバー資源のいずれかのリストを表示します。デフォルトでは、使用していないすべての資源を表示します。
ldm ls-devices [-a] [-p] [core] [cpu] [crypto] [memory] [io]
各表記の意味は次のとおりです。
-a は、すべてのサーバー資源 (バインドされた資源およびバインドされていない資源) を表示します。
-p は、解析可能でマシンが読み取り可能な形式で制約の出力を書き込みます。
core は、コア、コア ID、および物理 CPU セットに関する情報を表示し、まだ割り当てられていないコア内の CPU を指定します。
cpu は、CPU スレッドおよび物理 CPU 資源を表示します。
crypto は、モジュラー演算ユニット資源のみを表示します。
memory は、メモリー資源のみを表示します。
io は、PCI バス、ネットワーク、またはダイレクト I/O 割り当て可能デバイスなど、入出力資源のみを表示します。
電源管理列 (PM) またはフィールド (pm=) で、yes は CPU スレッドの電源が管理されていることを示し、no は CPU スレッドの電源が投入されていることを示します。100% 使用されていない CPU は、デフォルトで電源が管理されます。
I/O デバイスの一覧表示このサブコマンドは、システム上で構成されている I/O デバイスのリストを表示します。デバイスのリストには、I/O バス (NIU を含む) およびダイレクト I/O 割り当て可能デバイスが含まれます。
出力は次のセクションに分かれます。
I/O バス情報。IO 列にはバスまたはネットワークデバイスのデバイスパスが表示されます。PSEUDONYM 列には、バスまたはネットワークデバイスの関連付けられた仮名が表示されます。DOMAIN 列は、デバイスが現在バインドされているドメインを示します。
ダイレクト I/O 割り当て可能デバイス。PCIE 列にはデバイスのデバイスパスが表示され、PSEUDONYM 列にはデバイスの関連付けられた仮名が表示されます。
STATUS 列は、プラグインカードを受け入れるスロットに適用されます。値は、OCC (配置済み)、EMP (空)、または UNK (不明) のいずれかです。ボード上のデバイスを示すスロットの状態は常に、OCC になります。ルートドメインが直接 I/O (Direct I/O、DIO) 機能をサポートしない場合、スロットの状態は UNK になります。
DOMAIN 列は、デバイスが現在バインドされているドメインを示します。このフィールドが空の場合、対応するデバイスはバインドされていません。このフィールドにハイフン文字 (-) が表示されている場合、次のいずれかの理由により、現在、デバイスを primary ドメインから削除できません。
ルートドメインで実行されている OS では、DIO 機能がサポートされていません。この場合、出力の PCIE 列に表示されるすべてのデバイスの STATUS フィールドは、UNK です。
PCIe オプションカードが存在しないため、対応するスロットは空です。空のスロットをダイレクト I/O ドメインに割り当てることはできません。
デバイスが接続されているルートコンプレックスは、分割 PCI 構成を使用して別のドメインに割り当てられます。この場合、デバイスの STATUS 列は UNK です。
ldm list-io [-l] [-p] [pf-name] ldm list-io -d pf-name
各表記の意味は次のとおりです。
-l は、ダイレクト I/O 割り当て可能デバイスによりホストされるサブデバイスに関する情報を表示します。この出力は、ダイレクト I/O 割り当て可能デバイスによって受信ドメインに貸し出されるデバイスを示します。サブデバイス名は、コマンド入力のために使用することはできません。
-p は、解析可能でマシンが読み取り可能な形式で出力を書き込みます。
-d pf-name は、指定された物理機能に関する情報を表示します。
pf-name は、物理機能の名前です。
このサブコマンドは、サービスプロセッサ (Service Processor、SP) 上に格納される論理ドメインの構成のリストを表示します。
ldm ls-config [-r [autosave-name]]
-r [autosave-name] は、制御ドメインに存在する自動保存ファイルの構成を表示します。autosave-name が指定されている場合、autosave-name でのみレポートされます。出力には、対応する SP 構成よりも自動保存ファイルが新しいかどうかも示されます。
注 - 遅延再構成が保留中の場合は、構成の変更はただちに自動保存されます。そのため、ldm ls-config -r コマンドを実行すると、自動保存構成は現在の構成より新しいものとして表示されます。
このサブコマンドは、論理ドメインの 1 つ以上の変数のリストを表示します。ドメインのすべての変数を表示するには、var-name を空白のままにします。
ldm ls-var [var-name...] ldom
各表記の意味は次のとおりです。
var-name は、表示する変数の名前です。名前を指定しない場合、そのドメインのすべての変数が表示されます。
ldom は、1 つ以上の変数を表示する論理ドメインの名前です。
このサブコマンドでは、1 つ以上の論理ドメインの資源管理ポリシーを追加できます。資源管理ポリシーは、オプションのプロパティーとそれらの値で構成されています。
電源管理でエラスティックポリシーを使用していないかぎり、CPU DR をサポートするアクティブドメインで資源管理ポリシーを有効にできます。
ldm add-policy [enable=yes|no] [priority=value] [attack=value] [decay=value] [elastic-margin=value] [sample-rate=value] [tod-begin=hh:mm[:ss]] [tod-end=hh:mm[:ss]] [util-lower=percent] [util-upper=percent] [vcpu-min=value] [vcpu-max=value] name=policy-name ldom...
各表記の意味は次のとおりです。
プロパティーは「Properties」セクションに記述されています。
ldom は、資源管理ポリシーを追加する論理ドメインを指定します。
このサブコマンドでは、オプションのプロパティーに値を指定して、1 つ以上の論理ドメインの資源管理ポリシーを変更できます。
ldm set-policy [enable=[yes|no]] [priority=[value]] [attack=[value]] [decay=[value]] [elastic-margin=[value]] [sample-rate=[value]] [tod-begin=[hh:mm:ss]] [tod-end=[hh:mm:ss]] [util-lower=[percent]] [util-upper=[percent]] [vcpu-min=[value]] [vcpu-max=[value]] name=policy-name ldom...
各表記の意味は次のとおりです。
プロパティーは「Properties」セクションに記述されています。
ldom は、資源管理ポリシーを変更する論理ドメインを指定します。
このサブコマンドでは、1 つ以上のポリシー名を指定して、論理ドメインから資源管理ポリシーを削除できます。
ldm remove-policy [name=]policy-name... ldom
各表記の意味は次のとおりです。
name プロパティーは、資源管理ポリシーの名前である policy-name を指定します。
ldom は、資源管理ポリシーを削除する論理ドメインを指定します。
このサブコマンドでは、既存の構成を使用して、1 つ以上のゲストドメインまたは制御ドメイン、あるいはこの両方の種類のドメインを構成できます。ldm init-system コマンドは、XML ファイル (ldm ls-constraints -x の出力など) を入力として取り込み、指定したドメインを構成し、制御ドメインをリブートします。出荷時のデフォルトの構成を使用してこのコマンドを実行します。
ldm init-system [-frs] -i file
各表記の意味は次のとおりです。
-i file は、論理ドメインの作成に使用する XML 構成ファイルを指定します。
-f は、出荷時のデフォルト構成チェックをスキップし、システム上で何が構成済みであるかを問わず処理を次に進めます。
-f オプションの使用時には注意が必要です。ldm init-system はシステムが出荷時のデフォルト構成であると想定するため、XML ファイルで指定された変更を直接適用します。システムが出荷時のデフォルト以外の構成の場合に -f を使用すると、システムが XML ファイルで指定された構成どおりにならない可能性が高くなります。XML ファイル内の変更と初期構成の組み合わせによっては、システムに 1 つまたは複数の変更が適用されない場合があります。
-r は構成後にシステムをリブートします。
-s は、仮想サービス構成 (vds、vcc、および vsw) のみを復元します。
例 1 デフォルトのサービスの作成
3 つのデフォルトのサービスである、仮想ディスクサーバー、仮想スイッチ、および仮想コンソール端末集配信装置を設定して、これらのサービスをゲストドメインにエクスポートできるようにします。
# ldm add-vds primary-vds0 primary # ldm add-vsw net-dev=nxge0 primary-vsw0 primary # ldm add-vcc port-range=5000-5100 primary-vcc0 primary
例 2 サービスの一覧表示
サービスのリストを表示して、サービスが正常に作成されたこと、または使用可能なサービスを確認することができます。
# ldm ls-services primary VCC NAME LDOM PORT-RANGE primary-vcc0 primary 5000-5100 VSW NAME LDOM MAC NET-DEV DEVICE DEFAULT-VLAN-ID PVID VID MODE primary-vsw0 primary 00:14:4f:f9:68:d0 nxge0 switch@0 1 1 VDS NAME LDOM VOLUME OPTIONS MPGROUP DEVICE primary-vds0 primary
例 3 制御ドメインの初期設定
制御ドメインは、primary と呼ばれ、Logical Domains Manager のインストール時に存在する初期ドメインです。制御ドメインではすべての資源を利用でき、それらの資源は使用しているサーバーによって異なります。制御ドメインで維持する資源のみを設定し、残りの資源をゲストドメインに割り当てられるようにします。次に、構成をサービスプロセッサに保存します。リブートして変更を有効にする必要があります。
制御ドメインとその他のドメイン間のネットワークを使用可能にする場合、制御ドメインで仮想スイッチを plumb します。ゲストドメインでコンソールを使用するには、仮想ネットワーク端末サーバーデーモン (vntsd(1M)) を使用可能にする必要があります。
# ldm start-reconf primary # ldm set-crypto 1 primary # ldm set-vcpu 4 primary # ldm set-mem 4G primary # ldm add-config initial # shutdown -y -g0 -i6 # ifconfig -a # ifconfig vsw0 plumb # ifconfig nxge0 down unplumb # ifconfig vsw0 IP-of-nxge0 netmask netmask-of-nxge0 broadcast + up # svcadm enable vntsd
例 4 バインドの一覧表示
バインドのリストを表示して、指定した資源が制御ドメインにあるかどうか、または任意のドメインにバインドされている資源を確認できます。
# ldm ls-bindings primary NAME STATE FLAGS CONS VCPU MEMORY UTIL UPTIME primary active -t-cv 4 4G 12% 11m MAC 08:00:90:11:11:10 VCPU VID PID UTIL STRAND 0 0 18% 100% 1 1 13% 100% 2 2 9.8% 100% 3 3 5.4% 100% MEMORY RA PA SIZE 0x4000000 0x4000000 4G IO DEVICE PSEUDONYM OPTIONS pci@400 pci_0 pci@500 pci_1 pci@400/pci@0/pci@9 PCIE2 pci@400/pci@0/pci@9 MB/SASHBA pci@500/pci@0/pci@8 MB/NET0 VCC NAME PORT-RANGE primary-vcc0 5000-5100 VSW NAME MAC NET-DEV DEVICE MODE primary-vsw0 00:14:4f:f9:68:d0 nxge0 switch@0 prog,promisc VDS NAME VOLUME OPTIONS DEVICE primary-vds0
例 5 論理ドメインの作成
必要とするゲストドメイン構成を作成するための資源の存在の確認、ゲストドメインの追加、ドメインに必要な資源およびデバイスの追加、起動時の動作をシステムに指示する起動パラメータの設定、ドメインへの資源のバインド、バックアップ用の XML ファイルへのゲストドメインの構成の保存を実行します。また、primary ドメインおよびゲストドメインの構成を SC に保存する場合があります。その後、ドメインを起動し、ドメインの TCP ポートを検出し、デフォルトの仮想コンソールサービスを介してその TCP ポートに接続することができます。
# ldm ls-devices # ldm add-dom ldg1 # ldm add-vcpu 4 ldg1 # ldm add-mem 1g ldg1 # ldm add-vnet vnet1 primary-vsw0 ldg1 # ldm add-vdsdev /dev/dsk/c0t1d0s2 vol1@primary-vds0 # ldm add-vdisk vdisk1 vol1@primary-vds0 ldg1 # ldm set-var auto-boot\?=false ldg1 # ldm set-var boot-device=vdisk1 ldg1 # ldm bind-dom ldg1 # ldm ls-constraints -x ldg1 > ldg1.xml # ldm add-config ldg1_4cpu_1G # ldm start ldg1 # ldm ls -l ldg1 # telnet localhost 5000
例 6 多数のゲストドメインに対する 1 つの端末の使用
通常、作成した各ゲストドメインには、そのドメイン専用の TCP ポートおよびコンソールがあります。1 つめのゲストドメイン (この例では、ldg1) を作成したあとは、ldm set-vcons コマンドを使用して、その他すべてのドメイン (この例での 2 つめのドメインは ldg2) を同じコンソールポートに接続できます。set-vcons サブコマンドは、アクティブでないドメインでのみ機能します。
# ldm set-vcons group=ldg1 service=primary-vcc0 ldg2
1 つめ以外のすべてのゲストドメインで set-vcons コマンドを実行したあとに、ldm ls -l コマンドを実行すると、すべてのドメインが同じポートに接続していることを確認できます。コンソールの使用法については、vntsd(1M) マニュアルページを参照してください。
例 7 論理ドメインへの仮想 PCI バスの追加
I/O ドメインは、物理 I/O デバイスの直接所有権を持ち、これらに直接アクセスできるサービスドメインの一種です。I/O ドメインは、仮想 I/O デバイスの形式でゲストドメインにサービスを提供します。この例では、論理ドメインに仮想 PCI バスを追加する方法について示します。
# ldm add-io pci@7c0 ldg1
例 8 仮想データプレーンのチャンネル機能の追加 (Netra のみ)
使用しているサーバーに Netra Data Plane Software (NDPS) 環境がある場合、仮想データプレーンのチャンネル機能を追加することがあります。まず、サービスドメインに仮想データプレーンのチャンネルサービス (primary-vdpcs0 など) を追加します。この場合のサービスドメインは、primary ドメインです。
# ldm add-vdpcs primary-vdpcs0 primary
サービスドメイン (primary) にサービスを追加したら、ゲストドメイン (ldg1) に仮想データプレーンのチャンネルクライアント (vdpcc1) を追加できます。
# add-vdpcc vdpcc1 primary-vdpcs0 ldg1
例 9 制御ドメインの遅延再構成処理の取り消し
1 つの遅延再構成処理によって、その他すべてのドメインの構成処理がブロックされます。制御ドメインの遅延再構成処理の取り消しが必要になる場合があります。たとえば、目的のドメインまたは他のドメインでほかの構成コマンドを実行できるように、処理を取り消す場合があります。このコマンドを使用すると、遅延再構成処理を取り消して、目的のドメインまたは他のドメインでほかの構成処理を行うことができます。
# ldm cancel-op reconf primary
例 10 ドメインの移行
論理ドメインは、別のマシンに移行できます。次に、成功する移行の例を示します。
# ldm migrate ldg1 root@dt90-187:ldg Target password:
例 11 構成の一覧表示
次の例は、構成を表示する方法を示しています。1 つめのコマンドは、SP に格納されている構成を表示します。2 つめのコマンドは、SP 上の構成と、制御ドメイン上の自動保存構成に関する情報を表示します。
# ldm ls-config factory-default 3guests [current] data1 reconfig_primary split1 # ldm ls-config -r 3guests [newer] data1 [newer] reconfig_primary split1 unit
現在の 3guests 構成と data1 構成の両方で、SP に保存されていない変更が自動保存されています。この状態のときにシステムの電源が再投入されると、Logical Domains Manager は指定の手順に基づき、自動保存された 3guests の構成を回復します。3guests が current としてマークされているため、自動保存の回復処理はこのシステムに対して実行されます。
reconfig_primary および split1 自動保存構成は、SP 上のバージョンと同一で、より新しいバージョンではありません。
unit 構成は、自動保存構成として制御ドメインにのみ存在します。unit に対応する構成は、SP 上には存在しません。この状況は、SP で構成が失われると発生することがあります。SP を交換した場合、または SP 上の持続的なバージョンの構成に問題が発生した場合、構成が失われる可能性があります。rm-config コマンドを使用して構成を明示的に削除すると、制御ドメインの自動保存構成も削除されます。その結果、制御ドメインにも SP にも構成は残りません。
例 12 I/O デバイスの一覧表示
次の例では、システム上の I/O デバイスを一覧表示します。最初のセクションには、primary ドメイン上にある PCIe バスに関する情報が表示されます。2 つ目のセクションには、ダイレクト I/O 割り当て可能デバイスに関する情報が表示されます。
# ldm ls-io IO PSEUDONYM DOMAIN -- --------- ------ pci@400 pci_0 primary pci@500 pci_1 primary PCIE PSEUDONYM STATUS DOMAIN ---- --------- ------ ------ pci@400/pci@0/pci@c PCIE1 EMP - pci@400/pci@0/pci@9 PCIE2 OCC ldg1 pci@400/pci@0/pci@d PCIE3 OCC ldg2 pci@400/pci@0/pci@8 MB/SASHBA OCC primary pci@500/pci@0/pci@9 PCIE0 EMP - pci@500/pci@0/pci@d PCIE4 OCC ldg2 pci@500/pci@0/pci@c PCIE5 OCC ldg1 pci@500/pci@0/pci@8 MB/NET0 OCC primary
次の終了値が返されます。
正常に完了しました。
エラーが発生しました。
次の属性の説明については、attributes(5) マニュアルページを参照してください。
|
dumpadm(1M)、ifconfig(1M)、shutdown(1M)、vntsd(1M)、attributes(5)