Skip to main content

Virtual Machines Table

Prerequisites

Access Level:

User, Sub-admin, Admin

Permission Requirements

  • . Basic VM Interaction
    • View drives (inconsistent, see notes)
    • Create drives
    • Edit drives (name and whether to disable backup)
    • View drive keys (necessary to share/attach)
    • Share drives
    • Attach drives to VMs
    • Detach drives from VMs
    • View hardware/image setups made available to them
    • View own VM configs and configs shared with them
    • Create (and edit) VM configs
    • Spawn VMs from VM configs
    • Stop VMs spawned from VM configs
    • View own VM username
    • View anyone's VM username (necessary for sharing VMs)
    • Create sub-session for VM->Vault direct transfer
    • View own VMs and VMs shared with them
    • Spawn VMs(without a config)
    • Connect to own VMs and VMs shared with them
    • Share VMs with other users
    • Shutdown own VMs
  • . VM Administration
    • View all VM configs in the system
    • Arbitrarily edit any VM config
    • Arbitrarily delete any VM config
    • Modify any user's VM username
    • Arbitrarily view logs from any VM
  • . Miscellaneous
    • Transfer ownership of own files and drives
Legend
  • . VMs= Virtual Machines Table Overview
  • . Shared with you = Virtual Machine is owned by a different user but shared with you.
  • . FIPS enabled= Virtual Machines has been enabled FIPS by VMC for debug purposes.
  • . Owner = You own the Virtual Machine.
  • . Co-owner = You co-own the Virtual Machine with one or more users.
  • Project = the Virtual Machine is tagged by a project.
  • . Debug mode = the Virtual Machine is in debug mode, inappropriate for production.
  • . Connected = the Virtual Machine is connected.
  • . Running = the Virtual Machine is connected and running normally.
  • . Stopped = the Virtual Machine is connected but stopped.
  • . Not Running = the Virtual Machine has an error and cannot run.
  • . Unknown = the Virtual Machine is in a process of an action.

View Your Virtual Machines

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the VMs section on the top left panel.
  3. View your listed virtual machines in the right table.
  4. View your listed virtual machines in the right table.
  5. View your listed virtual machines in the right table.

Pin or Unpin Your Virtual Machines

  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 table, click Pin next to the VM you want to pin.
  4. Click Unpin next to the VM you want to unpin.
tip
  • Pin the VMs you use most frequently for quicker access.
  • The pinning mechanism uses vmConfig ID.

Access a Virtual Machine via Remote Desktop Connection (RDP)

  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, select the connected virtual machine to access.
  4. Click the Start Remote Desktop button.
  5. In the prompt, click the Copy button next to your username and password.
  6. Paste the credentials into your RDP client.
  7. Click Close.
tip

Click the Copy Password button when you only need the password to perform an RDP connection.

Confirmations, Errors & Solutions
View More
Tunnelling to RDP Confirmation

Tunneling to vm-nametotal-time-to-tunnel.

RDP Started Successfully

Started RDP application and copied password to clipboard.

Copied Username Confirmation

Username copied to clipboard.

Copied Password Confirmation

Password copied to clipboard.

Windows Remote Desktop Connection Warning

The publisher of this remote connection can't be identified. Do you want to connect anyway?

Click Connect.

Second Windows Remote Desktop Connection Warning

The publisher of this remote connection can't be identified. Do you want to connect anyway?

The server name on the certificate is incorrect. The certificate is not from a trusted certifying authority.

Click Yes.

Start Remote Desktop Button is Inactive in Virtual Machine

The Start Remote Desktop button is inactive in Virtual Machines' right panel.

Ask Remote Desktop Permissions from VM Owner

Ask the VM owner to allow you to start a remote desktop connection.



To Virtual Machine Owner
To allow VM users permissions to start Remote Desktop Connections:  
  1. In the VMs section, click the virtual machine where you want to update a users' remote desktop permissions.
  2. Click the VM Settings and Details option in the bottom center.
  3. In the new window, select the Users section in the left panel.
  4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
  5. Select Edit user access.
  6. In the pop-up, select profile to Custom.
  7. Scroll down under Permissions, and tick Remote application access Allows VM application access from user desktop.
  8. Click Save.
Insufficient Permissions to Start Remote Desktop Connection

Failed to get drive info: insufficient permissions: drives:list: missing permission:{PermDrives}.

Ask VM Owner For List VM Drives Access

Ask the VM owner to allow you VM drives access.



To Virtual Machine Owner
To allow a VM user permissions to list VM drives in the Virtual Machine:  
  1. In the VMs section, click the virtual machine where you want to update a users' remote desktop permissions.
  2. Click the VM Settings and Details option in the bottom center.
  3. In the new window, select the Users section in the left panel.
  4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
  5. Select Edit user access.
  6. In the pop-up, select role to Manager.
  7. Scroll down under Permissions, and tick Drives List, format, mount and unmount drives.
  8. Click Save.
The Server Failed to Start Remote Desktop Connection

Failed at failure-time: 500 Internal Server Error (open console for more details).

Ask System Admin to Debug VM

Ask the system admin to check the local ports to VM and the proxy via your-institution-deployment-application.

Reset Connection of a Remote Desktop (RDP)

  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, select the virtual machine to reset RDP connection.
  4. Click the Start Remote Desktop button.
  5. In the prompt, click the Reset Connection button.
  6. Once done, click Close.
danger

Resseting an RDP connection disrupts running applications and ongoing SFTP transfers.

Confirmations, Errors & Solutions
View More
Reseted Connection Successfully

Started RDP application and copied password to clipboard.

Turn On 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, select the virtual machine to turn on.
  4. Click the Start VM button in the top right.
Confirmations, Errors & Solutions
View More
Started Virtual Machine Successfully

Started vm-name.

Drive Problems in Virtual Machine

There are problems with drives attached to attached-drive-name. Drive is not shared with you.

Ask VM Owner to Share Drive with You

Ask the VM owner to share the drive with you before you attempt to turn on the virtual machine.



To Virtual Machine Owner
To share a drive follow the steps in in 

Share a Drive with Other Users.


Failed to Connect to Home Drive

Failed at failure-time: you do not have a read-write access to the home drive.

Ask VM Owner to Share Read-write Access to Home Drive

If not additional read-only drives are attached to the VM, you must be shared and given access to the read-write home drive to turn on the VM.



To Virtual Machine Owner
To share a drive follow the steps in in 

Give Full-Access (Read-Write) of a Drive to a User.


Failed to Turn On Project-Tagged Virtual Machine

Your membership is not active in this VM confirguration's project.

Ask VM Owner to Add You to Project

Ask the VM owner to add you the same project tagging the virtual machine. Additionally, ask the VM owner to share with you the project-tagged drives associated with the same project-tagged virtual machine.



To Virtual Machine Owner
You must ensure the drives are tagged by the same project when turning on a project-tagged VM. To add the same project-tagged drives to your project-tagged VM: 

  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 stopped virtual machine to add its associated project-tagged drives.
  4. In the left panel, click the Open Full Menu button next to the virtual machine.
  5. Select Edit.
  6. In the pop-up, scroll down under Home Drive section.
  7. Click the home drive field and select an existing drive from the list with the same project tag.
  8. Optionally, click Create new drive to create a new project-tagged home drive from scratch.
  9. Once done, click Save.

