A コマンドライン・ツール

この付録では、Oracle VM ServerおよびOracle VM Agentのコマンドライン・ツールについて説明します。 この付録で説明するコマンドライン・ツールは、次のとおりです。

• ovs-agent

• virt-install

• xm

• P2V

---

ovs-agent

ovs-agentコマンドライン・ツールを使用して、Oracle VM Agentを構成および管理できます。 ovs-agentコマンドライン・ツールのパラメータを次の形式で入力します。

service ovs-agent {option}

ゲストが実行されているHA対応のOracle VM Server上のOracle VM Agentを停止または再起動する場合は、次の操作を実行するように要求されます。

• Oracle VM Managerを使用したゲストの移行または電源オフ。 ゲストが移行または電源オフされると、Oracle VM Agentは停止します。

• ゲストおよびOracle VM Agentの停止。

• 停止操作の取消し。

ovs-agentコマンドライン・ツールの使用例については、第3章「Oracle VM Agent」を参照してください。

オプション

start

Oracle VM Agentを起動します。

# service ovs-agent start

stop

Oracle VM Agentを停止します。

# service ovs-agent stop

restart

Oracle VM Agentを停止して再起動します。

# service ovs-agent restart

status

Oracle VM Agentデーモンのステータスの情報を表示します。

# service ovs-agent status

configure

Oracle VM Agentインタラクティブ構成スクリプトを起動します。

# service ovs-agent configure

---

virt-install

virt-installコマンドライン・ツールを使用すると、準仮想化ゲストまたはハードウェア仮想化ゲストを作成できます。virt-installは、インタラクティブ・シェルとして使用することも、コマンドラインからすべてのパラメータを一度に設定することもできます。 virt-installコマンドライン・ツールの複数のパラメータを次の形式で入力します。

virt-install [option ...]

この項では、一般的なvirt-installオプションについて簡潔に説明します。 詳細な説明を参照するには、virt-install -hコマンドを使用してください。

virt-installツールの使用方法については、第4章「ゲスト仮想マシンの作成」を参照してください。

オプション

[-h | --help]

virt-installコマンド・パラメータとその目的を表示します。

# virt-install -h

[-nname | --name=name]

ゲスト・インスタンスの名前を設定します。

# virt-install -nMyGuest

[-rRAM | --ram=RAM]

ゲスト・インスタンスに割り当てるメモリーをメガバイト単位で設定します。

# virt-install --ram=256

[-uUUID | --uuid=UUID]

ゲストのUUIDを設定します。 何も指定しない場合、任意のUUIDが生成されます。

# virt-install -u

[--vcpus=number]

ゲストを構成するための仮想CPUの数を設定します。

# virt-install --vcpus=2

[-fdiskfile | --file=diskfile]

ディスク・イメージとして使用するファイルを設定します。

# virt-install --file=/home/myhome/myimage

[-sfilesize | --file-size=filesize]

ディスク・イメージ（存在しない場合）のサイズをギガバイト単位で設定します。

# virt-install -s2

[-nonsparse]

ディスクにスパース・ファイルを使用しません。 ゲストを作成する際、このオプションによって処理が大幅に遅くなる可能性があります。

[-mvalue | --mac=value]

ゲストの固定MACアドレスを設定します。何も指定しない場合またはRANDOMを指定した場合、任意のアドレスが使用されます。

# virt-install --mac=RANDOM

[-bvalue | --bridge=value]

ゲストのNICを接続するブリッジを設定します。 何も指定しない場合、デフォルトを設定します。

[--vnc]

グラフィックス・サポートにVNC（仮想ネットワーク・コンピューティング）を使用します。

# virt-install --vnc

[--vncport=port]

VNC接続に使用するポートを設定します。

# virt-install --vncport=5900

[--sdl]

グラフィックス・サポートにSDL（シンプル・ダイレクトメディア・レイヤー）を使用します。

# virt-install --sdl

[--nographics]

ゲストにグラフィカル・コンソールを使用しません。

# virt-install --nographics

[--noautoconsole]

ゲスト・コンソールに自動的に接続しません。

# virt-install --noautoconsole

