Create and Configure

Latest Frontend Version: 2.17.3

Create a New Virtual Machine

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. Click Create configuration in the top left panel.
4. In the pop-up, enter the VM name, team, project, optional VM co-owners, and description.
5. Next, enter the VM hardware setup to allocate resources.
6. Then, select an existing drive or click the Create new drive button to create a new drive to store the virtual machine data.
7. Finally, tick the box Launch a VM from this configuration immediately.
8. Click Create.

caution

Before creating a VM configuration, ensure you have the correct hardware setup from your admin and that you are part of an active team.

info

• Information about RAM disk size and mounting slot location is displayed under the Extra Drives section upon VM creation.
• To clone another virtual machine, type clone and the name of the virtual machine in the Hardware Setup field upon creation.

Confirmations, Errors & Solutions

Launch VM Immediately

In the Create new VM configuration prompt, under Actions tick Launch a VM from this configuration immediately.

VM Created Successfully

Starting VM from vm-name(total-starting-vm-time).

Failed to Create VM Configuration

Failed to create configuration: Need to have CreateVMConfig permission.

Ask Your Admin for VM Creation Permissions

Ask your admin to allow you to create and edit VM configurations.

To System Admin

To allow a user to create VM configurations:

1. In the Management section, click the Users section in the left panel.
2. Select the appropriate user to update permissions.
3. Click the Open Overlay button in the top right.
4. In the new window, go to the Manual permission management section.
5. Under Basic VM Interaction section, tick the Create (and edit) VM configs permission.
6. Once done, click Save in the top center.

Did Not Enter VM Name

You must enter a name.

Enter a VM Name

In the Create new VM configuration prompt, under Basic Information enter the VM name in the Name field.

Did Not Select VM Team

You must select a team from the autocomplete.

Select a Team Name

In the Create new VM configuration prompt, under Basic Information select the team name in the Team field.

Did Not Select Hardware Setup

You must select a hardware setup from the autocomplete.

Select a Hardware Setup

In the Create new VM configuration prompt, under Hardware Setup select the hardware setup in the Hardware Setup field.

VM Security Bypass

This hardware setup will enable admins to access your VM remotely, bypassing security mechanisms for the purpose of debugging issues with the VM controller.

Select a Non-Debug Mode Hardware Setup

In the Create new VM configuration prompt, under Hardware Setup select a hardware setup in the Hardware Setup field without the icon Active Debug mode.

To Virtual Machine Owner
Important: Use only non-debug mode for VMs in production.

Did Not Select Home Drive

Search for a drive...

Select a Home Drive

In the Create new VM configuration prompt, under Home drive select an existing home drive in the Home Drive field. Alternatively, create a new drive.

Edit a Virtual Machine

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. In the left panel, click the Open Full Menu button by the stopped virtual machine to edit.
4. Select Edit.
5. In the pop-up, edit the VM name, team, project, VM owners, description, hardware setup, and drives.
6. Once done, click Save.

caution

Disconnect and power off the VM configuration before editing its metadata.

Confirmations, Errors & Solutions

Updated VM Successfully

Updated vm-name

Share drives with new owners for vm-name (total-sharing-time).

Failed to View the Edit Button

Your VM is still running.

Shut Down Your VM

Follow the instructions in  

Shut Down a Virtual Machine

  section.

Delete a Virtual Machine

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. In the left panel, click the Open Full Menu button by the stopped virtual machine to delete.
4. Select Delete.
5. In the pop-up, click Delete.

caution

Disconnect and power off the VM configuration before deleting it.

Confirmations, Errors & Solutions

Deleted VM Successfully

Delete vm-nametotal-deleting-time.

Failed to View the Delete Button

Your VM is still running.

Shut Down Your VM

Follow the instructions in  

Shut Down a Virtual Machine

  section.