ナビゲーションリンクをスキップ
印刷ビューの終了
| Oracle VM Server for SPARC 3.0 リファレンスマニュアル Oracle VM Server for SPARC (日本語)

検索範囲:

- このドキュメント
- ライブラリ全体

### ldm

- Logical Domains Manager 用のコマンド行インタフェース

### 形式

    ldm or 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] [shutdown-group=num] [rc-add-policy=[iov]] 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-ipc|max-throughput]] [shutdown-group=num] [rc-add-policy=[iov]] ldom
    ldm remove-domain -a
    ldm remove-domain ldom...
    ldm list-domain [-e] [-l] [-o format] [-p] [-S] [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 (device | vf-name) ldom
    ldm add-io [iov=on|off] bus 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] [iov=[on|off]] [name=value...] vf-name
    ldm remove-io [-n] (bus | device | vf-name) ldom
    ldm list-io [-l] [-p] [bus | device | 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]
      [alt-mac-addrs=auto|num1[,auto|num2,...]] [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]]
      [alt-mac-addrs=auto|num1[,auto|num2,...]] [vid=vlan-id1,vlan-id2,...]
      [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]
      [log=[on|off]] 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 | -q] | [[-h | -r | -t sec] [-m msg]]] (-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] [-S] [core] [cpu] [crypto] [memory] [io]
    ldm list-hvdump
    ldm list-permits
    ldm list-services [-e] [-p] [ldom...]
    ldm set-hvdump [hvdump=on|off] [hvdump-reboot=on|off]
    ldm start-hvdump
    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
    ldm start-recovery
    ldm cancel-recovery
    ldm list-recovery

## 機能説明

`ldm` コマンドは、Logical Domains Manager と相互に作用し、論理ドメインの作成および管理に使用されます。Logical Domains Manager は、サーバーごとに 1 つだけ存在できます。Logical Domains Manager は制御ドメインに対して実行します。これは、サービスプロセッサにより作成される初期ドメインです。制御ドメインの名前は `primary` です。

論理ドメインは、個別のオペレーティングシステム、リソース、および単一のコンピュータシステム内での識別情報を持つ個別の論理グループです。各論理ドメインは、サーバーの電源の再投入を必要とせずに、作成、破棄、再構成、およびリブートを単独で行うことができます。セキュリティー上の理由から、論理ドメインを使用してさまざまなアプリケーションを異なるドメインで動作させて、アプリケーションの独立性を維持することができます。

論理ドメインはすべて同じですが、論理ドメインに対して指定する役割に基づいてそれぞれ区別できます。論理ドメインが実行できる役割は、次のとおりです。

制御ドメイン

  ハイパーバイザと通信することによって、ほかの論理ドメインおよびサービスを作成および管理します。

サービスドメイン

  仮想ネットワークスイッチ、仮想ディスクサービスなどのサービスをほかの論理ドメインに提供します。

I/O ドメイン

  SR-IOV (Single-Root I/O Virtualization) 仮想機能や PCIe (PCI EXPRESS) コントローラのネットワークカードなどの物理 I/O デバイスに直接アクセスします。I/O ドメインは PCIe ルートコンプレックスを所有するか、ダイレクト I/O 機能を使用して PCIe スロットまたはシステムボード上の PCIe デバイス、および SR-IOV 機能を使用して SR-IOV 仮想機能を所有することができます。

  I/O ドメインは、I/O ドメインがサービスドメインとしても使用される場合に、仮想デバイスの形式でほかのドメインと物理 I/O デバイスを共有できます。

ルートドメイン

  PCIe ルートコンプレックスが割り当てられます。このドメインは、PCIe ファブリックとすべての接続されているデバイスを所有し、ファブリックのエラー処理などのファブリック関連のサービスをすべて提供します。ルートドメインは、仮想機能を作成して I/O ドメインに割り当てることのできる SR-IOV 物理機能をすべて所有します。ルートドメインは I/O ドメインでもあり、物理 I/O デバイスを所有し、それらに直接アクセスできます。

  保持できるルートドメインの数は、プラットフォームアーキテクチャーによって決まります。たとえば、オラクルの Sun SPARC Enterprise T5440 サーバーを使用している場合、最大で 4 つのルートドメインを保持できます。

ゲストドメイン

  I/O ドメインおよびサービスドメインのサービスを使用し、制御ドメインによって管理されます。

Logical Domains Manager を使用して、ドメイン間の依存関係を確立できます。

マスタードメイン

  1 つ以上のドメインが依存しているドメインです。スレーブドメインは、マスタードメインに障害が発生したときの障害ポリシーを制定します。たとえば、マスタードメインに障害が発生した場合、スレーブドメインに対して、放置、パニックの発生、リブート、または停止を行うことができます。

スレーブドメイン

  他のドメインに依存しているドメインです。1 つのドメインには最大 4 つのマスタードメインを指定できます。1 つ以上のマスタードメインに障害が発生すると、障害ポリシーによってスレーブドメインの動作が指示されます。

## サブコマンドのサマリー

サポートされているサブコマンドとその説明および各サブコマンドに必要な権限は、次のとおりです。ユーザーアカウントの承認の設定については、『Oracle VM Server for SPARC 3.0 管理ガイド』の「権利プロファイルと役割の使用」を参照してください。

サブコマンド | 説明 | 承認
--- | --- | ---
`add-`resource | 既存の論理ドメインにリソースを追加します。リソースの定義については、「リソース」を参照してください。 | `solaris.ldoms.write`
`add-domain` | 論理ドメインを作成します。 | `solaris.ldoms.write`
`add-policy` | 既存の論理ドメインにリソース管理ポリシーを追加します。 | `solaris.ldoms.write`
`add-spconfig` | 論理ドメイン構成をサービスプロセッサ (Service Processor、SP) に追加します。 | `solaris.ldoms.write`
`add-variable` | 論理ドメインに 1 つ以上の変数を追加します。 | `solaris.ldoms.write`
`bind-domain` | 作成された論理ドメインにリソースをバインドします。 | `solaris.ldoms.write`
`cancel-operation` | 遅延再構成 (`reconf`)、メモリー動的再構成の削除 (`memdr`)、またはドメイン移行 (`migration`) などの処理を取り消します。 | `solaris.ldoms.write`
`cancel-reconf` | primary ドメインの遅延再構成処理を取り消します。 | `solaris.ldoms.write`
`cancel-recovery` | システムが復旧モードになっているときに、最後に選択された電源投入構成の復旧を取り消します。 | `solaris.ldoms.write`
`create-vf` | 仮想機能を作成します。 | `solaris.ldoms.write`
`destroy-vf` | 仮想機能を破棄します。 | `solaris.ldoms.write`
`init-system` | 既存の構成を使用して、1 つ以上のゲストドメインまたは制御ドメイン、あるいはその両方を構成します。 | `solaris.ldoms.write`
`list-bindings` | 論理ドメインのサーバーバインドを一覧表示します。 | `solaris.ldoms.read`
`list-constraints` | 論理ドメインのリソース制約を一覧表示します。 | `solaris.ldoms.read`
`list-devices` | 論理ドメインのデバイスを一覧表示します。 | `solaris.ldoms.read`
`list-domain` | 論理ドメインおよびその状態のリストを表示します。 | `solaris.ldoms.read`
`list-hvdump` | ハイパーバイザデータ収集のプロパティー値を一覧表示します。 | `solaris.ldoms.read`
`list-io` | 論理ドメインの I/O デバイスを一覧表示します。 | `solaris.ldoms.read`
`list-permits` | CPU コアの Capacity on Demand 許可情報を一覧表示します。 | `solaris.ldoms.read`
`list-recovery` | 復旧モードのステータスを表示します。 | `solaris.ldoms.read`
`list-services` | 論理ドメインのサービスを一覧表示します。 | `solaris.ldoms.read`
`list-spconfig` | 論理ドメインの構成を一覧表示します。 | `solaris.ldoms.read`
`list-variable` | 論理ドメインの変数のリストを表示します。 | `solaris.ldoms.read`
`migrate-domain` | マシン間で論理ドメインを移行します。 | `solaris.ldoms.write`
`panic-domain` | 指定された論理ドメインの Oracle Solaris OS でパニックを発生させます。 | `solaris.ldoms.write`
`remove-`resource | 既存の論理ドメインからリソースを削除します。リソースの定義については、「リソース」を参照してください。 | `solaris.ldoms.write`
`remove-domain` | 論理ドメインを削除します。 | `solaris.ldoms.write`
`remove-policy` | 既存の論理ドメインからリソース管理ポリシーを削除します。 | `solaris.ldoms.write`
`remove-spconfig` | サービスプロセッサから論理ドメイン構成を削除します。 | `solaris.ldoms.write`
`remove-variable` | 既存の論理ドメインから 1 つ以上の変数を削除します。 | `solaris.ldoms.write`
`set-`resource | 既存の論理ドメインに対してリソースを指定します。これは、プロパティーの変更または数量の変更のいずれかに使用できます。リソース `core`、`vcpu`、`memory`、または `crypto` に適用する場合、これは数量の変更を表します。数量の変更の場合、このサブコマンドは動的または遅延再構成処理となり、指定したリソースの数量が、指定した論理ドメインに割り当てられます。論理ドメインに割り当てられているリソースの数がこのサブコマンドの指定よりも多い場合は、いくつかのリソースが削除されます。論理ドメインに割り当てられているリソースの数がこのサブコマンドの指定よりも少ない場合は、いくつかのリソースが追加されます。リソースの定義については、「リソース」を参照してください。 | `solaris.ldoms.write`
`set-domain` | 論理ドメインにプロパティーを設定します。 | `solaris.ldoms.write`
`set-hvdump` | ハイパーバイザデータ収集プロセスのプロパティー値を設定します。 | `solaris.ldoms.write`
`set-io` | 物理機能または仮想機能を変更します。 | `solaris.ldoms.write`
`set-policy` | 既存の論理ドメインにリソース管理ポリシーのプロパティーを設定します。 | `solaris.ldoms.write`
`set-spconfig` | 使用する論理ドメイン構成を指定します。 | `solaris.ldoms.write`
`set-variable` | 既存の論理ドメインに 1 つ以上の変数を設定します。 | `solaris.ldoms.write`
`start-domain` | 1 つ以上の論理ドメインを起動します。 | `solaris.ldoms.write`
`start-hvdump` | ハイパーバイザデータ収集プロセスを手動で起動します。 | `solaris.ldoms.write`
`start-reconf` | ルートドメイン上で遅延再構成モードに入ります。 | `solaris.ldoms.write`
`start-recovery` | システムが復旧モードになっているときに、最後に選択された電源投入構成の復旧を手動で開始します。 | `solaris.ldoms.write`
`stop-domain` | 1 つ以上の実行中のドメインを停止します。 | `solaris.ldoms.write`
`unbind-domain` | 論理ドメインから、リソースのバインドを解除 (リソースを解放) します。 | `solaris.ldoms.write`

注 - すべてのサブコマンドが、すべてのリソースタイプでサポートされているわけではありません。

### 別名

次の表に、`ldm` サブコマンドの 3 種類の別名を示します。

別名の種類 | 省略形式 | 長文形式
--- | --- | ---
処理の別名 (動詞) | `ls` | `list`
処理の別名 (動詞) | `rm` | `remove`
リソースの別名 (名詞) | `config` | `spconfig`
リソースの別名 (名詞) | `crypto` | `mau`
リソースの別名 (名詞) | `dom` | `domain`
リソースの別名 (名詞) | `mem` | `memory`
リソースの別名 (名詞) | `var` | `variable`
リソースの別名 (名詞) | `vcc` | `vconscon`
リソースの別名 (名詞) | `vcons` | `vconsole`
リソースの別名 (名詞) | `vdpcc` | `ndpsldcc`
リソースの別名 (名詞) | `vdpcs` | `ndpsldcs`
リソースの別名 (名詞) | `vds` | `vdiskserver`
リソースの別名 (名詞) | `vdsdev` | `vdiskserverdevice`
リソースの別名 (名詞) | `vsw` | `vswitch`
サブコマンドのショートカット | `bind` | `bind-domain`
サブコマンドのショートカット | `cancel-op` | `cancel-operation`
サブコマンドのショートカット | `create` | `add-domain`
サブコマンドのショートカット | `destroy` | `remove-domain`
サブコマンドのショートカット | `list` | `list-domain`
サブコマンドのショートカット | `migrate` | `migrate-domain`
サブコマンドのショートカット | `modify` | `set-domain`
サブコマンドのショートカット | `panic` | `panic-domain`
サブコマンドのショートカット | `start` | `start-domain`
サブコマンドのショートカット | `stop` | `stop-domain`
サブコマンドのショートカット | `unbind` | `unbind-domain`

注 - このマニュアルページの以降の構文および例では、省略形式の処理の別名およびリソースの別名を使用します。

### リソース

次のリソースがサポートされています。

`core`

  CPU コア。

`crypto`

  サポートされているサーバー上でサポートされている暗号化装置。現在、モジュラー演算ユニット (Modular Arithmetic Unit、MAU) と Control Word Queue (CWQ) の 2 つの暗号化装置がサポートされています。

`io`

  PCIe ルートコンプレックスなどの I/O デバイスと、それらに接続されているアダプタとデバイス。または、ダイレクト I/O 割り当て可能デバイスおよび PCIe SR-IOV 仮想機能。

`mem`、`memory`

  バイト単位のデフォルトのメモリーサイズ。つまり、G バイト (`G`)、K バイト (`K`)、または M バイト (`M`) を指定します。ゲストドメインに割り当てることができる、サーバーの仮想化されたメモリーです。

