Editing virtual machines

You can update a virtual machine configuration using either the YAML editor in the web console or the OpenShift CLI on the command line. You can also update a subset of the parameters in the Virtual Machine Details screen.

Editing a virtual machine in the web console

You can edit a virtual machine by using the OKD web console or the command line interface.

Procedure

1. Navigate to Virtualization → VirtualMachines in the web console.

2. Select a virtual machine to open the VirtualMachine details page.

3. Click any field that has the pencil icon, which indicates that the field is editable. For example, click the current Boot mode setting, such as BIOS or UEFI, to open the Boot mode window and select an option from the list.

4. Click Save.

Editing a virtual machine YAML configuration using the web console

You can edit the YAML configuration of a virtual machine in the web console. Some parameters cannot be modified. If you click Save with an invalid configuration, an error message indicates the parameter that cannot be changed.

Procedure

1. Click Virtualization → VirtualMachines from the side menu.

2. Select a virtual machine.

3. Click the YAML tab to display the editable configuration.

4. Optional: You can click Download to download the YAML file locally in its current state.

5. Edit the file and click Save.

A confirmation message shows that the modification has been successful and includes the updated version number for the object.

Editing a virtual machine YAML configuration using the CLI

Use this procedure to edit a virtual machine YAML configuration using the CLI.

Prerequisites

• You configured a virtual machine with a YAML object configuration file.

• You installed the oc CLI.

Procedure

1. Run the following command to update the virtual machine configuration:

   $ oc edit <object_type> <object_ID>

2. Open the object configuration.

3. Edit the YAML.

4. If you edit a running virtual machine, you need to do one of the following:

   • Restart the virtual machine.

   • Run the following command for the new configuration to take effect:

     $ oc apply <object_type> <object_ID>

Adding a virtual disk to a virtual machine

Use this procedure to add a virtual disk to a virtual machine.

Procedure

1. Click Virtualization → VirtualMachines from the side menu.

2. Select a virtual machine to open the VirtualMachine details page.

3. On the Configuration → Disks tab, click Add disk.

4. Specify the Source, Name, Size, Type, Interface, and Storage Class.

   1. Optional: You can enable preallocation if you use a blank disk source and require maximum write performance when creating data volumes. To do so, select the Enable preallocation checkbox.

   2. Optional: You can clear Apply optimized StorageProfile settings to change the Volume Mode and Access Mode for the virtual disk. If you do not specify these parameters, the system uses the default values from the kubevirt-storage-class-defaults config map.

5. Click Add.

To configure storage class defaults, use storage profiles. For more information, see Customizing the storage profile.

Storage fields

Advanced storage settings

The following advanced storage settings are optional and available for Blank, Import via URL, and Clone existing PVC disks. Before OKD Virtualization 4.11, if you do not specify these parameters, the system uses the default values from the kubevirt-storage-class-defaults config map. In OKD Virtualization 4.11 and later, the system uses the default values from the storage profile.

Adding a secret, config map, or service account to a virtual machine

You add a secret, config map, or service account to a virtual machine by using the OKD web console.

These resources are added to the virtual machine as disks. You then mount the secret, config map, or service account as you would mount any other disk.

If the virtual machine is running, changes do not take effect until you restart the virtual machine. The newly added resources are marked as pending changes at the top of the page.

Prerequisites

• The secret, config map, or service account that you want to add must exist in the same namespace as the target virtual machine.

Procedure

1. Click Virtualization → VirtualMachines from the side menu.

2. Select a virtual machine to open the VirtualMachine details page.

3. Click Configuration → Environment.

4. Click Add Config Map, Secret or Service Account.

5. Click Select a resource and select a resource from the list. A six character serial number is automatically generated for the selected resource.

6. Optional: Click Reload to revert the environment to its last saved state.

7. Click Save.

Verification

1. On the VirtualMachine details page, click Configuration → Disks and verify that the resource is displayed in the list of disks.

2. Restart the virtual machine by clicking Actions → Restart.

You can now mount the secret, config map, or service account as you would mount any other disk.

Additional resources for config maps, secrets, and service accounts

• Understanding config maps

• Providing sensitive data to pods

• Understanding and creating service accounts

Adding a network interface to a virtual machine

Use this procedure to add a network interface to a virtual machine.

Procedure

1. Click Virtualization → VirtualMachines from the side menu.

2. Select a virtual machine to open the VirtualMachine details page.

3. On the Configuration → Network interfaces tab, click Add Network Interface.

4. In the Add Network Interface window, specify the Name, Model, Network, Type, and MAC Address of the network interface.

5. Click Add.

Networking fields