Proxmox Full Automation:Installation

Language:	English  • français

System Requirements

Below is the list of system requirements :

• WHMCS 5.3.9+
• PHP 5.6+
• Ioncube Loader version 10.1.0 or later
• PHP cURL with support SSL
• Proxmox VE 2.0+ / Proxmox VE 3.0+

Addon Installation

Installing WHMCS Proxmox Full Automation is very simple. The following steps will guide you through the process:

Upload

• Unzip the contents of the zip file to a folder on your computer
• Upload the files and folders to your WHMCS folder - if you experience problems, try uploading in binary mode

Activation

• Go to Configuration >> Modules Addon >> Proxmox Full Automation et clic to active.
• Check "Full Administrator" like in the image below.

• Go to Addons >> Proxmox Full Automation and enter your license in (Module License Key) like in the image below.

That's it! the installation is complete :).

Configuration

Plans

Go to the VM plans and add your product plans OpenVZ and KVM as in the images below:

Adding OpenVZ Plans

Adding KVM Plans

IP Addresses

Go to the section IP Blocks and add IP blocks and assign them to your cluster, then assign the IP address blocks to each block as in the image below :

Adding IP Blocks

Adding IP Addresses

Adding Server

• Go to Settings >> Products / Services >> Serverus

• Add a server and fill in the fields (Name, Hostname, IP Address)

then in the "Server Details" selection type "Proxmox" then fill in the fields (Username, Password) as in the image

• Note : The username can end with "@pam" or "@pve", it depends on the authentication method you have chosen.

Configuration Systems Templates

Go to Storage section of your Proxmox Cluster and add Storage called "xtemplates" where you should place your templates and your ISO

That's it! your module is configured.

Optional Configuration

Operating System Chooser

This small feature, convenient, lets you add a scrolling list of operating systems on the order form, allowing the customer to choose the operating system they want without having to reinstall them VPS after delivery with a default system.

To configure this, you must create a group of configurable options for each type of virtualization :

• Then you must add a new configurable option for the new group.

The default name for the configurable option is 'Operating System' but you can customize the display name of the option by adding a second part that will be the name displayed when ordering.

Both parties must be separated by a | (Alt Gr + 6)

• Select the type of option: Dropdown.

• In the Options field, you need to define your models with one hand the file name or the iso, and secondly, a friendly name that will be shown when ordering.

The first part is the file name eg 'X2PVOL_FR.iso' and the second part is the friendly name that is' Windows XP Pro. Both parties must be separated by a | (Alt Gr + 6)

The file name must match the name of the ISO or the OpenVZ template present in the storage "xtemplates".

You must obtain options that should like the image below:

That's it, just click on 'Save Changes' and follow this procedure for each type of virtualization you need.

Group Chooser

The group chooser lets you add a dropdown list of definable node groups on the products order form allowing the client to choose a specific group on order. This can be handy for a serveral purposes including a location chooser. For example, to set up a Location Chooser:

First create a group on "Cluster >> Clusters Groups" section

Fill out the fields and click "Save Changes"

You'll get a result like in the picture below

Then create a new configurable option group like in the image below:

• You then need to add a new configurable option to the new group. The default name for the configurable option is 'Location' but you can customize the display name of by adding a second part that will be the name displayed when ordering.

Both parties must be separated by a | (Alt Gr + 6)

• Select Option Type: Dropdown.

• In Field Options you need to define your locations with a friendly name and the cluster group id (You can get the id's from the Clusters Groups list).

When ID is '0' the Container/VM wille be created on the first available cluster.

Example:

Thats it, just click Save Changes!

Resources

The resource selector allows your customers to order custom configurations of virtual servers.

It allows customization of the size of disk space, memory, number of processors and the number of IP addresses.

PS: These options override the settings of the 'Plan' of your predefined

To establish a resources chooser:

• Create a new group of configurable option as in the picture below

• then you must add a new configurable option for the new group.

The default name for the configurable option is 'CPU' but you can customize by adding a second part that will be the name displayed when ordering.

Both parties must be separated by a | (Alt Gr + 6)

• Select the type of option: Dropdown.

• In the Options field, you must set the one hand the number of CPUs, and secondly, a friendly name that will be shown when ordering.

The first part is the number of CPUs for example '1' and the second part is the friendly name to know '1 vCPU'.

Both parties must be separated by a | (Alt Gr + 6)

You must obtain options that should like the image below:

• Then you must add a new configurable option named 'Disk Space', you can customize by adding a second part, both parties must be separated by a | (Alt Gr + 6)

• Select the type of option: Dropdown.

• In the Options field, you must set the one hand the disk size in GIGABYTES, and secondly, a friendly name that will be shown when ordering.

Both parties must be separated by a | (Alt Gr + 6)

You must obtain options that should like the image below:

• Then you must add a new configurable option called 'Memory', you can customize by adding a second part, both parties must be separated by a | (Alt Gr + 6)

• Select the type of option: Dropdown.

• In the Options field, you must set the memory size in MEGABYTES and the size of the swap and the other, a friendly name that will be shown when ordering.

The memory size and the size of the swap must be separated by : (colon).

PS: For KVM machines, the size of the swap is ignored.

Both parties must be separated by a | (Alt Gr + 6)

You must obtain options that should like the image below:

• Then you must add a new configurable option called 'IP Address', you can customize by adding a second part, both parties must be separated by a | (Alt Gr + 6)

• Select the type of option: Dropdown.

• In the Options field, you must set the one hand the number of IP addresses, and secondly, a friendly name that will be shown when ordering.

Both parties must be separated by a | (Alt Gr + 6)

You must obtain options that should like the image below :

That's it! you can now offer VPS with resources completely customizable.

Additional Resources

This selector allows your customers to order additional resources for their virtual servers.

It allows the addition of disk space, memory, processors and IP addresses.

PS: Adding disk space for Machine KVM is not supported

To implement a selector for additional resources:

• Create a new group of configurable option as in the picture below

• Then you must add new configurable options for the new group exactly as we have seen now for resources but with new variables as follows:

• For the CPU, the default name for the option is 'Extra CPU'

• For disk space, the default name for the option is 'Extra Disk Space'

• To the Memory, the default name for the option is 'Extra Memory'

• For IP address, the default name for the option is 'Extra IP Address'

That's it, you can now offer additional resources for your VPS.