Skip to content

Virtual Machines

A Virtual Machine (VM) is a virtual server used for running applications. A VM is created inside a certain Cloudspace, however it can be moved between Cloudspaces. This tutorial will get you started with VMs and their basic functionalities.

Creating Virtual Machines

To create a virtual machine

  1. Navigate to the specific Cloudspace details page. Select VMS from the given tabs.
  2. At the top of the page, click CREATE VM.
  3. Select the virtual machine source. You have eight options here

    • Create from an image
    • Install via a CDROM
    • Create a VM without an operating system installed
    • Import from S3
    • Create from a snapshot
    • Create from cdrom backup
    • Create from boot disk
    • Create from VM backup

    1. Select image: a list of images will appear, select an image from them.
    2. Compute size: set the vCPUs, Memory and Boot disk size, and choose the storage class of the boot disk.
    3. Storage: you can manage the storage of the VM by adding extra disks. (Optional)
    4. User data: add user data, such as an SSH key (Optional, for linux based OSs).
    5. Security: choose whether to attach a TPM device and which backup policy to assign. (Optional)
    6. Configuration details: add configuration details for your VM such as:
      • Name
      • Host Name
      • Boot type
      • Description (Optional)
      • Private IP (Optional)



    1. Select CDROM image: a list of CDROM images will appear, select an image from them.
    2. Compute size: set the vCPUs, Memory and Boot disk size.
    3. Storage: you can manage the storage of the VM by adding extra disks. (Optional)
    4. Security: choose whether to attach a TPM device and which backup policy to assign. (Optional)
    5. Configuration details: add configuration details for your VM such as:
      • Name
      • Boot type
      • Description (Optional)
      • Private IP (Optional)

    Note: The User data step is disabled for this source.



    1. No image is selected. In Compute size, set the vCPUs, Memory and Boot disk size.
    2. Storage: you can manage the storage of the VM by adding extra disks.
    3. Security: choose whether to attach a TPM device and which backup policy to assign. (Optional)
    4. Configuration details: add configuration details for your VM such as:
      • Name
      • Operating System type
      • Operating System name
      • Boot type
      • Description (Optional)
      • Private IP (Optional)



    1. In the S3 Information step, enter:
      • Link (S3 server link)
      • Key (access key to the server)
      • Secret (secret to access the server)
      • Region (region of the S3 server)
      • Bucket (name of the bucket)
      • Object Name (name of the stored object in the bucket)
    2. Compute size: set the vCPUs and Memory.
    3. Security: choose the backup policies to assign. (Optional)
    4. Configuration details:
      • Name
      • Host Name
      • OS type (default Linux)
      • OS name (default "Ubuntu server 16.04")
      • Boot type (default bios)
      • Description (Optional)
      • Private IP (Optional)
      • Start virtual machine(s) immediately after creation (checked by default)
      • Import virtual machine as close as possible... (unchecked by default)

    Note: The Storage and User data steps are disabled for this source.

    Note: The recommended way to import a VM from S3 is via the CLI — the portal links to that guide.



    1. Select Boot Disk: select a boot disk.
    2. Select snapshot: select the snapshot from the available snapshots list. If the boot disk dosn't have snapshots created before, you can enable Show automatic snapshots to choose from.
    3. Compute the sizes of the Vcpus and Memory by adjusting the slider.
    4. You can manage the storage of the VM by adding a data disk. (Optional)
    5. Add configuration details for your VM such as:
      • Name
      • Boot type
      • Description (Optional)
      • Private IP (optional)

    Note: On selecting snapshots, you can optionally choose to clone all the disks created along with the selected disk.



    1. In the Select backup source step, choose the backup source Create from acronis backup or Create from veeam backup. (The option on the source page is labelled Create from cdrom backup, but the step header reads Create from acronis backup.)
    2. Compute the sizes of the Vcpus, Memory and Boot disk by adjusting the slider.
    3. You can manage the storage of the VM by adding a data disk. (Optional)
    4. Add configuration details for your VM such as:
      • Name
      • Operating System type
      • Operating System name
      • Boot type
      • Description (Optional)
      • Private IP (optional)

    Note: Operating system type must be the same as the VM that was backed up.



    1. Select disk: select a boot disk.
    2. Compute the sizes of the Vcpus and Memory by adjusting the slider. The Boot disk size slider is hidden here — the boot disk size is inherited from the selected boot disk.
    3. You can manage the storage of the VM by adding a data disk. (Optional)
    4. Add configuration details for your VM such as:
      • Name
      • Operating System type
      • Operating System name
      • Boot type
      • Description (Optional)
      • Private IP (optional)



    This is a 5-step restore wizard.

    1. Select backup Target: a list of targets within the same location as the cloudspace will appear. Select a target from the list.
    2. Select backup VM: a list of VMs with backups available on the selected target will be displayed. Choose the VMs you want to restore.
    3. Select Backup and configure details: use the time filter to retrieve the most recent backup before a specified date or filter by backup policies to find the preferred backup copy to restore.
    4. Modify the configuration details for your VM, including:
      • Name
      • Private IP
    5. Backup restore progress: follow the progress of the restore.


  4. Click CREATE. When importing from S3 the final buttons are IMPORT and IMPORT BATCH (next to CANCEL) instead.

