Commit Graph

248 Commits

Author SHA1 Message Date
Cole Robinson
1b38612a64 man: virt-install: Drop finegrained --network virtualport docs
We shouldn't be duplicating libvirt documentation here. If someone
needs <virtualport> config, they are likely working backwards from
working XML and trying to figure out the command line. Drop most
of the details
2019-05-12 18:21:49 -04:00
Cole Robinson
b77d0e2d9f man: virt-install: update --disk section
Clearly separate storage creation and device config options. Lots
of tweaks to various suboption sections.
2019-05-12 18:08:43 -04:00
Cole Robinson
e364ecf69b man: virt-install: tweak --filesystem docs
'mode' is 'accessmode' these days
2019-05-12 17:29:10 -04:00
Cole Robinson
2d80a0b4b9 cli: Add --memory opts to match XML names
Sort out the memory property naming ambiguity on the command line.

* memory -> currentMemory
* maxmemory -> memory
* hotplugmemorymax -> maxMemory
* hotplugmemoryslots -> maxMemory.slots

To maintain back compat, we need to do some funky handling with
memory and maxmemory values. Basically if currentMemory is specfied,
we interpret them as new style, otherwise preserve the old behavior.
2019-05-12 17:25:47 -04:00
Cole Robinson
7f9e21f9b5 cli: Rename boot_order to boot.order
And add a backcompat alias to match
2019-05-12 17:25:47 -04:00
Pavel Hrdina
22342ef7ee cli: introduce CPU secure parameter
This will allow users to override the default behavior of virt-install
which copies CPU security features available on the host to the guest
XML if specific CPU model is configured.

Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
2019-04-04 13:40:20 +02:00
Cole Robinson
39bb8968d0 virt-install: add --location LOCATION,kernel=X,initrd=X
Add kernel= and initrd= --location suboptions. These can be
used to override the default kernel/initrd and specify new
paths, relative to LOCATION.

For example, if you have an ISO that libosinfo doesn't know
about called my-unknown.iso, with a kernel at 'kernel/fookernel'
and initrd at +'kernel/fooinitrd', you can make this work with:

--location my-unknown.iso,kernel=kernel/fookernel,initrd=kernel/fooinitrd
2019-02-03 12:05:18 -05:00
Cole Robinson
27445527dc man: virt-install: Update --cdrom and --location docs
Drop a lot of outdated info and simplify things
2019-02-03 12:05:18 -05:00
Ken Dreyer
fe2564530a doc: update Fedora versions
Fedora 20 and 25 are end-of-life. Update to a modern Fedora version.
2019-01-29 10:37:59 -05:00
Kenyon Ralph
957815397d virt-install.pod: make example command match commentary
The example commentary says Fedora 20, so make the command line match that.
2019-01-21 16:01:02 +01:00
Andrea Bolognani
ade53764fc virt-xml: Accept --os-variant option
We're not doing anything with it yet, but having the
parser accept it means we can write tests and see how
their output changes once we wire it up in earnest.

Signed-off-by: Andrea Bolognani <abologna@redhat.com>
2018-11-13 12:08:46 +01:00
Andrea Bolognani
751fb88c58 virt-install: Add "Guest OS" options group
The --os-variant option doesn't quite fit perfectly into
its current "Installation method" group, plus we want to
add the same option to virt-xml which can't have that
group for obvious reasons.

Signed-off-by: Andrea Bolognani <abologna@redhat.com>
2018-11-12 16:15:33 +01:00
Andrea Bolognani
a550a95727 virt-install: Fix description for --os-variant
Since we're messing with it either way, might as well use
modern OS names as examples.