[-kvalue | --keymap=value]

グラフィカル・コンソールのキーボード・マッピングを設定します。 何も指定しない場合、キーマップがローカル・キーマップに自動的に設定されます。

# virt-install --de

[--accelerate]

カーネル加速化機能を使用します。

# virt-install --accelerate

[--connect=URI]

URIでハイパーバイザに接続します。

# virt-install --connect=test:///default

[-v | --hvm]

完全に仮想化されたゲストとしてゲストを設定します。

# virt-install -v

[-cCD-ROM | --CD-ROM=CD-ROM]

完全に仮想化されたゲストの仮想CD-ROMデバイスを使用するために、ファイルを設定します。

[--os-type=type]

完全な仮想化ゲストのオペレーティング・システム・タイプを設定します。 設定可能な値は、windows、unix、otherおよびlinuxです。

# virt-install --os-type=windows

[--os-variant=variant]

完全な仮想化ゲストのオペレーティング・システム・バリアントを設定します（rhel5、win2k、vistaなど）。 このパラメータは、os-typeパラメータと組み合せて使用します。

次の表は、各os-typeオプションのos-variantに設定可能な値を示しています。

os-type=windowsに設定可能な値	os-type=unixに設定可能な値	os-type=otherに設定可能な値	os-type=linuxに設定可能な値
win2k3	solaris9	netware6	generic24
win2k	solaris10	generic	generic26
vista	freebsd6	netware4	rhel2.1
winxp	openbsd4	msdos	fedora7_64
		netware5	el5_64
			fedora6
			fedora7
			fedora5
			centos5_64
			generic26_64
			centos5
			sles10
			sles10_64
			el4_64
			rhel4
			rhel5
			rhel4_64
			rhel3
			fedora6_64
			rhel5_64
			fedora5_64
			el4
			el5

注意: すべてのオペレーティング・システム・バリアントがOracle製品用にオラクルでサポートされているわけではありませんが、便宜上使用できます。

# virt-install --os-type=windows --os-variant=winxp

[--noapic]

完全に仮想化されたゲストのAPIC（高度なプログラム可能割込みコントローラ）を無効にします。 --os-typeおよび--os-variantで設定された値を優先します。

[--arch=arch]

シミュレートするCPUアーキテクチャを設定します。

# virt-install --arch=x86

[-p | --paravirt]

準仮想化ゲストとしてゲストを設定します。

[-llocation | --location=location]

準仮想化ゲストのインストール・ソースを設定します（nfs:host:/path、http://host/path、ftp://host/pathなど）。

# virt-install -lhttp://example.com/path

[--vif-type=type]

ハードウェア仮想化ゲストの仮想ネットワーク・インタフェース・タイプを設定します。 netfrontドライバは、準仮想化ゲストまたは適切な準仮想化ドライバをインストールしたハードウェア仮想化ゲストと組み合せて使用できる準仮想化ドライバです。 ハードウェア仮想化ドライバのioemuドライバは、ハードウェア仮想化ゲストとだけ組み合せて使用できます。 両方のドライバには、ハードウェア仮想化ゲストをサポートするデバイス・エミュレーション・コードが含まれます。

ハードウェア仮想化ゲストの場合、ioemuまたはnetfrontをtypeに設定できます。 デフォルトはioemuです。

準仮想化ゲストには、このパラメータを使用できません。 準仮想化ゲストの場合、デフォルトはnetfrontであり変更できません。

# virt-install --vif-type=ioemu

[[-xargs | --extra-args=args] ...]

準仮想化ゲストのインストーラに渡される追加の引数です。

[-d | --debug]

デバッグ情報を出力します。

---

xm

Oracle VM Server管理のコマンドライン管理ツールであるxmは、ゲストを作成、破棄、管理および移行します。

この項では、一般的なxmコマンドについて簡潔に説明します。 完全な説明は、xm help --longコマンドを使用してください。

xmコマンドライン・ツールは、xendデーモンを起動する必要があります。

xmコマンドライン・ツールのパラメータを次の形式で入力します。

xm [option] [argument]

xmコマンドライン・ツールの使用例については、第5章「ドメインの監視および管理」を参照してください。

