Create Virtual Server

Virtual servers are created from templates. To create a virtual server:

  1. Go to your Control Panel's Virtual Servers menu and click the "+" button, or click the Create Virtual Server button at the bottom of the screen. This will start a VS creation wizard.
  2. Fill in the wizard step by step. Each of these steps is described in the corresponding sections below.
  3. Click the Create Virtual Server button to start the creation process. You will be taken to the virtual server details screen.



On this page:



OnApp must be configured properly before VSs can be created. You must have:

At least one data store configured and assigned to a data store zone

At least one network configured and assigned to a network zone

At least one Compute resource configured and online

At least one Compute resource assigned to a Compute zone

At least one data store attached to a Compute resource

At least one network attached to a Compute resource

Assigned a billing plan to the user creating the VS

See also:



Step 1 of 6. Cloud Locations

If you face the problem with viewing the maps, refer to the Add Google Map API Key section of this guide.

The Cloud Locations step applies to those users who have Compute zones assigned to location groups in their billing plan. This step will be present in the wizard if both of the following requirements are met:

  • all compute resources available to the user are assigned to location groups
  • compute resources are assigned to different locations

If the user's billing plan has several Compute zones, some of which are assigned to location groups, whereas others are not - the cloud locations screen will not be available in the wizard. Also if all compute zones are assigned to the same location this step will be skipped. In this case the wizard will start with the Templates step.

Indicate your virtual server's cloud location:

  • Country -  choose the country, where the cloud is located, from the drop-down menu.
  • City - specify the city, where the cloud is located, from the drop-down menu.

Click Next to proceed to the following step of the wizard to specify the virtual server templates.


Step 2 of 6. Templates

At this step, specify the template from which your virtual server will be built. Greyed out templates mean that there are not enough resources to build a VS from this template.
To choose a template:
  1. Click the required Operating system label (Windows, Linux or FreeBSD) to expand the list of template groups
  2. Distribution - choose a template Distribution
  3. Template - select the template
  4. Click Next

Windows Licensing Type

This option only appears if your billing plan allows it, and if the relevant licensing options have been configured for the template group this template belongs to. If this option is available, choose the license type you require:

  • For the KMS type, choose the licensing server
  • For your own license, type your license key

If you don't specify the licensing type, MAK licensing will be set by default.

Consider the following when creating a VS on Windows templates:

  • It is possible to deploy Windows virtual servers without running sysprep. To do so, you need to disable the Run Sysprep option for the Compute zone the virtual server will be built on. See Create Compute Zone section for details.
  • If there are several virtual servers simply deployed from the same template in the cloud, they will have identical SIDS. This will result in the system conflict.
  • It is not possible to select KMS or own licensing type when creating a Windows virtual server from custom template. As a workaround, you can create a virtual server from the template used for custom template creation.

Proceed to the following step of the wizard and specify the virtual server properties.

Template extraction is performed during server provisioning  or taking a backup when using a particular template. To prevent template from being used in other transactions during extraction, template is locked during the extraction and unlocked on accomplishment. If other transaction tries to use the locked template, it will fail after 5 minutes of standby. Transaction which locked template and failed, means that extracted template is broken.

Storing scheme:

  • template /onapp/templates/your_template.tgz
  • extracted template /onapp/backups/templates/your_template
  • locked template /onapp/backups/templates/your_template.lock

Windows 10/Windows Server 2016 Virtual Servers

If you want to build Windows 10/Windows Server 2016 VSs, the following limitations apply to KVM compute resources:

  • Windows 10/Windows Server 2016 VSs can be built on the CentOS 6/CentOS 7 compute resources with the following CPU models:
    • at least Ivy-Bridge-based Intel Xeon E series v2

    • Opteron G2, G3, G4, G5, and G6

  • CPU flag 'fsgsbase' is required. For more information on CPU flags refer to Manage Extended CPU Flags for Compute Zone.

The above limitations do not apply to XEN compute resources.

Step 3 of 6. Virtual Server Properties


At this step you need to indicate your virtual server's properties, such as label, password and other. You can create a virtual server having specified only the required parameters and configure it later.

