Contents
Managing virtual machines
You can create, install, or delete installed virtual machines and virtual machines pending installation. You can also view lists of virtual machines with preset and custom operating systems.
Page topCreating a virtual machine
You can create a virtual machine in one of the following ways:
- In the Virtual machines section.
- In the table of templates.
- In the template view.
The virtual machine template must be turned off. After the virtual machines is created, it must be installed.
Internet access is required to create a virtual machine with a custom operating system image.
Page topCreating a virtual machine in the Virtual machines section
To create a virtual machine with a preset operating system image in the Virtual machines section:
- In the Sandbox web interface window, select the Templates & Storage section.
- Go to the Virtual machines section.
- Click Create VM.
This opens the virtual machine creation window.
- In the Template drop-down list, select a template for the virtual machine.
If the list does not contain a suitable template, you can import or create a template in the Templates section of the Sandbox web interface window.
- In the Name field, type the name of the virtual machine.
- In the Description field, enter the description of the virtual machine. This field is optional.
- Click Add.
- Some operating systems from the distribution kit require accepting the terms of the relevant end user license agreement. Read the text of the end user license agreement and click Accept.
The virtual machine with a preset operating system image is created.
To create a virtual machine with a custom operating system image in the Virtual machines section:
- In the Sandbox web interface window, select the Templates & Storage section.
- Go to the Virtual machines section.
- Click Create VM.
This opens the virtual machine creation window.
- In the Template drop-down list, select a template for the virtual machine.
If the list does not contain a suitable template, you can import or create a template in the Templates section of the Sandbox web interface window.
- In the Name field, type the name of the virtual machine.
The name must consist of Latin characters.
- In the Description field, enter the description of the virtual machine. This field is optional.
- Click Add.
- If internet access is not configured for the server on which you are creating the virtual machine, the No internet access error message is displayed in the Templates window. To complete the virtual machine creation process, you must download debug symbols.
The virtual machine with a custom operating system image is created.
Page topCreating a virtual machine in the table of templates
To create a virtual machine with a preset operating system image in the template table:
- In the Sandbox web interface window, select the Templates & Storage section.
Go to the Templates section.
- In the Actions column next to the template, click Create VM.
This opens the virtual machine creation window.
- In the Template drop-down list, select a template for the virtual machine.
If the list does not contain a suitable template, you can import or create a template in the Templates section of the Sandbox web interface window.
- In the Name field, type the name of the virtual machine.
- In the Description field, enter the description of the virtual machine. This field is optional.
- Click Add.
- Some operating systems from the distribution kit require accepting the terms of the relevant end user license agreement. Read the text of the end user license agreement and click Accept.
The virtual machine with a preset operating system image is created.
To create a virtual machine with a custom operating system image in the template table:
- In the Sandbox web interface window, select the Templates & Storage section.
Go to the Templates section.
- In the Actions column next to the template, click Create VM.
This opens the virtual machine creation window.
- In the Template drop-down list, select a template for the virtual machine.
If the list does not contain a suitable template, you can import or create a template in the Templates section of the Sandbox web interface window.
- In the Name field, type the name of the virtual machine.
The name must consist of Latin characters.
- In the Description field, enter the description of the virtual machine. This field is optional.
- Click Add.
- If internet access is not configured for the server on which you are creating the virtual machine, the No internet access error message is displayed in the Templates window. To complete the virtual machine creation process, you must download debug symbols.
The virtual machine with a custom operating system image is created.
Page topCreating a virtual machine in the template view
To create a virtual machine with a preset operating system image in the template view:
- In the Sandbox web interface window, select the Templates & Storage section.
- Go to the Templates section.
- Select the relevant template.
- Click Create VM.
This opens the virtual machine creation window.
- In the Template drop-down list, select a template for the virtual machine.
If the list does not contain a suitable template, you can import or create a template in the Templates section of the Sandbox web interface window.
- In the Name field, type the name of the virtual machine.
- In the Description field, enter the description of the virtual machine. This field is optional.
- Click Add.
- Some operating systems from the distribution kit require accepting the terms of the relevant end user license agreement. Read the text of the end user license agreement and click Accept.
The virtual machine with a preset operating system image is created.
To create a virtual machine with a custom operating system image in the template view:
- In the Sandbox web interface window, select the Templates & Storage section.
- Go to the Templates section.
- Select the relevant template.
- Click Create VM.
This opens the virtual machine creation window.
- In the Template drop-down list, select a template for the virtual machine.
If the list does not contain a suitable template, you can import or create a template in the Templates section of the Sandbox web interface window.
- In the Name field, type the name of the virtual machine.
The name must consist of Latin characters.
- In the Description field, enter the description of the virtual machine. This field is optional.
- Click Add.
- If internet access is not configured for the server on which you are creating the virtual machine, the No internet access error message is displayed in the Templates window. To complete the virtual machine creation process, you must download debug symbols.
The virtual machine with a custom operating system image is created.
Page topViewing the table of virtual machines with preset operating systems
To view the list of virtual machines with preset operating systems:
- Select the Virtual machines section in the window of the Sandbox web interface.
- Select the Preconfigured tab.
The table of virtual machines with preset operating systems is displayed.
The table contains the following information:
- Name is the name of the virtual machine.
- Status is the status of the virtual machine, for example, Enabled or Disabled.
- Actions are operations available for the virtual machine. The following operations may be available: Delete.
The Not installed virtual machines section displays virtual machines that are ready for installation but have not yet been installed.
Page topViewing the table of virtual machines with custom operating systems
To view the list of virtual machines with custom operating systems:
- Select the Virtual machines section in the window of the Sandbox web interface.
- Select the Custom tab.
The table of virtual machines with custom operating systems is displayed.
The table contains the following information:
- Created is the time when the virtual machine was created.
- Name is the name of the virtual machine.
- Status is the status of the virtual machine, for example, Enabled or Disabled.
- Actions are operations available for the virtual machine. The following operations may be available: Delete.
- Description is the description specified when creating the virtual machine.
Installing a virtual machine
After creating a virtual machine, it must be installed.
To install a virtual machine with a preset operating system image:
- Select the Virtual machines section in the window of the Sandbox web interface.
- Select the Preconfigured tab.
- In the Not installed virtual machines section, click Install ready VMs.
All virtual machines pending installation are installed.
To install a virtual machine with a custom operating system image:
- Select the Virtual machines section in the window of the Sandbox web interface.
- Select the Custom tab.
- Next to the relevant virtual machine in the Actions column, click the Install link.
- When the virtual machine is installed, in the Actions column, click the Enable link.
The virtual machine is installed and ready to use.
Page topDeleting a virtual machine
To delete an installed virtual machine:
- Select the Virtual machines section in the window of the Sandbox web interface.
- Select the Preconfigured or Custom tab.
- In the Actions column next to the relevant virtual machine, click Delete.
The virtual machine is deleted.
To delete a non-installed virtual machine with a preset operating system image:
- Select the Virtual machines section in the window of the Sandbox web interface.
- In the Not installed virtual machines section, click Delete all pending VMs.
All virtual machines with preset operating system images that are pending installation are deleted.
To delete a non-installed virtual machine with a custom operating system image:
- Select the Virtual machines section in the window of the Sandbox web interface.
- Select the Custom tab.
- Next to the relevant virtual machine in the Actions column, click the Delete link.
The virtual machine with a custom operating system image that is pending installation is deleted.
Page topDownloading debug symbols
If internet access is not configured for the server on which the virtual machine with the custom image is installed, you must download the Microsoft debug symbols to correctly complete the virtual machine installation.
You can download debug symbols during virtual machine installation in the Templates window or after the virtual machine receives the Failed status in the list of virtual machines.
For debug symbols to download correctly, the operating system used for the virtual machine template must have Windows Debug Tools installed and the name of the host connected to the network (hostname) must contain only Latin letters, numerals, and special characters.
To download debug symbols during virtual machine installation in the Templates window:
- In the Sandbox web interface window, select the Templates & Storage section.
- Go to the Templates section.
- Select the relevant template.
- In the window with the No internet access error, click Download manifesto.
The Download manifesto is not available until the virtual machine gets the Failed status.
An archive is downloaded to your computer.
- Unpack the downloaded archive.
- Run the sbsymtool.ps1 using Windows PowerShell.
The archive with debug symbols is downloaded to the folder where this file is located.
- In the Sandbox web interface window, select the Templates & Storage section.
- Go to the Templates section.
- Select the template for which you have downloaded debug symbols.
- In the Actions drop-down list, select Upload symbols.
- This opens a window; in that window, select the archive with the debug symbols and click Open.
Debug symbols are downloaded. The virtual machine is installed and displayed in the list of virtual machines running custom operating systems.
To download debug symbols after a virtual machine has received the Failed status in the list of virtual machines:
- In the Sandbox web interface window, select the Templates & Storage section.
- Go to the Templates section.
- Select the relevant template.
- In the Actions drop-down list, select Download manifesto.
An archive is downloaded to your computer.
- Unpack the downloaded archive.
- Run the sbsymtool.ps1 using Windows PowerShell.
The archive with debug symbols is downloaded to the folder where this file is located.
- In the Templates window, expand the Actions list and select Upload symbols.
- This opens a window; in that window, select the archive with the debug symbols and click Open.
Debug symbols are downloaded. The virtual machine is installed and displayed in the list of virtual machines running custom operating systems.
Page top