オプション

block-attach {domain-id} {be-dev} {fe-dev} {mode} [bedomain-id]

新しい仮想ブロック・デバイスを作成します。 これによって、ゲストのホットプラグ・イベントがトリガーされます。

domain-idパラメータは、ドメイン識別子です。

be-devパラメータは、エクスポートされるバックエンド・ドメイン（通常はdom0）内のデバイスです。 物理パーティション（phy:sda7）として指定するか、またはループバックとしてマウントされたファイル（file://path/to/loop.iso）として指定できます。

fe-devパラメータは、ゲスト・ドメインに対してのデバイスの表示方法を指定します。 シンボリック名（一般的なデバイスの場合は/dev/hdcなど）として指定するか、またはデバイス識別子（16進数の/dev/hdcデバイス識別子である0x1400など）で指定できます。

modeパラメータは、ゲスト・ドメインからのデバイスのアクセス・モードを設定します。 サポートされているモードは、w（読取り/書込み）またはr（読取り専用）です。

bedomain-idパラメータは、デバイスをホストしているバックエンド・ドメインです。 デフォルトはdom0です。

たとえば、ISOをディスクとしてマウントするには、次のように指定します。

# xm block-attach 02 file://path/to/dsl-2.0RC2.iso /dev/hdc ro

これによって、ISOがゲスト・ドメインの/dev/hdc（読取り専用デバイス）としてマウントされます。 これは、ゲストによってCD-ROMとして検出されない場合がありますが、/dev/hdcをマウントすると、ISOにアクセスできるようになります。

block-detach {domain-id} {device-id} [--force]

ドメインから仮想ブロック・デバイスを接続解除します。

device-idパラメータは、dom0によってデバイスに指定されたデバイス識別子（数値）またはシンボリック名にすることができます。 デバイス識別子を判別するには、xm block-listコマンドを実行します。デバイスの接続解除には、ドメインの協力が必要となります。 ドメインが（ドメインがハングしているか、またはデバイスをまだ使用しているなどの理由で）デバイスの解放に失敗すると、接続解除は失敗します。 --forceパラメータはデバイスを強制的に接続解除しますが、これによってドメインでIOエラーが発生する場合があります。

# xm block-detach 02 51776

block-list {domain-id} [-l | --long]

ドメインの仮想ブロック・デバイスを表示します。

# xm block-list 02 --long

console {domain-id}

ドメインのコンソールに接続します。

# xm console 02

create [-c] {config-file [name=value ...]}

config-fileのエントリに基づいてドメインを作成します。

-cパラメータを入力すると、ドメインを作成および起動する際にドメインのコンソールに接続されます。 name=valueパラメータを使用して、config-fileの変数に優先する名前と値のペアを入力することもできます。

# xm -c /home/myhome/myconfig

destroy {domain-id}

ドメインをただちに終了します。

# xm destroy 02

dmesg [--clear]

Linuxカーネルのdmesgコマンドのログと形式が似ているメッセージ・バッファ・ログを表示します。

--clearパラメータは、メッセージ・バッファをクリアします。

help [--long] [option]

xmコマンドのヘルプとそのオプションを表示します。

--longオプションは、機能ごとに分類されたxmコマンドの完全なヘルプを表示します。

xmコマンドのオプションとしてコマンド名を入力して、そのコマンドのヘルプだけを取得します。

# xm help --long create

info

ホスト・コンピュータの情報を表示します。

# xm info

list [--long | --label] [domain-id, ...]

実行中のすべてのドメインの情報を表示します。

--longオプションは、実行中のドメインの情報をすべて表示します。

xmコマンドのオプションとしてdomain-idを入力して、そのドメインだけまたは一連のドメインの情報を取得します。

# xm list --long 02

log

Linuxカーネルのログに形式が似ているログを表示します。 ログ・ファイルは、/var/log/xend.logにあります。

# xm log

mem-max {domain-id} {MBs}

ドメインで使用可能な最大メモリーをMB単位で割り当てます。 構成ファイルのmaxmen設定より優先されます。

# xm mem-max 02 2048

mem-set {domain-id} {MBs}

