4.1. Managing virtual machines¶

4.1.1. Supported guest operating systems¶

The following guest operating systems have been tested and are supported in virtual machines:

4.1.2. Creating virtual machines¶

Before you proceed to creating VMs, check that you have these:

• A guest OS source (refer to Managing images):

  • A distribution ISO image of a guest OS to install in the VM

  • A template that is a boot volume in the QCOW2 format

  • A boot volume

    Note

    To obtain a boot volume, create a volume, as described in Managing compute volumes, attach it to a VM, install an operating system in it, and then delete the VM.

• One or more compute networks (refer to Managing virtual networks)

• An SSH key (refer to Managing SSH keys)

  Note

  You can specify an SSH key only when creating VMs from a template or boot volume.

To create a VM, do the following:

1. On the Virtual machines screen, click Create virtual machine. A window will open where you will need to specify the VM parameters.

   

2. Specify a name for the new VM.

3. Select the VM boot media:

   • If you have an ISO image or a template, do the following:

     1. Select Image in the Deploy from section, and then click Specify in the Image section.

     2. In the Images window, select the ISO image or template, and then click Done.

        

   • If you have a compute boot volume, do the following:

     1. Select Volume in the Deploy from section, and then click Specify in the Volumes section.

     2. In the Volumes window, click Attach.

     3. In the Attach volume window, find and select the volume, and then click Attach.

        

        If you attach more than one volume, the first attached volume becomes the boot volume, by default. To select another volume as bootable, place it first in the list by clicking the up arrow button next to it.

   After selecting the boot media, volumes required for this media to boot will be automatically added to the Volumes section.

4. Configure the VM disks:

   1. In the Volumes window, make sure the default boot volume is large enough to accommodate the guest OS. Otherwise, click the ellipsis icon next to it, and then Edit. Change the volume size and click Save.
   2. (Optional) Add more disks to the VM by creating or attaching volumes. To do this, click the pencil icon in the Volumes section, and then Add or Attach in the Volumes window.
   3. Select volumes that will be removed during the VM deletion. To do this, click the pencil icon in the Volumes section, click the ellipsis icon next to the needed volume, and then Edit. Enable Delete on termination and click Save.
   4. When you finish configuring the VM disks, click Done.

5. (Optional) If you have any placements, the Placement drop-down list is displayed. Placements are created by the administrator to group nodes or VMs sharing a distinctive feature, like a special license. Select the placement corresponding to the VM characteristics. For more information, refer to Managing placements.

6. Choose the amount of RAM and CPU resources that will be allocated to the VM in the Flavor section. In the Flavor window, select a flavor, and then click Done.

   

7. Add network interfaces to the VM in the Networks section:

   1. In the Networks interfaces window, click Add, select a compute network, and then click Add.

      

      A network interface connected to the selected network will appear in the Network interfaces list.

   2. (Optional) Edit additional parameters of newly added network interfaces, such as IP and MAC addresses. To do this, click the ellipsis icon, click Edit, and then set the parameters. You will not be able to edit these parameters later. Instead, you will be able to delete the old network interface and replace it with a new one.

   3. When you finish configuring the VM network interfaces, click Done.

8. (Optional) If you have chosen to boot from a template or volume, which has cloud-init and OpenSSH installed (refer to Preparing Templates), do the following:

   Important

   As cloud images have no default password, you can access VMs deployed from them only by using the key authentication method with SSH.

   • Add an SSH key to the VM, to be able to access it via SSH without a password. In the Select an SSH key window, select an SSH key and then click Done.

     

   • Add user data to customize the VM after launch, for example, change a user password. Write a cloud-config or shell script in the Customization script field or browse a file on your local server to load the script from.

     

     To inject a script in a Windows VM, refer to the Cloudbase-Init documentation. For example, you can set a new password for the account using the following script:

     #ps1
     net user <username> <new_password>
     

9. After configuring all of the VM parameters, click Deploy to create and boot the VM.

If you are deploying the VM from an ISO image, you need to install the guest OS inside the VM by using the built-in VNC console (refer to Connecting to virtual machines). Virtual machines created from a template or a boot volume already have a pre-installed guest OS.

4.1.3. Connecting to virtual machines¶

After a virtual machine is deployed, you can connect to it via the VNC console or SSH:

• To connect to a VM via the built-in VNC console, click Console on the VM right pane. The console will open in a separate browser window. In the console, you can send a key combination to a VM, take a screenshot of the console window, and download the console log (refer to Troubleshooting virtual machines).

• To be able to connect to a VM via SSH, make sure it has cloud-init and OpenSSH installed (refer to Preparing Templates). To connect to a VM via SSH, specify the username and VM IP address in the SSH terminal:

  # ssh <username>@<VM_IP_address>
  

  Linux cloud images have the default login, depending on the operating system, for example, centos or ubuntu. To connect to a Windows VM, enter the username that you specified during Cloudbase-Init installation.

  If you have deployed a VM without specifying an SSH key, you also need to enter a password to log in to the VM.

4.1.4. Managing virtual machine power state¶

After you create a virtual machine, you can manage its power state by using available actions. To see the full list of actions available for the VM current state, click the VM or the ellipsis button next to a it. Yo can do the following:

• To power up a VM, click Run.
• To gracefully shut down a running VM, click Shut down. The default shutdown timeout, after which a virtual machine will be powered off, is 10 minutes. You can configure this timeout per VM by using the vinfra service compute server stop --wait-time command (refer to vinfra service compute server stop).
• To forcibly cut off power from a VM, click Power off.
• To softly reboot a running VM, click Reboot.
• To reboot a VM without the guest OS graceful shutdown, click Hard reboot.
• To save the current VM state to a file, click Suspend. This may prove useful, for example, if you need to restart the host but do not want to quit the applications currently running in the VM or restart its guest OS.
• To restore a VM from the suspended state, click Resume.