Editing Virtual Machines

Similar to Cloudspaces, each virtual machine has a details page. From the details page, you can access and edit (resize, rename, delete ) all the virtual machine's information.

Accessing Details Page

To access the details page for an existing virtual machine

  1. Navigate to the specific Cloudspace details page. Select VMS from the given tabs.
  2. A list of all the virtual machines in this cloudspace will appear. Choose the virtual machine you want to access.

The details page for this VM will appear with all its detailed information: Name, Description, Status, Username, Initial password, OS image, IP address, vCPUs, Storage, Memory, Boot type, and the Agent, CPU pinning and TPM toggles. The details page does not show a cost panel; use the Spendings tab for the VM's cost.

Renaming Virtual Machines

To rename a virtual machine, navigate to the virtual machine's details page. Under Name, click to edit the virtual machine name.

Deleting Virtual Machines

To delete a virtual machine, navigate to the details page. Under MORE at the top of the page, click DELETE. The confirmation dialog asks you to confirm deleting the virtual machine and offers the checkboxes Detach disks and Detach vGPU. It does not ask for a reason.

Resizing Virtual Machines

You can resize the virtual CPUs and memory of a virtual machine from the details page. Under each of vCPUs and Memory, click to adjust the vCPUs and memory sizes.

CPU Topology

To configure the virtual CPU topology of the virtual machine, navigate to the CPU topology configuration page by clicking CPU Topology (under MORE) on the virtual machine's details page. Click UPDATE to apply the change.

You can configure the number of Cores, Threads and Sockets. Note, that changing the topology will result is changing the amount of consumed vCPUs and may lead to extra charges. The total number of vCPUs is calculated by multiplying the number of cores, thread and sockets. For example, if you configure the topology settings with 8 virtual sockets, 2 threads, and 4 cores per socket, the total number of vCPUs is calculated by multiplying 8x2x4 = 64.

To update the number of vCPUs without changing the topology, click next to the vCPU info on the virtual machine details page. Note that, the minimum delta value of the vCPU amount is calculated to preserve current CPU topology.

Stopping/Pausing Virtual Machines

To stop or pause a virtual machine, navigate to the details page. At the top of the page, click PAUSE to pause the VM or STOP to stop it. Each action opens a confirmation dialog ("Are you sure you want to stop vm ?" or "... pause vm ?") with Cancel and Confirm. After pausing, you can resume with the VM by clicking RESUME at the top of the page. After stopping, you can start the VM again by clicking START, which also asks "Are you sure you want to start vm ?".

Also you have an option to Force stop your VM. Click STOP, check the Force stop this vm. box and click CONFIRM.

Rebooting Virtual Machines

To reboot a virtual machine, navigate to the details page. At the top of the page, click REBOOT and confirm the "Are you sure you want to reboot vm ?" dialog; the virtual machine will then reboot.

Additional Actions

You can copy the virtual machine's ID and other information by clicking next to the fields.

Creating Disks