ドメインに、ゲスト構成ファイルのmaxmen設定またはmem-max {domain-id} {MBs}設定の値以下のメモリーを割り当てます。 ゲスト構成ファイルのmemory設定より優先されます。

# xm mem-set 02 1024

migrate {domain-id} {host} [-l | --live] [-r=MB | --resource=MB]

別のコンピュータにドメインを移行します。

domain-idパラメータは、移行するドメインです。

hostパラメータは、ターゲット・コンピュータです。

--liveパラメータは、ドメインを停止せずに移行します。

--resourceパラメータは、使用する最大量のメガバイトを設定します。

# xm migrate 02 example.com --live

new [config-file] [option ...] [name-=value ...]

ドメインをOracle VM Serverドメイン管理に追加します。

多くのコマンドライン・オプション、Pythonスクリプト（--defconfigパラメータを使用）、またはSXP構成ファイル（--configパラメータ）を使用して、ドメイン作成パラメータを設定できます。

name=valueペアを使用して構成変数を設定できます。たとえば、vmid=3と指定すると、vmidが3に設定されます。

config-fileパラメータは、ドメイン構成ファイルの場所です。

optionパラメータは、次に示す1つ以上のオプションで構成されます。

[-h | --help]

コマンドのヘルプを表示します。

[--help-config]

構成スクリプトに使用できる構成変数を出力します。

[-q | --quiet]

Quietモードです。

[--path=path]

構成スクリプトのpathで指定された場所を検索します。 pathの値は、コロンで区切られたディレクトリ・リストです。

[-f=file | --defconfig=file]

提供されたPython構成スクリプトを使用します。 引数が処理された後にスクリプトがロードされます。 各コマンドライン・オプションは、長いオプション名に基づいて構成変数を設定します。これらの変数は、ロードされる前にスクリプトの環境に配置されます。 繰り返されるオプションの変数には、リスト値があります。 コマンドラインのname=valueを使用して、他の変数を設定できます。 スクリプトをロードした後、コマンドラインで設定されなかった値は、スクリプトに設定された値に置き換えられます。

[-F=file | --config=file]

SXPを使用するためにドメイン構成を設定します。 SXPは、Xenで使用される基礎となる構成形式です。 構成を出力する--dryrunオプションを使用して、SXP構成を手動で記述またはPython構成スクリプトから生成できます。

[-n | --dryrun]

SXPの結果の構成を出力します。ただし、ドメインは作成しません。

[-x | --xmldryrun]

XMLの結果の構成を出力します。ただし、ドメインは作成しません。

[-s | --skipdtd]

ドメイン作成の前のDTDチェックおよびXMLチェックをスキップします。 このオプションはまだ試用段階であり、ドメインの作成が遅れる場合があります。

[-p | --paused]

作成後にドメインを中断したままにします。

[-c | --console_autoconnect]

ドメインの作成後にコンソールに接続します。

# xm new /home/myhome/myconfig

pause {domain-id}

ドメインの実行を中断します。

# xm pause 02

reboot [--all] [--wait] [domain-id]

ドメインを再起動します。

--allパラメータは、すべてのドメインを再起動します。

--waitパラメータは、コンソールに制御を返す前にドメインの再起動を待機します。

# xm reboot --wait 02

restore {statefile}

保存した状態からドメインをリストアします。

# xm restore /home/myhome/statefile

save {domain-id} {statefile}

後でリストアできるようにドメインの状態を保存します。

# xm save 02 /home/myhome/statefile

shutdown [-a] [-w] [domain-id]

ドメインを正しく停止します。

-aパラメータは、すべてのドメインを停止します。

-wパラメータは、コンソールに制御を返す前にドメインの停止を待機します。

# xm shutdown -w 02

top

ホストおよびドメインのリアルタイム監視の情報を表示します。

# xm top

unpause {domain-id}

ドメインの中断を解除します。

# xm unpause 02

vcpu-set {domain-id} {vCPUs}

ドメインの仮想CPUの数を、ゲスト構成ファイルのvcpus設定の値以下の数に設定します。

# xm vcpu-set 02 8

