Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
openeuler
libvirt
提交
595ade9f
L
libvirt
项目概览
openeuler
/
libvirt
通知
3
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
L
libvirt
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
595ade9f
编写于
5月 21, 2009
作者:
D
Daniel P. Berrange
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Add docs on domain XML conversion usage for QEMU/Xen drivers
上级
3d4a0ccb
变更
5
隐藏空白更改
内联
并排
Showing
5 changed file
with
395 addition
and
8 deletion
+395
-8
ChangeLog
ChangeLog
+5
-0
docs/drvqemu.html
docs/drvqemu.html
+107
-2
docs/drvqemu.html.in
docs/drvqemu.html.in
+94
-2
docs/drvxen.html
docs/drvxen.html
+102
-2
docs/drvxen.html.in
docs/drvxen.html.in
+87
-2
未找到文件。
ChangeLog
浏览文件 @
595ade9f
Thu May 21 15:20:22 BST 2009 Daniel P. Berrange <berrange@redhat.com>
* docs/drvqemu.html[.in], docs/drvxen.html[.in]: Add docs on
use of new domain XML conversions
Thu May 21 15:16:22 BST 2009 Daniel P. Berrange <berrange@redhat.com>
* src/qemu_driver.c, src/qemu_conf.c, src/qemu_conf.h: Add new
...
...
docs/drvqemu.html
浏览文件 @
595ade9f
...
...
@@ -130,12 +130,28 @@
</div>
<div
id=
"content"
>
<h1>
QEMU/KVM hypervisor driver
</h1>
<ul><li>
<a
href=
"#prereq"
>
Deployment pre-requisites
</a>
</li><li>
<a
href=
"#uris"
>
Connections to QEMU driver
</a>
</li><li>
<a
href=
"#imex"
>
Import and export of libvirt domain XML configs
</a>
<ul><li>
<a
href=
"#xmlimport"
>
Converting from QEMU args to domain XML
</a>
</li><li>
<a
href=
"#xmlexport"
>
Converting from domain XML to QEMU args
</a>
</li></ul>
</li><li>
<a
href=
"#xmlconfig"
>
Example domain XML config
</a>
</li></ul>
<p>
The libvirt QEMU driver can manage any QEMU emulator from version 0.8.1
or later. It can also manage anything that provides the same QEMU command
line syntax and monitor interaction. This includes KVM, and Xenner.
</p>
<h2>
Deployment pre-requisites
</h2>
<h2>
<a
name=
"prereq"
id=
"prereq"
>
Deployment pre-requisites
</a>
</h2>
<ul><li>
<strong>
QEMU emulators
</strong>
: The driver will probe
<code>
/usr/bin
</code>
for the presence of
<code>
qemu
</code>
,
<code>
qemu-system-x86_64
</code>
,
...
...
@@ -153,7 +169,9 @@
node. If both are found, then Xen paravirtualized guests can be run using
the KVM hardware acceleration.
</li></ul>
<h2>
Connections to QEMU driver
</h2>
<h2>
<a
name=
"uris"
id=
"uris"
>
Connections to QEMU driver
</a>
</h2>
<p>
The libvirt QEMU driver is a multi-instance driver, providing a single
system wide privileged driver (the "system" instance), and per-user
...
...
@@ -169,6 +187,93 @@
qemu://example.com/system (remote access, TLS/x509)
qemu+tcp://example.com/system (remote access, SASl/Kerberos)
qemu+ssh://root@example.com/system (remote access, SSH tunnelled)
</pre>
<h2>
<a
name=
"imex"
id=
"imex"
>
Import and export of libvirt domain XML configs
</a>
</h2>
<p>
The QEMU driver currently supports a single native
config format known as
<code>
qemu-argv
</code>
. The data for this format
is expected to be a single line first a list of environment variables,
then the QEMu binary name, finally followed by the QEMU command line
arguments
</p>
<h3>
<a
name=
"xmlimport"
id=
"xmlimport"
>
Converting from QEMU args to domain XML
</a>
</h3>
<p>
The
<code>
virsh domxml-from-native
</code>
provides a way to convert an
existing set of QEMU args into a guest description using libvirt Domain XML
that can then be used by libvirt.
</p>
<pre>
$ cat
>
demo.args
<<
EOF
LC_ALL=C PATH=/bin HOME=/home/test USER=test \
LOGNAME=test /usr/bin/qemu -S -M pc -m 214 -smp 1 \
-nographic -monitor pty -no-acpi -boot c -hda \
/dev/HostVG/QEMUGuest1 -net none -serial none \
-parallel none -usb
EOF
$ virsh domxml-from-native qemu-argv demo.args
<
domain type='qemu'
>
<
uuid
>
00000000-0000-0000-0000-000000000000
<
/uuid
>
<
memory
>
219136
<
/memory
>
<
currentMemory
>
219136
<
/currentMemory
>
<
vcpu
>
1
<
/vcpu
>
<
os
>
<
type arch='i686' machine='pc'
>
hvm
<
/type
>
<
boot dev='hd'/
>
<
/os
>
<
clock offset='utc'/
>
<
on_poweroff
>
destroy
<
/on_poweroff
>
<
on_reboot
>
restart
<
/on_reboot
>
<
on_crash
>
destroy
<
/on_crash
>
<
devices
>
<
emulator
>
/usr/bin/qemu
<
/emulator
>
<
disk type='block' device='disk'
>
<
source dev='/dev/HostVG/QEMUGuest1'/
>
<
target dev='hda' bus='ide'/
>
<
/disk
>
<
/devices
>
<
/domain
>
</pre>
<p>
NB, don't include the literral \ in the args, put everything on one line
</p>
<h3>
<a
name=
"xmlexport"
id=
"xmlexport"
>
Converting from domain XML to QEMU args
</a>
</h3>
<p>
The
<code>
virsh domxml-to-native
</code>
provides a way to convert a
guest description using libvirt Domain XML, into a set of QEMU args
that can be run manually.
</p>
<pre>
$ cat
>
demo.xml
<<
EOF
<
domain type='qemu'
>
<
name
>
QEMUGuest1
<
/name
>
<
uuid
>
c7a5fdbd-edaf-9455-926a-d65c16db1809
<
/uuid
>
<
memory
>
219200
<
/memory
>
<
currentMemory
>
219200
<
/currentMemory
>
<
vcpu
>
1
<
/vcpu
>
<
os
>
<
type arch='i686' machine='pc'
>
hvm
<
/type
>
<
boot dev='hd'/
>
<
/os
>
<
clock offset='utc'/
>
<
on_poweroff
>
destroy
<
/on_poweroff
>
<
on_reboot
>
restart
<
/on_reboot
>
<
on_crash
>
destroy
<
/on_crash
>
<
devices
>
<
emulator
>
/usr/bin/qemu
<
/emulator
>
<
disk type='block' device='disk'
>
<
source dev='/dev/HostVG/QEMUGuest1'/
>
<
target dev='hda' bus='ide'/
>
<
/disk
>
<
/devices
>
<
/domain
>
EOF
$ virsh domxml-to-native qemu-argv demo.xml
LC_ALL=C PATH=/usr/bin:/bin HOME=/home/test \
USER=test LOGNAME=test /usr/bin/qemu -S -M pc \
-no-kqemu -m 214 -smp 1 -name QEMUGuest1 -nographic \
-monitor pty -no-acpi -boot c -drive \
file=/dev/HostVG/QEMUGuest1,if=ide,index=0 -net none \
-serial none -parallel none -usb
</pre>
<h2>
<a
name=
"xmlconfig"
id=
"xmlconfig"
>
Example domain XML config
</a>
...
...
docs/drvqemu.html.in
浏览文件 @
595ade9f
...
...
@@ -2,13 +2,15 @@
<body>
<h1>
QEMU/KVM hypervisor driver
</h1>
<ul
id=
"toc"
></ul>
<p>
The libvirt QEMU driver can manage any QEMU emulator from version 0.8.1
or later. It can also manage anything that provides the same QEMU command
line syntax and monitor interaction. This includes KVM, and Xenner.
</p>
<h2>
Deployment pre-requisites
</h2>
<h2>
<a
name=
"prereq"
>
Deployment pre-requisites
</a>
</h2>
<ul>
<li>
...
...
@@ -32,7 +34,7 @@
</li>
</ul>
<h2>
Connections to QEMU driver
</h2>
<h2>
<a
name=
"uris"
>
Connections to QEMU driver
</a>
</h2>
<p>
The libvirt QEMU driver is a multi-instance driver, providing a single
...
...
@@ -52,6 +54,96 @@
qemu+ssh://root@example.com/system (remote access, SSH tunnelled)
</pre>
<h2><a
name=
"imex"
>
Import and export of libvirt domain XML configs
</a></h2>
<p>
The QEMU driver currently supports a single native
config format known as
<code>
qemu-argv
</code>
. The data for this format
is expected to be a single line first a list of environment variables,
then the QEMu binary name, finally followed by the QEMU command line
arguments
</p>
<h3><a
name=
"xmlimport"
>
Converting from QEMU args to domain XML
</a></h3>
<p>
The
<code>
virsh domxml-from-native
</code>
provides a way to convert an
existing set of QEMU args into a guest description using libvirt Domain XML
that can then be used by libvirt.
</p>
<pre>
$ cat
>
demo.args
<<
EOF
LC_ALL=C PATH=/bin HOME=/home/test USER=test \
LOGNAME=test /usr/bin/qemu -S -M pc -m 214 -smp 1 \
-nographic -monitor pty -no-acpi -boot c -hda \
/dev/HostVG/QEMUGuest1 -net none -serial none \
-parallel none -usb
EOF
$ virsh domxml-from-native qemu-argv demo.args
<
domain type='qemu'
>
<
uuid
>
00000000-0000-0000-0000-000000000000
<
/uuid
>
<
memory
>
219136
<
/memory
>
<
currentMemory
>
219136
<
/currentMemory
>
<
vcpu
>
1
<
/vcpu
>
<
os
>
<
type arch='i686' machine='pc'
>
hvm
<
/type
>
<
boot dev='hd'/
>
<
/os
>
<
clock offset='utc'/
>
<
on_poweroff
>
destroy
<
/on_poweroff
>
<
on_reboot
>
restart
<
/on_reboot
>
<
on_crash
>
destroy
<
/on_crash
>
<
devices
>
<
emulator
>
/usr/bin/qemu
<
/emulator
>
<
disk type='block' device='disk'
>
<
source dev='/dev/HostVG/QEMUGuest1'/
>
<
target dev='hda' bus='ide'/
>
<
/disk
>
<
/devices
>
<
/domain
>
</pre>
<p>
NB, don't include the literral \ in the args, put everything on one line
</p>
<h3><a
name=
"xmlexport"
>
Converting from domain XML to QEMU args
</a></h3>
<p>
The
<code>
virsh domxml-to-native
</code>
provides a way to convert a
guest description using libvirt Domain XML, into a set of QEMU args
that can be run manually.
</p>
<pre>
$ cat
>
demo.xml
<<
EOF
<
domain type='qemu'
>
<
name
>
QEMUGuest1
<
/name
>
<
uuid
>
c7a5fdbd-edaf-9455-926a-d65c16db1809
<
/uuid
>
<
memory
>
219200
<
/memory
>
<
currentMemory
>
219200
<
/currentMemory
>
<
vcpu
>
1
<
/vcpu
>
<
os
>
<
type arch='i686' machine='pc'
>
hvm
<
/type
>
<
boot dev='hd'/
>
<
/os
>
<
clock offset='utc'/
>
<
on_poweroff
>
destroy
<
/on_poweroff
>
<
on_reboot
>
restart
<
/on_reboot
>
<
on_crash
>
destroy
<
/on_crash
>
<
devices
>
<
emulator
>
/usr/bin/qemu
<
/emulator
>
<
disk type='block' device='disk'
>
<
source dev='/dev/HostVG/QEMUGuest1'/
>
<
target dev='hda' bus='ide'/
>
<
/disk
>
<
/devices
>
<
/domain
>
EOF
$ virsh domxml-to-native qemu-argv demo.xml
LC_ALL=C PATH=/usr/bin:/bin HOME=/home/test \
USER=test LOGNAME=test /usr/bin/qemu -S -M pc \
-no-kqemu -m 214 -smp 1 -name QEMUGuest1 -nographic \
-monitor pty -no-acpi -boot c -drive \
file=/dev/HostVG/QEMUGuest1,if=ide,index=0 -net none \
-serial none -parallel none -usb
</pre>
<h2><a
name=
"xmlconfig"
>
Example domain XML config
</a></h2>
<h3>
QEMU emulated guest on x86_64
</h3>
...
...
docs/drvxen.html
浏览文件 @
595ade9f
...
...
@@ -130,11 +130,27 @@
</div>
<div
id=
"content"
>
<h1>
Xen hypervisor driver
</h1>
<ul><li>
<a
href=
"#prereq"
>
Deployment pre-requisites
</a>
</li><li>
<a
href=
"#uri"
>
Connections to Xen driver
</a>
</li><li>
<a
href=
"#imex"
>
Import and export of libvirt domain XML configs
</a>
<ul><li>
<a
href=
"#xmlimport"
>
Converting from XM config files to domain XML
</a>
</li><li>
<a
href=
"#xmlexport"
>
Converting from domain XML to XM config files
</a>
</li></ul>
</li><li>
<a
href=
"#xmlconfig"
>
Example domain XML config
</a>
</li></ul>
<p>
The libvirt Xen driver provides the ability to manage virtual machines
on any Xen release from 3.0.1 onwards.
</p>
<h2>
Deployment pre-requisites
</h2>
<h2>
<a
name=
"prereq"
id=
"prereq"
>
Deployment pre-requisites
</a>
</h2>
<p>
The libvirt Xen driver uses a combination of channels to manage Xen
virtual machines.
...
...
@@ -163,7 +179,9 @@
the
<code>
/etc/xen
</code>
directory. It is important not to place
any other non-config files in this directory.
</li></ul>
<h2>
Connections to Xen driver
</h2>
<h2>
<a
name=
"uri"
id=
"uri"
>
Connections to Xen driver
</a>
</h2>
<p>
The libvirt Xen driver is a single-instance privileged driver,
with a driver name of 'xen'. Some example conection URIs for
...
...
@@ -175,6 +193,88 @@
xen://example.com/ (remote access, TLS/x509)
xen+tcp://example.com/ (remote access, SASl/Kerberos)
xen+ssh://root@example.com/ (remote access, SSH tunnelled)
</pre>
<h2>
<a
name=
"imex"
id=
"imex"
>
Import and export of libvirt domain XML configs
</a>
</h2>
<p>
The Xen driver currently supports two native
config formats. The first known as
<code>
xen-xm
</code>
is the format
used by the XM tool for files in
<code>
/etc/xen
</code>
. The second
known as
<code>
xen-sxpr
</code>
, is the format used for interacting
with the XenD's legacy HTTP RPC service.
</p>
<h3>
<a
name=
"xmlimport"
id=
"xmlimport"
>
Converting from XM config files to domain XML
</a>
</h3>
<p>
The
<code>
virsh domxml-from-native
</code>
provides a way to convert an
existing set of XM config files into a guest description using libvirt Domain XML
that can then be used by libvirt.
</p>
<pre>
$ virsh -c xen:/// domxml-from-native xen-xm rhel5.cfg
<
domain type='xen'
>
<
name
>
rhel5pv
<
/name
>
<
uuid
>
8f07fe28-753f-2729-d76d-bdbd892f949a
<
/uuid
>
<
memory
>
2560000
<
/memory
>
<
currentMemory
>
307200
<
/currentMemory
>
<
vcpu
>
4
<
/vcpu
>
<
bootloader
>
/usr/bin/pygrub
<
/bootloader
>
<
os
>
<
type arch='x86_64' machine='xenpv'
>
linux
<
/type
>
<
/os
>
<
clock offset='utc'/
>
<
on_poweroff
>
destroy
<
/on_poweroff
>
<
on_reboot
>
restart
<
/on_reboot
>
<
on_crash
>
restart
<
/on_crash
>
<
devices
>
<
disk type='file' device='disk'
>
<
driver name='tap' type='aio'/
>
<
source file='/var/lib/xen/images/rhel5pv.img'/
>
<
target dev='xvda' bus='xen'/
>
<
/disk
>
<
disk type='file' device='disk'
>
<
driver name='tap' type='qcow'/
>
<
source file='/root/qcow1-xen.img'/
>
<
target dev='xvdd' bus='xen'/
>
<
/disk
>
<
interface type='bridge'
>
<
mac address='00:16:3e:60:36:ba'/
>
<
source bridge='xenbr0'/
>
<
/interface
>
<
console type='pty'
>
<
target port='0'/
>
<
/console
>
<
input type='mouse' bus='xen'/
>
<
graphics type='vnc' port='-1' autoport='yes' listen='0.0.0.0'/
>
<
/devices
>
<
/domain
>
</pre>
<h3>
<a
name=
"xmlexport"
id=
"xmlexport"
>
Converting from domain XML to XM config files
</a>
</h3>
<p>
The
<code>
virsh domxml-to-native
</code>
provides a way to convert a
guest description using libvirt Domain XML, into the XM config file
format.
</p>
<pre>
# virsh -c xen:/// domxml-to-native xen-xm rhel5pv.xml
name = "rhel5pv"
uuid = "8f07fe28-753f-2729-d76d-bdbd892f949a"
maxmem = 2500
memory = 300
vcpus = 4
bootloader = "/usr/bin/pygrub"
kernel = "/var/lib/xen/boot_kernel.0YK-cS"
ramdisk = "/var/lib/xen/boot_ramdisk.vWgrxK"
extra = "ro root=/dev/VolGroup00/LogVol00 rhgb quiet"
on_poweroff = "destroy"
on_reboot = "restart"
on_crash = "restart"
sdl = 0
vnc = 1
vncunused = 1
vnclisten = "0.0.0.0"
disk = [ "tap:aio:/var/lib/xen/images/rhel5pv.img,xvda,w", "tap:qcow:/root/qcow1-xen.img,xvdd,w" ]
vif = [ "mac=00:16:3e:60:36:ba,bridge=virbr0,script=vif-bridge,vifname=vif5.0" ]
</pre>
<h2>
<a
name=
"xmlconfig"
id=
"xmlconfig"
>
Example domain XML config
</a>
...
...
docs/drvxen.html.in
浏览文件 @
595ade9f
...
...
@@ -2,12 +2,14 @@
<body>
<h1>
Xen hypervisor driver
</h1>
<ul
id=
"toc"
></ul>
<p>
The libvirt Xen driver provides the ability to manage virtual machines
on any Xen release from 3.0.1 onwards.
</p>
<h2>
Deployment pre-requisites
</h2>
<h2>
<a
name=
"prereq"
>
Deployment pre-requisites
</a>
</h2>
<p>
The libvirt Xen driver uses a combination of channels to manage Xen
...
...
@@ -44,7 +46,7 @@
</li>
</ul>
<h2>
Connections to Xen driver
</h2>
<h2>
<a
name=
"uri"
>
Connections to Xen driver
</a>
</h2>
<p>
The libvirt Xen driver is a single-instance privileged driver,
...
...
@@ -60,6 +62,89 @@
xen+ssh://root@example.com/ (remote access, SSH tunnelled)
</pre>
<h2><a
name=
"imex"
>
Import and export of libvirt domain XML configs
</a></h2>
<p>
The Xen driver currently supports two native
config formats. The first known as
<code>
xen-xm
</code>
is the format
used by the XM tool for files in
<code>
/etc/xen
</code>
. The second
known as
<code>
xen-sxpr
</code>
, is the format used for interacting
with the XenD's legacy HTTP RPC service.
</p>
<h3><a
name=
"xmlimport"
>
Converting from XM config files to domain XML
</a></h3>
<p>
The
<code>
virsh domxml-from-native
</code>
provides a way to convert an
existing set of XM config files into a guest description using libvirt Domain XML
that can then be used by libvirt.
</p>
<pre>
$ virsh -c xen:/// domxml-from-native xen-xm rhel5.cfg
<
domain type='xen'
>
<
name
>
rhel5pv
<
/name
>
<
uuid
>
8f07fe28-753f-2729-d76d-bdbd892f949a
<
/uuid
>
<
memory
>
2560000
<
/memory
>
<
currentMemory
>
307200
<
/currentMemory
>
<
vcpu
>
4
<
/vcpu
>
<
bootloader
>
/usr/bin/pygrub
<
/bootloader
>
<
os
>
<
type arch='x86_64' machine='xenpv'
>
linux
<
/type
>
<
/os
>
<
clock offset='utc'/
>
<
on_poweroff
>
destroy
<
/on_poweroff
>
<
on_reboot
>
restart
<
/on_reboot
>
<
on_crash
>
restart
<
/on_crash
>
<
devices
>
<
disk type='file' device='disk'
>
<
driver name='tap' type='aio'/
>
<
source file='/var/lib/xen/images/rhel5pv.img'/
>
<
target dev='xvda' bus='xen'/
>
<
/disk
>
<
disk type='file' device='disk'
>
<
driver name='tap' type='qcow'/
>
<
source file='/root/qcow1-xen.img'/
>
<
target dev='xvdd' bus='xen'/
>
<
/disk
>
<
interface type='bridge'
>
<
mac address='00:16:3e:60:36:ba'/
>
<
source bridge='xenbr0'/
>
<
/interface
>
<
console type='pty'
>
<
target port='0'/
>
<
/console
>
<
input type='mouse' bus='xen'/
>
<
graphics type='vnc' port='-1' autoport='yes' listen='0.0.0.0'/
>
<
/devices
>
<
/domain
>
</pre>
<h3><a
name=
"xmlexport"
>
Converting from domain XML to XM config files
</a></h3>
<p>
The
<code>
virsh domxml-to-native
</code>
provides a way to convert a
guest description using libvirt Domain XML, into the XM config file
format.
</p>
<pre>
# virsh -c xen:/// domxml-to-native xen-xm rhel5pv.xml
name = "rhel5pv"
uuid = "8f07fe28-753f-2729-d76d-bdbd892f949a"
maxmem = 2500
memory = 300
vcpus = 4
bootloader = "/usr/bin/pygrub"
kernel = "/var/lib/xen/boot_kernel.0YK-cS"
ramdisk = "/var/lib/xen/boot_ramdisk.vWgrxK"
extra = "ro root=/dev/VolGroup00/LogVol00 rhgb quiet"
on_poweroff = "destroy"
on_reboot = "restart"
on_crash = "restart"
sdl = 0
vnc = 1
vncunused = 1
vnclisten = "0.0.0.0"
disk = [ "tap:aio:/var/lib/xen/images/rhel5pv.img,xvda,w", "tap:qcow:/root/qcow1-xen.img,xvdd,w" ]
vif = [ "mac=00:16:3e:60:36:ba,bridge=virbr0,script=vif-bridge,vifname=vif5.0" ]
</pre>
<h2><a
name=
"xmlconfig"
>
Example domain XML config
</a></h2>
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录