Signed-off-by: Andrea Bolognani <abologna@redhat.com>
2018-11-12 16:15:33 +01:00
Martin Kletzander
9308bae310 util: Fix typo vpcu -> vcpu
Signed-off-by: Martin Kletzander <mkletzan@redhat.com>
2018-10-22 15:05:30 +01:00
Cole Robinson
42a96cfd59 virt-install: add --destroy-on-exit
This makes the console window behave like a raw qemu command line:
when the user closes it, the VM is hard powered off.
2018-10-11 15:24:16 -04:00
Lubomir Rintel
3a4cf07a28 virtinst: allow adding host block devices to LXC containers
Signed-off-by: Lubomir Rintel <lkundrak@v3.sk>
2018-06-19 15:07:45 -04:00
Lubomir Rintel
a2a022a879 virtinst: allow adding host character devices to LXC containers
Signed-off-by: Lubomir Rintel <lkundrak@v3.sk>
2018-06-19 15:07:42 -04:00
Lubomir Rintel
bba3d04558 virtinst: allow adding host network devices to LXC containers
Signed-off-by: Lubomir Rintel <lkundrak@v3.sk>
2018-06-19 15:05:28 -04:00
Cole Robinson
7a2abb5abf installer: Remove --location nfs support
Removal was discussed here:
https://www.redhat.com/archives/virt-tools-list/2018-May/msg00011.html

Basically I don't think many people use this, the feature is very
inflexible, it's hard to test, and users can essentially do it
themselves with a bit more effort.
2018-06-12 14:07:50 -04:00
Daniel P. Berrangé
b1460ba065 Chagne most URIs to use https:// instead of http://
All URLs were checked to see if they supported https://, those which did
were converted.

Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
2018-04-30 13:35:39 -04:00
David H. Gutteridge
ec2c62f110 man: virt-xml: Note --update implies --define 2018-04-06 11:12:52 -04:00
Cole Robinson
c9b2ec163f preferences: Add UI for disabling spice usb autoredir
We already have a gconf key and command line option for this.
Drop the CLI option and add UI for it, we should have just done
that to begin with
2018-03-16 14:38:22 -04:00
Cole Robinson
30cc70ccf4 virt-manager: Drop --no-conn-autostart
It was mildly interesting back before libvirt supported threads but
I don't think anyone cares about it now.
2018-03-16 14:19:35 -04:00
Nicolas Bock
27d4b167d5 Update --location for OpenSUSE
OpenSUSE is currently at Leap 42.3. This change updates the man page
for virt-install to point to the current repository.
2018-03-07 09:27:38 +01:00
Cole Robinson
5141e73416 man: Fix libvirt doc reference for startup_policy
Reported-by: Digimer <lists@alteeve.ca>
2018-02-06 10:24:32 -05:00
Wim ten Have
708516c39e virtinst: add vcpupin support
Add vcpupin support to virt-install so that it can create guest
domains with statically allocated vcpu pinning towards a given cpuset.

Syntax: to pin vcpu=0 to cpuset="1,3" and vcpu=1 to cpuset=2

  --cputune vcpupin0.vcpu=0,vcpupin0.cpuset=1,3,vcpupin1.vcpu=1,vcpupin1.cpuset=2

generates below XML description for the guest domain.

  <cputune>
    <vcpupin vcpu="0" cpuset="1,3"/>
    <vcpupin vcpu="1" cpuset="2"/>
  </cputune>

Signed-off-by: Wim ten Have <wim.ten.have@oracle.com>
Signed-off-by: Menno Lageman <menno.lageman@oracle.com>
2018-02-06 10:21:56 -05:00
David Rabel
9cbf7efb16 Fix typo in virt-convert man page
'VMX of OVF' -> 'VMX or OVF'
2017-10-26 10:34:33 +02:00
Lin Ma
40f70d4fe5 virt-install: add param cache.mode and cache.level for option '--cpu'
libvirt supports guest CPU cache by commit df13c0b, So add this feature
to virt-install to configure cpu L3 cache mode.

Currently, The valid values are 'passthrough', 'emulate' or 'disable'.
say:
  --cpu host-passthrough,cache.mode=passthrough
or
  --cpu $CPU,cache.mode=emulate,cache.level=3
