Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Excerpt
hiddentrue

SolusVM is a virtualization control panel for provisioning KVM, Xen, and OpenVZ VM's.


Table of Contents
Table of Contents
maxLevel4
minLevel2
outlinetrue
classtoc

Supported Features

CreateCancelSuspendUnsuspendManagementConfig Options
Status
colourGreen
titleYes
Status
colourGreen
titleYes
Status
colourGreen
titleYes
Status
colourGreen
titleYes
Status
colourGreen
titleYes
Status
colourGreen
titleYes

Management Features

This module supports the following management features within the client area:

...

The following table lists version compatibility between the module and the SolusVM API.

Module VersionSolusVM API Version
3.0.0 or greater1.16.10 or greater
1.0.0 - 2.8.0~1.13.02 or greater

Installing SolusVM

  1. Visit [Settings] > [Company] > [Modules] > Available.
  2. Click the "Install" button within the SolusVM module listing.

 


Info
titleUsing KVM?

If you are using KVM and want to make a VNC console available to your users, you must copy the /usr/local/solusvm/www/java/vnc directory from your SolusVM master to ~/vendors/vnc of your Blesta installation.

...

You may then add or update a server by setting the API credentials of an API User so that Blesta may communicate with the SolusVM server.

Module Options
OptionDescription
Server LabelThis is the friendly-name of the server used as reference throughout Blesta. Set it to anything you prefer.
User IDThe API User ID of the API user you have set in SolusVM.
KeyThe API Key of the API user you have set in SolusVM.
HostnameThe hostname of the SolusVM server, without the protocol.
SSL Port NumberThe port on which Blesta may connect to the SolusVM API at the given Hostname.

Configurable Options Overview

...

Info
titleNot Required

Configurable Options are not required, and this list in no way limits the Configurable Options that can be created. However, only the following Configurable Options can alter the way SolusVM servers are provisioned.


Option NamePossible ValuesRecommended Field TypeDescription
extra_ipsinteger >= 0Quantity, Dropdown

Determines how many extra IPs will be assigned to the server.

Info

It is recommended to set the config option Step to 1 when using the Quantity type.

The module allows for the removal of IP addresses one at a time. Using a Step value greater than 1 for a Quantity config option will disallow the removal of IP addresses through the module. This is because the decrement of a single IP address would no longer coincide with a valid Step as defined for the config option.


extra_diskinteger >= 0Dropdown

Sets the amount of extra disk space available for the server in GB (Gigabytes). This amount is added to the disk space currently set for the server's Plan.

e.g. "20" to indicate an additional 20 GB of disk space

extra_bandwidthinteger >= 0Dropdown

Sets the amount of extra bandwidth for the server in GB (Gigabytes). This amount is added to the bandwidth currently set for the server's Plan.

e.g. "5" to indicate an additional 5 GB of bandwidth

extra_cpusinteger >= 0Quantity, Dropdown

Sets the number of extra CPU cores available to the server. This number is added to the CPUs currently set for the server's Plan.

e.g. "2" to indicate two more additional CPUs

nodegroupinteger >= 1DropdownSets the node group from which SolusVM will determine a node to assign the server to. This overrides the Package settings for node or node group.
template???Dropdown

Sets the name/filename of the template to install on the server. This will override the Package setting for Template.
e.g. "centos-5.8-x86_64-solus-virtualmin"

Info

After a service has been created, updating the template will not affect the service. The service's template may only be changed from the Reinstall action.

Any pricing differences for the config option will still be incurred.


extra_memoryinteger >=0Dropdown

Sets the amount of extra 'guaranteed' memory in MB (Megabytes). This amount is added to the memory currently set for the server's Plan.
e.g. "512" to indicate an additional 512 MB of memory

extra_swapinteger >= 0Dropdown

Sets the amount of extra swap/burst memory in MB (Megabytes). The amount is added to the swap/burst memory currently set for the server's Plan.

e.g. "512" to indicate an additional 512 MB of swap

Info

Setting extra_swap requires that the extra_memory option be set as well.

If the server's plan does not provide any swap, and no extra swap has been set for this option, a value of 512 MB will be used by default.

OpenVZ:

  • Only OpenVZ supports changing swap space after the server has been created. Changing swap for other virtualization types will have no effect.
  • OpenVZ servers will always have their swap/burst set to the same value as memory. If any extra_swap is specified, it will be added onto this total.

 



Creating Packages

Note
titleNode Group Bug in SolusVM

There is a bug in SolusVM with the Default node group. If you select a node group for provisioning when creating a package, don't use the "Default" node group. First, create a new node group and assign your nodes to it in SolusVM. Then, select the new node group within the package.

 


Welcome Email

When creating or editing a package that uses this module, the following tags will be available:

TagsDescriptionNotes
{module.host}The host name of the server that the service was provisioned one.g. "domain.com"
{module.port}The port number to connect on

Default is "5656"

{service.solusvm_vserver_id}The service field for the virtual server IDe.g. "1"
{service.solusvm_console_user}The service field for the console username, if one exists
 

{service.solusvm_console_password}The service field for the console password, if one existsConsole passwords expire after a certain time period, and need to be regenerated, so this value may not always be accurate
{service.solusvm_hostname}The service field for the service's host namee.g. "my.domain.com"
{service.solusvm_main_ip_address}The service field for the service's main IP addresse.g. "127.0.0.1"
{service.solusvm_internal_ip}The service field for the service's internal IP addresse.g. "10.0.0.1"
{service.solusvm_extra_ip_addresses}The service field for the extra IP addressesThis is a comma-separated list of extra IP addresses
{service.solusvm_node}The service field for the node ID that the service is attached toe.g. "1"
{service.solusvm_username}The service field for the account username
 

{service.solusvm_password}The service field for the account passwordThe password will only be shown for the first service of this type created for a client--when the customer account is first created in SolusVM. This field will be blank when additional services are created for this client because the existing account will be re-used, and the current password will be unknown.
{service.solusvm_plan}The service field for the name of the plan
 

{service.solusvm_root_password}The service field for the root password
 

{service.solusvm_template}The service field for the name of the template
 

{service.solusvm_type}The service field for the type of SolusVM server the service is usingi.e. one of: "openvz", "xen", "xen hvm", "kvm"
{service.solusvm_virt_id}The service field for the SolusVM virtual IDe.g. "vm101|101"
{service.solusvm_vnc_ip}The service field for the VNC IP address, if one existse.g. "127.0.0.1"; for HVM/KVM servers
{service.solusvm_vnc_port}The service for the VNC port number, if one existse.g. "5901"
{service.solusvm_vnc_password}The service for the VNC password
 

Client Management

This module contains some client management features. Clients access this area by clicking the "Manage" button from within the client area for a service that uses this module.

...

A console, useful for accessing the server if it's inaccessible over the Internet.

Common Issues