`vcc`、`vconscon`

  ゲストドメインの作成時に各ゲストドメインに割り当てるための特定範囲の TCP ポートを持つ、仮想コンソール端末集配信装置 (コンセントレータ) サービス。

`vcons`、`vconsole`

  システムレベルのメッセージにアクセスするための仮想コンソール。接続は、特定のポートで制御ドメイン上の `vconscon` サービスに接続することによって実現します。

`vcpu`

  各仮想 CPU は、サーバーの 1 つの CPU スレッドを表します。たとえば、8 コアの Sun SPARC Enterprise T5120 サーバーには、論理ドメイン間で割り当てることができる 64 個の CPU スレッド (仮想 CPU) があります。

`vdisk`

  仮想ディスクは、さまざまな種類の物理デバイス、ボリューム、またはファイルで構成される総称的なブロック型デバイスです。仮想ディスクは SCSI ディスクと同義ではありません。そのため、ディスク名内のターゲット ID (`tN`) は除外されます。論理ドメインの仮想ディスクの形式は、`cNdNsN` です。`cN` は仮想コントローラ、`dN` は仮想ディスク番号、および `sN` はスライスを示します。

`vds`、`vdiskserver`

  ほかの論理ドメインに仮想ディスクをエクスポートできる仮想ディスクサーバー。

`vdsdev`、`vdiskserverdevice`

  仮想ディスクサーバーがエクスポートしたデバイス。このデバイスには、ディスク全体、ディスクのスライス、ファイル、またはディスクボリュームを指定できます。

`vdpcc`

  仮想データプレーンのチャンネルクライアント。Netra Data Plane Software (NDPS) 環境でのみ使用されます。

`vdpcs`

  仮想データプレーンのチャンネルサービス。Netra Data Plane Software (NDPS) 環境でのみ使用されます。

`vnet`

  仮想 Ethernet デバイスを実装し、仮想ネットワークスイッチ (`vsw`) を使用するシステム内のほかの `vnet` デバイスと通信する仮想ネットワークデバイス。

`vsw`、`vswitch`

  仮想ネットワークデバイスを外部ネットワークに接続し、仮想ネットワークデバイス間でのパケットの切り替えも行う仮想ネットワークスイッチ。

### オプション

次の表に、`ldm` コマンドのオプションを示します。適用可能な場合、オプションの省略形式に続いて長形式を示します。

`-a` | `--all` | すべての種類のオペランドで動作します。
| `--auto-adj` | `add-memory`、`set-memory`、および `remove-memory` サブコマンドが、256M バイトの境界でのメモリーの変更を揃えることを指定します。`--auto-adj` オプションの動作は、影響を受けるドメインの状態によって決まります。 アクティブなドメイン。動的再構成の場合、このオプションは追加または削除されるメモリーの量を 256M バイト境界にそろえます。量は `add-memory` 操作の場合は切り上げられ、`remove-memory` 操作の場合は切り下げられます。`set-memory` 操作は、`add-memory` 操作または `remove-memory` 操作として扱われます。これらのサブコマンドのいずれかに対して、`--auto-adj` 操作は、ドメインのメモリーの「結果として得られるサイズ」が要求されたサイズより大きいか等しくなるようにします。 「遅延再構成」の場合、このオプションは境界または非アクティブドメインと同じ動作になります。遅延再構成は次の状況下で発生します。 ドメインが遅延再構成を開始する。 遅延再構成がドメイン内で未処理になっている。 バインドされたドメインまたはアクティブでないドメイン。このオプションは、次の 256M バイト境界に切り上げることにより、ドメインの結果として得られるサイズを自動的にそろえます。この位置揃えは、`add-memory`、`set-memory`、および `remove-memory` 操作で発生します。
`-c` number | `--core` number | 次のような個別の CPU 操作を実行する非推奨のオプション: スレッドからコアへのドメインの割り当て単位を設定し (まだ設定されていない場合)、指定された数のコアへの割り当てを設定します。 ドメインがアクティブでない場合、ドメインがバインドされているか、アクティブであるときにドメインに割り当て可能なコアの数にキャップを設定します。ドメインが遅延再構成モードになっている場合、キャップは `primary` ドメインにのみ設定されます。 割り当てリクエストによってキャップで許可されるよりも多くのコアがドメインに割り当てられた場合、コマンドは失敗します。 このオプションは、Oracle VM Server for SPARC システムにハードパーティション分割を構成します。『Oracle VM Server for SPARC 3.0 管理ガイド』の「ハードパーティションによるシステムの構成」を参照してください。 コアからスレッドへの割り当て単位を変更したり、キャップを削除したりできます。このような変更を行うには、アクティブでないドメインまたは遅延再構成モードになっている `primary` ドメインで、`add-vcpu`、`set-vcpu`、または `rm-vcpu` コマンドを `-c` オプションを付けずに発行します。 Oracle VM Server for SPARC 2.2 リリース以降、CPU キャップと CPU コアの割り当ては別々のコマンドで処理されるようになりました。これらのコマンドを使用すれば、CPU コアの割り当て、キャップの設定、あるいはその両方を独立して実行できます。キャップが設定されていない場合でも、コアへの割り当て単位を設定できます。ただし、Oracle VM Server for SPARC システムにハードパーティション分割を構成する場合、キャップが設定されていないときにシステムを実行することは許可されません。 `add-core`、`set-core`、および `rm-core` サブコマンドを使用して、指定された数の CPU コアをドメインに割り当てます。 `create-domain` または `set-domain` サブコマンドを使用して `max-cores` プロパティー値を指定して、キャップを設定します。
`-e` | `--extended` | 自動的に設定されるサービスおよびデバイスを含む拡張リストを生成します。これは制御できません。
`-f` | `--force` | 処理を強制的に試行します。
`-i` file | `--input` file | 論理ドメインの作成に使用する XML 構成ファイルを指定します。
`-l` | `--long` | 長いリストを生成します。
`-n` | `--dry-run` | 移行が成功するかどうかを確認するために、移行の予行演習を行います。ドメインの移行が実際に行われるわけではありません。
`-o` format | `--output` format | 表示する内容に応じて、`ldm list` コマンドの形式を指定します。`console`、`core`、`cpu`、`crypto`、`disk`、`domain`、`memory`、 `network`、`physio`、`resmgmt`、`serial`、および `status` のうち 1 つ以上を指定します。複数の形式を指定する場合は、各形式をコンマで区切ります。スペースは入れません。
`-p` | `--parseable` | マシンが読み取り可能なバージョンの出力を生成します。
`-q` |  | ネットワークデバイスまたはディスクバックエンドデバイスの検証を無効にするため、コマンドをより迅速に実行できるようになります。
`-r` |  | `add-spconfig`、`list-spconfig`、および `remove-spconfig` サブコマンドの場合: 手動の構成回復を実行します。
`-r` | `--reboot` | `init-system` サブコマンドの場合: 構成後にシステムをリブートします。
`-s` | `--services-only` | 仮想サービス構成のみを復元します (`vds`、`vcc`、および `vsw`)。
`-S` |  | CPU 関連およびメモリー関連のリソースに関するステータス情報を生成します。ステータスの値は、リソースが正常に動作していることを示す `ok` と、リソースに障害が発生していることを示す `fail` です。 このステータスは、Fujitsu M10 システム上の CPU およびメモリーリソースに対してのみ決定されます。その他のすべてのプラットフォームでは、ステータスフィールドは、`-p` オプションが使用されているときに解析可能な出力で表示されるだけです。これらのプラットフォーム上のステータスは、常に `status=NA` と表示されます。
`-x` file | `--xml` file | 論理ドメインの制約を含む XML ファイルを標準出力 (`stdout`) に書き込むことを指定します。バックアップファイルとして使用できます。
`-V` | `--version` | バージョン情報を表示します。
| `--help` | 使用法を表示します。

### プロパティー

注 - さまざまな `ldm set-*` コマンドで、空の値を指定してプロパティーをデフォルト値にリセットすることができます。たとえば、次の `ldm set-policy` コマンドを実行すると、`attack` プロパティーをデフォルト値にリセットできます。

    # ldm set-policy attack= name=high-policy ldom1

次のプロパティーがサポートされています。

`alt-mac-addrs=auto|num1,[auto|num2,...]`

  代替 MAC アドレスのコンマ区切りリストを指定します。有効な値は、数値の MAC アドレスと、システムで代替 MAC アドレスが生成されるようにリクエストするために 1 回以上使用できる `auto` キーワードです。`auto` キーワードと数値の MAC アドレスは混在できます。数値の MAC アドレスは、標準のオクテット記述法で指定する必要があります。たとえば、`80:00:33:55:22:66` とします。

  1 つ以上の代替 MAC アドレスを割り当てると、このデバイス上に 1 つ以上の仮想 NIC (VNIC) を作成できます。VNIC ごとに 1 つの代替 MAC アドレスが使用されるため、割り当てられた MAC アドレスの数によって、デバイス上に作成できる VNIC の数が決まります。代替 MAC アドレスが指定されていない場合は、このデバイス上に VNIC を作成しようとしても失敗します。詳細は、Oracle Solaris 11 ネットワークドキュメントおよび『Oracle VM Server for SPARC 3.0 管理ガイド』の第 8 章「仮想ネットワークの使用」を参照してください。

`attack=value`

  いずれか 1 つのリソース制御サイクル中に追加するリソースの最大数を指定します。使用可能なリソースの数が指定された値よりも少ない場合、使用可能なリソースがすべて追加されます。使用可能な CPU スレッドをできるだけ多く追加できるように、デフォルトでは attack に制限はありません。有効な値は、1 からシステムで使用していない CPU スレッドの数までです。

`cid=core-ID`

  ドメインに割り当てる、またはドメインから削除する物理コア ID を指定します。名前付きコアをすべて削除するには、`ldm set-core cid=` コマンドを実行して、`cid` プロパティーの core-ID 値を省略します。

  `cid` プロパティーは、構成するシステムのトポロジについて知識のある管理者のみが使用するようにしてください。このような高度な構成機能では、特定の割り当て規則が適用されることによって、システム全体のパフォーマンスが影響を受ける可能性があります。

`cpu-arch=generic|native`

  次のいずれかの値を指定します。

  - `generic` では、ゲストドメインが CPU タイプに依存しない移行を実行できるように、共通の CPU ハードウェア機能が使用されます。

  - `native` では、ゲストドメインが同じ CPU タイプを持つプラットフォーム間でのみ移行できるように、CPU 固有のハードウェア機能が使用されます。`native` はデフォルト値です。

  `generic` 値を使用すると、`native` 値と比べてパフォーマンスが低下することがあります。これが発生する原因は、ゲストドメインが新しい CPU タイプにのみ存在する一部の機能を使用しないためです。このような機能を使用しなければ、`generic` 設定によって、新しい CPU タイプと古い CPU タイプを使用するシステム間で柔軟にドメインを移行できるようになります。

`decay=value`

  いずれか 1 つのリソース制御サイクル中に削除するリソースの最大数を指定します。このプロパティーで指定されている値のほうが大きい場合でも、現在バインドされている CPU スレッドの数から `vcpu-min` の値を引いた数だけが削除できます。デフォルトでは、値は 1 です。有効な値は、1 から CPU スレッドの合計数より 1 少ない数までです。

`default-vlan-id=`

  仮想ネットワークデバイスまたは仮想スイッチをメンバーにする必要があるデフォルトの仮想ローカルエリアネットワーク (VLAN) を、タグ付きモードで指定します。最初の VLAN ID (vid1) は、この `default-vlan-id` に予約されています。

`elastic-margin=value`

  `util-lower` と使用していない CPU スレッド数の間のバッファー領域量を指定して、CPU スレッドの数を減らした場合の変動を回避します。有効な値は、0 から 100 までです。デフォルト値は 5 です。

`enable=yes|no`

  個々のドメインのリソース管理を有効または無効にします。デフォルトでは、`enable=yes` です。

`extended-mapin-space=on|off`

  ドメインの拡張されたマップイン領域を有効または無効にします。デフォルトでは `extended-mapin-space=off` に設定されています。

  拡張されたマップイン領域は、追加の LCD 共有メモリー空間を参照します。このメモリー空間は、直接マップされた共有メモリーを使用する多数の仮想 I/O デバイスをサポートするために必要となります。この拡張されたマップイン領域も、パフォーマンスとスケーラビリティーを向上するために仮想ネットワークデバイスによって使用されます。

`failure-policy=`

  マスタードメインに障害が発生したときのスレーブドメインの動作を制御する障害ポリシーを指定します。このプロパティーは、マスタードメインで設定します。デフォルト値は `ignore` です。次に、有効なプロパティー値を示します。

  - `ignore` は、マスタードメインの障害を無視します。スレーブドメインは影響を受けません。

  - `panic` は、マスタードメインに障害が発生した場合、すべてのスレーブドメインにパニックを発生させます。

  - `reset` は、マスタードメインに障害が発生した場合、すべてのスレーブドメインをリセットします。

  - `stop` は、マスタードメインに障害が発生した場合、すべてのスレーブドメインを停止します。

`group=`

  コンソールを接続するグループを指定します。グループ引数を使用すると、同一の TCP 接続上で複数のコンソールを多重化できます。

`hostid=`

  特定のドメインのホスト ID を指定します。ホスト ID を指定しない場合、Logical Domains Manager により一意のホスト ID が各ドメインに割り当てられます。

`hvdump=on|off`

  ハイパーバイザデータ収集プロセスを有効または無効にします。デフォルト値は `on` です。このプロパティーは、Fujitsu M10 システムにのみ適用されます。

`hvdump-reboot=on|off`

  ハイパーバイザデータ収集プロセスが完了したあとの自動リブートを有効または無効にします。デフォルト値は `off` です。このプロパティーは、Fujitsu M10 システムにのみ適用されます。