Connect to 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, select the virtual machine to connect.
  4. Click the Connect VM button.
note
  • Ensure the virtual machine is turned on before connecting.
  • You may be required to enter your password upon connection.
Confirmations, Errors & Solutions
View More
Connected to Virtual Machine Successfully

Starting VM from vm-config-name(total-time-to-start).

Attach Drives to Virtual Machine Successfully

Attach/mount home-drive-name to vm-config-name(total-time-to-attach).

Drive Problems in Virtual Machine

This VM has no attached home drive. Most functionality does not work without an attached home drive, and has been hidden.

Try to Repair Drive And Ask The VM Owner

There are two approaches to fix this error.



  1. Click the Repair button in the top-right prompt to attempt to repair the drives.


Failed to Attach/Mount Home Drive

First attempt to attach/mount home drive failed (will retry once): No key available for drive drive-string-id.


  1. If you triggered the above error, ask the VM owner to add a home drive to the VM and share the home drive with you.


To Virtual Machine Owner
To add a drive follow the steps in in 

Attach an Existing Drive to an Existing VM.


Confirmations, Errors & Solutions
View More
Connected to Virtual Machine Successfully

Starting VM from vm-config-name(total-time-to-start).

Attach Drives to Virtual Machine Successfully

Attach/mount home-drive-name to vm-config-name(total-time-to-attach).

Drive Problems in Virtual Machine

This VM has no attached home drive. Most functionality does not work without an attached home drive, and has been hidden.

Try to Repair Drive And Ask The VM Owner

There are two approaches to fix this error.



  1. Click the Repair button in the top-right prompt to attempt to repair the drives.


Failed to Attach/Mount Home Drive

First attempt to attach/mount home drive failed (will retry once): No key available for drive drive-string-id.


  1. If you triggered the above error, ask the VM owner to add a home drive to the VM and share the home drive with you.


To Virtual Machine Owner
To add a drive follow the steps in in 

Attach an Existing Drive to an Existing VM.


View Virtual Machines’ Details

  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 virtual machine to view the details.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Overview section in the left panel.
  6. Then, view the running CPU, Memory, Kilobytes Received, Kilobytes Send, Home/Attached Drives and Drive Warnings.
  7. Scroll down to view the VM started date, runtime, IP/MAC address, VM controller version, and the Last 50 logs entry.
Confirmations, Errors & Solutions
View More
Failed to View Virtual Machine's Details

Failed to list CPU, Memory, Kilobytes Received, Kilobytes Send, Home/Attached Drives, Drive Warnings, VM started time, runtime, IP/MAC address, VM controller version and the last 50 logs. The logs are also infinitely loading.}.

Ask VM Statistics Permissions from VM Owner

Ask the VM owner to allow you to access the VM settings and details section.



To Virtual Machine Owner
To allow VM statistics permissions to a VM user:  
  1. In the VMs section, click the virtual machine where you want to update a users' VM statistics permissions.
  2. Click the VM Settings and Details option in the bottom center.
  3. In the new window, select the Users section in the left panel.
  4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
  5. Select Edit user access.
  6. In the pop-up, select profile to Custom.
  7. Scroll down under Permissions, and tick System Statistics View real-time system utilization.
  8. Click Save.
Confirmations, Errors & Solutions
View More
Failed to View Virtual Machine's Details

Failed to list CPU, Memory, Kilobytes Received, Kilobytes Send, Home/Attached Drives, Drive Warnings, VM started time, runtime, IP/MAC address, VM controller version and the last 50 logs. The logs are also infinitely loading.}.

Ask VM Statistics Permissions from VM Owner

Ask the VM owner to allow you to access the VM settings and details section.



To Virtual Machine Owner
To allow VM statistics permissions to a VM user:  
  1. In the VMs section, click the virtual machine where you want to update a users' VM statistics permissions.
  2. Click the VM Settings and Details option in the bottom center.
  3. In the new window, select the Users section in the left panel.
  4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
  5. Select Edit user access.
  6. In the pop-up, select profile to Custom.
  7. Scroll down under Permissions, and tick System Statistics View real-time system utilization.
  8. Click Save.

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 you are part of an active team.

info
  • Information about RAM disk size and mounting slot location is displayed under 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
View More
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. Additionally, create a new drive from scratch.

Confirmations, Errors & Solutions
View More
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. Additionally, create a new drive from scratch.

Add Users to a Virtual Machine

bulk-action

  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 virtual machine to add users to.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Users section in the left panel.
  6. Next, click the Add users button in the top-right panel.
  7. In the pop-up, enter the user names to add, profile, and their role in the VM.
  8. For custom users, tick or untick permissions in the VM.
  9. Click Add users.
Confirmations, Errors & Solutions
View More
Failed to View Users Section in Virtual Machine

Failed to list users: insufficient permissions: users:list: missing permission: {PermUsers}.

Ask VM Users Permissions from VM Owner

Ask the VM owner to allow you to access the VM users section.



To Virtual Machine Owner
To allow VM users permissions to a VM user:  
  1. In the VMs section, click the virtual machine where you want to update a users' viewing users permissions.
  2. Click the VM Settings and Details option in the bottom center.
  3. In the new window, select the Users section in the left panel.
  4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
  5. Select Edit user access.
  6. In the pop-up, select profile to Custom.
  7. Scroll down under Permissions, and tick Users View other users.
  8. Click Save.
Did Not Select Users, Teams and/or Groups

You must select at least one user from the autocomplete.

Select Users, Teams and/or Groups

In the Add Users to vm-name prompt, select existing users, teams and/or groups in the Add Users,Teams, Groups field.

Confirmations, Errors & Solutions
View More
Failed to View Users Section in Virtual Machine

Failed to list users: insufficient permissions: users:list: missing permission: {PermUsers}.

Ask VM Users Permissions from VM Owner

Ask the VM owner to allow you to access the VM users section.



To Virtual Machine Owner
To allow VM users permissions to a VM user:  
  1. In the VMs section, click the virtual machine where you want to update a users' viewing users permissions.
  2. Click the VM Settings and Details option in the bottom center.
  3. In the new window, select the Users section in the left panel.
  4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
  5. Select Edit user access.
  6. In the pop-up, select profile to Custom.
  7. Scroll down under Permissions, and tick Users View other users.
  8. Click Save.
Did Not Select Users, Teams and/or Groups

You must select at least one user from the autocomplete.

Select Users, Teams and/or Groups

In the Add Users to vm-name prompt, select existing users, teams and/or groups in the Add Users,Teams, Groups field.

Add Teams to a Virtual Machine

bulk-action

  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 virtual machine to add teams to.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Users section in the left panel.
  6. Next, click the Add users button in the top-right panel.
  7. In the pop-up, enter the team names to add, profile, and their role in the VM.
  8. For custom teams, tick or untick permissions in the VM.
  9. Click Add users.
note
  • This will add all team members of the selected team(s) to the Virtual Machine.
  • You may only add one team per virtual machine.

Add Groups to a Virtual Machine

bulk-action

  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 virtual machine to add groups to.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Users section in the left panel.
  6. Next, click the Add users button in the top-right panel.
  7. In the pop-up, enter the group names to add, profile, and their role in the VM.
  8. For custom groups, tick or untick permissions in the VM.
  9. Click Add users.
note

This will add all group members of the selected group(s) to the Virtual Machine.