To add a disk to a virtual machine

  1. In the VM details page, click ADD DISK at the top of the page.
  2. In Choose disk source, select Create an empty disk (the other options are Attach disk and Create disk from a snapshot).
  3. In Choose storage class, select the storage class:
    • Physical Storage: billed as FSU.
    • whitesky.cloud SDS: billed as SU.
    • External Storage NBD.

      Note Disks created as physical storage are physically attached to a specific node. A VM with a physical (local) disk can be moved to another node, but the local disk is re-provisioned empty on the destination node — its data does not follow (data loss). RAID-type local disks cannot be migrated without a force flag.

  4. In Create empty disk, enter the Disk name and Description (optional). For physical storage you can also set the Backup size limit.
  5. Adjust the Disk Size (GiB) and Speed (IOPS). The configuration cost is displayed and is updated according to the size and speed parameters.
  6. Click CREATE. A message saying Disk created successfully! will appear and the disk will be added to the virtual machine's list of disks.

Detaching Disks

To detach a disk from a virtual machine

  1. In the virtual machine's details page, select the DISKS tab.
  2. The disk details page will open. At the top of the page, click DETACH.
  3. Click Confirm to confirm detaching the disk.

A message saying Disk was successfully detached from this virtual machine! will appear and the disk will be removed from the list of disks in the virtual machine.

Attaching/Detaching Network Interfaces

To attach the virtual machine to a network interface

  1. In the virtual machine's details page, select the NETWORK INTERFACES tab.
  2. At the top of the page, click ATTACH NIC (singular — attaches one NIC at a time). A list of available networks will appear.
  3. Select a network to attach to your virtual machine.
  4. Click ATTACH.

A message indicating that the network was successfully attached will appear. Also, the new network will be added to the list of network interfaces for this virtual machine.

To detach the virtual machine from a network interface

  1. In the virtual machine's details page, select the network interfaces tab.
  2. From the list of network interfaces, select the network interface you want to detach.
  3. A details page for this network interface will appear, at the top of the page click DETACH.

A message will appear indicating that the network was successfully detached.

Attaching/Detaching CDROMs (ISO Images)

To attach a CDROM to a virtual machine

  1. In the virtual machine's details page, click MORE and select CDROM images.
  2. At the top of the page, click ATTACH CDROM IMAGE. The page reads "Select the cdrom image you want to attach" and lists the available images (Name, OS name, OS type, Public).
  3. Select a CDROM image and click ATTACH (or CANCEL).

A message will appear indicating that the CDROM image was attached successfully.

To detach a CDROM from a virtual machine

  1. In the virtual machine's details page, click MORE and select CDROM images. The list shows the Name, Size and Status of each image.
  2. From the list of attached CDROM images, select the CDROM you want to detach. The CDROM details page will appear.
  3. At the top of the page, click DETACH FROM <VM NAME> (the button shows the name of this virtual machine). Then, click Confirm.

A message will appear indicating that the CDROM image was detached successfully.

Assign backup policy

To assign a backup policy to the virtual machine

  1. In the virtual machine's details page, click MORE and select Assigned backup policies. The list shows the Policy name and Policy ID.
  2. At the top of the page, click ASSIGN BACKUP POLICY.
  3. On the Assign Backup Policy page, first use Select backup Target, then Assign backup policy to pick one or more policies from that target.
  4. Click SUBMIT (or CANCEL).

Using the VM Console

One way of interacting with the virtual machine is through the virtual machine console.

Tip

If the virtual machine was created from a Gigify Uganda Limited publicly available image, you can find the default username and password in the virtual machine's details page.

To access the console window, click CONSOLE at the top of the details page. The console window will pop up, along with six buttons: SEND TEXT, CAPSLOCK, CTRL+ALT+DEL, F12, PASTE USERNAME, and PASTE PASSWORD.

Console Actions:

  • You can start typing commands directly into the console.
  • The Send Text button is a convenient way to copy and paste text directly to the virtual machine.
  • The CapsLock button toggles the CapsLock state of the guest.
  • The CTRL+ALT+DEL button sends that key combination to the guest operating system, the same as pressing it on a physical keyboard — it is not a platform-level reboot. On Windows guests this typically opens the security/login screen; on most Linux guests it has no effect unless a handler is configured. To restart the VM itself, use Rebooting Virtual Machines instead.
  • The F12 button sends the F12 key to the guest.
  • The Paste Username and Paste Password buttons paste the default credentials (shown on the VM details page for Gigify Uganda Limited publicly available images) into the console.

