Commit Graph

246 Commits

Author SHA1 Message Date
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
Jim Minter 764063dfe9 virt-install --disk discard= support
(crobinso: Remove default overriding, add test cases)
2014-04-29 10:38:30 -04:00
Chen Hanxiao 01718bc408 man: update virt-manager bugreporting URL
Now we use http://virt-manager.org/bugs/ as
bug reporting page.
Although old URL will be redirected to this one,
direct URL would be better.

Signed-off-by: Chen Hanxiao <chenhanxiao@cn.fujitsu.com>
2014-04-01 23:08:30 +08:00