XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.

We will guide you step by step through the whole installation and configuration process.

Note: You can check the current PHP version in your WHMCS. To do so, proceed to 'Utilities' › 'System' › 'PHP Info'.

The content of PHP version files should look like this.

File is located in 'modules/servers/DigitalOcean Droplets/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

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'.

To do so, log in to your WHMCS and move to 'Setup' → 'Addon Modules'. Find 'DigitalOcean Droplets' and press 'Activate'.

To do so, click on 'Configure' button, tick 'Full Administrator' and press 'Save Changes' .

Suggested execution time for 'slowCron' - each 5 minutes.
Suggested execution time for 'cron' - each minute.

Go to 'Setup' → 'Products/Services' → 'Servers' and press 'Add New Server' .

Note: Server you are using on WHMCS is in fact a node on your PVA server, not a whole PVA server.

Click on 'Create a New Group' .

To create a product click on 'Create a New Product'.

Note: 'Product Type' should be set to 'Dedicated/VPS Server'.

Next, click on 'Save Changes'.

Note: 'DigitalOcean Droplets Container' server type can have only one routed network.

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.

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'.
Note: Values which will not be generated in configurable options, will be taken from 'Default Values'.

You can do it by simply selecting/unselecting checkboxes next to a page/functionality you want to enable/disable.
On screen below you can see enabled all pages and functionalities.

Your clients should see something similar to the screen below.

You can monitor and manage each product from your WHMCS admin area.

You can also find here a link to DigitalOcean Droplets For WHMCS Wiki which you are currently reading.

Afterwards, follow steps 9 to 21 of 'Droplets_VPS_For_WHMCS#Configuration_of_Server Installation and Configuration' instructions.

You can view here basic information about virtual servers.
To view more information about specific virtual machine, simply press on 'View' button.

To access it, go to 'Addons' → 'DigitalOcean Droplets' → 'Servers Monitor' and press 'IP Management' button.

Let's add a new configuration to 'Host Only' network. To do so, press ' Create a new configuration for this network' button.

Provide your configuration name, assign it to DigitalOcean Droplets products, addons or server and press 'Create New Configuration' .

To do so, click 'Create New Subnet' button and follow the steps described here.
Note: It is also recommended to enable IP Manager integration module for DigitalOcean Droplets. You can find instruction on how to do that here, but you do not have to assign configuration to it.

Go back to the IP Manager configuration list and press the 'Assigned Subnets' button.

You will now have to assign DigitalOcean Droplets configurable options that will be used to determine the number of IP addresses from the pool assigned to the DigitalOcean Droplets product.
Note: The configurable options are required for IP addresses assignment by IP Manager.
Even if you do not want to use all configurable options for the product, you have to create and assign at least these two:

ip_number|Number of Public IP
ip_number_secondary|Number of Private IP

Click Droplets_VPS_For_WHMCS#Editing_Configurable_Options here for more information. If you already have configurable options set, press the 'Configurable Options' button to add a new relation.

Important: If you decide to assign both public and private configurable options, as shown below, then you will also have to assign that configuration for the second network interface (if used).

Repeat the above steps for the second configuration in the same manner, or use the already created configuration to use shared IP pool.

You can also order 'Server Actions' (3) such as 'Stop' , 'Restart' , 'Suspend' , 'Start' , 'Reinstall' , 'Resume' and 'Migrate' .
You are able to configurable options(1), server details(4), assigned IP addresses(5), scheduled cron tasks(6) and host ID(7).
Note: 'Basic Template' cannot be changed if product was already created. 'Node' can be changed only using 'Migrate' and 'OS Template' through using 'Reinstall'.

Note: You are not able to reinstall 'Virtual Machine' server type.

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.

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.
Clients can also create backup and set up backup jobs(5), access VNC console(7), view virtual server usage statistics(6) and manage IP addresses(8).
Note: If your client is using 'DigitalOcean Droplets Container' they can also manage firewall (9).

To create backup job press 'Create Backup Schedule' as shown on the screen below. Note: If two backup task are ordered in too small time interval, only one backup is created.

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 Daily' option.
To create this backup job, press 'Create Backup Schedule' button.

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.

Note: If the noVNC console does not work, make sure that it was enabled in your DigitalOcean Droplets panel. There you can also test if it works properly.

They can 'Enable' / 'Disable' firewall(1), add new firewall rules(2), view existing rules list and manage existing rules(3).
Note: 'Firewall Management' is available only for 'DigitalOcean Droplets Container' server type.

He can find resource usage and graphs of CPU, memory, bandwidth and disk.
Additionally, he can choose period of resource usage to display on graphs.

They can also order new IP addresses.

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.

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' ).

Now, let us show you how to edit options. Lets 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.

Edit 'Maximum Allowed' textbox as shown on the following screen.
Afterwards, press 'Save Changes'.

Firstly, go to 'Setup' → 'Products/Services' → 'Configurable Option'.

On the screen below you can see hiding of 'Number of Public IP' and 'Number of Private IP'.

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.

1. Create and configure a DigitalOcean Droplets server and a server group.
2. Create and configure a DigitalOcean Droplets product. Product configuration should be the same as virtual machine you want to connect to DigitalOcean Droplets module.
3. 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.
4. 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.
6. 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 DigitalOcean Droplets product.

Give your DigitalOcean Droplets servers some time for processing the request and execution of operation.

Go to 'Setup' → 'Product/Services' → 'Servers' and press 'Test Connection' button next to your server.

Keep in mind there is a quick and easy option in our client area that will let you upgrade the license of your module to an open source version at any time - and at a lower price!
To take advantage of it, simply use the License Upgrade button located on the product's page and a discounted invoice will be generated automatically.

Firstly, download the latest version from your client area.

Note: You can check current PHP version in your WHMCS. To do so proceed to 'Utilities' → 'System' → 'PHP Info'.

The content of PHP version files should look like this.

Update configurable options of product using DigitalOcean Droplets module.
Update ordered product using DigitalOcean Droplets module.

Do not worry, it can take a while to download available settings from your PVA server.
But if loading takes too long, check if your server connection credential is set correctly.
Remember, use connection credential to PVA server node, not PVA server itself.

This module is needed to manage your IP addresses from DigitalOcean Droplets addon, and can be downloaded from here.

SQLSTATE[42S02]: Base table or view not found: 1146 Table 'username.pcsNetworkClassConf' doesn't exist.

when configuring product's module settings, make sure that the DigitalOcean Droplets addon has been enabled.