`id=`

  新しい仮想ディスクデバイス、仮想ネットワークデバイス、および仮想スイッチデバイスの ID をそれぞれ指定します。

`inter-vnet-link=on|off`

  仮想ネットワークデバイス間でチャネルを割り当てるかどうかを指定します。デフォルト値は `on` です。

  `inter-vnet-link=on` の場合、Logical Domains Manager は、ゲスト間のパフォーマンスを向上するために、同じ仮想スイッチに接続している仮想ネットワークデバイスの各ペア間にチャネルを割り当てます。

  `inter-vnet-link=off` の場合、Logical Domains Manager は、仮想ネットワークデバイスと仮想スイッチ間の通信に対してのみチャネルを割り当てます。このとき、ゲスト間の通信トラフィックは仮想スイッチを経由します。この設定を使用すると、仮想ネットワークデバイスに使用されるチャネルの数が減少します。そのため、システムに追加できる仮想デバイスの最大数が増加します。

`iov=on|off`

  指定された PCIe バス (ルートコンプレックス) 上の I/O 仮想化 (ダイレクト I/O および SR-IOV) 操作を有効または無効にします。有効にすると、該当するバスのデバイスで I/O 仮想化がサポートされます。デフォルト値は `off` です。

`linkprop=phys-state`

  配下の物理ネットワークデバイスに基づいて、仮想デバイスがリンクステータスをレポートするかどうかを指定します。コマンドラインで `linkprop=phys-state` を指定すると、仮想デバイスのリンクステータスは物理リンクステータスを反映します。デフォルトでは、仮想デバイスのリンクステータスは物理リンクステータスを反映しません。

`log=[on|off]`

  仮想コンソールのロギングを有効または無効にします。有効な値は、ロギングを有効にする `on`、ロギングを無効にする `off`、およびデフォルト値にリセットする NULL 値 (`log=`) です。デフォルト値は `on` です。

  ログデータは、仮想コンソール端末集配信装置サービスを提供するサービスドメイン上の `/var/log/vntsd/domain-name/console-log` というファイルに保存されます。`logadm` コマンドを使用すると、コンソールログファイルがローテーションされます。`logadm`(1M) および `logadm.conf`(4) のマニュアルページを参照してください。

`mac-addr=`

  MAC アドレスを定義します。番号は、標準のオクテット記述法で指定する必要があります。たとえば、`80:00:33:55:22:66` とします。

`master=`

  1 つのスレーブドメインに対して最大 4 つのマスタードメインの名前を指定します。このプロパティーは、スレーブドメインで設定します。デフォルトでは、ドメインに対してマスタードメインは設定されていません。`ldm add-domain` 操作の前に、そのドメインが存在している必要があります。

  注 - Logical Domains Manager では、依存サイクルが生じるドメイン関係を作成することはできません。

`max-cores=num|unlimited`

  ドメインに割り当てることができるコアの最大数を指定します。値が `unlimited` の場合、割り当てることができる CPU コアの数に制限はありません。

`mblock=PA-start:size`

  ドメインに割り当てる、またはドメインから削除する物理メモリーブロックを 1 つ以上指定します。PA-start には、メモリーブロックの開始物理アドレスを 16 進形式で指定します。size は、ドメインに割り当てる、またはドメインから削除するメモリーブロックのサイズ (単位を含む) です。名前付きメモリーブロックをすべて削除するには、`ldm set-memory mblock=` コマンドを実行して、`mblock` プロパティーから PA-start:size 値を省略します。

  `mblock` プロパティーは、構成するシステムのトポロジについて知識のある管理者のみが使用するようにしてください。このような高度な構成機能では、特定の割り当て規則が適用されることによって、システム全体のパフォーマンスが影響を受ける可能性があります。

`mode=`

  `add-vsw` および `set-vsw` サブコマンドの場合:

  ゲストドメインで Oracle Solaris Cluster ソフトウェアが動作していない場合は、仮想ネットワークのパフォーマンスに影響を与える可能性があるため、このオプションを指定しないでください。

  そうでない場合は、次のいずれかを指定します。

  - Logical Domains 環境で Oracle Solaris Cluster ハートビートパケットの処理を優先順位付けするために、仮想ネットワークのサポートを有効にするには、`mode=sc` を指定します。

  - ハートビートパケット用の特別な処理を停止するには、`set-vsw` サブコマンドの `mode=` 引数を空白のままにします。

  `add-vnet` および `set-vnet` サブコマンドの場合:

  NIU ハイブリッド I/O を使用しない場合は、このオプションを省略します。

  そうでない場合は、次のいずれかを指定します。

  - `mode=hybrid` を設定して、可能な場合には NIU ハイブリッド I/O を使用するようにシステムに要求します。可能でない場合、システムは仮想 I/O に戻ります。『Oracle VM Server for SPARC 3.0 管理ガイド』の「NIU ハイブリッド I/O の使用」を参照してください。

    SR-IOV 機能が推奨されるため NIU ハイブリッド I/O 機能は非推奨となりました。『Oracle VM Server for SPARC 3.0 管理ガイド』の「PCIe SR-IOV 仮想機能の使用」を参照してください。

  - NIU ハイブリッド I/O を無効にするには、`set-vnet` サブコマンドの `mode=` 引数を空白のままにします。

`mpgroup=`

  複数の仮想ディスクサーバーデバイス (`vdsdev`) のマルチパスグループ名を定義します。したがって、仮想ディスクが仮想ディスクサーバーデバイスと通信できない場合、マルチパスグループ内のほかの仮想ディスクサーバーデバイスに対してフェイルオーバーが開始されます。

`mtu=`

  仮想スイッチ、その仮想スイッチにバインドされている仮想ネットワークデバイス、またはその両方の最大転送単位 (MTU) を指定します。有効な値は、`1500-16000` の範囲です。無効な値を指定すると、`ldm` コマンドでエラーが発生します。

`name=policy-name`

  リソース管理ポリシー名を指定します。

`net-dev=`

  実際のネットワークデバイスのパス名を定義します。

`options=`

  特定の仮想ディスクサーバーデバイスに、次のオプションのすべてまたはサブセットを指定します。2 つ以上のオプションは、空白文字を入れずにコンマで区切って、`ro,slice,excl` のように指定します。

  - `ro` - 読み取り専用アクセスを指定

  - `slice` - 単一スライスのディスクとしてバックエンドをエクスポート

  - `excl` - 排他的なディスクアクセスを指定

  `add-vdsdev` サブコマンドの `options=` 引数を指定しないか空白のままにすると、デフォルト値であるディスク、非排他的、および読み取り/書き込みになります。以前に指定したオプションをオフにするには、`set-vdsdev` サブコマンドの options= 引数を空白のままにします。

`port=`

  特定のポート番号を指定するか、空白のままにして、Logical Domains Manager によるポート番号の設定を可能にします。

`port-range=`

  TCP ポートの範囲を定義します。

`priority=value`

  Dynamic Resource Management (DRM) ポリシーの優先順位を指定します。優先順位の値は、単一ドメイン内の DRM ポリシー間の関係、および単一システム内の DRM 対応ドメイン間の関係を決定するために使用されます。数値が低いほど、優先度は高く (良く) なります。有効な値は、1 から 9999 までです。デフォルト値は 99 です。

  `priority` プロパティーの動作は、次に示すように、使用していない CPU リソースプールが使用可能であるかどうかによって異なります。

  - プール内の空き CPU リソースが使用可能です。この場合、`priority` プロパティーによって、1 つのドメインに複数の重複するポリシーが定義されている場合に、どの DRM ポリシーが有効になるのかが決まります。

  - プール内の空き CPU リソースが使用可能ではありません。この場合、`priority` プロパティーによって、同じシステム内の優先順位の低いドメインから優先順位の高いドメインにリソースを動的に移動できるかどうかが指定されます。ドメインの優先順位は、そのドメインで有効になっている DRM ポリシーによって指定された優先順位です。

    たとえば、優先順位の高いドメインは、優先順位の低い DRM ポリシーを持つ別のドメインから CPU リソースを取得できます。このリソース取得機能は、DRM ポリシーが有効になっているドメインのみに適用されます。`priority` 値が等しいドメインは、この機能の影響を受けません。そのため、すべてのポリシーに対してデフォルトの優先順位が使用されている場合、ドメインは優先順位の低いドメインからリソースを取得できません。この機能を活用するには、値が等しくならないように `priority` プロパティーの値を調整します。

`pvid=`

  仮想ネットワークデバイスをメンバーにする必要のある VLAN をタグなしモードで指定します。

`rc-add-policy=[iov]]`

  特定のドメインに追加される可能性のあるルートコンプレックスで、ダイレクト I/O および SR-IOV I/O 仮想化操作を有効または無効にするかどうかを指定します。有効な値は、`iov` および値なし (`rc-add-policy=`) です。`rc-add-policy=iov` の場合、追加されるルートコンプレックスで、ダイレクト I/O および SR-IOV の機能が有効になります。`rc-add-policy=` の場合、`iov` プロパティー値が消去され、ルートコンプレックスの I/O 仮想化機能が無効になります (`add-io` コマンドを使用して `iov=on` を明示的に設定していない場合)。デフォルト値は値なしです。

`sample-rate=value`

  DRM のサンプリングレートとなるサイクル時間を秒で指定します。有効な値の範囲は、1 - 9999 です。推奨値はデフォルトの 10 です。

`service=`

  コンソール接続を処理する既存の仮想コンソール端末集配信装置の名前を指定します。

`shutdown-group=num`

  ドメインの停止グループ番号を指定します。この値は、順序付きシャットダウンが実行されるときに、Fujitsu M10 システム上の SP で使用されます。

  SP によって、順序付きシャットダウンが開始されると、停止グループ番号の降順でドメインが停止されます。つまり、もっとも大きい番号のドメインが最初に停止されます。もっとも小さい番号のドメインが最後に停止されます。複数のドメインで優先順位を共有している場合は、マスターとスレーブの関係が存在しないかぎり、停止順序は同時になります。この場合、マスタードメインの前にスレーブドメインが停止されます。

  有効な値は、`1` から `15` までです。その他のドメインのデフォルト値は `15` です。制御ドメインの停止グループ番号はゼロ (`0`) で、変更できません。

  新しい `shutdown-group` プロパティー値を有効にするには、`ldm add-spconfig` コマンドを使用して構成を SP に保存する必要があります。次に、SP で構成が読み込まれるように、サーバーの電源を再投入します。

  このプロパティーは、Fujitsu M10 システムにのみ適用されます。

`threading=max-ipc|max-throughput`

  `threading` プロパティーは、ドメインのワークフロースループットを指定します。ただし、このプロパティーの使用は非推奨となり、代わりに自動的に有効になる Critical Threads API が使用されます。Complete Power を参照してください。

  `threading` プロパティーの有効な値は次のとおりです。

  - `max-ipc`。ドメインに割り当てられる CPU コアごとに 1 つのスレッドのみがアクティブになることにより、1 サイクルあたりの命令数が最大になります。このモードを選択するには、コア全体の制限付きでドメインを構成する必要もあります。`add-core`、`set-core`、`add-domain`、および `set-domain` サブコマンドの説明を参照してください。

  - `max-throughput`。ドメインに割り当てられるスレッドをすべてアクティブにすることにより、スループットを最大にします。このモードはデフォルトで使用され、どのモードも指定されていない場合にも (`threading=`) 選択されます。

`timeout=`

  仮想ディスククライアント (`vdc`) と仮想ディスクサーバー (`vds`) の間の接続を確立する際の秒数を定義します。複数の仮想ディスク (`vdisk`) パスがある場合、`vdc` は、別の `vds` への接続を試みることができます。また、タイムアウトによって、いずれかの `vds` への接続が指定の時間内に確実に行われます。`0` を指定すると `set-vdisk` サブコマンドのタイムアウトは無効になります。

`tod-begin=hh:mm[:ss]`

  ポリシーの有効開始時刻を指定します。単位は時、分、秒 (オプション) です。この時間は、午前 0 時から 23:59:59 の範囲で、`tod-end` で指定された時間よりも早い時間に設定する必要があります。デフォルト値は `00:00:00` です。

`tod-end=hh:mm[:ss]`

  ポリシーの有効停止時刻を指定します。単位は時、分、秒 (オプション) です。この時間は、午前 0 時から 23:59:59 の範囲で、`tod-begin` で指定された時間よりも遅い時間に設定する必要があります。デフォルト値は `23:59:59` です。

`util-lower=percent`

  ポリシー分析がトリガーされる使用率の下限レベルを指定します。有効な値は、1 から、`util-upper` より 1 少ない数までです。デフォルト値は 60 です。

`util-upper=percent`

  ポリシー分析がトリガーされる使用率の上限レベルを指定します。有効な値は、`util-lower` に 1 を足した数から 99 までです。デフォルト値は 85 です。

`uuid=uuid`

  ドメインの汎用一意識別子 (UUID) を指定します。uuid は、ダッシュで区切った 5 つの 16 進数で構成される 16 進数の文字列 (`12345678-1234-abcd-1234-123456789abc` など) です。各数字には、次のように、指定された桁数の 16 進数 (8、4、4、4、12) が必要です。

      xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

`vcpu-max=value`

  ドメインの CPU スレッドリソースの最大数を指定します。デフォルトでは、CPU スレッドの最大数に制限はありません。有効な値は、`vcpu-min` に 1 を足した数から、システムで使用していない CPU スレッドの合計数までです。

`vcpu-min=value`

  ドメインの CPU スレッドリソースの最小数を指定します。有効な値は、1 から、`vcpu-max` より 1 少ない数までです。デフォルト値は 1 です。