構成ファイルのvcpu_availパラメータで、使用する仮想CPUを設定できます。 詳細は、第C.3項「仮想CPUの構成ファイルのパラメータ」を参照してください。

---

P2V

物理マシンから仮想マシンへの変換（P2V）ユーティリティを使用すると、コンピュータのオペレーティング・システム（LinuxおよびWindows）とアプリケーションをOracle VMハードウェア仮想化ゲスト・イメージに変換できます。 P2Vユーティリティは、Oracle VM ServerのCDに含まれています。 Oracle VM ServerのCDを使用してコンピュータを再起動すると、P2Vユーティリティにアクセスできます。 Oracle VM Serverの起動画面が表示されます。 boot:プロンプトで、次を入力します。

linux p2v

P2V kickstartファイルを使用すると、物理コンピュータのハードウェア仮想化ゲスト・イメージの作成を自動化できます。 この項では、P2V kickstartファイルのオプションとパラメータについて説明します。

P2Vユーティリティは、コンピュータ上のディスクを仮想ディスク・イメージに変換します。 仮想ディスク・イメージは、元のディスク名を使用して、ゲスト上にIDEディスク（hda、hdb、hdc、hddなど）として作成されます。 P2V kickstartファイルを使用すると、最大で4つのディスクがゲストに自動的に配置されます。 それ以上のディスクは、配置はされませんが、変換されてゲスト構成ファイル（vm.cfg）に追加されます。 ゲストに追加ディスクを配置するには、ゲスト構成ファイル（vm.cfg）を編集し、ディスク・エントリからコメントを削除して、その追加ディスクをSCSIデバイス名（sda、sdb、sdcなど）にマップします。 ブート・ディスクは、常にデバイスhdaにマップする必要があります。 ゲストのファイルのうち、これらのデバイスを参照しているファイルも変更する必要があります。たとえば、/etc/fstabファイルは/dev/hda1、/dev/sda1などを参照している場合があります。

P2V kickstartファイルを使用する際は、1つ以上のネットワーク・インタフェースでDHCPを使用する必要があります。 これは、P2Vユーティリティを実行しているコンピュータがネットワーク経由でkickstartファイルを読み込む場合に必要です。 このネットワーク・インタフェースのネットワーク構成は、kickstartファイルからは変更できません。

kickstartセッションの開始に使用したネットワーク・インタフェース以外のネットワーク・インタフェースを使用して、P2VユーテリティのWebサーバーでリスニングする場合は、そのネットワーク・インタフェースのネットワーク構成（DHCPまたは静的IPアドレス）をkickstartファイルに指定できます。

kickstartファイルを使用してP2Vユーティリティを起動する前に、複数の画面が表示される場合があります。 P2Vユーティリティを完全に自動化するため、これらの画面を表示しないようにすることができます。 P2Vユーティリティを起動する前に、最大で次の4つの画面が表示されます。

• 「P2Vネットワーク構成」画面

• 「言語の選択」画面

• 「キーボードの選択」画面

• 「インストール・ソース」画面

次の項では、これらの画面を表示しないようにする方法の例を示します。

「P2Vネットワーク構成」画面の非表示

「P2Vネットワーク構成」画面を表示しないようにするには、コマンドラインでEthernetデバイスを指定します。次に例を示します。

linux p2v ks=http://example.com/ks.cfg ksdevice=eth0

「言語の選択」画面の非表示

「言語の選択」画面を表示しないようにするには、言語のkickstartパラメータを指定します。次に例を示します。

lang en_US.UTF-8

「キーボードの選択」画面の非表示

「キーボードの選択」画面を表示しないようにするには、キーボードのkickstartパラメータを指定します。次に例を示します。

keyboard us

「インストール・ソース」画面の非表示

「インストール・ソース」画面を表示しないようにするには、ソースのkickstartパラメータを指定します。次に例を示します。

cdrom

P2V Kickstartファイルの例

次にP2V kickstartファイルの例を示します。

p2v
cdrom
lang en_US.UTF-8
keyboard us
target --ovmmanager
network --device eth0 --bootproto dhcp
diskimage --device /dev/sda --type IDE
vm_options --name myGuest --mem 1024 --vcpus 1 --consolepasswd mypassword