tip

You can add a combination of users, teams and groups to the VM simultaneously.

Confirmations, Errors & Solutions
View More
Failed to View Groups Section in Virtual Machine

Failed to list groups: insufficient permissions: group:list: missing permission: {PermGroups}.

Failed to List Groups in Virtual Machine

Failed to list groups: insufficient permissions: group:list: insufficient role, need RoleManager.

Ask VM Groups Permissions from VM Owner

Ask the VM owner to allow you to access the VM groups section.



To Virtual Machine Owner
To allow group permissions to a VM user:  
  1. In the VMs section, click the virtual machine where you want to update a users' group permissions.
  2. Click the VM Settings and Details option in the bottom center.
  3. In the new window, select the Users section in the left panel.
  4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
  5. Select Edit user access.
  6. In the pop-up, select role to Manager.
  7. Scroll down under Permissions, and tick Groups View groups.
  8. Click Save.

Add Users, Teams and Projects as Managers to a Virtual Machine

bulk-action

  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 virtual machine to add managers to.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Users section in the left panel.
  6. Next, click the Add users button in the top-right panel.
  7. In the pop-up, enter the user, team and project names to add and their profiles.
  8. Set their role to Manager.
  9. For custom users, teams and projects tick or untick permissions in the VM.
  10. Click Add users.
note
  • Adding a team or project as manager will add all users within the team or project as managers in the VM.
  • You cannot add managers to a VM you do not own but was shared with you. You must own or co-own the VM to add other managers.
Confirmations, Errors & Solutions
View More
Added Users, Teams and Projects Successfully

Add total-users-total-team-members-or-total-project-members-addedtotal-adding-time.

Add Users, Teams and Projects as Co-Owners to a Virtual Machine

bulk-action

Method One

  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 virtual machine to add co-owners to.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Users section in the left panel.
  6. Next, click the Add users button in the top-right panel.
  7. In the pop-up, enter the user, team and project names to add and their profiles.
  8. Set their role to Co-owner.
  9. For custom users, teams and projects tick or untick permissions in the VM.
  10. Click Add users.

Method Two

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Virtual Machines Table Overview section on the top left panel.
  3. In the left panel, click the Open Full Menu button by the virtual machine to add co-owners to.
  4. Select Add co-owners.
  5. In the pop-up, enter the user names to add as co-owners to the virtual machine.
  6. Select whether or not to sync user access.
  7. Click Update.
tip

Use sync user access for transparency between co-owner roles.

note
  • You cannot add co-owners to a VM you do not own but was shared with you. You must own or co-own the VM to add other co-owners.
  • You may need to enter your password to perform this operation.
caution

Adding co-owner(s) also grants them access to the VM's associated drives. Co-owners can restart and mount these drives in other VMs.

Confirmations, Errors & Solutions
View More
Updated Users' to VM Co-owners Successfully

Updated user(s).

Updated Users' to VM Co-owners Successfully

Sync user access for vm-name VM total-syncing-time.

Added Users, Teams and Projects Successfully

Add user-name to vm-nametotal-adding-time.

Failed to Select the Co-Owner

You must select at least one user from the autocomplete.

Select User to Be the VM Co-Owner

In the Add users, teams, groups field ensure you select the user for the co-owner position in the VM.

Remove Users from 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 virtual machine to remove users from.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Users section in the left panel.
  6. Next, select the user to remove.
  7. Click the Open Full Menu button in the top right panel.
  8. Then, select Remove user access.
  9. In the pop-up, click Delete user to proceed.
info

Removed VM users lose access to the VM but their home directory and group membership remain unchanged.

note

You cannot remove yourself from a VM if you are the sole owner.

Confirmations, Errors & Solutions
View More
Removed Users from VM Successfully

Remove user-name(s) from vm-nametotal-removing-time.

Failed to View Users Section in Virtual Machine

Failed to list users: insufficient permissions: users:list: missing permission: {PermUsers}.

Ask VM Users Permissions from VM Owner

Ask the VM owner to allow you to access the VM users section.



To Virtual Machine Owner
To allow VM users permissions to a VM user:  
  1. In the VMs section, click the virtual machine where you want to update a users' viewing users permissions.
  2. Click the VM Settings and Details option in the bottom center.
  3. In the new window, select the Users section in the left panel.
  4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
  5. Select Edit user access.
  6. In the pop-up, select profile to Custom.
  7. Scroll down under Permissions, and tick Users View other users.
  8. Click Save.

Edit Roles in a Virtual Machine

bulk-action

  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 virtual machine to edit management roles.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Users section in the left panel.
  6. Next, select the user(s) to manage.
  7. Click the Open Full Menu button in the top right panel.
  8. Then, select Edit user access.
  9. In the prompt, select the user(s) role between User or Manager.
  10. Click Save.
Confirmations, Errors & Solutions
View More
Updated Users' Roles VM Successfully

Updated user.

Edit Permissions in a Virtual Machine

bulk-action

  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 virtual machine to manage user permissions.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Users section in the left panel.
  6. Next, select the user(s) to manage.
  7. Click the Open Full Menu button in the top right panel.
  8. Then, select Edit user access.
  9. In the pop-up, tick or untick VM user(s) permissions.
  10. Click Save.
Confirmations, Errors & Solutions
View More
Updated Users' Permissions VM Successfully

Updated user.

Access User Profiles in 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 virtual machine to access user profiles.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Profiles section in the left panel.
note

All VM users can access profiles within their virtual machines. However, restrictions may apply to which users can apply the profiles.

Add User Profiles in 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 virtual machine to add user profiles.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Profiles section in the left panel.
  6. Click the Add new profile button in the top right panel.
  7. In the pop-up, enter the profile name.
  8. Select the role and permissions.
  9. Click Create Profile.
Confirmations, Errors & Solutions
View More
Failed to Enter User Profile Name

Did not enter user profile name in Add User Profiles to vm-name prompt.

Enter User Profile Name

Enter the user profile name in the Profile Name field.

Failed to Select User Profile Role

Must select a role.

Select User Profile Role

Select a user profile role under Role section.

Import User Profiles from the Same or Other Virtual Machines

  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 virtual machine to import user profiles.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Profiles section in the left panel.
  6. Click the Add new profile button in the top right panel.
  7. In the pop-up, tick Import profile from the same or other VM.
  8. Next, select the existing profile and enter a new profile name.
  9. Alter permissions for the new profile.
  10. Click Create Profile.

Apply Virtual Machine User Profile to User(s)

bulk-action

  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 virtual machine to edit management roles.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Users section in the left panel.
  6. Next, select the user(s) to manage.
  7. Click the Open Full Menu button in the top right panel.
  8. Then, select Edit user access.
  9. In the prompt, select the user(s) VM profile at the top.
  10. Click Save.
Confirmations, Errors & Solutions
View More
Applied Users' Profile VM Successfully

Updated user.

Edit User Profiles in a Virtual Machine

bulk-action

  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 virtual machine to edit user profiles.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Profiles section in the left panel.
  6. Click the Edit permissions button in the top right panel.
  7. Next, tick or untick permissions of the VM user profiles.
  8. Finally, click Save in the top right corner.
note
  • You can edit multiple VM profiles in bulk at the same time.
  • To edit a single profile, use the Edit button next to the user profile.
