← Back to branch summary

~ubuntu-branches/ubuntu/quantal/virtinst/quantal-proposed

« back to all changes in this revision

Viewing changes to man/en/virt-install.pod.in

  • Committer: Package Import Robot
  • Author(s): Marc Deslauriers
  • Date: 2012-07-24 08:52:01 UTC
  • mfrom: (1.6.8 sid)
  • Revision ID: package-import@ubuntu.com-20120724085201-q3h0cbabg4t46gfm
Tags: 0.600.2-1ubuntu1
* Merge from debian unstable. Remaining changes:
  - debian/patches/9003-fix-path-to-hvmloader-in-testsuite.patch: adjust
    testsuite for 0001-fix-path-to-hvmloader.patch and
    0002-Fix-path-to-pygrub.patch.
  - debian/patches/9004_ubuntu_fix_tree_support.patch: Fix tree detection
    for all ISO/HTTP source, to not longer fail with cobbler/koan.
  - debian/patches/0004-Fix-path-to-qemu-dm.patch: fix the path to the
    qemu-dm binary.
  - debian/{control,rules,pyversions}: Build using dh_python2, use
    debhelper v8 instead of cdbs; for some reason the package build an
    empty binary package when using dh_python2.
  - debian/control: added acl package to depends.
  - debian/control: added libvirt-bin to recommends
* Dropped patches:
  - debian/patches/9005_ubuntu_releases.patch: Upstream

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/en/virt-install.pod.in
14
14
container guests using the C<libvirt> hypervisor management library.
15
15
See the EXAMPLES section at the end of this document to quickly get started.
16
16
 
17
 
B<virt-install> tool supports both text based & graphical installations,
18
 
using VNC or SDL graphics, or a text serial console. The guest can be
19
 
configured to use one or more virtual disks, network interfaces,
 
17
B<virt-install> tool supports graphical installations using (for example)
 
18
VNC or SPICE, as well as text mode installs over serial console. The guest
 
19
can be configured to use one or more virtual disks, network interfaces,
20
20
audio devices, physical USB or PCI devices, among others.
21
21
 
22
22
The installation media can be held locally or remotely on NFS, HTTP, FTP
42
42
 
43
43
Show the help message and exit
44
44
 
45
 
=item  --connect=CONNECT
46
 
 
47
 
Connect to a non-default hypervisor. The default connection is chosen based
48
 
on the following rules:
 
45
=item  --connect=URI
 
46
 
 
47
Connect to a non-default hypervisor. If this isn't specified, libvirt
 
48
will try and choose the most suitable default.
 
49
 
 
50
Some valid options here are:
49
51
 
50
52
=over 4
51
53
 
52
 
=item xen
53
 
 
54
 
If running on a host with the Xen kernel (checks against /proc/xen)
55
 
 
56
54
=item qemu:///system
57
55
 
58
 
If running on a bare metal kernel as root (needed for KVM installs)
 
56
For creating KVM and QEMU guests to be run by the system libvirtd instance.
 
57
This is the default mode that virt-manager uses, and what most KVM users
 
58
want.
59
59
 
60
60
=item qemu:///session
61
61
 
62
 
If running on a bare metal kernel as non-root
63
 
 
64
 
It is only necessary to provide the C<--connect> argument if this default
65
 
prioritization is incorrect, eg if wanting to use QEMU while on a Xen kernel.
 
62
For creating KVM and QEMU guests for libvirtd running as the regular user.
 
63
 
 
64
=item xen:///
 
65
 
 
66
For connecting to Xen.
 
67
 
 
68
=item lxc:///
 
69
 
 
70
For creating linux containers
66
71
 
67
72
=back
68
73
 
176
181
 
177
182
Configure domain security driver settings. Type can be either 'static' or
178
183
'dynamic'. 'static' configuration requires a security LABEL. Specifying
179
 
LABEL without TYPE implies static configuration. To have libvirt automatically
180
 
apply your static label, you must specify relabel=yes.
 
184
LABEL without TYPE implies static configuration.
 
185
 
 
186
To have libvirt automatically apply your static label, you must specify
 
187
relabel=yes. Otherwise disk images must be manually labeled by the admin,
 
188
including images that virt-install is asked to create.
181
189
 
182
190
=back
183
191
 
357
365
Have guest permanently boot off a local kernel/initrd pair, with the
358
366
specified kernel options.
359
367
 
 
368
=item B<--boot loader=BIOSPATH>
 
369
 
 
370
Use BIOSPATH as the virtual machine BIOS. Only valid for fully virtualized
 
371
guests.
 
372
 
360
373
=back
361
374
 
362
375
=back
893
906
 
894
907
Attach a virtual audio device to the guest. MODEL specifies the emulated
895
908
sound card model. Possible values are ich6, ac97, es1370, sb16, pcspk,
896
 
or default. 'default' will be AC97 if the hypervisor supports it,
897
 
otherwise it will be ES1370.
 
909
or default. 'default' will try to pick the best model that the specified
 
910
OS supports.
898
911
 
899
 
This deprecates the old boolean --sound model (which still works the same
 
912
This deprecates the old boolean --sound option (which still works the same
900
913
as a single '--soundhw default')
901
914
 
902
915
=item --watchdog MODEL[,action=ACTION]
1140
1153
 
1141
1154
=back
1142
1155
 
 
1156
=item --memballoon MODEL
 
1157
 
 
1158
Attach a virtual memory balloon device to the guest. If the memballoon device
 
1159
needs to be explicitly disabled, MODEL='none' is used.
 
1160
 
 
1161
MODEL is the type of memballoon device provided. The value can be 'virtio',
 
1162
'xen' or 'none'.
 
1163
Some examples:
 
1164
 
 
1165
Use the recommended settings:
 
1166
 
 
1167
--memballoon virtio
 
1168
 
 
1169
Do not use memballoon device:
 
1170
 
 
1171
--memballoon none
 
1172
 
1143
1173
=back
1144
1174
 
1145
1175
=head2 Miscellaneous Options
1298
1328
the rest of the options.
1299
1329
 
1300
1330
  # virt-install \
1301
 
       --name demo
1302
 
       --ram 512
1303
 
       --disk /home/user/VMs/mydisk.img
 
1331
       --name demo \
 
1332
       --ram 512 \
 
1333
       --disk /home/user/VMs/mydisk.img \
1304
1334
       --import
1305
1335
 
1306
1336
Test a custom kernel/initrd using an existing disk image, manually
1307
1337
specifying a serial device hooked to a PTY on the host machine.
1308
1338
 
1309
1339
  # virt-install \
1310
 
       --name mykernel
1311
 
       --ram 512
1312
 
       --disk /home/user/VMs/mydisk.img
1313
 
       --boot kernel=/tmp/mykernel,initrd=/tmp/myinitrd,kernel_args="console=ttyS0"
 
1340
       --name mykernel \
 
1341
       --ram 512 \
 
1342
       --disk /home/user/VMs/mydisk.img \
 
1343
       --boot kernel=/tmp/mykernel,initrd=/tmp/myinitrd,kernel_args="console=ttyS0" \
1314
1344
       --serial pty
1315
1345
 
1316
1346
=head1 AUTHORS