or
  --cpu $CPU,cache.mode=disable

Signed-off-by: Lin Ma <lma@suse.com>
2017-09-14 18:54:01 -04:00
Pavel Hrdina
af91d51fc8 cli: introduce snapshot_policy parameter for disk device
This allows to configure snapshot behavior for each disk.

Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1430642

Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
2017-09-12 08:58:31 +02:00
Pavel Hrdina
36230c9a18 devicepanic: use model instead of address.type
There are multiple models of the panic device, the address type is only
one and is valid only for "isa" model.

To not break the virt-install/virt-xml the command line parser needs to
be updated.  Before this patch there was only one parameter that
configured the "iobase".  Now the first parameter configures a model
but to keep it backward compatible it follows these rules:

1. there is only one parameter and it matches known model:

  --panic isa

  <panic model='isa'>
    <address iobase='0x505' type='isa'/>
  </panic>

2. there is only one parameter and it doesn't match any model:

  --panic 0x505

  <panic model='isa'>
    <address iobase='0x505' type='isa'/>
  </panic>

3. there are two parameters:

  --panic isa,iobase=0x505

  <panic model='isa'>
    <address iobase='0x505' type='isa'/>
  </panic>

Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
2017-09-09 10:09:46 +02:00
Cole Robinson
640e559774 man: virt-install: Make some VNC references more generic
Since these parameters apply to SPICE too
2017-07-14 19:48:56 -04:00
Cole Robinson
7bfe9d9d72 man: virt-install: Give a --cpu cell example (bz 1465368)
https://bugzilla.redhat.com/show_bug.cgi?id=1465368
2017-06-27 12:19:02 -04:00
Pavel Hrdina
24f9d05329 virt-install: add support for loader secure attribute
Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
2017-06-01 09:58:46 +02:00
Pavel Hrdina
f38c56c971 virt-install: add support for SMM feature
Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
2017-06-01 09:58:46 +02:00
Cole Robinson
ebd2f1dcee man: virt-install: Don't reference deprecated --cpuset 2017-05-05 12:21:44 -04:00
Pavel Hrdina
a2985f07e6 virtinst: add support for memory device
This is the actual memory device that is used to hot(un)plug memory
to(from) a guest.

Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
2017-05-05 12:20:52 +02:00
Pavel Hrdina
3ebbeef80e virtinst: introduce support for <maxMemory> element
This element controls hot(un)plugable memory for the guest in
addition to the initial memory configured by <memory> element.

One has to configure <maxMemory> and guest numa nodes using <numa>
element to enable hot(un)plug of memory modules.

Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
2017-05-05 11:49:27 +02:00
Chen Hanxiao
407915b489 virt-xml: add qemu commandline passthrough example
We forgot to mention --qemu-commandline in virt-xml.pod.
Also added an example copied from Cole's blog.

Signed-off-by: Chen Hanxiao <chenhanxiao@gmail.com>
2017-03-29 23:51:42 +08:00
Yaniv Kaul
7d221d51f1 Update virt-install man with path to Fedora 25 ISO
The path was to an outdated Fedora 21. Updated for Fedora 25.
2017-03-27 16:20:01 -04:00
Pavel Hrdina
5e2b63c1ff virt-clone: add support to clone nvram VARS
Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1243335

Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
2017-03-07 13:06:20 +01:00
Cole Robinson
191896d0dc cli: Add --qemu-commandline option 2017-03-06 22:15:46 -05:00
Marc-André Lureau
dffb2aaa2d virtinst/cli: add spice rendernode argument
Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
2017-02-23 18:31:43 -05:00
David H. Gutteridge
2b9d468176 Add caveats section to virt-xml.pod
Caveats section added to warn users that some changes made to a VM's definition may be ignored by the virtualization host.
2017-02-09 16:33:00 -05:00
Pavel Hrdina
888fcf7aec man/virt-install: remove -c as short for --connect
Argument -c is short for --cdrom so fix the man page.

Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1366241

Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
2017-01-18 09:48:56 +01:00
Pavel Hrdina
45a3d50668 man: virt-install: keymap is valid for spice graphics as well
Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1399091

Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
2017-01-13 13:20:47 +01:00
Cole Robinson
63784f4dd8 man: Document new --sysinfo option 2016-09-08 11:42:45 -04:00
Chen Hanxiao
c050bf45fa virt-install: fix a wrong example
add the missed backslash.