Confirmations, Errors & Solutions
View More
Failed to Enter User Profile Name

Updated total-number-of-user-profiles to vm-name (total-updating-time).

Delete User Profiles in 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 virtual machine to edit user profiles.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Profiles section in the left panel.
  6. Click the Remove button next to the user profile you want to delete.
  7. In the pop-up, click Remove to proceed.

Bulk Email Users from a Virtual Machine

bulk-action

  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 virtual machine to bulk email.
  4. Select Bulk Email.
  5. In the pop-up, click Copy to copy the VM's users emails or click Download to download them.
  6. Once done, click Close.
note

Tick the Prefer contact email? to use the email registered upon user account creation.

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
View More
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
View More
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.


View Logs in 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 virtual machine to view its logs.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Logs section in the left panel.
  6. View the last 50 logs entry.
  7. Click Load Older to view older logs or Download to download all logs.
  8. Once done, click Close.
Confirmations, Errors & Solutions
View More
Downloaded Logs Successfully

Downloading VM Logs.. total-downloading-time.

Failed to View the Logs Section, Previews and Button

Your do not have viewing statistics permissions from the VM owner.

Ask the VM Owner to Grant You Permissions

Ask the VM owner to allow you to view statistics of their virtual machine.



To VM Owner
To allow a VM user to view VM statistics:  

  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 virtual machine to update user permissions.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Users section in the left panel.
  6. Next, select the user whose VM permissions you want to update.
  7. Click the Open Full Menu button in the top right corner.
  8. Select Edit User Access.
  9. Scroll down, under Permissions and tick System Statistics permission.
  10. Once done, click Save.

Export Virtual Machine Data in JSON Format

bulk-action

  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 virtual machine to export in JSON format.
  4. Select JSON Export.
  5. In the pop-up, click Expand all fields button in the top left panel.
  6. View all JSON export object data by users, groups, drives, acess directories and profiles.
  7. Once done, click Copy to copy the JSON data or click Download to download the JSON data.
  8. Click Close.
note

Use the search bar in the JSON export pop-up to serch by keywords.

Confirmations, Errors & Solutions
View More
JSON Data Copied

JSON copied to the clipboard.

View the Libvirt XML Description of 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 virtual machine to view the Libvrit XML description.
  4. Select Libvirt XML description.
  5. In the pop-up, view the Libvirt XML description from the backend.
  6. Click Copy to copy the XML description or click Download to download the XML description.
  7. Once done, click Close.
caution

This feature may only be accessed by super-admins.

Confirmations, Errors & Solutions
View More
XML Data Copied

XML copied to the clipboard.

Open a VNC Terminal in 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 virtual machine to access the VNC terminal.
  4. Select Open VNC terminal.
  5. In the pop-up, use the VNC terminal.
  6. Once done, click Close.
caution

The VNC terminal is accessible only in debug mode VMs and should be used by system admins for debugging purposes.

Confirmations, Errors & Solutions
View More
Connected to VNC Terminal

Connected to vm-name.

Unable to Connect to VNC Terminal

Something went wrong, connection is closed.

Ask the VM Owner to Perform This Action

As a VM co-owner, manager or user you cannot perform this action. Only VM owners can open VNC terminals of their own VMs.

Open VNC Terminal Button Inactive

The Open VNC terminal is inactive in the Open Full Menu of the virtual machine.

Ask the VM Owner to Perform This Action

Only VM owners can open VNC terminals for their own VMs. VM owners must log in to the VNC terminal to perform debugging.

Restart Virtual Machine Controller

  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 virtual machine to restart controller.
  4. Select Restart Controller.
  5. In the pop-up, read the risks.
  6. Once done, click Restart.
caution

Restarting the controller takes a little while. We recommend to wait at least 15 seconds before using the virtual machine after a VM controller restart was performed.

Confirmations, Errors & Solutions
View More
Restarted VM Controller

VM restarting (wait at least 15s to reconnect).

Unauthorized to Restart VM Controller

You are not authorized to restart this VM.

Ask the VM Owner for Restart VM Controller Access

Ask the VM owner to allow you to restart the VM controller in their virtual machine.



To VM Owner
To allow a VM user to restart VM controller:  

  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 virtual machine to add users to.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Users section in the left panel.
  6. Next, select the user whose VM permissions you want to change.
  7. Click the Open Full Menu button in the top right corner.
  8. Select Edit User Access.
  9. Select the user role to Manager.
  10. Scroll down, under Permissions and tick Restart VM controller permission.
  11. Once done, click Save.
Open VNC Terminal Button Inactive

The Open VNC terminal is inactive in the Open Full Menu of the virtual machine.

Ask the VM Owner to Perform This Action

Only VM owners can open VNC terminals for their own VMs. VM owners must log in to the VNC terminal to perform debugging.

Forcefully Restart a Virtual Machine Controller

  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 virtual machine to restart controller.
  4. Select Restart Controller.
  5. In the pop-up, read the risks.
  6. Tick the box I know the risks of force restarting the controller and wish to force restart anyways.
  7. Once done, click Force Restart.
warning

Force restarting the VM controller kills all processes via an OS syscall. Do not force restart a controller while other users are active on the virtual machine, as this will corrupt their ongoing processes.

Confirmations, Errors & Solutions
View More
Restarted VM Controller

VM restarting (wait at least 15s to reconnect).

Sync Users’ Permissions in a Virtual Machine

bulk-action

  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 virtual machine to sync users' permissions.
  4. Select Sync User Permissions.
note

Due to the zero-trust principle, the backend might not recognize a user added in the frontend. Follow the instructions above to synchronize them.

Confirmations, Errors & Solutions
View More
Synced User Permissions

Sync user permissions total-syncing-time.

Repair Corrupted Databases in Virtual Machines

bulk-action

  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 virtual machine to repair corrupted database.
  4. Select Repair Corrupted Database.
  5. In the pop-up, enter the word Repair.
  6. Click Repair.
warning

Do not use this option unless instructed by an admin. Repairing may cause secondary issues when performed arbitrarily. All VM connections including RDP will be disconnected.

Confirmations, Errors & Solutions
View More
Repaired Corrupted Database

Repairing home drive for vm-nametotal-repairing-time.


Attach/mount drive-name to vm-name total-attaching-time.

Failed to Repair Corrupted Home Drive

First attempt to attach/mount home drive failed (will retry once): Libvirt Error: Storage volume not found: not storage vol with matching name 'drive-string-id.drive-format'.


Failed to load LUKS header from device: invalid argument.

Ask the System Admin to Review Home Drive

Ask the system admin to review the home drive connection to the Libvirt Volume and the local LUKS header loading. If the home drive is unrecoverable, migrate the data to a backup drive and create a new home drive from scratch.

Enable Applications to Virtual Machines

bulk-action

  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 virtual machine to enable applications.
  4. Select Enable applications.
note

This is a unique use case. Admins almoust never use this setup.

Confirmations, Errors & Solutions
View More
Enabled Applications Successfully

(No action confirmation. Verify action in the VM Settings and Details under Applications, Video annotation types section.)

Set a Project in 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 virtual machine to set project.
  4. Select Set Project.
  5. In the pop-up, select a project to tag the virtual machine.
  6. Click Classify.
Confirmations, Errors & Solutions
View More
Did Not Select Any Project

No change made.

Set Project Successfully