Specify the following virtual server properties:

  • Label - the label of the virtual server. The required parameter.
  • Hostname - the hostname of the virtual server. The required parameter. The hostname should consist of letters [A-Z a-z], digits [0-9] and dash [ - ]. For more info on hostname validation, refer to RFC standard documentation.

    Particular characters are not allowed for Windows-based virtual servers:

    • percent sign [%]
    • double quotation marks [“]
    • brackets [<,>]
    • vertical bar [|]
    • caret [^]
    • ampersand [&]
    • parentheses [(,)]
  • Time zone - set the time zone for the virtual server. This parameter is applicable only to Windows XEN and KVM virtual servers.

    Currently, the time zone is set at the Compute resource side only. Therefore, users need to set the target time zone inside a Windows VS manually. Setting correct time zone at the Compute resource side helps to keep correct time inside a VS after starting it if time synchronization is not completed for some reason.

  • Password - a secure password for the VS. It can consist of 6-99 characters, letters [A-Za-z], digits [0-9], dash [ - ] and lower dash [ _ ], and the following special characters: ~ ! @ # $ * _ - + = ` \\ { } [ ] : ; ' , . ? /. You can use both lower- and uppercase letters. If you leave password field blank, it will be generated automatically.

  • Password confirmation - repeat the password to confirm it.
  • Encrypt password - move the Encrypt Password slider to the right, to encrypt your password, then enter an encryption key in the field that appears.

Click Next to proceed to the following step of the wizard to specify the virtual server resources.


Step 4 of 6. Resources


At this step, you can choose to create the virtual server either by selecting a predefined instance package or by setting your virtual server's resources, such as disk size, network configuration and other manually.

  • A VS created using instance packages is called an instance package VS.
  • A VS created by setting resources manually is called a custom virtual server.

Depending on the permissions, this step will display either Instance Packages or Create your own tabs, or both of them.

You are forwarded to the next step from the tab you are currently on. If you select an instance package and then click on the Create Your Own tab and proceed to the next step, the system will set the resources from the Create Your Own tab even if you did not configure any resources there.


Instance packages

If the selected instance package applies to certain compute zones only, as indicated in the user's billing plan, the VS will be created on one of the compute resources within one of those zones. Otherwise, the compute zone and compute resource for the VS will be selected automatically from the zones available to the user.

Note that instance package VSs can only be created on compute resources within compute zones where all compute resources are assigned the same amount of CPU units. If there are compute resources with different amount of CPU units set in a zone, it will not be possible to create instance package VSs in such zones. The reason is that CPU priority for instance package VSs in this configuration cannot be set to 100%, which is the default value for such virtual servers.

If there are no available IP addresses during VS creation, all instance packages will be grayed out in the wizard. 

From this tab, you can choose one of the predefined Instance Packages for your virtual server.

You will see all instance packages available to you, but those that have resources incompatible with the available compute zone(s) will be grayed out. Grayed out instance packages cannot be selected.

For each of the instance packages the following details are displayed:

  • Memory - the RAM size (GB) available in the instance package
  • CPUs - the number of CPU cores available in this instance package
  • Disk Size - the disk size available in this instance package
  • Bandwidth - the bandwidth available in this instance package
  • Price per Hour:
    • Mode ON - hourly instance package price for the VS powered on
    • Mode OFF - hourly instance package price for the VS powered off
  • Price per Month:
    • Mode ON - monthly instance package price for the VS powered on
    • Mode OFF - monthly instance package price for the VS powered on

Click the instance package to select it. After that, the instance package you have chosen will be highlighted in green.

Virtual servers created using instance packages do not support autoscaling.

Create Your Own

Using this tab you can define the resources for your virtual server manually:

Compute Resources

  • Compute Zone - the Compute zone to build the VS on
  • Compute Resource - the specific Compute resource to build the VS on.  Compute resource may be selected automatically according to the set provisioning type.

    When the Show Compute resources on Virtual Machine creation permission is disabled (so that user cannot select the Compute resource, but can choose the virtualization type), the Compute resource that meets the virtualization type and the resources set will be automatically selected. The data store will be set according to the compute zone selected.


  • RAM - set the amount of virtual server's RAM. The maximum RAM depends on your billing plan's settings. The maximum RAM that can be assigned to a VS is 168 GB regardless of the Max RAM value set in the billing plan. The maximum RAM that can be assigned to a VS built on a XEN 32bit (x86) template is 16 GB.
  • CPU Cores - set the amount of virtual server's CPU cores. For KVM Compute resources, this parameter sets CPU sockets by default, unless CPU topology is enabled.
  • CPU Priority (or CPU Units) - set virtual server's CPU priority. If the CPU units are switched on in the billing plan for this user, then CPU priority is replaced with CPU units. Refer to Billing Calculation section for details on CPU units and CPU priority.

