← 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.1

  • Committer: Bazaar Package Importer
  • Author(s): Guido Günther
  • Date: 2009-12-07 10:04:22 UTC
  • mto: (1.6.3 sid)
  • mto: This revision was merged to the branch mainline in revision 20.
  • Revision ID: james.westby@ubuntu.com-20091207100422-2izjffd5ljvqun47
Tags: upstream-0.500.1
Import upstream version 0.500.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/en/virt-install.1
132
132
.\" ========================================================================
133
133
.\"
134
134
.IX Title "VIRT-INSTALL 1"
135
 
.TH VIRT-INSTALL 1 "2009-07-28" "perl v5.10.0" "Virtual Machine Install Tools"
 
135
.TH VIRT-INSTALL 1 "2009-12-03" "" "Virtual Machine Install Tools"
136
136
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
137
137
.\" way too many mistakes in technical documents.
138
138
.if n .ad l
238
238
Optimize the guest configuration for a type of operating system (ex. 'linux',
239
239
\&'windows'). This will attempt to pick the most suitable \s-1ACPI\s0 & \s-1APIC\s0 settings,
240
240
optimally supported mouse drivers, virtio, and generally accommodate other
241
 
operating system quirks. See \f(CW\*(C`\-\-os\-variant\*(C'\fR for valid options.
 
241
operating system quirks.
 
242
.Sp
 
243
By default, virt-install will attempt to auto detect this value from
 
244
the install media (currently only supported for \s-1URL\s0 installs). Autodetection
 
245
can be disabled with the special value 'none'
 
246
.Sp
 
247
See \f(CW\*(C`\-\-os\-variant\*(C'\fR for valid options.
242
248
.IP "\-\-os\-variant=OS_VARIANT" 2
243
249
.IX Item "--os-variant=OS_VARIANT"
244
250
Further optimize the guest configuration for a specific operating system
245
251
variant (ex. 'fedora8', 'winxp'). This parameter is optional, and does not
246
 
require an \f(CW\*(C`\-\-os\-type\*(C'\fR to be specified. Valid values are:
 
252
require an \f(CW\*(C`\-\-os\-type\*(C'\fR to be specified.
 
253
.Sp
 
254
By default, virt-install will attempt to auto detect this value from
 
255
the install media (currently only supported for \s-1URL\s0 installs). Autodetection
 
256
can be disabled with the special value 'none'.
 
257
.Sp
 
258
Valid values are:
247
259
.RS 2
248
260
.IP "linux" 4
249
261
.IX Item "linux"
283
295
.IP "fedora12" 4
284
296
.IX Item "fedora12"
285
297
Fedora 12
 
298
.IP "fedora13" 4
 
299
.IX Item "fedora13"
 
300
Fedora 13
286
301
.IP "generic24" 4
287
302
.IX Item "generic24"
288
303
Generic 2.4.x kernel
304
319
.IP "rhel5" 4
305
320
.IX Item "rhel5"
306
321
Red Hat Enterprise Linux 5
 
322
.IP "rhel5.4" 4
 
323
.IX Item "rhel5.4"
 
324
Red Hat Enterprise Linux 5.4 or later
 
325
.IP "rhel6" 4
 
326
.IX Item "rhel6"
 
327
Red Hat Enterprise Linux 6
307
328
.IP "sles10" 4
308
329
.IX Item "sles10"
309
330
Suse Linux Enterprise Server
411
432
.RE
412
433
.RS 4
413
434
.RE
 
435
.IP "none" 4
 
436
.IX Item "none"
 
437
No \s-1OS\s0 version specified (disables autodetect)
414
438
.RE
415
439
.RS 2
416
440
.RE
602
626
\&    \-\-disk opt1=val1,opt2=val2,...
603
627
.Ve
604
628
.Sp
605
 
To specify media, one of the following options is required:
 
629
To specify media, the command can either be:
 
630
.Sp
 
631
.Vb 1
 
632
\&    \-\-disk /some/storage/path,opt1=val1
 
633
.Ve
 
634
.Sp
 
635
or explicitly specify one of the following arguments:
606
636
.RS 2
607
637
.IP "\fBpath\fR" 4
608
638
.IX Item "path"
659
689
The cache value can be 'none', 'writethrough', or 'writeback'.
660
690
\&'writethrough' provides read caching. 'writeback' provides
661
691
read and write caching.
 
692
.IP "\fBformat\fR" 4
 
693
.IX Item "format"
 
694
Image format to be used if creating managed storage. For file volumes, this
 
695
can be 'raw', 'qcow2', 'vmdk', etc. See format types in
 
696
<http://libvirt.org/storage.html> for possible values.
662
697
.RE
663
698
.RS 2
664
699
.Sp
762
797
Use 0.0.0.0 to allow access from other machines.
763
798
.IP "\-k \s-1KEYMAP\s0, \-\-keymap=KEYMAP" 2
764
799
.IX Item "-k KEYMAP, --keymap=KEYMAP"
765
 
Request that the virtual \s-1VNC\s0 console be configured to run with a non-English
766
 
keyboard layout.
 
800
Request that the virtual \s-1VNC\s0 console be configured to run with a specific
 
801
keyboard layout. If the special value 'local' is specified, virt-install
 
802
will attempt to configure to use the same keymap as the local system. A value
 
803
of 'none' specifically defers to the hypervisor. Default behavior is
 
804
hypervisor specific, but typically is the same as 'local'.
767
805
.IP "\-\-sdl" 2
768
806
.IX Item "--sdl"
769
807
Setup a virtual console in the guest and display an \s-1SDL\s0 window in the
898
936
\&  # virt\-install \e
899
937
\&       \-\-name demo
900
938
\&       \-\-ram 512
901
 
\&       \-\-disk path=/home/user/VMs/mydisk.img
 
939
\&       \-\-disk /home/user/VMs/mydisk.img
902
940
\&       \-\-import
903
941
.Ve
904
942
.SH "AUTHORS"