Red Hat Training

A Red Hat training course is available for Red Hat Enterprise Linux

第23章 ドメイン XML の操作

本章では、ゲスト仮想マシン XML 設定ファイルのコンポーネントを詳しく説明します (ドメイン XML とも呼ばれます)。この章では、domain <という用語は、すべてのゲスト仮想マシンに必要なルートドメイン要素を参照します>。ドメイン XML には typeid の 2 つの属性があります。type は、ドメインの実行に使用するハイパーバイザーを指定します。許可される値はドライバー固有の値ですが、KVM も含まれます。ID は、実行中のゲスト仮想マシンの一意の整数識別子です。非アクティブなマシンには ID 値 ありません。本章のセクションでは、ドメイン XML のコンポーネントを説明します。このマニュアルの追加章では、ドメイン XML の操作が必要な場合にこの章が表示される場合があります。
重要
(virshVirtual Machine Managerなど)およびコマンド (virt-xmlなど)のみを使用して、ドメイン XML ファイルのコンポーネントを編集します。テキストエディターを使用して、ドメインの XML ファイルを開き、編集しないでください。絶対的にドメイン XML ファイルを直接編集する必要がある場合は、virsh edit コマンドを使用します。

23.1. 一般情報およびメタデータ

この情報はドメイン XML の以下の部分に入ります。

図23.1 ドメイン XML メタデータ


<domain type='kvm' id='3'>
  <name>fv0</name>
  <uuid>4dea22b31d52d8f32516782e98ab3fa0</uuid>
  <title>A short description - title - of the domain</title>
  <description>A human readable description</description>
  <metadata>
    <app1:foo xmlns:app1="http://app1.org/app1/">..</app1:foo>
    <app2:bar xmlns:app2="http://app1.org/app2/">..</app2:bar>
  </metadata>
  ...
</domain>
ドメイン XML の本項のコンポーネントは以下のとおりです。

表23.1 一般的なメタデータの要素

要素 説明
<name> 仮想マシンの名前を割り当てます。この名前は、英数字のみで構成されており、1 つのホストの物理マシンの範囲内で一意である必要があります。多くの場合、永続設定ファイルを保存するファイル名を形成します。
<uuid> 仮想マシンのグローバルに一意の識別子を割り当てます。形式は RFC 4122 に準拠する必要があります(例: 3e3fce45-4f53-4fa7-bb32-11f34168b82b )。新しいマシンの定義または作成時に省略すると、無作為に UUID が生成されます。sysinfo 仕様を使用して UUID を指定することもできます。
<title> ドメインの簡単な説明の領域を作成します。タイトルには新しい行を含めることはできません。
<description> タイトルとは異なります。libvirt ではこのデータは使用されません。表示するユーザーの選択情報をすべて含めることができます。
<metadata> アプリケーションにより、カスタムメタデータを XML ノード/ツリーの形式で保存することができます。アプリケーションは、XML ノード/ツリーでカスタム名のスペースを使用する必要があります。