Signed-off-by: Chen Hanxiao <chenhanxiao@gmail.com>
2016-08-28 20:57:58 +08:00
Richard W.M. Jones
246e3c9c59 virtinst: Add --transient flag.
If this flag is specified, --import|--boot will create a transient
libvirt domain, ie. one which goes away when the guest shuts down or
the host is rebooted.

(crobinso: some tweaks and tests)
2016-06-17 12:20:24 -04:00
Cole Robinson
8d4e58c501 cli: Add --disk backing_format= option 2016-06-16 20:09:37 -04:00
Cole Robinson
14fd99255b cli: add --graphics listen=socket support
This is the new style socket support, where we request libvirt to
allocate a socket path for us. Plus this is the only way to enable
socket support for type=spice
2016-06-11 16:56:41 -04:00
Cole Robinson
2b34831b26 cli: Add device address.type/address.bus/... options
This exposes every device <address> option, for each device
cli option. So --disk, --network, --video, etc.

Fill out a few more address XML bits as well
2016-06-11 16:10:31 -04:00
Pavel Hrdina
df1c3e74aa virt-install: add a new guest feature GIC for ARM guests
Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1334857

Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
2016-06-11 18:41:31 +02:00
Marc-André Lureau
8aead7619c virtinst: add listen=none graphics option
Add a special listen value to disable any extra display server listening
socket. This is necessary now that qemu prevents starting a spice+virgl
VM with listening sockets (until spice allows remoting with virgl).

Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
2016-05-20 14:51:31 -04:00
Pavel Hrdina
21e29a4178 man: virt-manager: properly indent --spice-disable-auto-usbredir
Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1331633

Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
2016-05-20 15:30:57 +02:00
Marc-André Lureau
8ba48f5299 virtinst: add virtio device model and accel3d attribute
Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
2016-03-09 20:25:37 -05:00
Marc-André Lureau
f912f28e97 virtinst: add --graphics gl option
Add a --graphics option to enable accelarated rendering using
OpenGl. This is used only by Spice (and for local only guests atm).

Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
2016-03-09 20:25:37 -05:00
Cole Robinson
83bd112d06 man: virt-install: Fix typo (bz 1313101) 2016-03-01 11:35:44 -05:00
Kothapally Madhu Pavan
f801a7e4ec man: virt-install: Documenting boot_order parameter
virt-install man page doesn't have boot_order documentation.
This patch documents boot_order.

Signed-off-by: Kothapally Madhu Pavan <kmp@linux.vnet.ibm.com>
2015-11-23 14:05:55 -05:00
Cole Robinson
778eba5e2a man: virt-xml: Tweak some of the examples 2015-11-21 11:00:17 -05:00
Pavel Hrdina
68f0b05720 man: virt-install: fix a typo in examples
There is no parameter --disks, it should be --disk.

Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1263900

Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
2015-10-26 17:56:32 +01:00
Abhijeet Kasurde
d7e678cb28 Added support pvspinlock in features
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
2015-10-05 15:14:34 -04:00
Cole Robinson
3825d853f3 man: Add an explicit Ubuntu URL example 2015-09-23 18:06:53 -04:00
Pavel Hrdina
39da70a456 Added option to enable kvm_hidden feature in virt-install cmd-line
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
2015-09-08 12:03:04 +02:00
Cole Robinson
7786c4b35b xmlbuilder: Make clear() work for child objects
So we can call clear() on a Guest owned VirtualDisk, and it actually
does the correct thing. This allows us to enable clearxml= cli option
for most devices.
2015-09-05 13:16:35 -04:00
Daniel P. Berrange
df92749286 virt-install: document virtual port profile parameters
Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2015-08-28 12:40:19 +01:00
Pavel Hrdina
3a3a1d5bd4 doc: make --sparse documentation in man page consistent
Commit 549c93be fixed a man page to make --sparse documentation
consistent, but it forget to updated also the next paragraph.

Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1210572

Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
2015-06-21 12:47:59 +02:00
Cole Robinson
34a19e497e man: virt-xml: Fix example 2015-05-10 18:10:21 -04:00
Cole Robinson
93f826a8b2 cli: Replace add --check option (bz 1063471)
For fine grained enabling/disabling validation checks. Use this to
replace the heavy handed --force option.
2015-04-11 19:48:35 -04:00
Giuseppe Scrivano
1f6faa33dc doc: make clearer what usb2 and usb3 means to --controller
Closes: https://bugzilla.redhat.com/show_bug.cgi?id=1204895

