Upgrading Guests Commands
upgrade virtualization guest <guest-name> images <device> [routing-instance <name>]
Upgrades the guest images for multiple disks of a guest and powers the guest off and on.
None.
- guest-name
- The name of a guest.
- disk-id
- The number for a virtual disk.
- image-uri
- An image in QCOW2 or ISO-9660 format for the corresponding virtual disk.
- keep-old-images
- Specifies that the old images are not deleted.
- name
- Specifies the name of the routing instance to reach the remote host or hosts serving the disk image files. The default routing-instance is used if a value for the routing-instance keyword is not specified.
Operational mode.
Use this command to upgrade the guest images for multiple disks of a guest and power the guest off and on.
If device-type is disk, the QCOW2 format is supported. If device type is cdrom, the ISO-9660 format is supported.
The command replaces the disk image of a virtual disk for a guest with another guest image. The command also powers the guest off and on. The image may be local or remote. When a routing instance is specified, it is used to reach all remote hosts that are specified. For information about VRF configuration, refer to the VRF Support chapter in the . You must use fully qualified path names for the image files. You can upgrade multiple disks for a guest with one command. Any existing images that conflict with the new images are overwritten during an upgrade. The configuration is saved if changes were made to it during the upgrade. Any images which were previously used by the disks being upgraded are deleted after an upgrade, if they are not overwritten during the upgrade. The keep-old-images option prevents the deletion of old images.
During a deployment or upgrade, the disk images are moved from their current, specified location, and not copied, if they are local.
For more information, refer to Upgrading Guests.
upgrade virtualization xml <xml-file> [ image <image-file> ] [ iso <iso-file> ] [ keep-old-images ] [routing-instance <name>]
Reconfigures a guest according to a libvirt domain XML file and optionally upgrade the guest image and ISO files.
upgrade virtualization xml xml-file [ image image-file] [ iso iso-file ] [ keep-old-images ] [ routing-instance name ]
None.
- xml-file
- A libvirt domain XML file.
- image-file
- An image file.
- iso-file
- An ISO file.
- keep-old-images
- Specifies the retention of old images.
- name
- Specifies the name of the routing instance to reach the remote host or hosts serving the XML, disk image or ISO files. The default routing-instance is used if a value for the routing-instance keyword is not specified.
Operational mode.
Use this command to reconfigure a guest according to a libvirt domain XML file and optionally upgrade the guest image and ISO files.
The command reconfigures an existing guest according to the parameters that are defined within an XML file. The XML file must contain the same guest name as the guest being upgraded. If a disk image is not specified in the command, the current guest image is retained for the new configuration. If an ISO file is not specified in the command, the current ISO image of the guest is retained for the new configuration. The files may be local or remote. When a routing instance is specified, it is used to reach all remote hosts that are specified. Use fully qualified path names for the files. If an image or ISO file is specified, any existing files that conflict are overwritten during the upgrade. If the existing guest configuration has more than one disk or CDROM drive, the extra disks are lost during the upgrade. The configuration is saved if changes were made to it during the upgrade. The keep-old-images option prevents the deletion of old images.
During a deployment or upgrade, the disk images are moved from their current, specified location, and not copied, if they are local.