Statistics

The Statistics tab contains graphs displaying the resources in the virtual machine. Each graph shows how much the virtual machine is utilizing this resource at different points in time. Use the LG / MD / SM buttons above the graphs to change how many graphs fit per row (a layout-density toggle, not a per-graph expand action).

To change the dates of the observed period, click the date bar under the Statistics tab and select the new dates you want to observe.

Spendings

The Spendings tab illustrates the virtual machine's cost at different points in time. The total cost is shown along with each resource's cost separately. You can remove certain resources from the graph by clicking on the buttons next to each resource name on top of the graph.

To change the dates of the observed period, click the date bar under the Spendings tab and select the new dates you want to observe.

Software Licenses

The Software licenses page (under MORE) lists the Microsoft software detected on this specific virtual machine, and how many instances of each were detected.

Column Description
License Name The Microsoft product detected on this virtual machine
Number of licenses The number of detections recorded for that software on this virtual machine

This is separate from the customer-wide Software Licenses page and the operator-wide Software Licenses page — it reports data for this VM only. Use Search to filter the list, click a column heading to sort, and use the refresh button to retrieve the latest data. When nothing is detected, the table displays No licenses available.

Audits

The Audits page (under MORE) shows the same request log described in Audits, pre-filtered to this virtual machine. See that page for the column and filter reference — everything there applies here, just scoped to one VM. Use the Include GET requests option to include read requests in the list.

Setting a Disk as Boot Disk

On the VM's Disks tab, each non-boot disk has an action icon to Set as boot disk. This changes which disk is the primary boot disk for the VM.

Reordering NICs

On the VM's Network Interfaces tab, click Reorder NICs in the subtop bar. A dialog lets you change the order of attached NICs, which affects the primary interface.

Backups Tab

The VM details page has a Backups page under MORE (in addition to Assigned backup policies) that shows all backups taken for this VM, with actions to delete, restore, and view details. The BACKUP button in the subtop bar opens the Create Backup page ("Select backup policy to create backup"): choose one of the Assigned backup policies and click CREATE (or CANCEL). The list shows Creation time, Data size, Policy, Duration, Status and Previous Backup. The Show expired option includes expired entries in the list.

Roles & Permissions Tab (Admin-Only)

The VM details page has a Roles & permissions page under MORE (visible to customer admins only) where you can grant (GRANT ROLE ACCESS) or revoke role-based access to this specific VM.

Moving a VM Between Cloudspaces

On the VM details page, click MOVE. The form lists the other cloudspaces of the same location (Name, Mode, External ip, Status) with a "selected items" counter. Pick the target cloudspace, then click MOVE to confirm. The MOVE button stays enabled whether the VM is running or halted; the portal does not require a halted state in the form.

Bulk Disk Actions

On the VM's Disks tab, select multiple disks using the row checkboxes. The subtop bar then shows Delete Selected and Detach Selected for bulk operations.

Bulk Backup Actions

On the VM's Backups page, select multiple backups. The subtop bar shows Delete Selected Backup(s) and Unassign selected backup policies.

VM Notes

On the VM details page, you can add private notes (visible only to you) using + new note under the details panel. Each note is shown as a chip with its title, author (By:), content and creation date, and has edit and delete icons. Notes are free-form text and do not affect the VM.

Anti-Affinity Groups

If the VM is a member of one or more anti-affinity groups, the group names are shown as chips on the VM details page.

Exporting a VM to S3 (Portal)

On the VM details page, click EXPORT TO S3. Enter the S3 endpoint details (Link, Key, Secret, Region, Bucket and Object Name) and click EXPORT TO S3; the VM's disk will be exported to that bucket.

Note: the CLI method is also available and recommended for large exports.

Creating a VM Template

On the VM details page, click MORE and select Create Template. Enter the Template name and click CREATE. The running VM's configuration and disks are captured as a reusable template for creating new VMs.