`vid=`

  仮想ネットワークデバイスまたは仮想スイッチをメンバーにする必要がある VLAN を、タグ付きモードで指定します。

`volume=`

  仮想ディスクのボリューム名を変更します。

`vswitch=`

  仮想ネットワークの仮想スイッチ名を変更します。

### `list` サブコマンド出力内のフラグ

次に、`list` サブコマンド出力内のフラグの定義を示します。

`-`

  可変部分

`c`

  制御ドメイン

`d`

  遅延再構成の保留中

`e`

  エラー

`n`

  標準

`r`

  メモリー動的再構成の進行中

`s`

  列 1 - 起動または停止

  列 6 - ソースドメイン

`t`

  列 2 - 切り替え

  列 6 - ターゲットドメイン

`v`

  仮想 I/O サービスドメイン

リストフラグ値は位置に依存します。次に、左から順に 5 つの列のそれぞれに表示される可能性のある値を示します。

表 1 リストフラグの位置

列 1 | 列 2 | 列 3 | 列 4 | 列 5 | 列 6
--- | --- | --- | --- | --- | ---
`s` または `-` | `n`、または `t` | `d`、`r`、または `-` | `c` または `-` | `v` または `-` | `s`、`t`、または `e`

## サブコマンドの使用法

このセクションでは、サポートされているコマンド行インタフェース (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] [shutdown-group=num] [rc-add-policy=[iov]]
      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 では、依存サイクルが生じるドメイン関係を作成することはできません。

- `rc-add-policy` は、特定のドメインに追加される可能性のあるルートコンプレックスで、ダイレクト I/O および SR-IOV I/O 仮想化操作を有効または無効にするかどうかを指定します。有効な値は、`iov` および値なし (`rc-add-policy=`) です。`rc-add-policy=iov` の場合、追加されるルートコンプレックスで、ダイレクト I/O および SR-IOV の機能が有効になります。`rc-add-policy=` の場合、`iov` プロパティー値が消去され、ルートコンプレックスの I/O 仮想化機能が無効になります (`add-io` コマンドを使用して `iov=on` を明示的に設定していない場合)。デフォルト値は値なしです。

- `threading` プロパティーを設定すると、ドメインのワークフロースループットが指定されます。ただし、このプロパティーの使用は非推奨となり、代わりに自動的に有効になる Critical Threads API が使用されます。Complete Power を参照してください。

  `threading` プロパティーの有効な値は次のとおりです。

  - `max-ipc`。ドメインに割り当てられる CPU コアごとに 1 つのスレッドのみがアクティブになることにより、1 サイクルあたりの命令数が最大になります。このモードを選択するには、コア全体の制限付きでドメインを構成する必要もあります。`add-vcpu` および `set-vcpu` サブコマンドの説明を参照してください。

  - `max-throughput`。ドメインに割り当てられるスレッドをすべてアクティブにすることにより、スループットを最大にします。このモードはデフォルトで使用され、どのモードも指定されていない場合にも (`threading=`) 選択されます。

- `uuid=`uuid には、ドメインの汎用一意識別子 (UUID) を指定します。uuid は、ダッシュで区切った 5 つの 16 進数で構成される 16 進数の文字列 (`12345678-1234-abcd-1234-123456789abc` など) です。各数字には、次のように、指定された桁数の 16 進数 (8、4、4、4、12) が必要です。

      xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

- `max-cores=[num|unlimited]` には、ドメインに割り当てることができるコアの最大数を指定します。値が `unlimited` の場合、割り当てることができる CPU コアの数に制限はありません。

- `shutdown-group=num` には、ドメインの停止グループ番号を指定します。この値は、順序付きシャットダウンが実行されるときに、Fujitsu M10 システム上の SP で使用されます。

  SP によって、順序付きシャットダウンが開始されると、停止グループ番号の降順でドメインが停止されます。つまり、もっとも大きい番号のドメインが最初に停止されます。もっとも小さい番号のドメインが最後に停止されます。複数のドメインで優先順位を共有している場合は、マスターとスレーブの関係が存在しないかぎり、停止順序は同時になります。この場合、マスタードメインの前にスレーブドメインが停止されます。

  有効な値は、`1` から `15` までです。その他のドメインのデフォルト値は `15` です。制御ドメインの停止グループ番号はゼロ (`0`) で、変更できません。

  新しい `shutdown-group` プロパティー値を有効にするには、`ldm add-spconfig` コマンドを使用して構成を SP に保存する必要があります。次に、SP で新しい構成が強制的に読み込まれるように、サーバーの電源を再投入します。

  このプロパティーは、Fujitsu M10 システムにのみ適用されます。

- 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]] [shutdown-group=num] [rc-add-policy=[iov]]
      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 では、依存サイクルが生じるドメイン関係を作成することはできません。

- `rc-add-policy` は、特定のドメインに追加される可能性のあるルートコンプレックスで、ダイレクト I/O および SR-IOV I/O 仮想化操作を有効または無効にするかどうかを指定します。有効な値は、`iov` および値なし (`rc-add-policy=`) です。`rc-add-policy=iov` の場合、追加されるルートコンプレックスで、ダイレクト I/O および SR-IOV の機能が有効になります。`rc-add-policy=` の場合、`iov` プロパティー値が消去され、ルートコンプレックスの I/O 仮想化機能が無効になります (`add-io` コマンドを使用して `iov=on` を明示的に設定していない場合)。デフォルト値は値なしです。

- `threading` プロパティーを設定すると、ドメインのワークフロースループットが指定されます。ただし、このプロパティーの使用は非推奨となり、代わりに自動的に有効になる Critical Threads API が使用されます。Complete Power を参照してください。

  `threading` プロパティーの有効な値は次のとおりです。

  - `max-ipc`。ドメインに割り当てられる CPU コアごとに 1 つのスレッドのみがアクティブになることにより、1 サイクルあたりの命令数が最大になります。このモードを選択するには、コア全体の制限付きでドメインを構成する必要もあります。`add-vcpu` および `set-vcpu` サブコマンドの説明を参照してください。

  - `max-throughput`。ドメインに割り当てられるスレッドをすべてアクティブにすることにより、スループットを最大にします。このモードはデフォルトで使用され、どのモードも指定されていない場合にも (`threading=`) 選択されます。

- `max-cores=[num|unlimited]` には、ドメインに割り当てることができるコアの最大数を指定します。値が `unlimited` の場合、割り当てることができる CPU コアの数に制限はありません。

- `shutdown-group=num` には、ドメインの停止グループ番号を指定します。この値は、順序付きシャットダウンが実行されるときに、Fujitsu M10 システム上の SP で使用されます。

  SP によって、順序付きシャットダウンが開始されると、停止グループ番号の降順でドメインが停止されます。つまり、もっとも大きい番号のドメインが最初に停止されます。もっとも小さい番号のドメインが最後に停止されます。複数のドメインで優先順位を共有している場合は、マスターとスレーブの関係が存在しないかぎり、停止順序は同時になります。この場合、マスタードメインの前にスレーブドメインが停止されます。

  有効な値は、`1` から `15` までです。その他のドメインのデフォルト値は `15` です。制御ドメインの停止グループ番号はゼロ (`0`) で、変更できません。

  新しい `shutdown-group` プロパティー値を有効にするには、`ldm add-spconfig` コマンドを使用して構成を SP に保存する必要があります。次に、SP で新しい構成が強制的に読み込まれるように、サーバーの電源を再投入します。

  このプロパティーは、Fujitsu M10 システムにのみ適用されます。

- ldom は、オプションを設定する論理ドメインの名前を指定します。

ドメインの削除

次のサブコマンドは、1 つ以上の論理ドメインを削除します。

    ldm rm-dom -a
    ldm rm-dom ldom...

ここでは:

- `-a` は、制御ドメインを除くすべての論理ドメインを削除します。

- ldom は、削除する論理ドメインを指定します。

  破棄するドメインがマスタードメインとして指定されている場合は、このドメインへの参照がすべてのスレーブドメインから削除されます。

Logical Domainsの移行

このサブコマンドは、ドメインをある場所から別の場所に移行します。

    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 は次の種類の再構成処理をサポートしています。

- 動的再構成処理。動的再構成は、アクティブなドメインに対してリソースを追加、設定、または削除する機能です。特定の種類のリソースの動的再構成を実行できるかどうかは、論理ドメインで動作している特定のバージョンの OS でサポートされているかどうかに依存します。制御ドメインで動的再構成を実行できない場合、遅延再構成処理を開始します。自動的に遅延再構成が開始されることもあります。

- 遅延再構成処理。すぐに有効になる動的再構成処理とは異なり、遅延再構成処理が有効になるのは、次に OS をリブートしたあとや、OS が実行中でない場合に論理ドメインを停止して起動したあとです。`ldm start-reconf primary` コマンドを実行すると、ルートドメイン上で遅延再構成モードに手動で切り替えることができます。`primary` 以外のルートドメインで遅延再構成を開始すると、制限付きの I/O 操作 (`add-io`、`set-io`、`rm-io`、`create-vf`、および `destroy-vf`) しか実行できなくなります。動的に構成できないリソースを変更する前に、ほかのドメインを停止する必要があります。

動的再構成と遅延再構成の詳細については、『Oracle VM Server for SPARC 3.0 管理ガイド』の「リソースの再構成」を参照してください。

### CPU の操作

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 3.0 管理ガイド』の「ハードパーティションによるシステムの構成」を参照してください。

  コアからスレッドへの割り当て単位を変更したり、キャップを削除したりできます。このような変更を行うには、アクティブでないドメインまたは遅延再構成モードになっている `primary` ドメインで、`add-vcpu`、`set-vcpu`、または `rm-vcpu` コマンドを `-c` オプションを付けずに発行します。

  Oracle VM Server for SPARC 2.2 リリース以降、CPU キャップと CPU コアの割り当ては別々のコマンドで処理されるようになりました。これらのコマンドを使用すれば、CPU コアの割り当て、キャップの設定、あるいはその両方を独立して実行できます。キャップが設定されていない場合でも、コアへの割り当て単位を設定できます。ただし、Oracle VM Server for SPARC システムにハードパーティション分割を構成する場合、キャップが設定されていないときにシステムを実行することは許可されません。

  - `add-core`、`set-core`、および `rm-core` サブコマンドを使用して、指定された数の CPU コアをドメインに割り当てます。

  - `create-domain` または `set-domain` サブコマンドを使用して `max-cores` プロパティー値を指定して、キャップを設定します。

- `-c` オプションが指定されていない場合、number は論理ドメインに追加される CPU スレッドの数です。`-c` オプションが指定されている場合、number は論理ドメインに追加される CPU コアの数です。

- ldom には、CPU スレッドが追加される論理ドメインを指定します。

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 3.0 管理ガイド』の「ハードパーティションによるシステムの構成」を参照してください。

  コアからスレッドへの割り当て単位を変更したり、キャップを削除したりできます。このような変更を行うには、アクティブでないドメインまたは遅延再構成モードになっている `primary` ドメインで、`add-vcpu`、`set-vcpu`、または `rm-vcpu` コマンドを `-c` オプションを付けずに発行します。

  Oracle VM Server for SPARC 2.2 リリース以降、CPU キャップと CPU コアの割り当ては別々のコマンドで処理されるようになりました。これらのコマンドを使用すれば、CPU コアの割り当て、キャップの設定、あるいはその両方を独立して実行できます。キャップが設定されていない場合でも、コアへの割り当て単位を設定できます。ただし、Oracle VM Server for SPARC システムにハードパーティション分割を構成する場合、キャップが設定されていないときにシステムを実行することは許可されません。

  - `add-core`、`set-core`、および `rm-core` サブコマンドを使用して、指定された数の CPU コアをドメインに割り当てます。

  - `create-domain` または `set-domain` サブコマンドを使用して `max-cores` プロパティー値を指定して、キャップを設定します。

- `-c` オプションが指定されていない場合、number は論理ドメインで設定される CPU スレッドの数です。`-c` オプションが指定されている場合、number は論理ドメインで設定される CPU コアの数です。

- ldom は、CPU スレッドの数が設定される論理ドメインです。

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 3.0 管理ガイド』の「ハードパーティションによるシステムの構成」を参照してください。

  コアからスレッドへの割り当て単位を変更したり、キャップを削除したりできます。このような変更を行うには、アクティブでないドメインまたは遅延再構成モードになっている `primary` ドメインで、`add-vcpu`、`set-vcpu`、または `rm-vcpu` コマンドを `-c` オプションを付けずに発行します。

  Oracle VM Server for SPARC 2.2 リリース以降、CPU キャップと CPU コアの割り当ては別々のコマンドで処理されるようになりました。これらのコマンドを使用すれば、CPU コアの割り当て、キャップの設定、あるいはその両方を独立して実行できます。キャップが設定されていない場合でも、コアへの割り当て単位を設定できます。ただし、Oracle VM Server for SPARC システムにハードパーティション分割を構成する場合、キャップが設定されていないときにシステムを実行することは許可されません。

  - `add-core`、`set-core`、および `rm-core` サブコマンドを使用して、指定された数の CPU コアをドメインに割り当てます。

  - `create-domain` または `set-domain` サブコマンドを使用して `max-cores` プロパティー値を指定して、キャップを設定します。

- `-c` オプションが指定されていない場合、number は論理ドメインから削除される CPU スレッドの数です。`-c` オプションが指定されている場合、number は論理ドメインから削除される CPU コアの数です。

- ldom には、CPU スレッドが削除される論理ドメインを指定します。

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[,...]` には、ドメインに割り当てる物理 CPU コアを 1 つ以上指定します。

- ldom には、CPU コアが割り当てられるドメインを指定します。

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[,...]` には、ドメインに割り当てる物理 CPU コアを 1 つ以上指定します。`cid=` は、名前付き CPU コアをすべて削除します。