Do not use CPU Units for KVM Compute resources running on CentOS5.

The following options are available for VSs based on KVM Compute resources only, providing the Enable CPU topology permission is switched on for the user.

  • Use CPU Topology - move the slider to the right, to set the following parameters:
    • CPU Sockets - set the amount of sockets.

    • CPU Threads - set the amount of threads per core. 

CPU topology (CPU sockets and CPU threads) is the Labs feature preview. Pay attention that setting CPU sockets and CPU threads are at your own risk only!

You may face the following problems when setting CPU topology:

  •  Currently you cannot set CPU sockets and threads parameters for existing VSs.
  • After setting, the new parameters won't be shown at the VS details screen.
  • Some Linux VSs fail to boot up.
  • When sockets and threads are set incorrectly, you may face huge load on Compute resource's under CentOS 5.x.

Primary Disk

  • Data Store Zone - choose a data store zone for VS's primary disk.
  • Primary disk size -  set the primary disk size.

Swap Disk

  • Data Store Zone - choose a data store zone for VS's swap disk.
  • Swap disk size - set the swap disk size.  There is no swap disk for Windows-based VSs. In all other cases, swap disk size must be greater than zero.

Network Configuration

  • Network Zone - choose a network zone from the drop-down box.
  • Show only my IP address - tick this checkbox to view only own IP addresses in the IP addresses dropbox.
  • Show IP address selection for new VS - if the option is available, you can also assign an IP address for the VS from the drop-down menu. Indicate Compute resource and network to have the list of available IPs.
  • Port Speed - set the port speed for this VS
  • Since not every application supports IPv6, at least one IPv4 address must be allocated to a VS's primary network interface. 

  • Show IP address selection for new VS option is enabled via the "Show IP address selection for new VS" slider on the Settings > Configuration screen (under the System tab).
  • You can't select unlimited port speed if the Network Zone is not selected. In this case the port speed will be 1 by default.
    It's possible to create virtual server with unlimited network speed without selecting a network zone only if you have only one Network Zone assigned to your billing plan.

Click Next to proceed to the following step of the wizard where you can specify the virtual server recipes.


Step 5 of 6. Recipes


At this step you need to indicate the recipes you want to assign to your virtual server. This step is optional. You can create a virtual server without choosing recipes and add them later if required.
  1. Choose a recipe you want to assign to this virtual server by dragging the required recipe to the Assigned recipes pane. 
  2. To add a custom variable, click the "+" button next to the Custom recipe variables title bar, then specify variable details:
    • Specify the recipe name and its value.
    • Move the Enabled slider to the right to allow use of this variable.
  3. Click Next to proceed to the next step of the wizard that completes the virtual server creation process.


The recipes step can be missing in the wizard if there are no recipes created in the cloud.




Step 6 of 6. Confirmation


At this step, configure the automation settings. This is the final step of the virtual server creation wizard.
  • Move the Enable Automated Backup slider to the right if you want this VS to be backed up automatically (according to the backup settings configured in the Settings/Auto-backup Presets menu)
  • Move the Build Virtual Server slider to the right if you want the system to automatically build the VS. If you leave this box blank, you will have to build your server manually after it is created.
  • Move the Boot Virtual Server slider to the right if you want the virtual server to be started up automatically.
  • Move the Enable Autoscale slider to the right to set autoscaling for this VS.

    • Until the autoscaling rules are configured the autoscaling itself will not start working.
    • If the Enable Autoscale slider is grayed out that means that you have reached the autoscaling limit in the billing plan (or the max is set as 0).
  • Move the Accelerate slider to the right to enable accelerator for this VS. For more information, refer to CDN Accelerator section.

The Accelerate slider is available if the following conditions are met:

  • Accelerator is available in the network
  • IP Address, selected during VS creation, is in the same network as Accelerator
  • VS is created by setting own virtual server's resources, not by selecting a predefined instance package
  • The Show IP address selection for new VS slider is activated in the Control Panel Settings menu > Configuration
  • Only HTTP is supported. Other protocols, including HTTPS, will be passed through to the VS directly.
  • In order to route the VS’s traffic, the VS must be on the same network with the Accelerator.


At the Confirmation step you can find the configuration summary of VS, which will be created.  You can view template's name, RAM size, number of networks, primary disk and swap disk size, number of cores.

After you set up all parameters, click the Create Virtual Server button to start the creation process.