Signed-off-by: Giuseppe Scrivano <gscrivan@redhat.com>
2015-04-10 13:05:09 +02:00
Giuseppe Scrivano
549c93be5f doc: make --sparse documentation consistent with error message
Closes: https://bugzilla.redhat.com/show_bug.cgi?id=1210572

Signed-off-by: Giuseppe Scrivano <gscrivan@redhat.com>
2015-04-10 13:05:09 +02:00
Cole Robinson
527c49dec2 virt-install: Add --input option
For configuring VM <input> devices
2015-04-09 13:22:40 -04:00
Cole Robinson
e31c0cf562 man: Bunch of formatting improvements 2015-04-04 17:57:19 -04:00
Cole Robinson
3d6831ec8f virt-install: Deprecate --print-step, just use --print-xml
argparse lets us handle this in a back compat fashion, so let's simplify
the CLI.
2015-04-04 17:10:45 -04:00
Cole Robinson
4e9f70f9b3 Drop all references to kqemu, it's long dead 2015-04-03 16:45:43 -04:00
Cole Robinson
2f2ab1438f man: Use F21 URL for --location example (bz 1172818)
Because newer fedora has a different URL format
2015-03-26 16:18:25 -04:00
Giuseppe Scrivano
24e489e88a man: replace "--boot bootmenu=on" with "--boot menu=on"
Closes: https://bugzilla.redhat.com/show_bug.cgi?id=1192768

