# Virtuozzo Hybrid Server For WHMCS
# (opens new window) About Virtuozzo Hybrid Server For WHMCS (opens new window)
Virtuozzo Hybrid Server For WHMCS is a useful module created for the automatic provisioning and management of VPS servers in your WHMCS.
Your clients will gain the flexibility to remotely manage backups, snapshots, and firewalls, as well as access the noVNC console.
The module also contains a dedicated addon that helps maintaining virtual machines and nodes, including the setup of proxy and Virtuozzo Automator.
Admin Area Features
- Create/Suspend/Unsuspend/Terminate Server
- Stop/Restart/Suspend/Reinstall Virtual Machine
- Migrate Server Between Nodes
- Change Package - Supports Configurable Options
- Change Password
- Update IP Addresses List
- Assign/Delete Virtual Machine By Name
- View Server Details And Status
- View And Update Assigned IP Addresses
- View Scheduled Tasks
- Configure Product As Virtuozzo Container Or Virtual Machine Type
- Configure Product Networking
- Configure Product Features And Limits
- Configure Client Area Features Per Product
- Select Available OS Templates To Rebuild Server
- Enable "Guest Tools" Installation (Virtual Machine Type Only)
- Automatically Enable Console After Server Creation
- Disable Including Unnamed Backups For Clients
- Enable Sending Welcome Email Template After Server Creation
Client Area Features
- View Server Details And Status
- Start/Stop/Restart/Suspend/Resume/Reinstall Server
- Add And Download Public SSH Keys (Virtual Machine Type Only)
- Change Hostname
- Change Boot Device (Virtual Machine Type Only)
- Schedule/Restore/Manage Backups
- Create And Revert Snapshots (Virtual Machine Type Only)
- Enable/Disable/Access noVNC Console
- View Usage Statistics
- View And Order IP Addresses
- Manage Firewall Rules (Container Type Only)
- Rebuild Server With Selected OS Template
- Mount Selected ISO Images To Chosen CD/DVD-ROM (Virtual Machine Type Only)
- Change Password
- Upgrade/Downgrade Product
Virtuozzo Hybrid Server Addon Features
- Add/Edit Node
- Check Nodes Status
- View Nodes IP Address, Usage, And Statistics
- View Virtual Machines List On Node
- Assign And Manage IP Network Configurations - Requires IP Manager For WHMCS (opens new window)
- Configure OS Template
- Configure Network Classes Names, Rates, Total Rates, And Status
- Configure Virtuozzo Automator For Backups Restoration
- Configure Console Proxy
- View Installation Steps
Configurable Options
- Available Nodes
- Available Base Templates
- Available OS Templates
- Number Of CPU Cores
- CPU Limit
- Memory Size
- Bandwidth
- Number Of Public IP Addresses
- Number Of Private IP Addresses
- Disk Size
- Backup Quota
- Disk I/O Limit, Bps
- Disk I/O Limit, Nps
- Snapshots Limit
General Info
- Requires Virtual Automation (PVA)
- Supports High Availability Function
- Supports Proxy For Console Connections
- Server Resources Chosen During Order
- Integrated With IP Manager For WHMCS (opens new window) - Complete Control And Easy Assignment Of IP Subnets
- Integrated With Advanced Billing For WHMCS (opens new window) - Actual Server Resource Usage Billing
- Integrated With Server Allocator For WHMCS (opens new window) - Automatic Assignment Of Most Suitable Servers To Products
- Multi-Language Support
- Supports Virtuozzo And Virtuozzo Containers Up To Version 7
- Supports PHP 8.3 Back To PHP 8.2
- Supports WHMCS Themes "Twenty-One", "Nexus" And "Lagom WHMCS Client Theme"
- Supports WHMCS V9.X Back To WHMCS V8.10
- Requires ionCube Loader V14 Or Later
- Easy Module Upgrade To Open Source Version (opens new window)
# Installation and Configuration
This tutorial will show you how to successfully install and configure Virtuozzo Hybrid Server For WHMCS. (opens new window)
We will guide you step by step through the whole installation and configuration process.
# Installation
- Log in to our client area and download the module.
Extract the package and upload its content into the main WHMCS directory.
The content of the package to upload should look like this.
When you install Virtuozzo Hybrid Server For WHMCS for the first time, you have to rename 'license_RENAME.php' file.
File is located in 'modules/servers/virtuozzo/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.
In order to configure your license key, you have to edit a previously renamed 'license.php' file.
Enter your license key between quotation marks as presented on the following screen.
You can find your license key in our client area → 'My Products'.
# Activation of Virtuozzo Hybrid Server Monitor
Firstly, you need to activate Virtuozzo Hybrid Server addon.
To do so, log in to your WHMCS and move to 'Setup' → 'Addon Modules'. Find 'Virtuozzo' and press 'Activate'.
In the next step you need to permit access to this module.
To do so, click on 'Configure' button, tick 'Full Administrator' and press 'Save Changes'.
In order to allow module to run smoothly, go to your addon → 'Installation' tab and add two cron jobs marked on the following screen.
Suggested execution time for 'slowCron' - each 5 minutes.
Suggested execution time for 'cron' - each minute.
# Configuration of Server
Now we will show you how to configure a new product.
Go to 'Setup' → 'Products/Services' → 'Servers' and press 'Add New Server'.
Next, enter your server name, IP address, username and password. Choose 'Virtuozzo' from a dropdown menu and press 'Save Changes'.
Note: Server you are using on WHMCS is in fact a node on your PVA server, not a whole PVA server.
It is time to create a server group, to do so click on 'Create New Group'.
- Enter name, click on your previously created server, press 'Add' and afterwards 'Save Changes'.
# Configuration of Product
In order to create and configure a product click on 'Setup' → 'Products/Services' → 'Products/Services'.
Click on 'Create a New Group'.
Enter product group name and press 'Save Changes'.
When you have a product group, you can create your product.
To create a product click on 'Create a New Product'.
Afterwards, fill in the below fields and press 'Continue' when ready
- Select your product type - use 'Server/VPS Server'
- Select the product group from a dropdown menu
- Enter your product name
- Choose a module name, 'VirtuozzoVPS', from a dropdown menu
Now, go to 'Module Settings' section. As the module name has been already selected, find the server group in the dropdown menu.
Next, click on 'Save Changes'.
From dropdown menus choose 'Base Node', 'Type', 'Public Network' and 'Private Network'.
Note: 'Virtuozzo Container' server type can have only one routed network.
Depending on the server type that you have chosen, you may see different field names in 'Default Values' and 'Configurable Options' subsection.
On the following screen we will show you the configuration of 'Virtual Machine' server type.
If you wish to offer predefined servers to your clients, set up 'Default Values' and skip 'Configurable Options'.
In order to set up 'Default Values', choose "Base Template" from a dropdown menu. Next, enter values into textboxes marked on the screen below.
At the very bottom, you may select "Install Guest Tools" option. Guest tools will be installed into a virtual machine after its creation or reinstallation.
Eventually, select "Enable Console After Creation" option. The remote console will be automatically enabled after the product creation.
If not selected, the console will be disabled by default, but the client will still be allowed to enable it manually if access was permitted in the "Client Area Functions".
Note 1: This option requires "Install Guest Tools" to be enabled if it is used for Virtual Machine type.
Note2: Virtual machine template must have mounted CD-ROM to use guest tools.
Important: 'Guest Tools' are NOT supported if 'Container' type has been selected.
At 'Configurable Options' you can generate/update specific configurable options for product.
Firstly, mark/unmark checkboxes at 'Settings To Generate' to specify which option you want to generate in your configurable options.
Afterwards, select nodes and base templates to generate in configurable options.
At the end, confirm it through 'Generate Configurable Options'/'Update Configurable Options'. Follow to the 'Management of Configurable Options' section to learn more.
Note: Values which will not be generated in configurable options, will be taken from 'Default Values'.
Now, it is time to define pages and functionalities visible for client in 'Client Area Configuration' subsection.
You can do it by simply selecting/unselecting checkboxes next to a page/functionality you want to enable/disable.
Here, you may also decide which of the OS templates will be available for clients to select when rebuilding the server.
Important: There are different sets of possible options to choose depending on the selected type:
SSH Keys and Snapshots options are supported by 'Virtual Machine' type only (although visible for both types).
Manage Firewall Rules is supported and visible for the 'Container' type only.
ISO Management access is provided only for the 'Virtual Machine' type.
For Virtual Machines you can also specify the OS images paths that clients will be able to mount and install using the 'ISO Management' section.
To make OS images available to customers, you must manually upload them to your local Virtuozzo server and then enter the direct paths to them.
For example, you can create '/root/images/' directory and upload to it downloaded OS images that you want to make available to your customers.
Then enter the direct paths to uploaded files in the 'Available ISO Images For Mount' area, separating them from each other with commas and a new lines.
Optionally at the end of the path, you can also add a friendly operating system name after | character, which will be displayed to the client instead of the file name.
Please note that Virtuozzo should support OS images in the following formats: .iso, .cue, .ccd, and .dmg and these images cannot be compressed and/or encrypted.
Send Custom Welcome Email - select this option to send a welcome email to a client only after the virtual machine is successfully created.
Please do not set up a standard welcome template email in 'Details' section not to double the messages.
If you decide to use the option to send the email after the machine has been created, not just the product, you may add to the template extra merger fields that will indicate a list of assigned IP addresses.
These are the extra merge fields that can be added to your custom or edited email template:- Dedicated IP {$service_dedicated_ip}
- Assigned IPs {$service_assigned_ips}
Select the template from dropdown. Email notification will be sent on the virtual machine creation.
You may read more about creating templates and using merge fields in the official WHMCs documentation here (opens new window).
Congratulations! You have just finished the installation and configuration of the module.
Your clients should see something similar to the screen below.
In the admin area you can monitor and manage each of your products:
# Management
In the following articles we will include all crucial information on how to use the addon and how to manage your products with ease.
Finally, you will find here described all the possibilities that your clients are offered to manage their virtual machines in the client area. Take a look below to learn all of that.
# Addon
In 'Addons' → 'Virtuozzo Hybrid Server' you can find all used virtual machines and nodes as well as instructions on how to install the module.
# Installation
At this tab you can find instructions on how to install Virtuozzo Hybrid Server For WHMCS and configure the product.
You can also find here a link to Virtuozzo Hybrid Server For WHMCS documentation article which you are currently reading.
Make sure you have set up correctly the cron jobs, as it has been said in point number 8 of this manual.
# Servers Monitor
To add new node, press '+ Add Node' button.
Afterwards, follow steps 9 to 21 of 'Installation and Configuration' instructions.
You can also view current node usage through pressing 'Usage' button, as presented on the following screen.
In 'Usage' tab you can view resource usage in specific time period for node that you chose.
To access virtual machines list on a particular node, press on 'Virtual Machines'.
'Virtual Machines' tab contains virtual machines list created on this WHMCS and node that you selected.
You can view here basic information about virtual servers.
To view more information about specific virtual machine, simply press on 'View' button.
If you change your Virtuozzo server connection details, you can update connection credentials on your WHMCS through pressing 'Edit' next to altered node.
Afterwards, upgrade your connection details and confirm through pressing 'Save Changes'.
# Templates Configuration
In this section, you may configure the OS templates. Assign friendly names to templates and existing tags and create new OS groups for easier management.
# Network Classes
The Network Classes section allows quick and easy configuration of the network classes' names, rates, total rates, and statuses.
Remember to update the class configuration on nodes after making any changes.
# Settings
In 'Settings' you can find the fields required for the configuration of Virtuozzo Automator and proxy.
# Virtuozzo Automator
Set up Virtuozzo Automator to allow the restoration of backups created on nodes other than the node of the virtual machine.
- Provide the data to successfully connect with your Virtozzo Automator:
- IP address
- Username
- Password
- Check the Secure - selection to use SSL mode for connection
- Enable Backups - activate the 'Restore Backups' feature for backups produced on nodes other than the virtual machine's designated node
Important: In the product's module settings you may define if backups are stored on the virtual machine's node (Auto) or choose another available node from the drop down list.
If a backup node is different than the VM node, enable the backups option to use the restore function.
Additionally, it is possible to create a server that will be used only for backup purposes.
To do so, create a new server, and establish the successful connection as always, but remember to disable the server by selecting the 'Enable/Disable' option in the server details.
Then, manually add this server node to allow storing backups.
Proxy Installation For Console Connection
A comprehensive guide detailing the installation, update instructions, and operational flow for the Proxmox Proxy application can be found in a dedicated article accessible through the following link.
We encourage you to refer to it for further insight into the Proxmox Proxy application.
The proxy feature can be looked on as an added security boost for your infrastructure.
It hides your Virtuozzo server so that your clients will not get to know its actual address when connecting to the server via the console in your system.
To work properly, the proxy must be accessible from both the public and private net as clients connect with the proxy from the public net, without the need to connect directly to Virtuozzo.
Before you begin the process of connecting the console to the server through a proxy, you need to download the proxy application file.
The file can be found under the following link (opens new window) after you have logged in to your ModulesGarden account.
Create a new VPS server, which you may run on a Virtuozzo server.
It is advised to use the KVM virtualization type.
Warning! The used VPS may NOT have any services running, such as: PHP, WebServer (e.g. apache, nginx) or MySQL server.Configure the network on the virtual machine, make sure the network works correctly, to do so you may use the below command:
ping modulesgarden.comIf everything is fine, assure that basic server security settings have been established.
You may turn off login with a password and turn on login with a key, change the SSH port, set up firewalls etc.Log into the machine on which you are going to set up proxy. '
Install the docker engine and the docker compose:
https://docs.docker.com/engine/install/
https://docs.docker.com/compose/install/Upload the application files into a proper directory, eg: /root/virtuozzo-proxy (create if needed).
Then unzip the files.Move to the following catalog:
cd /root/virtuozzo-proxyNote that the exact directory depends on the previous step where you uploaded the files.
Purchase or generate your own SSL certificate, and then use the certificate to overwrite the following files: 'nginx/localhost.crt' and 'nginx/localhost.key'.
Find the 'example.env' file and rename it to '.env'.
Then open the just renamed '.env' file and provide a random set of signs to create the database and root passwords: DB_PASSWORD and MYSQL_ROOT_PASSWORD
These data will be automatically used when creating the database.Run the below command:
docker-compose up --build -dMove to docker container:
docker exec -it proxyphp bashand run the installation script:
php -q /var/www/html/installer.php installWhen ready, find the API Key and keep it safe, you will need it later on when pasting the data into the Virtuozzo Hybrid Server Addon, see point 12 for details.
Next, copy your machine IP address to WHMCS. You may check the IP address using the below command:
ip aNote: Remember to check the IP address in your virtual machine, not in the proxyphp conatiner.
Configure all the required data in the Virtuozzo Hybrid Server addon in your WHMCS.
Move to 'Addons' → 'Virtuozzo Hybrid Server Addon' → 'Settings'. At the bottom you will find section 'Proxy Configuration' with 'Host' and 'API Key' fields.
Note that the Host field may include either an IP address or a domain. It is extremely important that you paste here the same data as the ones used in the SSL certificate.
Provide the necessary data, tick 'Enabled' and save changes.
Make sure the server works. In order to do so, please open the address: https://{vmip}:8443.
Remember to replace {vmip} with a valid virtual machine IP address, for example: https://192.168.8.113:8443/
When you see {"errors":["Invalid API Endpoint"]} it means that the server correctly responds.Finally, try to open the noVNC console on your WHMCS Virtuozzo product to check if the proxy configuration is working properly.
Important: If your certificate expires in the meantime, you will need to buy/generate a new one and follow the below steps:
- move to the /root/virtuozzo-proxy catalog (the directory may differ depending on your setup)
- replace the nginx/localhost.crt and nginx/localhost.key files
- run the following command:
docker-compose up --build -d
Note: If you ever encounter an iconcube error while rerunning the 'docker-compose up' command, delete all local docker images related to your docker file using the following command and try again.
$ docker rmi -f $(docker images -a -q)
For instruction on how to react in case an update is required, please refer to the dedicated article including all details on the Proxmox Proxy application.
# IP Management
The module allows flexible IP address assignment for Virtuozzo instances.
By default, IP addresses are automatically retrieved from the Virtuozzo server configuration, so no additional setup is required.
Optionally, you can integrate the IP Manager For WHMCS (opens new window) module to gain full control over IP pools and assignment rules.
To access IP Management, go to 'Addons' → 'Virtuozzo Hybrid Server Addon' → 'Servers Monitor' and press the 'IP Management' button.
In this section, you can assign IP Manager configurations to selected network types.
If no configuration is assigned ('None'), IP addresses will be provided directly by Virtuozzo using its default mechanism.
To use IP Manager, click 'Create a new configuration for this network'.
You will be redirected to the IP Manager module, where a new configuration can be created and assigned to selected products, addons, servers or configurable options.
After creating the configuration, define IP pools by adding subnets.
Use the 'Create New Subnet' button and follow the steps described here.
Once the subnet is created, assign it to the configuration using the 'Assigned Subnets' section.
Select the desired IP pool from the dropdown and confirm with 'Assign Subnet'.
You can define how many IP addresses should be assigned using one of the following methods:
- Prduct/Addon/Server Configuration – specify IPv4/IPv6 quantity directly in the product assignment.
- Configurable Options – optionally control the number of IPs dynamically per order.
If you decide to use configurable options, you have to map them within the IP Manager configuration to determine how many public or private IP addresses should be assigned for each network.
Note: Configurable options are optional and are not required for IP assignment.
Finally, return to the Virtuozzo addon and assign the created configuration to the selected network type.
From this point, IP allocation will follow the defined IP Manager rules instead of the default Virtuozzo behavior.
If no configuration is assigned, the module will continue to allocate IP addresses directly from Virtuozzo.
# Management of Admin Area
In the admin area you can execute basic commands(2) as 'Create', 'Suspend', 'Unsuspend', 'Terminate' and 'Change Package'.
You can also order 'Server Actions'(3) such as 'Stop', 'Restart', 'Suspend', 'Start', 'Reinstall', 'Resume' and 'Migrate'.
You are able to view configurable options(1), server details(4), assigned IP addresses(5), scheduled cron tasks(6), host ID(7) and SSH Key(8).
Note: 'Basic Template' cannot be changed if product was already created. 'Node' can be changed only using 'Migrate' and 'OS Template' through using 'Reinstall'.
# Reinstall
To reinstall your virtual server you have to stop it through pressing 'Stop' button.
Note: You are not able to reinstall 'Virtual Machine' server type.
Afterwards, press 'Reinstall' button.
# Migrate
To migrate your virtual machine, choose server you want to migrate your virtual machine to.
Afterwards, select node on this server from a 'Node' configurable option and press 'Save Changes' button.
The last step is pressing 'Migrate Button'.
Note: To migrate your virtual server you have to generate 'Node' configurable option.
Afterwards, popup should appear. Confirm migration through clicking 'Migrate' button.
# Management of Client Area
Client area interface of Virtuozzo Hybrid Server should look like the one on the screen below.
As you can see, control panel contains useful options needed to manage a VPS.
Module allows your customers to easily 'Suspend'(1), 'Stop'(2), 'Restart'(3) their servers through pressing a specific button.
It is also available to 'Start', 'Reinstall' (4) and 'Resume' server by clicking on defined buttons.
'Start' and 'Reinstall' actions are available only when server is down, 'Resume' is available when server is suspended.
# SSH Management
SSH Key management is available for 'Virtual Machine' type and only if 'Guest Tools' are installed.
Add SSH Key to use it as authentication step when connecting to the server.<
You may do that on the product page by pressing 'Add SSH' button marked on the screen below.
A new window will appear, paste your public SSH key, use the OpenSSH format.
You may also download and check your SSH Key, just press the adequate button and the file will be downloaded.
Important: Adding and downloading SSH keys is supported only if guest tools are installed on the virtual machine.
There are two ways to add an SSH key. You may do that already when placing an order, by filling in an adequate configurable option field.
Take a look at the screen below:
# Backups Management
In 'Backups Management' you can order backup jobs or create backups.
To create backup job press 'Create Backup Schedule' as shown on the screen below.
Note: If two backup tasks are ordered in a small time interval, only one backup is created.
Now define backup description by typing its name into a textbox and choose backup type from a dropdown menu.
You can choose whether to delete previous backup or not, through marking checkbox next to 'Remove Previous'.
Afterwards, select 'Recurrence Pattern' through marking desired option and set time of run.
On the screen below you can view sample setting for 'Repeat Weekly' option.
To create this backup job, press 'Schedule Backup' button.
You can also create a single backup. To do so, click on 'Create Backup' button as shown on the following screen.
Now enter backup description and select backup type from a dropdown menu.
Afterwards, choose whether to delete previous backup or not, through marking checkbox next to 'Remove Previous'.
Confirm creation of this backup through pressing 'Create Backup' button.
To restore a backup, simply press restore icon and then confirm the action.
Important: Along with the decision to restore a backup of your virtual machine, you accept to delete all the created snapshots of your virtual machine.
# Snapshots Management
'Snapshots Management' section allows you to create single snapshots of the current virtual machine look and condition.
To create a snapshot simply press 'Create Snapshot' button.
Name the snapshot and confirm the action.
Creating a snapshot might last a few minutes. Please wait until the next cron run to see it on the list of current snapshots.
When the snapshot is ready, you will see it on the list with information on its creation date, size and options to revert the snapshot or delete it.
To revert a snapshot simply press adequate button. The virtual machine snapshot will be reverted to real environment.
# Console
One of the most interesting functionalities is noVNC console (which uses HTML5) where your clients can remotely manage server.
To access it, simply press on the 'Console' button. A new window will be opened, so make sure your browser does not block it.
You may also disable the console od enable it back again whenever needed. Simply, press the 'Disable/Enable Console' button.
Note: If the noVNC console does not work, make sure that it has been enabled in your Virtuozzo panel. There you can also test if it works properly.
Important: If your WHMCS instance uses 'HTTPS' protocol, then your Virtuozzo host must use 'HTTPS' as well.
In order to establish connection between Virtuozzo and your WHMCS, run the below command on Virtuozzo server:
prlsrvctl set --vnc-ssl-certificate /PathToCert/certificate.crt --vnc-ssl-key /PathToKey/private.key
Remember that the used here certificate must be generated for the used by Virtuozzo host.
# Firewall Management
Under 'Firewall Management' section the client can set up firewall for their virtual server.
They can 'Enable'/'Disable' firewall, add new firewall rules, view existing rules list and manage existing rules.
Important: 'Firewall Management' is available only for 'Virtuozzo Container' server type.
Press 'Create New Rule' to add a new one.
Now, enter all the required data to set up a valid firewall rule.
- Define a rule chain: 'Input', 'Output' or 'Forward'
- Define the rule policy
- Select protocol
- Provide source and destination: specify IP address and netmask or leave empty to enable for all
- Define source and destination ports - specify ports or enter a port range
# Usage Statistics
At 'Usage Statistics' your clients can view information about resource used by the virtual server.
There can be found resource usage and graphs of CPU, memory, bandwidth and disk.
# IP Management
Here your clients can find all IP addresses assigned to their virtual server.
To order new IP addresses, press 'Order New IP'.
Note 1: To order a new IP you have to generate configurable options for 'Number of Public IP' and 'Number of Private IP'.
Depending on generated configurable options, your client will be able to order public IP, private IP or both.
Note 2: You can hide these configurable options from the order form. You can find instruction here.
Popup will appear, select IP address type and press 'Order'.
# Rebuild Server
Here you can rebuild your server. Select one of the available OS templates and press the 'Rebuild' button.
A popup will appear, confirm if you are sure to rebuild the server.
# ISO Management
If you have given your customers access to the ISO Management section, they will be able to see which image is currently mounted on their Virtual Machine.
Note: This section is available only for the Virtual Machine type.
Clients can unmount the currently used image from here as well as mount other images which paths you provided in the configuration of product.
When mounting, you can make the image bootable and decide to which CD/DVD-ROM it should be mounted, if more than one is available.
Please note that images can only be mounted if the virtual machine is stopped.
After mounting the image, please remember that in order to use it during the boot of virtual machine, you also need to change the 'Boot Device' in the server details to the CD/DVD-ROM in which the image is mounted.
The boot device, in addition to available CD/DVD-ROM devices, can also be selected as HDD disks or network interfaces.
# Management of Configurable Options
When you successfully set up a product, your client can order it by choosing amount of resources from default configurable options.
# Editing Configurable Options
In case these options don't suit your needs, you can edit them.
To do so, go to 'Setup' → 'Products/Services' → 'Configurable Option'.
Afterwards, press edit button next to configurable option used by your product (its name is 'Configurable options for your_product_name').
Here you can view all products this configurable option group is assigned to.
Now, let us show you how to edit options. Let’s say you want to add an option to order VPS with 1000 GB disk.
To do so, edit 'hddSize_gb|Disk Size in GB' by pressing edit button as shown on the screen below.
You will see a popup window, so make sure your browser will not block it.
Edit 'Maximum Allowed' textbox as shown on the following screen.
Afterwards, press 'Save Changes'.
Here is a list of all available configurable options for Virtuozzo Hybrid Server products:
- nodeID|Node
- baseSampleIdVirtuozzo|Base Sample
- osTemplate|OS Template
- cpuunits|CPU Cores
- cpulimit_mhz|CPU Limit
- memory_gb|Memory Size
- ip_number|Number of Public IPs
- ip_number_secondary|Number of Private IPs
- hddSize_gb|Disk Size
- backup_quota_gb|Backup Quota
- io_limit_mb|Disk I/O Limit, Bps
- iops_limit|Disk I/O Limit, Nps
- snapshots_limit|Snapshots Limit
# Hiding Configurable Options
If you decide to hide configurable options from a client order form, follow steps below.
Firstly, go to 'Setup' → 'Products/Services' → 'Configurable Option'.
Afterwards, tick 'Hidden' checkboxes next to configurable options you want to hide.
On the screen below you can see hiding of 'Number of Public IP' and 'Number of Private IP'.
# Management of Billing
When you combine Virtuozzo Hybrid Server For WHMCS with Advanced Billing For WHMCS, you will be able to set up additional billing options.
Module allows you to charge your customers based on the server resources used by them.
Note: To set price for specific template you need to have it assigned to product configurable options.
With Advanced Billing module, you can also display your customers the current server resource usage and their cost.
# Management of Existing Accounts
You can easily use Virtuozzo Hybrid Server For WHMCS module with your existing Virtuozzo accounts. To do so, follow the instructions below:
Create and configure a Virtuozzo server and a server group.
Create and configure a Virtuozzo product. Product configuration should be the same as virtual machine you want to connect to Virtuozzo Hybrid Server module.
Place new order with previously created product for your customer (it is important to use same hostname as VM you want to use). Do not activate product yet.
Go to 'Products/Services' section of freshly created product and press 'Assign VM by Name', this will only connect VM by UUID, and get IP addresses list.
Set product status to 'Active'.
Remember to not click 'Create' button during the entire process. That would unnecessarily create a new virtual machine.
If you decide to remove VM and you do not want to configure it on WHMCS system, create product with its hostname and use 'Delete VM by Name'.
Use 'Delete VM by Name' button with care.
Both 'Assign VM by Name' and 'Delete VM by Name' can be found in admin area of uncreated Virtuozzo Hybrid Server product.
# Tips
Operations performed on the virtual servers are not executed immediately.
Give your Virtuozzo servers some time for processing the request and execution of the operation.To change the password, OS on VM has to finish a boot sequence. Password is changed when the ready status is detected by cron.
# Update Instructions
An essential guidance through the process of updating the module is offered here.
Ensure successful completion of the module update by carefully following each step, thereby preventing data loss or any unforeseen issues.
Additionally, you will find a current list of supplementary actions necessary for a smooth update process there.
# How To Update From Parallels Cloud Server
If you switch from Parallels Cloud Server to newer version of Virtuozzo Hybrid Server, follow the below steps.
Firstly, download the latest version from our client area. In the downloaded file you might find one or two packages that support different PHP versions.
In the most recent versions of the module, you will find only one package that supports PHP 7.4 and later.
If you need a package for the previous versions of PHP, please contact our support (opens new window).Once you have chosen the package with the right PHP version, extract it and upload its content into the main WHMCS directory.
The content of the chosen PHP version files to upload should look like this.
Then you need to update server settings in 'Products/Services' → 'Servers'. Find more here
Finally, update your product details. To do so, move to 'Products/Services' → 'Products/Services'. Find details here.
If you are updating from Parallels Cloud Server 1.0.5 or older, you have to make additional changes.
Update configurable options of product using Virtuozzo Hybrid Server module.
Update ordered product using Virtuozzo Hybrid Server module.
Your module and products have been just successfully updated, good job!
# Upgrade Guide
Seeking a solution that offers greater flexibility, customization tailored to your precise needs, and unrestricted availability?
There is an option that not only proves to be cost-effective in the long run but also includes prioritized support services, making it a truly valuable investment.
Opt for the Open Source version (opens new window) of your Virtuozzo Hybrid Server For WHMCS module to unlock these benefits.
Simply click on either the Get Source Code or Upgrade To Lifetime button found on the product's page in our client area to complete the one-step upgrade process, with a dedicated discount already applied.
Follow a comprehensive guide covering the transition process, the advantages it brings, and step-by-step instructions on what to do next after the order has been successfully finalized.
# Common Problems
When you have problems with connection, check whether your SELinux or firewall does not block ports.
It can happen that at your 'Module Settings' tab you can get loading gray screen.
Do not worry, it can take a while to download available settings from your Virtuozzo server.
But if loading takes too long, check if your server connection credentials are set correctly.
Remember, use connection credentials to Virtuozo server node, not the Virtuozo server itself.When you see the message shown on the screen below, it means that you have not installed IP Manager For WHMCS.
This module is needed to manage your IP addresses from the Virtuozzo Hybrid Server addon, and can be downloaded from here (opens new window).
It is not advised to use Parallels Cloud Server For WHMCS module with Virtuozzo Hybrid Server For WHMCS at the same time.
If you are getting an error like this one:
SQLSTATE[42S02]: Base table or view not found: 1146 Table 'username.pcsNetworkClassConf' doesn't exist.when configuring the product's module settings, make sure that the Virtuozzo Hybrid Server addon has been enabled.
You may encounter a problem with the scheduled backup task that may have been initiated successfully but got stuck on the "Current in progress" status with 0 attempts.
In that case, we recommend that you increase the 'wait_timeout' parameter in your MySQL configuration from the default 300 to at least 3600.