Set project of vm-name to project-name(total-setting-time).

Failed to Set Project

Changing a project tag on a running VM does not take effect until the VM is restarted, even if the VM configuration reflects the updated project tag.


Failed to load LUKS header from device: invalid argument.

Ask the VM Owner to Restart VM

Ask the VM owner to restart the VM. Once the VM is restarted ensure you re-login to view the changes.



To Virtual Machine Owner
To restart the VM, follow the steps in 

Restart a Virtual Machine.


Forcefully Set a Project in 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 virtual machine to set project.
  4. Select Set Project.
  5. In the pop-up, select any project to tag the virtual machine.
  6. Click Force change with admin priviledge.
note

Forcefully tagging a virtual machine with a project is only available to users with admin or super-admin roles in the system.

caution

Changing a project tag on a running VM does not take effect until the VM is restarted, even if the VM configuration reflects the updated project tag.

Confirmations, Errors & Solutions
View More
Did Not Select Any Project

No change made.

Forcefully Set Project Successfully

Set project for vm-name(total-settting-time).

Failed to Set Project

Changing a project tag on a running VM does not take effect until the VM is restarted, even if the VM configuration reflects the updated project tag.


Failed to load LUKS header from device: invalid argument.

Ask the VM Owner to Restart VM

Ask the VM owner to restart the VM. Once the VM is restarted ensure you re-login to view the changes.



To Virtual Machine Owner
To restart the VM, follow the steps in 

Restart a Virtual Machine.


Manage Projects from 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 project tag on the virtual machine to manage.
  4. In the new window, click Open Overlay in the top right corner.
  5. In the pop-up, manage the Members, Member Certifications, Subprojects and Security Requirements of the project in the virtual machine.

Remove a Project from 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 virtual machine to set project.
  4. Select Set Project.
  5. In the pop-up, select No project (unlocked) to remove the project tag from VM.
  6. Click Declassify.
note

If you are a super-admin and do not belong to the project, you can use the Force change with admin privilege option to forcibly remove a project tag.

Confirmations, Errors & Solutions
View More
Removed Project Successfully

Declassify vm-name completely (using 'set' privilege) (total-declassifying-time).

Disconnect from 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 Disconnect VM button by the virtual machine to disconnect.

Transfer Files from a Virtual Machine into the Vault

bulk-action

  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 virtual machine to transfer files from.
  4. Click the File Transfer option in the center.
  5. In the new window, drag-and-drop the files from the right panel (the virtual machine) to the left panel (the vault).
  6. Once done, click Close.

Transfer Files from the Vault into a Virtual Machine

bulk-action

  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 virtual machine to transfer files to.
  4. Click the File Transfer option in the center.
  5. In the new window, drag-and-drop the files from the left panel (the vault) to the right panel (the virtual machine).
  6. Once done, click Close.
Confirmations, Errors & Solutions
View More
File Transfer Button is Inactive in Virtual Machine

The File Transfer button is inactive in the Virtual Machines' right panel.

Ask VM Files Permissions from VM Owner

Ask the VM owner to allow you to access the VM files section.



To Virtual Machine Owner
To allow VM users permissions to VM Files:  
  1. In the VMs section, click the virtual machine where you want to update a users' files permissions.
  2. Click the VM Settings and Details option in the bottom center.
  3. In the new window, select the Users section in the left panel.
  4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
  5. Select Edit user access.
  6. In the pop-up, select profile to Custom.
  7. Scroll down under Permissions, and tick all the following permissions.
    • Files View/edit files.
    • VM to Vault Transfer Transfer file to tiCrypt Vault from VM.
    • Vault to VM Transfer Upload files to VM and create directories.
  8. Click Save.
Confirmations, Errors & Solutions
View More
File Transfer Button is Inactive in Virtual Machine

The File Transfer button is inactive in the Virtual Machines' right panel.

Ask VM Files Permissions from VM Owner

Ask the VM owner to allow you to access the VM files section.



To Virtual Machine Owner
To allow VM users permissions to VM Files:  
  1. In the VMs section, click the virtual machine where you want to update a users' files permissions.
  2. Click the VM Settings and Details option in the bottom center.
  3. In the new window, select the Users section in the left panel.
  4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
  5. Select Edit user access.
  6. In the pop-up, select profile to Custom.
  7. Scroll down under Permissions, and tick all the following permissions.
    • Files View/edit files.
    • VM to Vault Transfer Transfer file to tiCrypt Vault from VM.
    • Vault to VM Transfer Upload files to VM and create directories.
  8. Click Save.

Explore Files in 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 virtual machine whose files you want to explore.
  4. Click the File Explorer option in the center.
  5. Explore the drives and access directories of the virtual machine.
Confirmations, Errors & Solutions
View More
File Explorer Button is Inactive in Virtual Machine

The File Explorer button is inactive in Virtual Machines' right panel.

Ask VM Files Permissions from VM Owner

Ask the VM owner to allow you to access the VM Files sections.



To Virtual Machine Owner
To allow VM users permissions to VM Files:  
  1. In the VMs section, click the virtual machine where you want to update a users' files permissions.
  2. Click the VM Settings and Details option in the bottom center.
  3. In the new window, select the Users section in the left panel.
  4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
  5. Select Edit user access.
  6. In the pop-up, select profile to Custom.
  7. Scroll down under Permissions, and tick all the following permissions.
    • Files View/edit files.
    • VM to Vault Transfer Transfer file to tiCrypt Vault from VM.
    • Vault to VM Transfer Upload files to VM and create directories.
  8. Click Save.
Confirmations, Errors & Solutions
View More
File Explorer Button is Inactive in Virtual Machine

The File Explorer button is inactive in Virtual Machines' right panel.

Ask VM Files Permissions from VM Owner

Ask the VM owner to allow you to access the VM Files sections.



To Virtual Machine Owner
To allow VM users permissions to VM Files:  
  1. In the VMs section, click the virtual machine where you want to update a users' files permissions.
  2. Click the VM Settings and Details option in the bottom center.
  3. In the new window, select the Users section in the left panel.
  4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
  5. Select Edit user access.
  6. In the pop-up, select profile to Custom.
  7. Scroll down under Permissions, and tick all the following permissions.
    • Files View/edit files.
    • VM to Vault Transfer Transfer file to tiCrypt Vault from VM.
    • Vault to VM Transfer Upload files to VM and create directories.
  8. Click Save.

Open a Virtual Machines’ Terminal Hub

  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 virtual machine to open its terminal.
  4. Click the Open Terminal option in the center.
  5. Use the terminal console.
Confirmations, Errors & Solutions
View More
Open Terminal Button is Inactive in Virtual Machine

The Open Terminal button is inactive in Virtual Machines' right panel.

Ask Open Terminal Permissions from VM Owner

Ask the VM owner to allow you to open the VM terminal.



To Virtual Machine Owner
To allow VM users permissions to VM Terminal:  
  1. In the VMs section, click the virtual machine where you want to update a users' terminal permissions.
  2. Click the VM Settings and Details option in the bottom center.
  3. In the new window, select the Users section in the left panel.
  4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
  5. Select Edit user access.
  6. In the pop-up, select profile to Custom.
  7. Scroll down under Permissions, and tick Terminals Open terminals through tiCrypt.
  8. Click Save.
Confirmations, Errors & Solutions
View More
Open Terminal Button is Inactive in Virtual Machine