Signed-off-by: Giuseppe Scrivano <gscrivan@redhat.com>
2015-02-24 14:19:00 +01:00
Cole Robinson
a04307cd70 virt-install: Add --boot uefi
Will enable UEFI if we know libvirt + hypervisor support it, and libvirt
is advertising a suitable UEFI binary.
2015-02-22 10:25:47 -05:00
Giuseppe Scrivano
74c5aa82a9 virt-install: document cache mode 'unsafe' and 'directsync'
Signed-off-by: Giuseppe Scrivano <gscrivan@redhat.com>
2015-02-13 16:00:24 +01:00
Chen Hanxiao
302a0bf075 man: add man page for virt-clone --reflink
Signed-off-by: Chen Hanxiao <chenhanxiao@cn.fujitsu.com>
2015-02-07 10:18:19 +08:00
Cole Robinson
8a96406902 man: Document --disk $URL format 2014-12-10 13:22:42 -05:00
Cole Robinson
e992cc15b2 virt-xml: Disable clearxml= for devices
It doesn't work in the general case, and users can just --remove and
--add devices as needed for the same effect
2014-12-04 15:28:14 -05:00
Chen Hanxiao
52744fadf8 man: update binary prefixes for units in virt-install man page
Signed-off-by: Chen Hanxiao <chenhanxiao@cn.fujitsu.com>
2014-10-06 09:50:55 +08:00
Giuseppe Scrivano
4c978f70cb doc, virt-clone: make --quiet consistent with --help output
Signed-off-by: Giuseppe Scrivano <gscrivan@redhat.com>
2014-09-30 14:33:05 +02:00
Giuseppe Scrivano
bfeed049b8 doc, virt-install: do not use obsoleted --file/--file-size
Signed-off-by: Giuseppe Scrivano <gscrivan@redhat.com>
2014-09-30 14:33:05 +02:00
Cole Robinson
d7e1a40352 virt-install: Deprecate --nodisks in favor of --disk none 2014-09-20 19:16:13 -04:00
Cole Robinson
57ae284ad4 virt-install: Deprecate --nonetworks in favor of --network none
Follows the pattern used by the other cli options
2014-09-20 19:02:38 -04:00
Cole Robinson
6a8194ebc7 docs: Document virtio-scsi better, and add explicit test cases for it 2014-09-20 15:03:19 -04:00
Cole Robinson
5130d959e5 cli: Advertise the --host-device option as --hostdev
It annoys me that all the other CLI options map to the libvirt XML name,
except this one. Of course, keep the old option around for back compat,
just give precendence to the new option.
2014-09-20 14:29:34 -04:00
Cole Robinson
f42e9bf8d4 man: virt-install: Drop overly specific bits about full virt 2014-09-19 20:54:08 -04:00
Laszlo Ersek
d2fffa509e virt-install: add support for OVMF
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
2014-09-16 09:47:02 +02:00
Giuseppe Scrivano
0218d29a35 virtinst: add ich9 to the list of audio models
Signed-off-by: Giuseppe Scrivano <gscrivan@redhat.com>
2014-09-16 09:04:14 +02:00
Cole Robinson
a722eeac78 virt-install: Enable libosinfo detection for --cdrom
This streamlines virt-manager and virt-install implementations, requiring
installer.distro_detect to be called if we want distro detection. As
a side effect, we now get CDROM detection for free.
2014-09-07 12:20:26 -04:00
Cole Robinson
5aafe008bc Remove virt-image, as scheduled
As promised with the last release, remove virt-image. In 6 months I didn't
hear a peep from any actual users that cared.
2014-09-06 18:05:43 -04:00
Giuseppe Scrivano
e22d841d2c man, virt-clone: document --quiet
Signed-off-by: Giuseppe Scrivano <gscrivan@redhat.com>
2014-08-04 14:25:49 +02:00
Giuseppe Scrivano
2803445f85 man: add empty line after --spice-disable-auto-usbredir
Signed-off-by: Giuseppe Scrivano <gscrivan@redhat.com>
2014-08-01 11:30:18 +02:00
Cole Robinson
1e77c05c4e Clarify some translation strings, reported on transifex 2014-07-04 16:42:24 -04:00
Chen Hanxiao
99df0057f5 man: fix an incorrect description in virt-install man page
Actually --pm accepts suspend_to_mem rather than suspend_to_ram.

Signed-off-by: Chen Hanxiao <chenhanxiao@cn.fujitsu.com>
2014-06-04 16:39:23 +08:00
Chen Hanxiao
d1b0fade1d virt-install: add --resource support
This patch will enable setting
resource partition configuration.

Signed-off-by: Chen Hanxiao <chenhanxiao@cn.fujitsu.com>
2014-06-04 10:08:05 +08:00
Chen Hanxiao
3c45262526 virt-install: add --events support
This patch will enable setting event configuration:
on_poweroff, on_reboot and on_crash.

Signed-off-by: Chen Hanxiao <chenhanxiao@cn.fujitsu.com>
2014-05-29 09:46:24 +08:00
Giuseppe Scrivano
78caf0d5da doc, virt-install: add "lun" to the Disk device type list
Closes: https://bugzilla.redhat.com/show_bug.cgi?id=1077232

Signed-off-by: Giuseppe Scrivano <gscrivan@redhat.com>
2014-05-05 15:23:34 +02:00