4.1.5. Reconfiguring and monitoring virtual machines¶

To monitor virtual machine’s CPU, storage, and network usage, select the VM and open the Monitoring tab.

The default time interval for the charts is twelve hours. To zoom into a particular time interval, select the internal with the mouse; to reset zoom, double-click any chart.

The following performance charts are available:

CPU / RAM

CPU and RAM usage by the VM.

Network

Incoming and outgoing network traffic.

Storage read/write

Amount of data read and written by the VM.

Read/write latency

Read and write latency. Hovering the mouse cursor over a point on the chart, you can also see the average and maximum latency for that moment, as well as the 95 and 99 percentiles.

To reconfigure a VM, select it and, on the Overview tab, click the pencil icon next to a parameter you need to change. You cannot do the following:

• Change, detach, or delete the boot volume
• Manage non-boot volumes, except attaching and detaching
• Modify previously added network interfaces
• Attach and detach network interfaces to and from shelved VMs

4.1.6. Shelving virtual machines¶

You can unbind a stopped VM from the node it is hosted on and release its reserved resources such as CPU and RAM. A shelved VM remains bootable and retains its configuration, including the IP addresses. To do this, click Shelve on the VM right pane.

Virtual machines in other states can be shelved by clicking Shut down or Power off, and then selecting the check box Shelve virtual machine in the confirmation window.

To spawn a shelved VM on a node with enough resources to host it, click Unshelve on the VM right pane.

4.1.7. Rescuing virtual machines¶

If a VM experiences boot problems, you can send it to the rescue mode to access its boot volume. When a VM in the “Active” state is sent to the rescue mode, it is shut down softly first. Once the VM is in the rescue mode, you can connect to it via SSH or via the console. Its previous boot disk is now attached as a secondary one. You can mount the disk and repair it.

Before sending a VM to the rescue mode, consider the following:

• The rescue mode can only use qcow2 images (templates) for booting a VM. For instructions on making templates, refer to Preparing templates.
• You can send a VM to the rescue mode only if its current status is “Active” or “Shut down”.
• There are only three actions available for the VM in the rescue mode: Console, Exit rescue mode, and Delete.
• If a rescue image has cloud-init installed, then the VM booted from it can be accessed with the same SSH key that was used for its creation.

To put a VM to the rescue mode, follow the steps:

1. On the Virtual machines screen, click the required VM on the list.

2. On the VM panel, click the ellipsis button on the toolbar. Then, click Enter rescue mode.

   

3. In the Enter rescue mode window, select an image to rescue the VM with. By default, the initial image used for creating the VM is selected. Click Enter.

   

The machine status changes to “Rescue”. To return the VM to normal operation from the rescue mode, follow these steps:

1. On the Virtual machines screen, click the required VM on the list.

2. On the VM panel, click Exit rescue mode.

3. In the Exit rescue mode window, click Exit. The VM will be automatically rebooted.

   

The VM status changes to “Active” and it boots from the original root disk.

4.1.8. Managing guest tools¶

This section explains how to install and uninstall the guest tools. This functionality is required for creating consistent snapshots of a running VM’s disks (refer to Managing volume snapshots).

4.1.9. Troubleshooting virtual machines¶

If a VM fails to deploy, you can view the error message on its right pane. One of the possible root causes is that compute nodes lack free RAM or CPU resources to host the VM.

If a VM is stuck in a failed or transitional state, you can reset the VM to its last stable state: active, shut down or shelved. To do this, click Reset state on the VM right pane.

If a VM is stuck with the “Powering off” task state (it is shown as the “Active (Powering off)” status on the VM right pane), you can cancel this task by running vinfra service compute server cancel-stop (refer to vinfra service compute server cancel-stop). The command will cancel the guest OS shutdown and return the VM to the active state.

To troubleshoot a VM, you can also examine the VM console log by clicking Download console log on the VM right pane. The log will contain log messages only if logging is enabled inside the VM, otherwise the log will be empty. To enable logging, do the following:

• In Linux VMs, enable the TTY1 and TTYS0 logging levels:

  1. Add the line GRUB_CMDLINE_LINUX_DEFAULT="console=tty1 console=ttyS0" to the file /etc/default/grub.

  2. Depending on the boot loader, run either

     # grub-mkconfig -o /boot/grub/grub.cfg
     

     or

     # grub2-mkconfig -o /boot/grub2/grub.cfg
     

  3. Reboot the VM.

• In Windows VMs, enable Emergency Management Services (EMS) console redirection:

  1. Start Windows PowerShell by using administrator privileges.

  2. In the PowerShell console, set the COM port and baud rate for EMS console redirection. As Windows VMs have only the COM1 port with the transmission rate of 9600 bps, run:

     bcdedit /emssettings EMSPORT:1
     

  3. Enable EMS for the current boot entry:

     bcdedit /ems on
     

You may also enable driver status logging to see the list of loaded drivers. This can be useful for troubleshooting a faulty driver or long boot process. Do the following:

1. Start System Configuration by using administrator privileges.
2. In the System Configuration windows, open the Boot tab, and select the check boxes OS boot information and Make all boot settings permanent.
3. Confirm the changes and restart the system.

4.1.10. Deleting virtual machines¶

To remove a virtual machine, click its ellipsis button, and then click Delete. To remove multiple VMs at once, select them, and then click Delete.

A VM is removed along with its disks that have the Delete on termination option enabled during the VM deployment.