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 (see Managing Images):

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

  • a template that is a boot volume in the QCOW2 format, or

  • a boot volume

    Note

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

• One or more virtual networks (see Managing Private Virtual Networks)

• An SSH key (see 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 VM parameters.

   

2. Specify a name for the new VM.

3. In Deploy from, choose Volume if you have a boot volume or want to create one. Otherwise, choose Image.

4. Depending on your choice, click the pencil icon in the Volumes or Image section and do one of the following:

   • In the Images window, select the ISO image or template and click Done.
   
   • In the Volumes window, do one of the following:
     • If you have prepared a volume with an installed guest OS, click Attach, find and select the volume, and click Done.
   

5. Optionally, in the Volumes window, click Add or Attach to create or attach any other volumes you need. To select a volume as bootable, place it first in the list by clicking the up arrow button next to it.

6. After you select an image or a volume, 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, see Managing Placements.

7. In the Flavor window, choose a flavor and click Done.

   

8. In the network window, click Add, select a virtual network interface and click Add. It will appear in the Network interfaces list.

   

   You can edit additional parameters of newly added network interfaces, like IP and MAC addresses and spoofing protection. To do this, click interface’s ellipsis icon, then Edit, and set parameters in the Edit network interface window.

   

   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.

   

   Click Done.

9. (Optional) If you are deploying the VM from a template or boot volume (not an ISO image), you can specify the following:

   • An SSH key to be injected into the VM. To do it, select an SSH key in the Select an SSH key window, and click Done.

     

     Note

     To be able to connect to the VM via SSH, make sure the VM template or boot volume has cloud-init and OpenSSH installed (see Preparing Templates).

   • User data to customize the VM after launch. You can specify user data in one of two formats: cloud-config or shell script. To do it, write a script in the Customization script field or browse a file on your local server to load the script from.

     

     Note

     For the guest OS to be customizable, make sure the VM template or boot volume has cloud-init installed (see Preparing Templates).

     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>
     

10. Back in the Create virtual machine window, click Deploy to create and boot the VM.

11. If you are deploying the VM from an ISO image (not a boot volume template or a volume with a pre-installed guest OS), select the VM, click Console, and install the guest OS using the built-in VNC console.

12. (Optional) If you are deploying the VM from a prepared template with an injected SSH key, you can connect to it via SSH using the username and the VM IP address:

    • For Linux templates, enter the username that is default for the cloud image OS (for example, for a CentOS cloud image, the default login is centos).
    • For Windows templates, enter the username that you specified during Cloudbase-Init installation.

    For example:

    # ssh myuser@10.10.10.10
    

4.1.3. Virtual Machine Actions Overview¶

After you create a virtual machine, you can manage it using the actions available for its current state. To see the full list of available actions, click the ellipsis button next to a VM or on top of its panel. Actions include:

• Run powers up a VM.

• Console connects to running VMs via the built-in VNC console. In the console browser window, you can send a key combination to a VM, take a screenshot of the console window, and download the console log.

• Reboot soft-reboots a running VM.

• Shut down gracefully shuts down a running VM.

• Hard reboot cuts off and restores power, then starts a VM.

• Power off forcibly cuts off power from a VM.

• Shelve unbinds a stopped VM from the node it is hosted on and releases its reserved resources such as CPU and RAM. A shelved VM remains bootable and retains its configuration, including the IP addresses.

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

• Unshelve spawns a shelved VM on a node with enough resources to host it.

• Suspend saves the current VM state to a file.

  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.

• Resume restores a VM from suspended state.

• Download console log downloads the console log. Make sure logging is enabled inside the VM, otherwise the log will be empty (for more information, see Enabling Logging inside Virtual Machines).

  Examining console logs may be useful in troubleshooting failed virtual machines.

• Reset state resets the VM stuck in a failed or transitional state to its last stable state: active, shut down or shelved.

• Delete removes a VM from the compute cluster.

4.1.4. Enabling Logging inside Virtual Machines¶

VM’s console log will contain log messages only if the TTY1 and TTYS0 logging levels are enabled inside the VM. For example, you can enable them as follows in Linux VMs:

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, you can enable Emergency Management Services (EMS) console redirection for this purpose. Do the following:

1. Start Windows PowerShell with 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. You can do this as follows:

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

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 12 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. 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).