The Open Terminal button is inactive in Virtual Machines' right panel.

Ask Open Terminal Permissions from VM Owner

Ask the VM owner to allow you to open the VM terminal.



To Virtual Machine Owner
To allow VM users permissions to VM Terminal:  
  1. In the VMs section, click the virtual machine where you want to update a users' terminal permissions.
  2. Click the VM Settings and Details option in the bottom center.
  3. In the new window, select the Users section in the left panel.
  4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
  5. Select Edit user access.
  6. In the pop-up, select profile to Custom.
  7. Scroll down under Permissions, and tick Terminals Open terminals through tiCrypt.
  8. Click Save.

Perform an SFTP to VM Transfer from a Local Machine to a Virtual Machine

bulk-action

  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 virtual machine to transfer files to.
  4. Click the SFTP to VM option in the center.
  5. In the pop-up, click Copy to copy the username, password, host and port to your SFTP client.
info

For LFTP or SSHFS transfers, visit the Remote File System section.

View Live Quota Consumption of 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 virtual machine to view the live quota consumption.
  4. Click the VM Settings and Details option in the center right.
  5. In the new window, view the following.
  • CPU : Central Processing Unit of the VM.
  • MEM : Memory Used by the VM.
  • IN : Ammount of kilobytes received.
  • OUT : Ammount of kilobytes sent.
  • DRIVE : Home drive usage.
  • WARNING : Drives warnings and errors.

Edit Quotas Consumption in a Virtual Machine

You cannot edit quotas of a virtual machine. Quotas in virtual machines are part of the team using the virtual machine. To edit a virtual machine quota consumption, you must edit the quotas of the team using the virtual machine.

note

To edit drive capacity of a virtual machine you must create a new drive or a new virtual machine.

Repair an Unattached Drive in 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 virtual machine to repair drive.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, under drive warnings, click the Repair button next to the drive warning.
note

There are various reasons why a drive may not work properly. Consult your admin for further guidance.

Create a Group in 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 virtual machine to create a VM group.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Groups section in the left panel.
  6. Click the Create group button in the top right panel.
  7. In the pop-up, enter the group name.
  8. Click Create group.

Sync Multiple Groups in a Virtual Machine

bulk-action

  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 virtual machine to sync its VM groups.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Groups section in the left panel.
  6. Click the Sync all groups button in the top right panel.
note

Syncing multiple groups from various admins helps you set up the VM infrastructure at scale.

Add Members to a Virtual Machine Group

bulk-action

  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 virtual machine whose group you want to add members to.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Groups section in the left panel.
  6. Select the existing group to add new members.
  7. Click the Open Full Menu button in the top right panel.
  8. Select Edit membership.
  9. In the prompt, enter the user names to add to the group.
  10. Click Update membership.
info

You can only add the members who belong to the existing virtual machine.

tip

If you accidentally add a user to the virtual machine group, click Undo to reverse the action.

Remove Members from a Virtual Machine Group

  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 virtual machine whose group you want to remove members from.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Groups section in the left panel.
  6. Select the existing group to remove its members.
  7. Click the Open Full Menu button in the top right panel.
  8. Select Edit membership.
  9. In the prompt, click Delete next to the user names you want to remove.
  10. Click Update membership.
caution

Removing a user from a virtual machine group does not revoke their access to the virtual machine.

Open Access Control List Templates in 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 virtual machine whose access control list templates you want to view.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Access Control List (ACL) templates section in the left panel.
  6. View the access control list templates.

Create an Access Control List Template in 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 virtual machine for which you want to create access control list templates.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Access Control List (ACL) templates section in the left panel.
  6. Click Add ACL template button in the top right panel.
  7. In the pop-up, enter the ACL name and optional description.
  8. Select the appropriate permissions.
  9. Click Save.

Import an Access Control List Template from an Existing 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 virtual machine for which you want to import access control list templates.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Access Control List (ACL) templates section in the left panel.
  6. Click Add ACL template button in the top right panel.
  7. In the pop-up, tick Import templates from same or other VM.
  8. Next, select an existing ACL template from the list.
  9. Update the ACL name, description and permissions.
  10. Click Save.
note

Importing an ACL template helps you create similar templates quickly.

Edit an Access Control List Template in 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 virtual machine whose access control list templates you want to edit.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Access Control List (ACL) templates section in the left panel.
  6. Select the access control list template to edit.
  7. Click the Open Full Menu button in the top right panel.
  8. Select Edit.
  9. In the pop-up, edit the access control list template name and optional descripion.
  10. Click Save.

View Details of Access Control List Templates in 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 virtual machine whose access control list templates you want to view.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Access Control List (ACL) templates section in the left panel.
  6. Select the access control list template to view.
  7. Click the View button in the top right panel.
  8. In the new window, view the name, description and built-in status of the access control list template.

Refresh Details of Access Control Lists Templates in a Virtual Machine

bulk-action

  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 virtual machine whose access control list templates you want to refresh.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Access Control List (ACL) templates section in the left panel.
  6. Select the access control list template to refresh.
  7. Click the View button in the top right panel.
  8. In the new window, click the Refresh button in the top right panel.

Replace Access Control List Templates in Virtual Machines

bulk-action

  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 virtual machine whose access control list templates you want to replace.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Access Control List (ACL) templates section in the left panel.
  6. Select the access control list template you want to replace.
  7. Click the Open Full Menu button in the top right panel.
  8. Select Replace ACL Template.
  9. In the prompt, select between Read-write, Read-only or Full control options.
  10. Click Replace.
note
  • Yout ACL template must have at least one access directory to be able to replace another ACL template.
  • Replacing ACL templates allows you to change permissions consistently accross all access directories using a similar ACL template. This helps you make changes at scale.

Delete Access Control Lists Templates in 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 virtual machine whose access control list templates you want to delete.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Access Control List (ACL) templates section in the left panel.
  6. Select the access control list template to delete.
  7. Click the Open Full Menu button in the top right panel.
  8. Select Delete ACL template.
  9. In the prompt, type "Delete" followed by the name of the access control list.
  10. Click Delete.

View an Access Directory for a Virtual Machine Group

  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 virtual machine to view the access directory.
  4. Next, click the Access Directories button.
  5. In the new window, select the access directory to view.
  6. Click the View button in the top right panel.
  7. In the new window, view the access directory basic information, owner and group.
Confirmations, Errors & Solutions
View More
Access Directories Button is Inactive in Virtual Machine

The Access Directories button is inactive in Virtual Machines' right panel.

Ask Access Directories Permissions from VM Owner

Ask the VM owner to allow you to open the VM access directories.



To Virtual Machine Owner
To allow VM users permissions to VM access directories:  
  1. In the VMs section, click the virtual machine where you want to update a users' access directories permissions.
  2. Click the VM Settings and Details option in the bottom center.
  3. In the new window, select the Users section in the left panel.
  4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
  5. Select Edit user access.
  6. In the pop-up, select profile to Custom.
  7. Scroll down under Permissions, and tick Access Directories View access directories.
  8. Click Save.
Failed to Look Up Drive in Access Directory

Failed to look up drive name:insufficient permissions: drives:list:missing permissions: {PermDrives}

Ask Drive Permissions from Your Admin

Ask the VM owner to allow you to view drives.



