The module will allow your clients not only to remotely control the status of a machine, but also access the KVM and IMPI console, and update reverse DNS paths.
In addition, you will easily decide whether an existing server can be reused by another customer, in case the previous one no longer needs it.

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

In the most recent versions of the module, you will find only one package that supports PHP 7.1 and later.
If you need a package for the previous versions of PHP, please contact our support.

The first one that supports PHP 5.6 up to PHP 7.0, and the second one addressed to PHP 7.1 up to PHP 7.3.
Note: Keep in mind that PHP versions 5.6 up to 7.0 are no longer officially supported and their security issues are not fixed or released any more. Find more info here.

The content of the chosen PHP version files to upload should look like this.

The file is located in 'modules/servers/OvhVpsAndDedicated/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

Enter your license key between the quotation marks as presented on the following screen.
You can find your license key in our client area → 'My Products'.

This folder is available at '/your_whmcs/modules/servers/OvhVpsAndDedicated/'.

• Mail cron - will be used to send emails to clients after Server creation, reinstallation and entering the rescue mode.
  You will find more information on this topic in the product configuration section. We suggest the cron to run every 5 minutes:

php -q /home/your_whmcs/public_html/test/modules/servers/OvhVpsAndDedicated/cron/cron.php mail:run

Remember to replace 'your_whmcs' with your WHMCS root path.

Log in to your WHMCS admin area. Click 'Setup' and find 'Addon Modules'.
Afterwards, find 'OVH VPS And Dedicated Servers For WHMCS' and press the 'Activate' button.

To do so, click on the 'Configure' button, tick the desired admin roles and press 'Save Changes'.

Access the addon under 'Addons' → 'OVH VPS And Dedicated'.

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

Now, provide your:

• Application Key
• Application Secret
• Consumer Key
  

Then select Location and Country corresponding with the server offered by the administrator and finally, select the server type.
Note: For "So You Start" and "Kimsufi" select 'Dedicated'.
Check the connection when ready and, if it is successful, save the changes.

• https://api.ovh.com/createApp/ (US)
• https://eu.api.ovh.com/createApp/
• https://ca.api.ovh.com/createApp/
• https://eu.api.soyoustart.com/createApp/
• https://ca.api.soyoustart.com/createApp/
• https://eu.api.kimsufi.com/createApp/
• https://ca.api.kimsufi.com/createApp/

To create an application, please move directly here and create the necessary keys.
In case you encounter any issues with generating your API details, please contact your provider. To learn more about API, please refer to the documentation.

Click on 'Create a New Group'.

To do so, first click on 'Create a New Product'.

The module should automatically save and reload the settings. If not, click on the 'Save Changes' option manually.

Underneath we will describe the settings configuration for 'OVH VPS' and 'OVH Dedicated Servers' in details.
Note that settings for 'So You Start' and 'Kimsufi' products are very much alike the 'OVH Dedicated Servers' once, so you may surely base on them while configuring these products.

OVH VPS configuration settings:

• VPS Type - Select a VPS, each type is adapted for specific use
  • VPS Cloud
  • VPS Cloud RAM
  • VPS SSD

• Solution Type - choose from the available the one that will suit your needs the most

• Operating System - choose the OS, it can still be reinstalled at any time if such an option is enabled for clients
  • GNU/Linux
  • Windows (Cloud/Cloud RAM only)

• Image - select the image of the system or system with a preinstalled application, such as cPanel or WordPress, that will be installed on the server

• Version - version of operating system or application to be installed

• Language - language of operating system or application to be installed

• Datacenter Location - choose where the server shall be located on the OVH data center

• Duration Term - choose frequency of renewals

• Snapshot - toggle to allow clients to capture an image of the server at a given time, option used to quickly restore the VPS or secure it before making changes

• License - this field appears when Windows OS or an image with Plesk or cPanel is selected, decide whether a paid license shall be also added to the order

• Operation System Template - choose template of operation system to install

• Operating System Language - choose language of installed operation system

Due to API limitations, all emails with server credentials can only be sent to your OVH/ Kimsufi/ So You Start email address set in the panel.
This applies to messages with credentials sent after creating the server as well as messages sent after reinstallation.
The solution to this problem is email piping that will be used to receive messages sent to your OVH mailbox and then forwarded through the templates further to your WHMCS clients.

Note: Even though the module filters the received messages in your mailbox, we recommend that you use a separate mailbox for your main OVH VPS and Dedicated Servers profile account to avoid any issues with non-OVH content.

After setting up the dedicated mailbox, provide its valid credentials below and test whether the connection has been established correctly.

Note: There is available an option to 'Disable Certificate Validation'. Please toggle this option ONLY if you are having troubles with the connection. The certificate validation will be omitted when connecting to an email box.