- ldom には、CPU コアが割り当てられるドメインを指定します。

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[,...]` には、ドメインから削除する物理 CPU コアを 1 つ以上指定します。

- ldom には、CPU コアが削除されるドメインを指定します。

### 暗号化装置の操作

暗号化装置のサブコマンドは、個別の暗号化装置を持つ SPARC プラットフォームにのみ適用されます。SPARC T4 プラットフォーム以降の新しいプラットフォームには、統合された暗号化手順があるため、個別の暗号化装置は使用されません。

暗号化装置の追加

次のサブコマンドは、論理ドメインに追加する暗号化装置の数を指定します。現在、サポートされているサーバー上でサポートされている暗号化装置は、モジュラー演算ユニット (Modular Arithmetic Unit、MAU) および Control Word Queue (CWQ) です。

    ldm add-crypto number ldom

ここでは:

- number は、論理ドメインに追加する暗号化装置の数です。

- ldom は、暗号化装置を追加する論理ドメインを指定します。

暗号化装置の設定

次のサブコマンドは、論理ドメインで設定する暗号化装置の数を指定します。アクティブなドメインからすべての暗号化装置を削除する場合は、`-f` オプションを指定する必要があります。

ドメインがアクティブなときに `primary` ドメインから最後の暗号化装置を削除する場合は、次のいずれかの操作を実行します。

- 動的再構成を使用して、`-f` オプションを指定します

- 遅延再構成を使用します

    ldm set-crypto [-f] number ldom

ここでは:

- number が `0` の場合に `-f` を指定すると、ドメイン内の最後の暗号化装置が強制的に削除されます。

  `-f` オプションは次の状況でのみ必要となります。

  - ゲストドメインがアクティブな場合

  - `primary` ドメイン上 (ただし、システム上にアクティブなゲストドメインが 1 つ以上存在する場合のみ)

- number は、論理ドメインで設定する暗号化装置の数です。

- ldom は、暗号化装置の数を設定する論理ドメインを指定します。

暗号化装置の削除

次のサブコマンドは、指定した数の暗号化装置を論理ドメインから削除します。アクティブなドメインからすべての暗号化装置を削除する場合は、`-f` オプションを指定する必要があります。

ドメインがアクティブなときに `primary` ドメインから最後の暗号化装置を削除する場合は、次のいずれかの操作を実行します。

- 動的再構成を使用して、`-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 は、メモリーを削除する論理ドメインを指定します。

### 遅延再構成モードの入力

このサブコマンドで、ドメインが遅延再構成モードに入ることができます。遅延再構成は、ルートドメインでのみサポートされています。

    ldm start-reconf ldom

### 遅延再構成処理の取り消し

このサブコマンドは、遅延再構成を取り消します。遅延再構成は、ルートドメインでのみサポートされています。

    ldm cancel-reconf ldom

### 操作の取り消し

このサブコマンドは、論理ドメインに対する遅延再構成 (`reconf`)、メモリー動的再構成の削除 (`memdr`)、またはドメイン移行 (`migration`) を取り消します。`reconf` 操作は、ルートドメインでのみサポートされています。

    ldm cancel-op migration ldom
    ldm cancel-op reconf ldom
    ldm cancel-op memdr ldom

### I/O デバイス

I/O デバイスの追加

このサブコマンドは、指定した論理ドメインに PCIe バス、デバイス、または仮想機能を動的に追加しようと試みます。ドメインで動的構成がサポートされていない場合は、コマンドに失敗し、遅延再構成を開始するか、ドメインを停止してからデバイスを追加する必要があります。

`iov=off` のときにルートドメインにルートコンプレックスを追加する場合、`create-vf`、`destroy-vf`、`add-io`、または `rm-io` サブコマンドを使用しても、ダイレクト I/O および SR-IOV デバイスを正常に割り当てることができません。

    ldm add-io [iov=on|off] bus ldom
    ldm add-io (device | vf-name) ldom

ここでは:

- `iov=on|off` は、PCIe バス (ルートコンプレックス) 上の I/O 仮想化 (ダイレクト I/O および SR-IOV) 操作を有効または無効にします。有効にすると、該当するバスのデバイスで I/O 仮想化がサポートされます。`ldm add-io` コマンドは、指定された PCIe バスをルートドメインに再度バインドします。デフォルト値は `off` です。

  追加しようとする PCIe バスがすでにドメインにバインドされている場合は、コマンドに失敗することに注意してください。

- 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 は、バスまたはデバイスを追加する論理ドメインを指定します。

仮想機能のプロパティーの設定

このサブコマンドは、プロパティー値を変更するか、新しいプロパティーを渡すことによって、仮想機能の現在の構成を変更します。このコマンドは、クラス固有のプロパティーとデバイス固有のプロパティーの両方を変更できます。

ほとんどのネットワーククラス固有のプロパティーは、ルートドメインをリブートしなくても変更できます。ただし、ドメインにバインドされている仮想機能の `mtu` および `mac-addresses` プロパティーを変更するには、まず該当するドメインを停止するか、ルートドメインで遅延再構成を開始する必要があります。

- すべてのデバイス固有のプロパティーでは、物理機能デバイスドライバの接続操作中に該当するプロパティーを更新できるように、遅延再構成が開始されます。結果として、ルートドメインのリブートが必要になります。

- このコマンドは、物理機能ドライバが結果として得られる構成を正常に検証できた場合にのみ成功します。

    ldm set-io [mac-addr=num] [alt-mac-addrs=[auto|num1,[auto|num2,...]]]
      [pvid=[port-vlan-id]] [vid=[vlan-id1,vlan-id2,...]] [iov=[on|off]]
      [mtu=size] [name=value...] vf-name

ここでは:

- `alt-mac-addrs=auto|num1,[auto|num2,...]` は、代替 MAC アドレスのコンマ区切りリストです。有効な値は、数値の MAC アドレスと、システムで代替 MAC アドレスが生成されるようにリクエストするために 1 回以上使用できる `auto` キーワードです。`auto` キーワードと数値の MAC アドレスは混在できます。数値の MAC アドレスは、標準のオクテット記述法で指定する必要があります。たとえば、`80:00:33:55:22:66` とします。

  1 つ以上の代替 MAC アドレスを割り当てると、このデバイス上に 1 つ以上の仮想 NIC (VNIC) を作成できます。VNIC ごとに 1 つの代替 MAC アドレスが使用されるため、割り当てられた MAC アドレスの数によって、デバイス上に作成できる VNIC の数が決まります。代替 MAC アドレスが指定されていない場合は、このデバイス上に VNIC を作成しようとしても失敗します。詳細は、Oracle Solaris 11 ネットワークドキュメントおよび『Oracle VM Server for SPARC 3.0 管理ガイド』の第 8 章「仮想ネットワークの使用」を参照してください。

- `iov=on|off` は、PCIe バス (ルートコンプレックス) 上の I/O 仮想化 (ダイレクト I/O および SR-IOV) 操作を有効または無効にします。有効にすると、該当するバスのデバイスで I/O 仮想化がサポートされます。デフォルト値は `off` です。

  `iov` プロパティー値を変更するには、ルートコンプレックスをドメインにバインドし、ドメインを遅延再構成の状態にする必要があります。

- name`=`value は、設定するプロパティーの名前と値の組み合わせです。

- vf-name は、仮想機能の名前です。

物理機能のプロパティーの設定

このサブコマンドは、物理機能の構成を変更します。物理機能デバイス固有のプロパティーのみがサポートされています。物理機能デバイスドライバの接続操作中にプロパティーが適用されるため、プロパティーを変更すると遅延再構成が発生します。

プロパティー値は、整数または文字列である必要があります。プロパティー値のタイプおよび特定のプロパティーが設定可能かどうかを判定するには、`ldm list-io -d` コマンドを実行します。

`ldm set-io` コマンドは、結果として得られる構成を物理機能ドライバが正常に検証した場合にのみ成功することに注意してください。

    ldm set-io name=value [name=value...] pf-name

ここでは:

- name`=`value は、設定するプロパティーの名前と値の組み合わせです。

- pf-name は、物理機能の名前です。

I/O デバイスの削除

このサブコマンドは、指定したドメインから PCIe バス、デバイス、または仮想機能を削除します。

    ldm rm-io [-n] (bus | device | vf-name) ldom

ここでは:

- `-n` は、コマンドが成功するかどうかを判定するために予行演習を行います。実際には I/O デバイスは削除されません。

- 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 3.0 管理ガイド』の「VLAN のタグ付けの使用」を参照してください。

- `linkprop=phys-state` では、配下の物理ネットワークデバイスに基づいて、仮想デバイスがリンクステータスをレポートするかどうかを指定できます。コマンドラインで `linkprop=phys-state` を指定すると、仮想デバイスのリンクステータスは物理リンクステータスを反映します。デフォルトでは、仮想デバイスのリンクステータスは物理リンクステータスを反映しません。

- `vid=`vlan-id は、仮想ネットワークデバイスまたは仮想スイッチをメンバーにする必要がある 1 つ以上の VLAN を、タグ付きモードで指定します。このプロパティーは、`set-vsw` サブコマンドにも適用されます。詳細については、『Oracle VM Server for SPARC 3.0 管理ガイド』の「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 Cluster ハートビートパケットの処理を優先順位付けするために、仮想ネットワークのサポートを有効にします。Oracle Solaris Cluster などのアプリケーションでは、輻輳した仮想ネットワークおよびスイッチデバイスによって高優先度のハートビートパケットがドロップされないようにする必要があります。このオプションを使用して、Oracle Solaris Cluster のハートビートフレームが優先され、これらのフレームが信頼性の高い方法で転送されるようにします。

  Oracle Solaris Cluster を Logical Domains 環境で実行し、ゲストドメインを Oracle Solaris Cluster ノードとして使用ている場合にこのオプションを設定する必要があります。ゲストドメインで Oracle Solaris Cluster ソフトウェアを実行していない場合には、仮想ネットワークのパフォーマンスに影響を与える可能性があるため、このオプションを設定しないでください。