To Admin
To allow VM users permissions to VM access directories:  
  1. In the VMs section, click the virtual machine where you want to update a users' access directories permissions.
  2. Click the VM Settings and Details option in the bottom center.
  3. In the new window, select the Users section in the left panel.
  4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
  5. Select Edit user access.
  6. In the pop-up, select profile to Custom.
  7. Scroll down under Permissions, and tick Access Directories View access directories.
  8. Click Save.

Refresh an Access Directory Data for a Virtual Machine Group

bulk-action

  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 virtual machine to view the access directory.
  4. Next, click the Access Directories button.
  5. In the new window, select the access directory whose data you want to refresh.
  6. Click the View button in the top right panel.
  7. In the new window, click the Refresh button in the top right panel.

Repair Permissions in an Access Directory for a Virtual Machine Group

bulk-action

  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 virtual machine to view the access directory.
  4. Next, click the Access Directories button.
  5. In the new window, select the access directory whose permissions you want to repair.
  6. Click the View button in the top right panel.
  7. In the new window, click the Open Full Menu button in the top right panel.
  8. Select Repair Permissions.
note

The Repair Permissions option only displays when there is an issue with permissions in the access directory.

Create an Access Directory for a Virtual Machine Group

  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 virtual machine to create an access directory in.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Access directories section in the left panel.
  6. Click Create access directory in the top right panel.
  7. In the prompt, select the access directory location.
  8. Next, enter the directory name and owner.
  9. Optionally, for Windows and Linux OS, enter the users and groups permissions associated with the access control list.
  10. Click Create.
info

To create a new group for the access directory from scratch, click Create new group button in the prompt.

Confirmations, Errors & Solutions
View More
Created Access Directory Successfully

Created access directory.

Failed to Enter Access Directory Name

You must enter a name.

Enter Access Directory Name

Enter the access directory name in the Name field.

Failed to Select an Access Directory Owner

You must select an owner.

Select an Access Directory Owner

Under the Owner field, select an access directory owner.

Failed to Select an ACL Template

ACL template not selected.

Select an ACL Template

Under the Users and/or Groups field, select an access control list template if needed.

Failed to Create Access Directory

Failed to create access directory: [restricted-action]: action is restricted: accessDirectories:create.

Select A Read-Only VM Drive in Prompt

In the Create Access Directory on vm-name prompt, select a read-only drive. Access directories cannot be created on read-write drives in VMs.

Sync All Permissions for Access Directories in a Virtual Machine

bulk-action

  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 virtual machine to sync its access directory permissions.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Access directories section in the left panel.
  6. Click Sync all permissions in the top right panel.
Confirmations, Errors & Solutions
View More
Created Access Directory Successfully

Sync permissions for access-directory-name (total-syncing-time).

Edit an Access Directory for a Virtual Machine Group

  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 virtual machine to edit its access directory.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Access directories section in the left panel.
  6. Click the Open Full Menu button in the top right panel.
  7. Select Edit access directory.
  8. In the prompt, update the directory name and owner.
  9. Optionally, for Windows and Linux OS, enter the users and groups permissions associated with the access control list.
  10. Click Update.
note

You cannot edit your Home access directory.

Confirmations, Errors & Solutions
View More
Created Access Directory Successfully

Update access directory access-directory-name (total-updating-time).

Refresh an Access Directory Data for a Virtual Machine Group

bulk-action

  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 virtual machine to refresh its access directory.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Access directories section in the left panel.
  6. Select the access directory whose data you want to refresh.
  7. Click the View button in the top right panel.
  8. In the new window, click the Refresh button in the top right corner.

Repair Permissions in an Access Directory for a Virtual Machine Group

bulk-action

  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 virtual machine to repair its access directory.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Access directories section in the left panel.
  6. Select the access directory whose data you want to repair.
  7. Click the View button in the top right panel.
  8. In the new window, click the Repair Permissions button in the top right corner.

Delete an Access Directory for a Virtual Machine Group

Method one

  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 virtual machine to delete its access directory.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Access directories section in the left panel.
  6. Select the access directory you want to delete.
  7. Click the Open Full Menu button in the top right panel.
  8. Select Remove access directory.

Method two

  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 virtual machine to delete its access directory.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Access directories section in the left panel.
  6. Select the access directory you want to delete.
  7. Click the View button in the top right panel.
  8. In the new window, click Delete in the top right panel.
  9. In the pop-up, click Delete access directory.
caution

When you delete an access directory, all its members lose access to it until you create another access directory. You cannot delete your Home access directory.

Confirmations, Errors & Solutions
View More
Created Access Directory Successfully

Delete total-number-of-access-directories access directories (total-deletion-time).

Access the Virtual Machine Controller Logs

  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 virtual machine to access its controller logs.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Logs section in the left panel.
  6. View the logs.
  7. Optionally, click the Load Older button to view older VM logs.

Download All Virtual Machine Controller Logs

bulk-action

  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 virtual machine to download its controller logs.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Logs section in the left panel.
  6. View the logs.
  7. Click the Download button in the bottom right corner.
caution

Downloading VM logs should be restricted to VM managers, owners, and admins only.

Confirmations, Errors & Solutions
View More
Created Access Directory Successfully

Downloading VM Logs.. (total-downloading-time).

Access the Virtual Machine Applications

  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 virtual machine to access its applications.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Video annotation types section in the left panel.
  6. View the existing video annotation templates.
Confirmations, Errors & Solutions
View More
Unable to View Video Annotation Template Section

Cannot view the Video annotation types section, in VM Settings and Details.

Ask Admin to Create a New Windows Virtual Machine

Your VM may be a Linux VM. Only Windows VMs use video annotation types. Ask your admin to give you access to an existing Windows VM or create a new Windows VM from scratch.

Create a Video Annotation Template

  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 virtual machine to create its video annotation template.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Video annotation types section in the left panel.
  6. Click Add template in the top right panel.
  7. In the prompt, enter the template name.
  8. Select the annotation type and directory.
  9. Optionally, select the export directory and the custom video playback buffer size.
  10. Click Create Templates.
caution

You can only have one video annotation template per directory.

tip
  • Use smaller buffer size to optimize template for minimal buffering delay. Ideal for fast and stable internet connections.
  • Use larger buffer size to increase template data pre-loading to enhance playback stability. Ideal for slower or less reliable internet connections.
Confirmations, Errors & Solutions
View More
Failed to Enter Video Annotation Name

You must enter a name.

Enter Video Annotation Name

In the Add annotation templete to vm-name prompt, enter the annotation name in the name field.

Create Templates Button Inactive

You must select a home-access directory where the template will be created.

Select Home Access Directory from List

Under Choose a Directory select an existing drive or home access directory for the video annotation template.

View an Existing Video Annotation Template

  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 virtual machine to view its video annotation template.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Video annotation types section in the left panel.
  6. Select the video annotation template to view.
  7. Click the View button in the top right panel.
  8. In the new window, view the categories and tags of the video annotation template.

Add a Category to Video Annotation Template

  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 virtual machine to add category to its video annotation template.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Video annotation types section in the left panel.
  6. Select the video annotation template to add category.
  7. Click the View button in the top right panel.
  8. In the new window, click the Edit button on the right.
  9. Next, click Add category in the top-left panel.
  10. In the prompt, enter the category name.
  11. Click Create category.
  12. Click the Save button on the top right.