• Action On Service Suspension - decide what to do with the server in situation when the module command: Suspend has been triggered
  • Stop (VPS)
  • Do Nothing (VPS)
  • Do Nothing (Dedicated Server)
  • Reboot To Rescue (Dedicated Server)
  • Terminate (Dedicated Server)
  • Reinstall (Dedicated Server)

• Auto Pay With Preferred Method - toggle to make payments for orders automatically with a preferred payment method in OVH Panel

• Auto Assign VPS/Dedicated Server To Reusable On Termination - when terminated, the server will be in fact cleared and added to the queue to be selected as a reusable by other clients

• Waive Retractation Period - toggle to waive retractation period on OVH orders

You will find here numerous options that can be enabled and then will be available to your clients in their client area. Please note that some options are available for VPS only, Dedicated Server only and some for both of them:

• Snapshot (VPS only) - if enabled, clients are granted access to snapshot section

• Disks (VPS only) - if enabled, clients are allowed to view disks attached to their servers with specified limits

• Reinstall - if enabled, clients are allowed to reinstall the server in the client area

• KVM/IPMI Console - if enabled, clients are allowed to manage their server using KVM console

• Rescue Mode - if enabled, clients are allowed to reboot the server in rescue mode

• IP Addresses - if enabled, clients are allowed to view IP addresses assigned to the server

• Update Reverse DNS Paths - if enabled, reverse DNS can be updated in the client area, 'IP Addresses' must be previously enabled to use his option

• Traffic Statistics Graph (Dedicated Server only) - if enabled, clients are allowed to view traffic graph

Important: Access to KVM/IPMI Console and Traffic Statistics Graph is available for OVH only. "Kimsufi" and "So You Start" brands do not support them.

Configurable options can be used by your clients to select each Server parameters individually during order placement.
Otherwise, if configurable options are not defined, then the fixed parameters specified in the earlier configuration will be used instead.
If you decide to use configurable options, select which options you want to generate.
Note that the configuration for disabled options will still be taken from the configuration of the main product.
More information about how to use configurable options can be found here or in the official WHMCS documentation.

Go to 'Addons' → 'OVH VPS And Dedicated' in your WHMCS.

Next to the machine name, there are details such as:

• its state
• displayed name
• assigned client (if there is any already)
• service assigned
• reusable toggle - for machines that can be used again by other clients without the necessity to terminate it first. If disabled, the machine can be simply terminated when not used.
  If enabled, when the product is created for the next time by the client, this machine will be automatically reinstalled and assigned to this client.

In order to manually assign the machine to a client, simply press the marked on the screen button and start typing to see a list of clients, then select existing service to assign.

This includes supervision of such features like:

1. Module commands and service actions that enable you to manage server status and features
2. Service information which provides you with the current status, resources and options set for the server

3. Service Monitoring section with current statuses
4. Created snapshot with a direct option to edit, restore and delete it
5. List of IP addresses with option to update the reverse DNS path
6. List of disks with any important details

3. List of IP Addresses with option to update the reverse DNS path
4. Traffic statistics graph

After the order placement and successful VM creation, the server credentials will be sent to the client's email address according to the set cron execution intervals.

The module allows your customers to easily power on/off, shutdown, reboot and reboot in rescue mode, reinstall and access console through pressing the corresponding buttons.
Clients can also view disks, create and restore snapshots, see IP addresses and view current traffic graphs.
Additionally, clients may view the current server parameters, resources as well as the assigned IP addresses.

OVH VPS client area view:

Allowed actions on the created snapshot:

1. Edit the snapshot (description)
2. Restore the snapshot to reverse the saved contents of the VM settings
3. Delete the snapshot
4. Create a snapshot.
   Keep in mind that you must have previously deleted the existing snapshot, as only one snapshot may exist at the time.
   

Note: Creating a snapshot may take a while, so it will not appear on the list right away.

• Type
• Size
• Bandwidth limit
• Free space threshold
• Status

Update the reverse DNS path of an IP address by pressing the marked button.

You may easily adjust the graph's view by changing the time scope of the displayed stats.

Note 1: Some of the mentioned option may not be visible on the graph until soma data are generated. This is applicable to the graph itself as well.
Note 2: "So You Start" and "Kimsufi" brands may not support graphs.

• OVH VPS Has Been Created
• OVH VPS Rescue Reboot
• OVH VPS Reinstalled
• OVH Dedicated Reinstalled
• OVH Dedicated Server Rescue Reboot
  

In order to view the templates' content and edit it, please move to WHMCS → Setup → Email Templates.
More detailed information on templates can be found in the official documentation.

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.