- `mtu=`size は、仮想スイッチデバイスの最大転送単位 (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 3.0 管理ガイド』の「VLAN のタグ付けの使用」を参照してください。

- `vid=`vlan-id は、仮想ネットワークデバイスまたは仮想スイッチをメンバーにする必要がある 1 つ以上の VLAN を、タグ付きモードで指定します。『Oracle VM Server for SPARC 3.0 管理ガイド』の「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 Cluster ハートビートパケットの処理を優先順位付けするために、仮想ネットワークのサポートを有効にします。Oracle Solaris Cluster などのアプリケーションでは、輻輳した仮想ネットワークおよびスイッチデバイスによって高優先度のハートビートパケットがドロップされないようにする必要があります。このオプションを使用して、Oracle Solaris Cluster のハートビートフレームが優先され、これらのフレームが信頼性の高い方法で転送されるようにします。

  `mode=` (空白のまま) では、 ハートビートパケットの特殊処理が停止されます。

  Oracle Solaris Cluster を Logical Domains 環境で実行し、ゲストドメインを Oracle Solaris Cluster ノードとして使用ている場合にこのオプションを設定する必要があります。ゲストドメインで Oracle Solaris Cluster ソフトウェアを実行していない場合には、仮想ネットワークのパフォーマンスに影響を与える可能性があるため、このオプションを設定しないでください。

- `mtu=`size は、仮想スイッチデバイスの最大転送単位 (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] [alt-mac-addrs=auto|num1[,auto|num2,...]]
      [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` とします。

- `alt-mac-addrs=auto|num1,[auto|num2,...]` は、代替 MAC アドレスのコンマ区切りリストです。有効な値は、数値の MAC アドレスと、システムで代替 MAC アドレスが生成されるようにリクエストするために 1 回以上使用できる `auto` キーワードです。`auto` キーワードと数値の MAC アドレスは混在できます。数値の MAC アドレスは、標準のオクテット記述法で指定する必要があります。たとえば、`80:00:33:55:22:66` とします。

  1 つ以上の代替 MAC アドレスを割り当てると、このデバイス上に 1 つ以上の仮想 NIC (VNIC) を作成できます。VNIC ごとに 1 つの代替 MAC アドレスが使用されるため、割り当てられた MAC アドレスの数によって、デバイス上に作成できる VNIC の数が決まります。代替 MAC アドレスが指定されていない場合は、このデバイス上に VNIC を作成しようとしても失敗します。詳細は、Oracle Solaris 11 ネットワークドキュメントおよび『Oracle VM Server for SPARC 3.0 管理ガイド』の第 8 章「仮想ネットワークの使用」を参照してください。

- `mode=hybrid` は、可能な場合に、この `vnet` で NIU ハイブリッド I/O を使用するようにシステムに要求します。可能でない場合、システムは仮想 I/O に戻ります。このハイブリッドモードを制御ドメイン上のアクティブな `vnet` で設定した場合、遅延再構成とみなされます。『Oracle VM Server for SPARC 3.0 管理ガイド』の「NIU ハイブリッド I/O の使用」を参照してください。

  SR-IOV 機能が推奨されるため NIU ハイブリッド I/O 機能は非推奨となりました。『Oracle VM Server for SPARC 3.0 管理ガイド』の「PCIe SR-IOV 仮想機能の使用」を参照してください。

- `pvid=`port-vlan-id には、仮想ネットワークデバイスをメンバーにする必要のある VLAN をタグなしモードで指定します。『Oracle VM Server for SPARC 3.0 管理ガイド』の「VLAN のタグ付けの使用」を参照してください。

- `vid=`vlan-id は、仮想ネットワークデバイスがタグ付きモードでメンバーとして属する必要のある 1 つ以上の VLAN を指定します。『Oracle VM Server for SPARC 3.0 管理ガイド』の「VLAN のタグ付けの使用」を参照してください。

- `mtu=`size は、仮想ネットワークデバイスの最大転送単位 (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]]
      [alt-mac-addrs=auto|num1[,auto|num2,...]] [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` とします。

- `alt-mac-addrs=auto|num1,[auto|num2,...]` は、代替 MAC アドレスのコンマ区切りリストです。有効な値は、数値の MAC アドレスと、システムで代替 MAC アドレスが生成されるようにリクエストするために 1 回以上使用できる `auto` キーワードです。`auto` キーワードと数値の MAC アドレスは混在できます。数値の MAC アドレスは、標準のオクテット記述法で指定する必要があります。たとえば、`80:00:33:55:22:66` とします。

  1 つ以上の代替 MAC アドレスを割り当てると、このデバイス上に 1 つ以上の仮想 NIC (VNIC) を作成できます。VNIC ごとに 1 つの代替 MAC アドレスが使用されるため、割り当てられた MAC アドレスの数によって、デバイス上に作成できる VNIC の数が決まります。代替 MAC アドレスが指定されていない場合は、このデバイス上に VNIC を作成しようとしても失敗します。詳細は、Oracle Solaris 11 ネットワークドキュメントおよび『Oracle VM Server for SPARC 3.0 管理ガイド』の第 8 章「仮想ネットワークの使用」を参照してください。

- `vswitch=`vswitch-name は、接続する既存のネットワークサービス (仮想スイッチ) の名前です。

- `mode=hybrid` を指定すると、この `vnet` での NIU ハイブリッド I/O 操作が有効になります。このオプションを制御ドメイン上のアクティブな `vnet` で設定した場合、遅延再構成とみなされます。NIU ハイブリッド I/O を無効にするには、`mode=` 引数を空白のままにします。

  SR-IOV 機能が推奨されるため NIU ハイブリッド I/O 機能は非推奨となりました。『Oracle VM Server for SPARC 3.0 管理ガイド』の「PCIe SR-IOV 仮想機能の使用」を参照してください。

- `pvid=`port-vlan-id には、仮想ネットワークデバイスをメンバーにする必要のある VLAN をタグなしモードで指定します。『Oracle VM Server for SPARC 3.0 管理ガイド』の「VLAN のタグ付けの使用」を参照してください。

- `linkprop=phys-state` では、配下の物理ネットワークデバイスに基づいて、仮想デバイスがリンクステータスをレポートするかどうかを指定できます。コマンドラインで `linkprop=phys-state` を指定すると、仮想デバイスのリンクステータスは物理リンクステータスを反映します。デフォルトでは、仮想デバイスのリンクステータスは物理リンクステータスを反映しません。`linkprop` プロパティーを指定していない場合や、`linkprop=` 引数を使用して `ldm set-vnet` コマンドを実行する場合は、デフォルトの状態になります。

- `vid=`vlan-id は、仮想ネットワークデバイスがタグ付きモードでメンバーとして属する必要のある 1 つ以上の VLAN を指定します。『Oracle VM Server for SPARC 3.0 管理ガイド』の「VLAN のタグ付けの使用」を参照してください。

- `mtu=`size は、仮想ネットワークデバイスの最大転送単位 (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 3.0 管理ガイド』の第 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 3.0 管理ガイド』を参照してください。

    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]
      [log=[on|off]] ldom

ここでは:

- `port=`port-num は、このコンソールで使用する特定のポートです。Logical Domains Manager で自動的にポート番号を割り当てるには、port-num を空白のままにします。

- `group=`group は、このコンソールに接続する新しいグループです。グループ引数を使用すると、同一の TCP 接続上で複数のコンソールを多重化できます。この概念については、Oracle Solaris OS `vntsd`(1M) マニュアルページを参照してください。グループを指定した場合は、サービスも指定する必要があります。

- `service=`vcc-server は、コンソール接続を処理する既存の仮想コンソール端末集配信装置の名前です。グループを指定した場合は、サービスを指定する必要があります。

- `log=[on|off]` は、仮想コンソールのロギングを有効または無効にします。有効な値は、ロギングを有効にする `on`、ロギングを無効にする `off`、およびデフォルト値にリセットする NULL 値 (`log=`) です。デフォルト値は `on` です。

  ログデータは、仮想コンソール端末集配信装置サービスを提供するサービスドメイン上の `/var/log/vntsd/domain-name/console-log` というファイルに保存されます。`logadm` コマンドを使用すると、コンソールログファイルがローテーションされます。`logadm`(1M) および `logadm.conf`(4) のマニュアルページを参照してください。

- ldom は、仮想コンソールを設定する論理ドメインを指定します。

### 物理機能および仮想機能

仮想機能

PCIe Single-Root I/O Virtualization (SR-IOV) 標準を使用すると、I/O ドメイン間で PCIe デバイスを効率的に共有できます。この標準は、ハードウェアでネイティブに近い I/O パフォーマンスを実現するために実装されます。SR-IOV では、物理デバイスまたは物理機能の仮想化されたインスタンスである仮想機能が数多く作成されます。関連付けられた物理デバイスを共有し、CPU やハイパーバイザのオーバーヘッドを発生させずに I/O を実行できるように、仮想機能は直接 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 つずつ増やすことによって、指定された物理機能から仮想機能を作成します。新しい仮想機能には、仮想機能番号の順序でもっとも大きい番号が割り当てられます。

仮想機能を動的に作成するには、必ず親ルートコンプレックスに `iov` プロパティーを設定してください。

ネットワーククラス仮想機能には、デフォルトで割り当てられている MAC アドレスを割り当てる必要があります。デフォルトの MAC アドレス値をオーバーライドするには、`mac-addr` プロパティーに別の値を指定します。

仮想機能を作成するときに、クラス固有のプロパティーとデバイス固有のプロパティーを設定することもできます。このコマンドは、結果として得られる構成を物理機能ドライバが正常に検証した場合にのみ成功します。デフォルトでは、新しい仮想機能はどのドメインにも割り当てられていません。ルートドメインがリブートし、ハードウェアで仮想機能がインスタンス化されたあとでなければ、仮想機能を I/O ドメインに割り当てることはできません。前もって計画して、複数の仮想機能を作成するかどうかを決定します。その場合、複数回リブートを実行することを回避するために、続けて作成します。

デバイス固有のプロパティーは、物理機能ドライバによってエクスポートされるプロパティーによって異なります。詳細については、`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 アドレスと、システムで代替 MAC アドレスが生成されるようにリクエストするために 1 回以上使用できる `auto` キーワードです。`auto` キーワードと数値の MAC アドレスは混在できます。数値の MAC アドレスは、標準のオクテット記述法で指定する必要があります。たとえば、`80:00:33:55:22:66` とします。

  1 つ以上の代替 MAC アドレスを割り当てると、このデバイス上に 1 つ以上の仮想 NIC (VNIC) を作成できます。VNIC ごとに 1 つの代替 MAC アドレスが使用されるため、割り当てられた MAC アドレスの数によって、デバイス上に作成できる VNIC の数が決まります。代替 MAC アドレスが指定されていない場合は、このデバイス上に VNIC を作成しようとしても失敗します。詳細は、Oracle Solaris 11 ネットワークドキュメントおよび『Oracle VM Server for SPARC 3.0 管理ガイド』の第 8 章「仮想ネットワークの使用」を参照してください。

- `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 つ以上の実行中のドメインを停止します。

- 適切な Logical Domains エージェントが実行されている場合、`shutdown` リクエストをドメインに送信する

- Oracle Solaris OS がブートされている場合は、`uadmin` リクエストをドメインに送信する

デフォルトでは、このコマンドはまず `shutdown` を使用してドメインを停止しようと試みます。ただし、適切な Logical Domains エージェントが使用できない場合、このコマンドは `uadmin` を使用してドメインを停止します。`shutdown`(1M) および `uadmin`(1M) のマニュアルページを参照してください。

このデフォルト動作は、`ldmd/default_quick_stop` SMF プロパティーを設定することによって変更できます。`ldmd`(1M) のマニュアルページを参照してください。

    ldm stop-domain [[-f | -q] | [[-h | -r | -t sec] [-m msg]]] (-a | ldom...)

ここでは:

- `-a` は、制御ドメインを除く動作中のすべての論理ドメインを停止します。

- `-f` は、動作中の論理ドメインの停止を強制的に試行します。ドメインをその他の手段で停止できない場合にのみ使用してください。

- `-h` は `shutdown` コマンドのみを使用して、オペレーティングシステムを停止し、ドメインを停止します。このオプションは、`uadmin` コマンドの使用にフォールバックしません。

- `-m` msg には、停止またはリブートするドメインに送信するメッセージを指定します。

  msg 文字列に空白が含まれる場合、この文字列を引用符で囲む必要があります。

- `-q` は `uadmin` コマンドを発行することによって、指定されたドメインをすばやく停止します。

- `-r` は `shutdown` コマンドを使用して、オペレーティングシステムを停止してリブートします。

- `-t` sec は、ドメインの停止処理が終了するまで少なくとも sec 秒間待機してから、`-q` オプション付きでコマンドを再発行して、まだ実行中の指定されたドメインをすべて停止します。このコマンドは、ドメインの停止リクエストが時間内に完了しない場合にのみ再発行されます。sec は、`0` よりも大きい値にする必要があります。

  特定のドメインで停止リクエストが実行できない場合、該当するドメインに対するコマンドはすぐに `-q` オプションにフォールバックします。

- ldom は、停止する 1 つ以上の動作中の論理ドメインを指定します。

正常な Oracle Solaris の停止を、それをサポートする Logical Domains エージェントバージョンが実行されていないドメインで実行するには、該当するドメインで `shutdown` または `init` 操作を実行します。`init`(1M) のマニュアルページを参照してください。正常な停止をサポートする Logical Domains エージェントのバージョンをドメインが実行しているかどうかを判定するには、正常な停止のみを実行する `ldm stop -h` コマンドを実行します。

Oracle Solaris OS でのパニックの発生

次のサブコマンドは、指定した論理ドメイン上の 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 は、リソースのバインドを解除する論理ドメインを指定します。

### 構成の操作

論理ドメイン構成の追加

次のサブコマンドは、現在アクティブな構成または以前に自動保存された構成に基づいて、論理ドメイン構成を追加します。この構成は、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] [-S] [ldom...]

ここでは:

- `-e` は、自動的に設定されるサービスおよびデバイスを含む拡張リストを生成します。これは制御できません。

- `-l` は、長いリストを生成します。

- `-o` は、出力の format を、次に示すサブセットのうち 1 つ以上に制限します。複数の形式を指定する場合は、各形式をコンマで区切ります。スペースは入れません。

  - `console` - 出力には、仮想コンソール (`vcons`) および仮想コンソール端末集配信装置 (`vcc`) サービスが含まれます。

  - `core` – 出力には、コア、コア ID、および物理 CPU セットに関する情報が含まれます。

  - `cpu` – 出力には、CPU スレッド (`vcp` )、物理 CPU (`pcpu`)、およびコア ID (`cid`) に関する情報が含まれます。

  - `crypto` - 暗号化装置の出力には、モジュラー演算ユニット (Modular Arithmetic Unit、`mau`)、およびサポートされているその他の暗号化装置 (Control Word Queue、CWQ) などが含まれます。

  - `disk` - 出力には、仮想ディスク (`vdisk`) および仮想ディスクサーバー (`vds`) が含まれます。

  - `domain` – 出力には、変数 (`var`)、ホスト ID (`hostid`)、ドメインの状態、フラグ、汎用一意識別子 (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` は、解析可能でマシンが読み取り可能な形式でリストを生成します。

- `-S` は、CPU 関連およびメモリー関連のリソースに関するステータス情報を生成します。ステータスの値は、リソースが正常に動作していることを示す `ok` と、リソースに障害が発生していることを示す `fail` です。

  このステータスは、Fujitsu M10 システム上の CPU およびメモリーリソースに対してのみ決定されます。その他のすべてのプラットフォームでは、ステータスフィールドは、`-p` オプションが使用されているときに解析可能な出力で表示されるだけです。これらのプラットフォーム上のステータスは、常に `status=NA` と表示されます。

- ldom は、状態情報を表示する論理ドメインの名前です。

ドメインのバインドの一覧表示

次のサブコマンドは、論理ドメインのバインドのリストを表示します。論理ドメインを指定しない場合、すべての論理ドメインが表示されます。

ドメインの名前を指定した場合、制御ドメインの MAC アドレスのあとに、仮想ネットワークデバイスの代替 MAC アドレスが表示されます。次のコマンドは、`ldg1` ドメイン上の `vnet1` の代替 MAC アドレスを 3 つ表示します。

    # ldm ls-bindings ldg1
    ...
    NETWORK
    NAME  SERVICE              ID DEVICE    MAC               MODE PVID VID MTU LINKPROP
    vnet1 primary-vsw0@primary 0  network@0 00:14:4f:f8:0c:80      1        1500
                                            00:14:4f:fa:3a:f9
                                            00:14:4f:f9:06:ab
                                            00:14:4f:fb:3d:af

    PEER                 MAC               MODE PVID VID MTU LINKPROP
    primary-vsw0@primary 00:14:4f:fa:94:60      1        1500
    vnet2@ldg2           00:14:4f:f9:38:d1      1        1500
    vnet3@ldg3           00:14:4f:fa:60:27      1        1500
    vnet4@ldg4           00:14:4f:f8:0f:41      1        1500
    ...

次のコマンドは、`ldg1` ドメイン上の `vnet1` の代替 MAC アドレスを解析可能な出力で 3 つ表示します。

    # ldm ls-bindings -p ldg1
    ...
    VNET|name=vnet1|dev=network@0|service=primary-vsw0@primary|mac-addr=00:14:4f:f8:0c:80
      |mode=|pvid=1|vid=|mtu=1500|linkprop=|id=0
    |alt-mac-addr=00:14:4f:fa:3a:f9,00:14:4f:f9:06:ab,00:14:4f:fb:3d:af
    |peer=primary-vsw0@primary|mac-addr=00:14:4f:fa:94:60|mode=|pvid=1|vid=|mtu=1500
    |peer=vnet2@ldg2|mac-addr=00:14:4f:f9:38:d1|mode=|pvid=1|vid=|mtu=1500|linkprop=
    |peer=vnet3@ldg3|mac-addr=00:14:4f:fa:60:27|mode=|pvid=1|vid=|mtu=1500|linkprop=
    |peer=vnet4@ldg4|mac-addr=00:14:4f:f8:0f:41|mode=|pvid=1|vid=|mtu=1500|linkprop=
    ...

    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` は、解析可能でマシンが読み取り可能な形式で制約の出力を書き込みます。

Capacity on Demand 許可情報の一覧表示

このサブコマンドは、Fujitsu M10 システム上の CPU コアの Capacity on Demand 許可情報を一覧表示します。`PERMITS` 列には、発行された許可の合計数が表示されます。この合計には、すべての常時許可と使用ごと支払い許可が含まれます。常時許可を使用すると、顧客は特定のリソースを時間無制限に使用できます。使用ごと支払い許可を使用すると、顧客は特定のリソースを 1 時間使用できます。発行された常時許可の数は、`PERMANENT` 列に表示されます。`IN USE` 列には、使用中の発行済み許可の数が表示されます。`REST` 列には、使用可能な許可の数が表示されます。

    ldm ls-permits

デバイスの一覧表示

次のサブコマンドは、使用していない (バインドされていない) リソースまたはすべてのサーバーリソースのいずれかのリストを表示します。デフォルトでは、使用していないすべてのリソースを表示します。

    ldm ls-devices [-a] [-p] [-S] [core] [cpu] [crypto] [memory] [io]

ここでは:

- `-a` は、すべてのサーバーリソース (バインドされたリソースおよびバインドされていないリソース) を表示します。

- `-p` は、解析可能でマシンが読み取り可能な形式で制約の出力を書き込みます。

- `-S` は、CPU 関連およびメモリー関連のリソースに関するステータス情報を生成します。ステータスの値は、リソースが正常に動作していることを示す `ok` と、リソースに障害が発生していることを示す `fail` です。

  このステータスは、Fujitsu M10 システム上の CPU およびメモリーリソースに対してのみ決定されます。その他のすべてのプラットフォームでは、ステータスフィールドは、`-p` オプションが使用されているときに解析可能な出力で表示されるだけです。これらのプラットフォーム上のステータスは、常に `status=NA` と表示されます。

- `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` 列は、差し込み式カードを受け入れるスロットおよびマザーボード上のデバイスに適用され、次のいずれかの値を指定できます。

  - `UNK` – スロットのデバイスはファームウェアによって検出されましたが、OS では検出されませんでした。

  - `OCC` – デバイスはマザーボード上で検出されたか、またはスロットの PCIe カードです。

  - `IOV` – バスは IOV リソースを共有するために初期化されました。

  - `INV` – スロット、仮想機能、または物理機能は無効な状態であり、使用できません。

  - `EMP` – スロットは空です。

  システムボード上のデバイスを示すスロットのステータスは常に、`OCC` になります。ルートドメインがダイレクト I/O をサポートしない場合、スロットのステータスは `UNK` になります。

    ldm list-io [-l] [-p] [bus | device | pf-name]
    ldm list-io -d pf-name

ここでは:

- `-l` は、ダイレクト I/O 割り当て可能デバイスによりホストされるサブデバイスに関する情報を表示します。この出力は、ダイレクト I/O 割り当て可能デバイスによって受信ドメインに貸し出されるデバイスを示します。サブデバイス名は、コマンド入力のために使用することはできません。

- `-p` は、解析可能でマシンが読み取り可能な形式で出力を書き込みます。

- `-d` pf-name には、指定された物理機能に関する情報が一覧表示されます。

- bus、device、および pf-name は、それぞれ PCIe バス、ダイレクト I/O 割り当て可能デバイス、および PCIe SR-IOV 物理機能です。

論理ドメイン構成の一覧表示

このサブコマンドは、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 動的再構成をサポートするアクティブなドメインでリソース管理ポリシーを有効にできます。

    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 は、リソース管理ポリシーを削除する論理ドメインを指定します。

### 復旧モード操作の開始、取り消し、または一覧表示

サポートされるシステムでは、最後に選択された電源投入構成に必要であったリソースが使用できない場合は常に、SP は復旧モードでシステムの電源を投入します。Logical Domains Manager が使用可能なリソースに基づいて、以前に選択された電源投入構成と一致するように Logical Domains 構成を再作成できる場合があります。

復旧モードのサブコマンドを使用すると、復旧モード操作の開始、取り消し、または一覧表示を行うことができます。`ldm start-recovery` および `ldm cancel-recovery` コマンドは、復旧モードが有効になっているときにのみ発行できます。復旧モードが有効になっているときは、復旧関連のサブコマンドおよびリスト関連のサブコマンドを発行できます。その他のサブコマンドはすべて拒否されます。

手動による復旧操作の開始

システムが復旧モードになっているときに、最後に選択された電源投入構成の復旧を手動で開始します。このコマンドは、復旧モードのときにのみ使用できます。

    ldm start-recovery

復旧操作の取り消し

システムが復旧モードになっているときに、最後に選択された電源投入構成の復旧を取り消します。このコマンドは、復旧モードが有効になっているときにのみ使用できます。

`ldm cancel-recovery` コマンドを使用して、復旧モードを終了できます。この時点で、システムは工場出荷時のデフォルト構成に戻り、すべてのリソースが制御ドメインに割り当てられます。この時点では、すべての `ldm` サブコマンドが許可されます。再度システムを復旧モードにするには、`ldm cancel-recovery` コマンドを実行したあとに、システムの電源を再投入する必要があります。

    ldm cancel-recovery

復旧モードのステータスの表示

復旧モードのステータスを表示します。出力には、復旧モードになっているかどうか、または復旧モード操作が完了したかどうかが表示されます。出力には、見つからないリソースも一覧表示されます。このコマンドはいつでも発行できます。

    ldm list-recovery

### XML ファイルからのドメインの構成または再構成

次のサブコマンドでは、既存の構成を使用して、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`) のみを復元します。

### ハイパーバイザダンプデータの収集

ハイパーバイザの強制的な中止イベントが発生すると、ハイパーバイザメモリーの内容がファームウェアによって保持され、システムは工場出荷時のデフォルト構成でリブートされます。`ldmd` デーモンは、保持されたハイパーバイザメモリーの内容を、制御ドメイン上の `/var/opt/SUNWldm/hvdump.N.gz` というファイルにコピーします。N は、`0`-`7` の範囲内の数値です。このファイルは、ハイパーバイザの強制的な中止が発生した時点のハイパーバイザメモリーの内容のバイナリダンプです。

次のサブコマンドは、Fujitsu M10 システム上のハイパーバイザダンプからデータを収集するプロセスに適用されます。

ハイパーバイザダンプデータの一覧表示

このサブコマンドは、Fujitsu M10 システム上で使用可能なハイパーバイザデータ収集プロセスを制御する `hvdump` および `hvdump-reboot` プロパティーの値を表示します。

    ldm list-hvdump

ハイパーバイザデータ収集プロセスのプロパティー値の設定

このサブコマンドは、Fujitsu M10 ハイパーバイザデータ収集のプロパティーを変更します。自動ハイパーバイザデータ収集プロセスを有効または無効にするプロパティーを設定できます。データの収集後に元の構成を復元するための自動リブートを有効または無効にするプロパティーを設定することもできます。

    ldm set-hvdump [hvdump=on|off] [hvdump-reboot=on|off]

ここでは:

- `hvdump=on|off` は、ハイパーバイザデータ収集プロセスを有効または無効にします。デフォルト値は `on` です。

- `hvdump-reboot=on|off` は、ハイパーバイザデータ収集プロセスが完了したあとの自動システムリブートを有効または無効にします。デフォルト値は `off` です。

手動によるハイパーバイザデータ収集プロセスの起動

このサブコマンドは、自動収集に失敗した場合に、Fujitsu M10 ハイパーバイザデータ収集プロセスを手動で起動します。

    ldm start-hvdump

## 使用例

例 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-vcpu 8 primary
    # ldm set-mem 8G 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  NORM UPTIME
    primary  active     -n-cv-  UART    8     16G      0.2%  0.2% 1d 18h 5m

    UUID
        d8d2db22-21b9-e5e6-d635-92036c711e65

    MAC
        00:21:28:c1:3f:3c

    HOSTID
        0x8

    CONTROL
        failure-policy=ignore
        extended-mapin-space=off
        cpu-arch=native
        rc-add-policy=

    DEPENDENCY
        master=

    CORE
        CID    CPUSET
        0      (0, 1, 2, 3, 4, 5, 6, 7)

    VCPU
        VID    PID    CID    UTIL NORM STRAND
        0      0      0      0.4% 0.4%   100%
        1      1      0      0.2% 0.2%   100%
        2      2      0      0.1% 0.1%   100%
        3      3      0      0.1% 0.1%   100%
        4      4      0      0.2% 0.2%   100%
        5      5      0      0.5% 0.5%   100%
        6      6      0      0.2% 0.2%   100%
        7      7      0      1.2% 1.2%   100%

    MEMORY
        RA               PA               SIZE
        0x20000000       0x20000000       8G
        0x400000000      0x400000000      8G

    CONSTRAINT
        threading=max-throughput

    VARIABLES
        pm_boot_policy=disabled=1;ttfc=0;ttmr=0;

    IO
        DEVICE                           PSEUDONYM        OPTIONS
        pci@400                          pci_0
        niu@480                          niu_0
        pci@400/pci@1/pci@0/pci@8        /SYS/MB/RISER0/PCIE0
        pci@400/pci@2/pci@0/pci@8        /SYS/MB/RISER1/PCIE1
        pci@400/pci@1/pci@0/pci@6        /SYS/MB/RISER2/PCIE2
        pci@400/pci@2/pci@0/pci@c        /SYS/MB/RISER0/PCIE3
        pci@400/pci@1/pci@0/pci@0        /SYS/MB/RISER1/PCIE4
        pci@400/pci@2/pci@0/pci@a        /SYS/MB/RISER2/PCIE5
        pci@400/pci@1/pci@0/pci@4        /SYS/MB/SASHBA0
        pci@400/pci@2/pci@0/pci@4        /SYS/MB/SASHBA1
        pci@400/pci@2/pci@0/pci@6        /SYS/MB/NET0
        pci@400/pci@2/pci@0/pci@7        /SYS/MB/NET2

    VCC
        NAME             PORT-RANGE
        primary-vcc0     5000-5100

    VSW
        NAME             MAC               NET-DEV   ID   DEVICE   LINKPROP
        primary-vsw0     00:14:4f:fa:0b:57 net0      0    switch@0

        DEFAULT-VLAN-ID PVID VID                  MTU   MODE INTER-VNET-LINK
        1               1                         1500       on

    VDS
        NAME             VOLUME         OPTIONS          MPGROUP        DEVICE
        primary-vds0

    VCONS
        NAME             SERVICE                     PORT   LOGGING
        UART

例 5 論理ドメインの作成

必要とするゲストドメイン構成を作成するためのリソースの存在の確認、ゲストドメインの追加、ドメインに必要なリソースおよびデバイスの追加、起動時の動作をシステムに指示する起動パラメータの設定、ドメインへのリソースのバインド、バックアップ用の XML ファイルへのゲストドメインの構成の保存を実行します。また、primary ドメインおよびゲストドメインの構成を SC に保存する場合があります。その後、ドメインを起動し、ドメインの TCP ポートを検出し、デフォルトの仮想コンソールサービスを介してその TCP ポートに接続することができます。

    # ldm ls-devices
    # ldm add-dom ldg1
    # ldm add-vcpu 8 ldg1
    # ldm add-mem 8g 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_8cpu_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 デバイスを一覧表示します。

    # ldm ls-io
    NAME                                      TYPE   BUS      DOMAIN   STATUS
    ----                                      ----   ---      ------   ------
    pci_0                                     BUS    pci_0    primary
    pci_1                                     BUS    pci_1    primary
    pci_2                                     BUS    pci_2    primary
    pci_3                                     BUS    pci_3    primary
    pci_8                                     BUS    pci_8    primary
    pci_9                                     BUS    pci_9    primary
    pci_10                                    BUS    pci_10   primary
    pci_11                                    BUS    pci_11   primary
    pci_4                                     BUS    pci_4    primary
    pci_5                                     BUS    pci_5    primary
    pci_6                                     BUS    pci_6    primary
    pci_7                                     BUS    pci_7    primary
    pci_12                                    BUS    pci_12   primary
    pci_13                                    BUS    pci_13   primary
    pci_14                                    BUS    pci_14   primary
    pci_15                                    BUS    pci_15   primary
    pci_16                                    BUS    pci_16   primary  IOV
    pci_17                                    BUS    pci_17   primary
    pci_18                                    BUS    pci_18   primary
    pci_19                                    BUS    pci_19   primary
    pci_24                                    BUS    pci_24   primary
    pci_25                                    BUS    pci_25   primary
    pci_26                                    BUS    pci_26   primary
    pci_27                                    BUS    pci_27   primary
    pci_20                                    BUS    pci_20   primary  IOV
    pci_21                                    BUS    pci_21   primary
    pci_22                                    BUS    pci_22   primary
    pci_23                                    BUS    pci_23   primary
    pci_28                                    BUS    pci_28   primary
    pci_29                                    BUS    pci_29   primary
    pci_30                                    BUS    pci_30   primary
    pci_31                                    BUS    pci_31   primary
    /SYS/IOU0/PCIE3                           PCIE   pci_0    primary  OCC
    /SYS/IOU0/EMS1/CARD/NET0                  PCIE   pci_0    primary  OCC
    /SYS/IOU0/EMS1/CARD/SCSI                  PCIE   pci_0    primary  OCC
    /SYS/IOU0/PCIE2                           PCIE   pci_1    primary  OCC
    /SYS/IOU0/PCIE5                           PCIE   pci_2    primary  EMP
    /SYS/IOU0/PCIE8                           PCIE   pci_3    primary  OCC
    /SYS/IOU0/PCIE6                           PCIE   pci_8    primary  OCC
    /SYS/IOU0/EMS2/CARD/NET0                  PCIE   pci_8    primary  OCC
    /SYS/IOU0/EMS2/CARD/SCSI                  PCIE   pci_8    primary  OCC
    /SYS/IOU0/PCIE7                           PCIE   pci_9    primary  OCC
    /SYS/IOU0/PCIE4                           PCIE   pci_10   primary  OCC
    /SYS/IOU0/PCIE1                           PCIE   pci_11   primary  OCC
    /SYS/IOU0/PCIE11                          PCIE   pci_4    primary  OCC
    /SYS/IOU0/EMS3/CARD/NET0                  PCIE   pci_4    primary  OCC
    /SYS/IOU0/EMS3/CARD/SCSI                  PCIE   pci_4    primary  OCC
    /SYS/IOU0/PCIE10                          PCIE   pci_5    primary  OCC
    /SYS/IOU0/PCIE13                          PCIE   pci_6    primary  OCC
    /SYS/IOU0/PCIE16                          PCIE   pci_7    primary  OCC
    /SYS/IOU0/PCIE14                          PCIE   pci_12   primary  OCC
    /SYS/IOU0/EMS4/CARD/NET0                  PCIE   pci_12   primary  OCC
    /SYS/IOU0/EMS4/CARD/SCSI                  PCIE   pci_12   primary  OCC
    /SYS/IOU0/PCIE15                          PCIE   pci_13   primary  OCC
    /SYS/IOU0/PCIE12                          PCIE   pci_14   primary  OCC
    /SYS/IOU0/PCIE9                           PCIE   pci_15   primary  OCC
    /SYS/IOU1/PCIE3                           PCIE   pci_16   primary  OCC
    /SYS/IOU1/EMS1/CARD/NET0                  PCIE   pci_16   primary  OCC
    /SYS/IOU1/EMS1/CARD/SCSI                  PCIE   pci_16   primary  OCC
    /SYS/IOU1/PCIE2                           PCIE   pci_17   primary  EMP
    /SYS/IOU1/PCIE5                           PCIE   pci_18   primary  OCC
    /SYS/IOU1/PCIE8                           PCIE   pci_19   primary  EMP
    /SYS/IOU1/PCIE6                           PCIE   pci_24   primary  UNK
    /SYS/IOU1/EMS2/CARD/NET0                  PCIE   pci_24   primary  OCC
    /SYS/IOU1/EMS2/CARD/SCSI                  PCIE   pci_24   primary  OCC
    /SYS/IOU1/PCIE7                           PCIE   pci_25   primary  EMP
    /SYS/IOU1/PCIE4                           PCIE   pci_26   primary  EMP
    /SYS/IOU1/PCIE1                           PCIE   pci_27   primary  EMP
    /SYS/IOU1/PCIE11                          PCIE   pci_20   primary  OCC
    /SYS/IOU1/EMS3/CARD/NET0                  PCIE   pci_20   primary  OCC
    /SYS/IOU1/EMS3/CARD/SCSI                  PCIE   pci_20   primary  OCC
    /SYS/IOU1/PCIE10                          PCIE   pci_21   primary  EMP
    /SYS/IOU1/PCIE13                          PCIE   pci_22   primary  EMP
    /SYS/IOU1/PCIE16                          PCIE   pci_23   primary  EMP
    /SYS/IOU1/PCIE14                          PCIE   pci_28   primary  EMP
    /SYS/IOU1/EMS4/CARD/NET0                  PCIE   pci_28   primary  OCC
    /SYS/IOU1/EMS4/CARD/SCSI                  PCIE   pci_28   primary  OCC
    /SYS/IOU1/PCIE15                          PCIE   pci_29   primary  EMP
    /SYS/IOU1/PCIE12                          PCIE   pci_30   primary  EMP
    /SYS/IOU1/PCIE9                           PCIE   pci_31   primary  EMP
    /SYS/IOU0/PCIE3/IOVNET.PF0                PF     pci_0    primary
    /SYS/IOU0/PCIE3/IOVNET.PF1                PF     pci_0    primary
    /SYS/IOU0/PCIE3/IOVNET.PF2                PF     pci_0    primary
    /SYS/IOU0/PCIE3/IOVNET.PF3                PF     pci_0    primary
    /SYS/IOU0/EMS1/CARD/NET0/IOVNET.PF0       PF     pci_0    primary
    /SYS/IOU0/EMS1/CARD/NET0/IOVNET.PF1       PF     pci_0    primary
    /SYS/IOU0/PCIE2/IOVNET.PF0                PF     pci_1    primary
    /SYS/IOU0/PCIE2/IOVNET.PF1                PF     pci_1    primary
    /SYS/IOU0/PCIE2/IOVNET.PF2                PF     pci_1    primary
    /SYS/IOU0/PCIE2/IOVNET.PF3                PF     pci_1    primary
    /SYS/IOU0/PCIE8/IOVNET.PF0                PF     pci_3    primary
    /SYS/IOU0/PCIE8/IOVNET.PF1                PF     pci_3    primary
    /SYS/IOU0/PCIE8/IOVNET.PF2                PF     pci_3    primary
    /SYS/IOU0/PCIE8/IOVNET.PF3                PF     pci_3    primary
    /SYS/IOU0/PCIE6/IOVNET.PF0                PF     pci_8    primary
    /SYS/IOU0/PCIE6/IOVNET.PF1                PF     pci_8    primary
    /SYS/IOU0/PCIE6/IOVNET.PF2                PF     pci_8    primary
    /SYS/IOU0/PCIE6/IOVNET.PF3                PF     pci_8    primary
    /SYS/IOU0/EMS2/CARD/NET0/IOVNET.PF0       PF     pci_8    primary
    /SYS/IOU0/EMS2/CARD/NET0/IOVNET.PF1       PF     pci_8    primary
    /SYS/IOU0/PCIE7/IOVNET.PF0                PF     pci_9    primary
    /SYS/IOU0/PCIE7/IOVNET.PF1                PF     pci_9    primary
    /SYS/IOU0/PCIE7/IOVNET.PF2                PF     pci_9    primary
    /SYS/IOU0/PCIE7/IOVNET.PF3                PF     pci_9    primary
    /SYS/IOU0/PCIE4/IOVNET.PF0                PF     pci_10   primary
    /SYS/IOU0/PCIE4/IOVNET.PF1                PF     pci_10   primary
    /SYS/IOU0/PCIE4/IOVNET.PF2                PF     pci_10   primary
    /SYS/IOU0/PCIE4/IOVNET.PF3                PF     pci_10   primary
    /SYS/IOU0/PCIE1/IOVNET.PF0                PF     pci_11   primary
    /SYS/IOU0/PCIE1/IOVNET.PF1                PF     pci_11   primary
    /SYS/IOU0/PCIE1/IOVNET.PF2                PF     pci_11   primary
    /SYS/IOU0/PCIE1/IOVNET.PF3                PF     pci_11   primary
    /SYS/IOU0/PCIE11/IOVNET.PF0               PF     pci_4    primary
    /SYS/IOU0/PCIE11/IOVNET.PF1               PF     pci_4    primary
    /SYS/IOU0/PCIE11/IOVNET.PF2               PF     pci_4    primary
    /SYS/IOU0/PCIE11/IOVNET.PF3               PF     pci_4    primary
    /SYS/IOU0/EMS3/CARD/NET0/IOVNET.PF0       PF     pci_4    primary
    /SYS/IOU0/EMS3/CARD/NET0/IOVNET.PF1       PF     pci_4    primary
    /SYS/IOU0/PCIE10/IOVNET.PF0               PF     pci_5    primary
    /SYS/IOU0/PCIE10/IOVNET.PF1               PF     pci_5    primary
    /SYS/IOU0/PCIE10/IOVNET.PF2               PF     pci_5    primary
    /SYS/IOU0/PCIE10/IOVNET.PF3               PF     pci_5    primary
    /SYS/IOU0/PCIE13/IOVNET.PF0               PF     pci_6    primary
    /SYS/IOU0/PCIE13/IOVNET.PF1               PF     pci_6    primary
    /SYS/IOU0/PCIE13/IOVNET.PF2               PF     pci_6    primary
    /SYS/IOU0/PCIE13/IOVNET.PF3               PF     pci_6    primary
    /SYS/IOU0/PCIE16/IOVNET.PF0               PF     pci_7    primary
    /SYS/IOU0/PCIE16/IOVNET.PF1               PF     pci_7    primary
    /SYS/IOU0/PCIE16/IOVNET.PF2               PF     pci_7    primary
    /SYS/IOU0/PCIE16/IOVNET.PF3               PF     pci_7    primary
    /SYS/IOU0/PCIE14/IOVNET.PF0               PF     pci_12   primary
    /SYS/IOU0/PCIE14/IOVNET.PF1               PF     pci_12   primary
    /SYS/IOU0/PCIE14/IOVNET.PF2               PF     pci_12   primary
    /SYS/IOU0/PCIE14/IOVNET.PF3               PF     pci_12   primary
    /SYS/IOU0/EMS4/CARD/NET0/IOVNET.PF0       PF     pci_12   primary
    /SYS/IOU0/EMS4/CARD/NET0/IOVNET.PF1       PF     pci_12   primary
    /SYS/IOU0/PCIE15/IOVNET.PF0               PF     pci_13   primary
    /SYS/IOU0/PCIE15/IOVNET.PF1               PF     pci_13   primary
    /SYS/IOU0/PCIE15/IOVNET.PF2               PF     pci_13   primary
    /SYS/IOU0/PCIE15/IOVNET.PF3               PF     pci_13   primary
    /SYS/IOU0/PCIE12/IOVNET.PF0               PF     pci_14   primary
    /SYS/IOU0/PCIE12/IOVNET.PF1               PF     pci_14   primary
    /SYS/IOU0/PCIE12/IOVNET.PF2               PF     pci_14   primary
    /SYS/IOU0/PCIE12/IOVNET.PF3               PF     pci_14   primary
    /SYS/IOU0/PCIE9/IOVNET.PF0                PF     pci_15   primary
    /SYS/IOU0/PCIE9/IOVNET.PF1                PF     pci_15   primary
    /SYS/IOU0/PCIE9/IOVNET.PF2                PF     pci_15   primary
    /SYS/IOU0/PCIE9/IOVNET.PF3                PF     pci_15   primary
    /SYS/IOU1/EMS1/CARD/NET0/IOVNET.PF0       PF     pci_16   primary
    /SYS/IOU1/EMS1/CARD/NET0/IOVNET.PF1       PF     pci_16   primary
    /SYS/IOU1/EMS2/CARD/NET0/IOVNET.PF0       PF     pci_24   primary
    /SYS/IOU1/EMS2/CARD/NET0/IOVNET.PF1       PF     pci_24   primary
    /SYS/IOU1/EMS3/CARD/NET0/IOVNET.PF0       PF     pci_20   primary
    /SYS/IOU1/EMS3/CARD/NET0/IOVNET.PF1       PF     pci_20   primary
    /SYS/IOU1/EMS4/CARD/NET0/IOVNET.PF0       PF     pci_28   primary
    /SYS/IOU1/EMS4/CARD/NET0/IOVNET.PF1       PF     pci_28   primary

例 13 Capacity on Demand 許可情報の一覧表示

次の例では、Fujitsu M10 システム上の CPU コアの Capacity on Demand 許可に関する情報を示します。`PERMITS` 列は、10 個の許可が発行されたことを示しています。この合計には、すべての常時許可と使用ごと支払い許可が含まれます。`PERMANENT` 列は、常時許可が 10 個あり、使用ごと支払い許可は発行されていないことを示しています。

`IN USE` 列は、そのうち 2 個の許可だけが現在使用中であることを示しています。`REST` 列は、8 個の許可が使用可能であることを示しています。

    # ldm ls-permits
    CPU CORE
    PERMITS (PERMANENT)   IN USE      REST
    10      (10)          2           8

## 終了ステータス

次の終了値が返されます。

0

  正常に完了しました。

>0

  エラーが発生しました。

## 属性

次の属性の説明については、`attributes`(5) マニュアルページを参照してください。

属性型 | 属性値
--- | ---
使用条件 | `SUNWldm`
インタフェースの安定性 | 未確定

## 関連項目

`dumpadm`(1M)、`ifconfig`(1M)、`shutdown`(1M)、`vntsd`(1M)、`attributes`(5)

『Oracle VM Server for SPARC 3.0 管理ガイド 』

Copyright © 2007, 2013, Oracle and/or its affiliates. All rights reserved. 著作権について |