Add a Category Tag in Video Annotation Template

  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 virtual machine to which you want to add a category tag in its video annotation template.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Video annotation types section in the left panel.
  6. Select the video annotation template to add tag to its category.
  7. Click the View button in the top right panel.
  8. In the new window, click the Edit button on the right.
  9. Next, click Add tag to category next to the category you want to add a tag to.
  10. Enter the tag name below category name.
  11. Tick the VM groups who will be tagged in the category.
  12. Once done, click the Save button on the top right.
note

The default tag is set to Everybody, which includes all users from the virtual machine.

Edit a Category Tag in Video Annotation Template

  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 virtual machine for which you want to edit a category tag in its video annotation template.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Video annotation types section in the left panel.
  6. Select the video annotation template to edit tag to its category.
  7. Click the View button in the top right panel.
  8. In the new window, click the Edit button on the right.
  9. Next, update the tag name below category name or the VM users the tag applies to.
  10. Once done, click the Save button on the top right.

Edit a Video Annotation Template

  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 virtual machine to edit its video annotation template.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Video annotation types section in the left panel.
  6. Select the video annotation template to edit.
  7. Click the Open full menu button in the top right panel.
  8. Select Edit.
  9. In the prompt, update the annotation name, type, directory, export directory or video playback buffer size.
  10. Once done, click Save Changes.

Export a Video Annotation Template in JSON Format

  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 virtual machine to export its video annotation template.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Video annotation types section in the left panel.
  6. Select the video annotation template to export.
  7. Click the Open full menu button in the top right panel.
  8. Select Export annotation.
  9. In the prompt, select the export directory.
  10. Click Export.
Confirmations, Errors & Solutions
View More
Deleted Video Annotation Template

Exporting template-name to JSON (total-exporting-time).

Delete a Category Tag in Video Annotation Template

  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 virtual machine for which you want to delete a category tag in its video annotation template.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Video annotation types section in the left panel.
  6. Select the video annotation template to delete tag from its category.
  7. Click the View button in the top right panel.
  8. In the new window, click the Edit button on the right.
  9. Next, click the Delete button next to the tag you want to remove.
  10. In the prompt, click Delete tag.

Delete a Category in Video Annotation Template

  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 virtual machine for which you want to delete a category in its video annotation template.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Video annotation types section in the left panel.
  6. Select the video annotation template to delete its category.
  7. Click the View button in the top right panel.
  8. In the new window, click the Edit button on the right.
  9. Next, click the Remove category button next to the category you want to delete.
  10. In the prompt, click Delete category.
Confirmations, Errors & Solutions
View More
Deleted Video Annotation Template

Deleted category-name.

Delete a Video Annotation Template

  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 virtual machine to delete its video annotation template.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Video annotation types section in the left panel.
  6. Select the video annotation template to delete.
  7. Click the Open full menu button in the top right panel.
  8. Select Delete.
  9. In the prompt, click Delete.
Confirmations, Errors & Solutions
View More
Deleted Video Annotation Template

Delete total-number-of-annotation-templates templates(s) (total-deletion-time).

View Drives Capacity of a Virtual Machine

bulk-action

Method One

  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 virtual machine to view its drive capacity.
  4. In the bottom right, under Drives section, view the drive name, total, used and percentage capacities.

Method Two

  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 virtual machine to view its drive capacity.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, click the Overview section in the left panel.
  6. Under the Drives card, view the drive name, total, used and percentage capacities.

Restart 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. Select the virtual machine you want to restart.
  4. In the left panel, click the Open Full Menu button next to the virtual machine.
  5. Select Power.
  6. In the pop-up, click Restart.
Confirmations, Errors & Solutions
View More
Restarted VM Successfully

Restart vm-nametotal-restart-time.

Inactive Restart Button in Virtual Machine

Only VMs you own can be restarted.

Ask VM Co-ownership from VM Owner

Ask the VM owner to allow you to co-own the VM.



To Virtual Machine Owner
To allow VM users to co-own your VM:  
  1. In the VMs section, click the virtual machine where you want to update a users' role in the VM.
  2. Click the VM Settings and Details option in the bottom center.
  3. In the new window, select the Users section in the left panel.
  4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
  5. Select Edit user access.
  6. In the pop-up, select profile to Custom.
  7. Scroll down under Role, and select Co-owner.
  8. Click Save.
Confirmations, Errors & Solutions
View More
Restarted VM Successfully

Restart vm-nametotal-restart-time.

Inactive Restart Button in Virtual Machine

Only VMs you own can be restarted.

Ask VM Co-ownership from VM Owner

Ask the VM owner to allow you to co-own the VM.



To Virtual Machine Owner
To allow VM users to co-own your VM:  
  1. In the VMs section, click the virtual machine where you want to update a users' role in the VM.
  2. Click the VM Settings and Details option in the bottom center.
  3. In the new window, select the Users section in the left panel.
  4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
  5. Select Edit user access.
  6. In the pop-up, select profile to Custom.
  7. Scroll down under Role, and select Co-owner.
  8. Click Save.

Shut Down 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. Select the virtual machine you want to shut down.
  4. In the left panel, click the Open Full Menu button next to the virtual machine.
  5. Select Power.
  6. In the pop-up, click Normal Shutdown.
Confirmations, Errors & Solutions
View More
Shut Down VM Successfully

Shutdown vm-nametotal-shutdown-time.

Failed to Access Power Button in Virtual Machine's Open Full Menu

Failed to view the Power button in the VM's Open Full Menu.

Ask VM Owner for Shutdown Permissions

Ask the VM owner to allow you to shut down your VMs.



To Virtual Machine Owner
To allow VM users to shut down their VMs:  

  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 Shutdown own VMs permission.
  6. Once done, click Save in the top center.
Frozen Screen When Clicking Power Button in Virtual Machine's Open Full Menu

As a co-owner, manager or user of a virtual machine, the screen freezes when you click the Power button in the VM's Open Full Menu.

Ask VM Owner to Shut Down the Virtual Machine

Ask the VM owner to shut down their virtual machine.



Note: The virtual machine may have a drive error such as an unattached home-drive.
Failed to Shut Down the Virtual Machine

Failed to shut down vm-name: Cannot read properties of undefined (reading 'suppressErrors').

Ask VM Owner to Repair Corrupted Database in the Virtual Machine

Ask the VM owner to shut down their virtual machine and  

repair corrupted database

If the issue persist contact the system administrator.



Note: You may also be unable to connect to the virtual machine.

Forcefully Shut Down 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. Select the virtual machine you want to forcefully shut down.
  4. In the left panel, click the Open Full Menu button next to the virtual machine.
  5. Select Power.
  6. In the pop-up, read the risks.
  7. Tick the box I accept the risk.
  8. Click Hard shutdown.
warning

Use the Hard Shutdown command only as a last resort.

Confirmations, Errors & Solutions
View More
Force Shut Down VM Successfully

Force shutdown vm-nametotal-force-shutdown-time.

Failed to Forcefully Shut Down the Virtual Machine

Failed to shut down vm-name: Cannot read properties of undefined (reading 'suppressErrors').

Ask VM Owner to Repair Corrupted Database in the Virtual Machine

Ask the VM owner to shut down their virtual machine and  

repair corrupted database

If the issue persist contact the system administrator.



Note: You may also be unable to connect to the virtual machine.