その他の例およびP2V kickstartファイルの使用方法の詳細は、第10章「ホストおよびOracle VM以外の仮想マシンの変換」の「LinuxホストまたはWindowsホストの変換」を参照してください。

オプション

P2V kickstartファイルでは次のパラメータを使用できます。

p2v

kickstartファイルがP2V変換の自動化を目的としていることを示します。 このパラメータは自動化されたP2V変換を実行するために必要であり、install、updateまたはrescueではなく、Oracle VM Serverのboot:プロンプトで指定する必要があります。 パラメータは使用しません。

target [option]

ゲスト・イメージの宛先を設定します。

optionパラメータには、次のオプションのみを指定できます。

--ovmmanager

P2VユーティリティをHTTPSサーバー・モードで動作するように設定し、ゲスト・イメージをOracle VM Managerの実行中のインスタンスに転送します。

diskimage [option...]

ゲスト・イメージに含めるディスクを指定します。 P2Vユーティリティでは、デバイス・マッパー・ベースのスナップショット機能を使用して、ディスクをsystem-*.imgファイルとしてターゲット・コンピュータにコピーします。 P2V kickstartファイル内に複数のdiskimageディレクティブが存在する場合があり、ディレクティブごとにゲスト・イメージにディスク・イメージが作成されます。 --deviceパラメータは、イメージ化する必要があるデバイスを示すdiskimageディレクティブとともに使用する必要があります。

optionパラメータは、次に示す1つ以上のオプションで構成されます。

--device path

イメージ化するデバイスです。pathにはデバイスのフルパスを指定します。 次に例を示します。

diskimage --device /dev/sda

--type [IDE | SCSI | LVM | MDRAID]

ディスクの種類を設定します。 IDE、SCSI、LVMまたはMDRAIDのいずれかである必要があります。 デバイス/dev/hda、/dev/hdb、/dev/hdcおよび/dev/hddはIDEである必要があります。 デバイス/dev/sd[a-zz]はSCSIである必要があります。 論理ボリュームはLVMである必要があります。 デバイス/dev/md[a-zz]はMDRAIDである必要があります。 次に例を示します。

diskimage --device /dev/hda --type IDE

network [option...]

コンピュータのネットワーク情報を構成します。

optionパラメータは、次に示す1つ以上のオプションで構成されます。

--bootproto [dhcp | bootp | static]

ネットワーク構成を判別する方法を設定します。 dhcp、bootpまたはstaticのいずれかである必要があります。 デフォルトはdhcpです。bootpとdhcpは同様に処理されます。

dhcpではDHCPサーバーを使用して、ネットワーク構成を取得します。次に例を示します。

network --bootproto dhcp

staticではすべてのネットワーク情報が必要です。 名前が示すとおり、この情報は静的であり、インストール中とインストール後に使用されます。 すべてのネットワーク構成情報を1行に含める必要があるため、静的ネットワークのエントリはより複雑です。 IPアドレス、ネットマスク、ゲートウェイ、ネームサーバーを指定する必要があります。次に例を示します。

network --bootproto static --ip 10.0.2.15 --netmask 255.255.255.0 --gateway 10.0.2.254 --nameserver 10.0.2.1

staticの方法には次の制限があります。

• 静的ネットワーク構成情報は、すべてを1行に指定する必要があり、バックスラッシュを使用して行をラップすることはできません。

• ネームサーバーは1つのみ指定できます。

--ip ipaddress

コンピュータのIPアドレスです。

--gateway ipaddress

デフォルト・ゲートウェイのIPアドレスです。

--nameserver ipaddress

プライマリ・ネームサーバーのIPアドレスです。

--netmask netmask

コンピュータのネットマスクです。

vm_options [option...]

ゲストの構成オプションを設定します。

--name name

ゲストの名前です。

--mem size

ゲストのメモリーの割当て（MB）です。

--vcpus number

ゲストのVCPUの数です。

--consolepasswd password

ゲストのコンソール・パスワードです。 次に例を示します。

vm_options --name myGuest --mem 1024 --vcpus 1 --consolepasswd mypassword