← Back to branch summary

~ubuntu-branches/ubuntu/raring/virtinst/raring-proposed

« back to all changes in this revision

Viewing changes to man/en/virt-install.1

  • Committer: Package Import Robot
  • Author(s): Laurent Léonard
  • Date: 2012-07-14 18:47:52 UTC
  • mfrom: (1.2.13)
  • mto: This revision was merged to the branch mainline in revision 43.
  • Revision ID: package-import@ubuntu.com-20120714184752-h7wf9o5bnkgemi52
Tags: 0.600.2-1
* [6e16ae7] Imported Upstream version 0.600.2
* [27d03b8] Drop patch
  - 0004-Fix-location-of-Debian-daily-builds.patch - fixed upstream
* [e040ecd] Bump Standards-Version to 3.9.3

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/en/virt-install.1
124
124
.\" ========================================================================
125
125
.\"
126
126
.IX Title "VIRT-INSTALL 1"
127
 
.TH VIRT-INSTALL 1 "2012-01-31" "" "Virtual Machine Install Tools"
 
127
.TH VIRT-INSTALL 1 "2012-07-09" "" "Virtual Machine Install Tools"
128
128
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
129
129
.\" way too many mistakes in technical documents.
130
130
.if n .ad l
140
140
container guests using the \f(CW\*(C`libvirt\*(C'\fR hypervisor management library.
141
141
See the \s-1EXAMPLES\s0 section at the end of this document to quickly get started.
142
142
.PP
143
 
\&\fBvirt-install\fR tool supports both text based & graphical installations,
144
 
using \s-1VNC\s0 or \s-1SDL\s0 graphics, or a text serial console. The guest can be
145
 
configured to use one or more virtual disks, network interfaces,
 
143
\&\fBvirt-install\fR tool supports graphical installations using (for example)
 
144
\&\s-1VNC\s0 or \s-1SPICE\s0, as well as text mode installs over serial console. The guest
 
145
can be configured to use one or more virtual disks, network interfaces,
146
146
audio devices, physical \s-1USB\s0 or \s-1PCI\s0 devices, among others.
147
147
.PP
148
148
The installation media can be held locally or remotely on \s-1NFS\s0, \s-1HTTP\s0, \s-1FTP\s0
163
163
.IP "\-h, \-\-help" 2
164
164
.IX Item "-h, --help"
165
165
Show the help message and exit
166
 
.IP "\-\-connect=CONNECT" 2
167
 
.IX Item "--connect=CONNECT"
168
 
Connect to a non-default hypervisor. The default connection is chosen based
169
 
on the following rules:
 
166
.IP "\-\-connect=URI" 2
 
167
.IX Item "--connect=URI"
 
168
Connect to a non-default hypervisor. If this isn't specified, libvirt
 
169
will try and choose the most suitable default.
 
170
.Sp
 
171
Some valid options here are:
170
172
.RS 2
171
 
.IP "xen" 4
172
 
.IX Item "xen"
173
 
If running on a host with the Xen kernel (checks against /proc/xen)
174
173
.IP "qemu:///system" 4
175
174
.IX Item "qemu:///system"
176
 
If running on a bare metal kernel as root (needed for \s-1KVM\s0 installs)
 
175
For creating \s-1KVM\s0 and \s-1QEMU\s0 guests to be run by the system libvirtd instance.
 
176
This is the default mode that virt-manager uses, and what most \s-1KVM\s0 users
 
177
want.
177
178
.IP "qemu:///session" 4
178
179
.IX Item "qemu:///session"
179
 
If running on a bare metal kernel as non-root
180
 
.Sp
181
 
It is only necessary to provide the \f(CW\*(C`\-\-connect\*(C'\fR argument if this default
182
 
prioritization is incorrect, eg if wanting to use \s-1QEMU\s0 while on a Xen kernel.
 
180
For creating \s-1KVM\s0 and \s-1QEMU\s0 guests for libvirtd running as the regular user.
 
181
.IP "xen:///" 4
 
182
.IX Item "xen:///"
 
183
For connecting to Xen.
 
184
.IP "lxc:///" 4
 
185
.IX Item "lxc:///"
 
186
For creating linux containers
183
187
.RE
184
188
.RS 2
185
189
.RE
280
284
.IX Item "--security type=TYPE[,label=LABEL][,relabel=yes|no]"
281
285
Configure domain security driver settings. Type can be either 'static' or
282
286
\&'dynamic'. 'static' configuration requires a security \s-1LABEL\s0. Specifying
283
 
\&\s-1LABEL\s0 without \s-1TYPE\s0 implies static configuration. To have libvirt automatically
284
 
apply your static label, you must specify relabel=yes.
 
287
\&\s-1LABEL\s0 without \s-1TYPE\s0 implies static configuration.
 
288
.Sp
 
289
To have libvirt automatically apply your static label, you must specify
 
290
relabel=yes. Otherwise disk images must be manually labeled by the admin,
 
291
including images that virt-install is asked to create.
285
292
.SS "Installation Method options"
286
293
.IX Subsection "Installation Method options"
287
294
.IP "\-c \s-1CDROM\s0, \-\-cdrom=CDROM" 2
425
432
.IX Item "debiansqueeze        : Debian Squeeze"
426
433
.IP "debianlenny          : Debian Lenny" 2
427
434
.IX Item "debianlenny          : Debian Lenny"
 
435
.IP "fedora17             : Fedora 17" 2
 
436
.IX Item "fedora17             : Fedora 17"
428
437
.IP "fedora16             : Fedora 16" 2
429
438
.IX Item "fedora16             : Fedora 16"
430
439
.IP "fedora15             : Fedora 15" 2
431
440
.IX Item "fedora15             : Fedora 15"
432
 
.IP "fedora14             : Fedora 14" 2
433
 
.IX Item "fedora14             : Fedora 14"
434
441
.IP "mageia1              : Mageia 1 and later" 2
435
442
.IX Item "mageia1              : Mageia 1 and later"
436
443
.IP "mes5.1               : Mandriva Enterprise Server 5.1 and later" 2
437
444
.IX Item "mes5.1               : Mandriva Enterprise Server 5.1 and later"
438
 
.IP "mandriva2010         : Mandriva Linux 2010 and later" 2
439
 
.IX Item "mandriva2010         : Mandriva Linux 2010 and later"
440
445
.IP "rhel6                : Red Hat Enterprise Linux 6" 2
441
446
.IX Item "rhel6                : Red Hat Enterprise Linux 6"
442
447
.IP "rhel5.4              : Red Hat Enterprise Linux 5.4 or later" 2
451
456
.IX Item "opensuse12           : openSuse 12"
452
457
.IP "opensuse11           : openSuse 11" 2
453
458
.IX Item "opensuse11           : openSuse 11"
 
459
.IP "ubuntuquantal        : Ubuntu 12.10 (Quantal Quetzal)" 2
 
460
.IX Item "ubuntuquantal        : Ubuntu 12.10 (Quantal Quetzal)"
 
461
.IP "ubuntuprecise        : Ubuntu 12.04 \s-1LTS\s0 (Precise Pangolin)" 2
 
462
.IX Item "ubuntuprecise        : Ubuntu 12.04 LTS (Precise Pangolin)"
454
463
.IP "ubuntuoneiric        : Ubuntu 11.10 (Oneiric Ocelot)" 2
455
464
.IX Item "ubuntuoneiric        : Ubuntu 11.10 (Oneiric Ocelot)"
456
465
.IP "ubuntunatty          : Ubuntu 11.04 (Natty Narwhal)" 2
457
466
.IX Item "ubuntunatty          : Ubuntu 11.04 (Natty Narwhal)"
458
 
.IP "ubuntumaverick       : Ubuntu 10.10 (Maverick Meerkat)" 2
459
 
.IX Item "ubuntumaverick       : Ubuntu 10.10 (Maverick Meerkat)"
460
 
.IP "ubuntulucid          : Ubuntu 10.04 (Lucid Lynx)" 2
461
 
.IX Item "ubuntulucid          : Ubuntu 10.04 (Lucid Lynx)"
 
467
.IP "ubuntulucid          : Ubuntu 10.04 \s-1LTS\s0 (Lucid Lynx)" 2
 
468
.IX Item "ubuntulucid          : Ubuntu 10.04 LTS (Lucid Lynx)"
462
469
.IP "ubuntuhardy          : Ubuntu 8.04 \s-1LTS\s0 (Hardy Heron)" 2
463
470
.IX Item "ubuntuhardy          : Ubuntu 8.04 LTS (Hardy Heron)"
464
471
.RE
490
497
.IX Item "--boot kernel=KERNEL,initrd=INITRD,kernel_args=console=/dev/ttyS0"
491
498
Have guest permanently boot off a local kernel/initrd pair, with the
492
499
specified kernel options.
 
500
.IP "\fB\-\-boot loader=BIOSPATH\fR" 2
 
501
.IX Item "--boot loader=BIOSPATH"
 
502
Use \s-1BIOSPATH\s0 as the virtual machine \s-1BIOS\s0. Only valid for fully virtualized
 
503
guests.
493
504
.RE
494
505
.RS 2
495
506
.RE
925
936
.IX Item "--soundhw MODEL"
926
937
Attach a virtual audio device to the guest. \s-1MODEL\s0 specifies the emulated
927
938
sound card model. Possible values are ich6, ac97, es1370, sb16, pcspk,
928
 
or default. 'default' will be \s-1AC97\s0 if the hypervisor supports it,
929
 
otherwise it will be \s-1ES1370\s0.
 
939
or default. 'default' will try to pick the best model that the specified
 
940
\&\s-1OS\s0 supports.
930
941
.Sp
931
 
This deprecates the old boolean \-\-sound model (which still works the same
 
942
This deprecates the old boolean \-\-sound option (which still works the same
932
943
as a single '\-\-soundhw default')
933
944
.IP "\-\-watchdog MODEL[,action=ACTION]" 2
934
945
.IX Item "--watchdog MODEL[,action=ACTION]"
1142
1153
.RE
1143
1154
.RS 2
1144
1155
.RE
 
1156
.IP "\-\-memballoon \s-1MODEL\s0" 2
 
1157
.IX Item "--memballoon MODEL"
 
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
.Sp
 
1161
\&\s-1MODEL\s0 is the type of memballoon device provided. The value can be 'virtio',
 
1162
\&'xen' or 'none'.
 
1163
Some examples:
 
1164
.Sp
 
1165
Use the recommended settings:
 
1166
.Sp
 
1167
\&\-\-memballoon virtio
 
1168
.Sp
 
1169
Do not use memballoon device:
 
1170
.Sp
 
1171
\&\-\-memballoon none
1145
1172
.SS "Miscellaneous Options"
1146
1173
.IX Subsection "Miscellaneous Options"
1147
1174
.IP "\-\-autostart" 2
1296
1323
.PP
1297
1324
.Vb 5
1298
1325
\&  # virt\-install \e
1299
 
\&       \-\-name demo
1300
 
\&       \-\-ram 512
1301
 
\&       \-\-disk /home/user/VMs/mydisk.img
 
1326
\&       \-\-name demo \e
 
1327
\&       \-\-ram 512 \e
 
1328
\&       \-\-disk /home/user/VMs/mydisk.img \e
1302
1329
\&       \-\-import
1303
1330
.Ve
1304
1331
.PP
1307
1334
.PP
1308
1335
.Vb 6
1309
1336
\&  # virt\-install \e
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"
 
1337
\&       \-\-name mykernel \e
 
1338
\&       \-\-ram 512 \e
 
1339
\&       \-\-disk /home/user/VMs/mydisk.img \e
 
1340
\&       \-\-boot kernel=/tmp/mykernel,initrd=/tmp/myinitrd,kernel_args="console=ttyS0" \e
1314
1341
\&       \-\-serial pty
1315
1342
.Ve
1316
1343
.SH "AUTHORS"