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.

 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(Settings -> Data Stores -> Add New Data Store)
  • Have at least one network configured and assigned to a network zone (Settings -> Networks -> Add New Network)
  • Have at least one compute resource configured and online (Settings -> compute resources -> Add New compute resource)
  • Have at least one compute resource assigned to a compute zone (Settings -> compute resource Zones -> Choose a zone -> Press "+" sign next to an unassigned compute resource)
  • Have at least one data store attached to a compute resource (Settings -> compute resources -> [choose a compute resource] -> Manage Data Stores)
  • Have at least one network attached to a compute resource (Settings -> compute resources -> [choose a compute resource] -> Manage Networks)
  • Have assigned a bucket to the user creating the VS (Users and Groups -> Edit [user])

Step 1 of 6. Cloud Locations

If you face the problem with viewing the maps, refer to the 2020-07-13_11-43-05_Add Google Map API Key section of Administrator guide.

At this 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.

If compute resources of your bucket do not have assigned location groups (or have only one assigned location group), this step of the wizard will be missing. 

Step 2 of 6. Templates

At this step, specify the template from which your virtual server will be built. 
To choose a template:
  1. Click the required group icon on the right (Windows, Linux, FreeBSD etc.) to expand the list of templates on the left. Every template contains the following info:
    • Template's label
    • Min memory size, required to create a VS from this template
    • Min disk size, required to create a VS from this template
    • Virtualization type (XEN, KVM)
    • Price per hour
  2. Select the template.
  3. Click Next.

Windows Licensing Type

This option only appears if your bucket 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

Step 3 of 6. Virtual Server Properties

At this step you need to indicate your virtual server's properties, such as label, Compute resource, 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 [(,)]
  • Domain - specify the domain for this VS. The default value is localdomain. This parameter is not applicable for Windows virtual servers. 

    For example: - specify 'test' as hostname, ''-  as domain. If you leave the domain field blank, the default value 'localdomain' will be used and you will get the following -
  • 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 set your virtual server's resources, such as disk size, network configuration and other.

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.
<=CentOS 6.2512 GB
CentOS 6.32000 GB
>CentOS 6.34000 GB

Set RAM to 512MB is you are creating a FreeBSD based virtual server. The RAM value can be later increased after the VS creation when editing the VS.

  • 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 bucket for this user, then CPU priority is replaced with CPU units. Refer to Billing Calculation section for details on CPU units and CPU priority.

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 into how many sockets the CPU cores should be arranged. This value will affect the amount of cores_per_socket.

Setting the correct amount of CPU sockets

If the CPU topology is enabled, the CPU cores will mean a number of vCPUs, which is the maximum value that can be arranged into cpu sockets and cores per socket. If the CPU topology is disabled, the CPU cores will actually mean the CPU sockets value with 1 core_per_socket.

  • Set the total amount of virtualized CPUs and the number of sockets.
  • The value of cores_per_socket will be calculated automatically by the formula vCPUs  = cpu_sockets x cores_per_socket.
  • Thus, if you set the vCPU value 8, and the CPU sockets 2, this means that the cores_per_socket value will be set 4. 

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.
  • Network - choose the network from which the VS should get the IP address.
  • Show only my IP address - tick this checkbox to view only own IP addresses in the IP addresses dropbox.
  • Selected IP address - 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
  •  Selected IP address 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 bucket.

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.

If mentioned below prerequisites are met, the Recipes step will be replaced with the Service Add-ons step.

Service Add-ons


Ensure that the following requirements are met to be able to assign service add-on to VS during its creation:

  • Replace Recipes with Service Add-ons on VS creation permission is enabled
  • Service add-on groups are available in your bucket
  • The On Provisioning option is enabled for all or some of the service add-ons available to you within bucket. 

In case there are no available service add-ons, this step of the wizard will be skipped.

At this step you need to indicate the service add-ons you want to assign to your virtual server. This step is optional. You can create a virtual server without choosing service add-ons and add them later if required.

  1. Click the service add-on group icon on the left  to expand the list of service add-ons on the right. Every service add-on contains the following info:
    • Label
    • VS's types, with which this service add-on is compatible
    • description of the service add-on
    • Price per hour
  2. Select the service add-on by clicking on it. You can select several add-ons from different service add-on groups. Click View Selected Add-ons to see the list of selected service add-ons. You can remove the selected service add-on from the list by clicking the  button near the add-on.
  3. Click Next to proceed to the next step of the wizard that completes the virtual server creation process.

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 bucket (or the max is set as 0).
  • Move the Acceleration allowed slider to the right to enable accelerator to allow acceleration for this VS or move this slider to the left to prohibit acceleration for this VS. 

The Acceleration allowed 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.