KernelCare WHMCS Plugin

Overview

CloudLinux Licenses For WHMCS allows you to automatically provision KernelCare, Imunify360, and CloudLinux licenses along with selected products. You can provision them for free or as a paid add-on to your product. Owing to CloudLinux Licenses add-on, all module commands on your main product are automatically reproduced on the license product.

Admin Area Functionality

  • Create License
  • Terminate License
  • Suspend/Unsuspend License (only IP based licenses)
  • Change License IP Address
  • View License Details

Client Area Functionality

  • View License Details
  • Change License IP Address

Add-on Functionality

  • Manage Relations Between Add-on And License Product
  • Manage Relations Between Server And License Product
  • Automatically Add License Product To Order When Relation Is Triggered
  • View Existing Licenses
  • Dependencies Between Module Actions - Every Action: Create, Terminate, Suspend Or Unsuspend Called On The Server Product Will Result With The Same Action Performed On The Licensed Products
  • Flexible Filtering Of Existing Licenses

Additionally

  • Multi-Language Support – Only Provisioning Module
  • Supports CloudLinux, KernelCare, and Imunify360 Licenses
  • Supports WHMCS V6 and Later

Installation & Configuration

In this section we will show you how to set up our products.

Installation and Update

Download CloudLinux Licenses For WHMCS:

Upload archive to your WHMCS root folder and extract it. Files should automatically jump into their places. Run the following script:

php <whmcs_root>/clDeploy.php --migrate

Configuration of Product

  1. Log into your WHMCS admin area and go to Setup → Products/Services → Products/Services. Click Create a New Group.
  2. Fill Product Group Name (product group will be visible under that name in your WHMCS system) and click Save Changes.
  3. Click Create a New Product. Choose Other from Product Type drop-down menu and previously created product group from Product Group drop-down menu.
  4. Fill Product Name and click Continue.
  5. Set up this product as hidden by ticking Hidden checkbox at Details tab. Do not set up pricing for this product. Pricing will be done in another way.
  6. Go to the Module Settings tab and select CloudLinux Licenses from Module Name drop-down.
  7. Fill Username and Password with your CloudLinux API access details and select KernelCare from License Type drop-down.
  8. Click Save Changes to confirm.

Configuration of Add-on

  1. Go to the Setup → Add-on Modules, find CloudLinux Licenses Add-on and click Activate next to it.
  2. The next step is permitting access to this module. Click Configure, select admin role and confirm by clicking Save Changes.
Fig 1: KernelCare License For WHMCS provisioning module configuration.
Fig 2: KernelCare License For WHMCS add-on module main page.

Management

In this section you can find two ways of linking license product with your server product as well as other possibilities of the module.

In order to allow your client to decide whether he wants to order server with or without a license we will use Product Add-on. In this way, when the client orders an add-on, the relation will be triggered and the license product will be ordered along with module.

The following steps must be performed to prepare such connection:

  1. Go to Setup → Products/Services → Products Add-ons and click Add New Add-on.
  2. Fill add-on name, set up billing cycle and price.
  3. Then tick Show on Order checkbox, assign add-on to the product and click Save Changes.
Fig 3: Configuration of product add-on, which will trigger license product adding.
  1. Go to Add-ons → CloudLinux Licenses Add-on → Add-on Relations and click Add Relation.
  2. Select previously created product add-on and license product as shown below and click Add Relation.
Fig 4: Creating relation between product add-on and provisioning module.

If you want to offer server along with the license, perform the following steps.

Note

Please do not set up pricing for license provisioning product. In exchange, you can increase a price for server provisioning product.

  1. Prepare license provisioning product as described in the Configuration of Product section of this documentation.
  2. Go to Add-ons → CloudLinux Licenses Add-on → Products Relations and click Add Relation.
  3. Select server provisioning product from the Main product drop-down list and license provisioning product from Linked Product With License and click Add Relation.
Fig 5: Creating relations directly between server and license provisioning modules.

In order to allow your client to decide whether he wants to order server with or without license we can use Configurable Options ( https://docs.whmcs.com/Addons_and_Configurable_Options).

Below we will show you what steps to proceed to prepare such connection:

  1. Configure CloudLinuxLicenses product as described here.
  2. Go to Setup → Products/Services → Configurable Options and click Create a New Group.
  3. Fill group name and add New Configurable Option , set up billing cycle, price and option type. Then save changes.
  4. Go to Add-ons → CloudLinux Licenses Add-on → Configurable Options Relations and click Add Relation.
  5. Choose appropriate configurable option and license product which it is assigned to and click Add relation.

Note

The plugin doesn’t support quantity type of Configurable Options.

Fig 6: Creating relations directly between server and license provisioning modules.

Note

For WHMCS 7.2.x and later

WHMCS 7.2 introduces the ability to associate Product Add-ons with Provisioning Modules.

In order to allow your client to decide whether he wants to order server with or without license we will use product add-on. Below we will show you what steps to proceed to prepare such connection.

  1. Go to Setup → Products/Services → Products Add-ons and click Add New Add-on.
  2. Fill add-on name, set up billing cycle and price. Then tick Show on Order checkbox, assign add-on to the product.
  3. Go to Module Settings tab and select CloudLinux Licenses from Module Name drop-down.
  4. Fill Username and Password with your CloudLinux API access (API secret key) details and select KernelCare from License Type drop-down.
  5. Click Save Changes to confirm.
Fig 7: Configuration of product add-on with Provisioning Modules.

KernelCare Key Licenses

  1. To set KernelCare Key license while adding service in Module Settings do the following:
  • choose KernelCare in License Type drop-down;
  • mark Use Key (instead of IP address) checkbox;
  • enter IP registration token (API secret key) from Profile page in CLN;
  • in Key Limit field enter the number of servers and click Save Changes;
Fig 8: Setup KernelCare License.
  • the License Key Custom Field will be automatically added.
Fig 9: License Key Custom Field is displayed while editing service.
  1. To edit service do the following:
  • when Service Created Successfully message appears, you can edit Service;
  • specify all proper information and settings and click Save Changes.
Fig 10: Editing service.

Order

All the services registered in the account are displayed in My Products & Services area. When you choose particular Product/Service and click View Details, you can view Product information, change license key, view Add-ons or make changes in Management Actions section.

Fig 11: Client’s products list.
Fig 12: Licenses details.

To order and purchase a new service do the following:

  • choose Category → KernelCare Group and click Order Now on a particular service;
Fig 13: Order - Products group.
  • choose Billing Cycle if possible;
  • enter information in Configure Server area;
  • choose Available Add-ons and click Continue Shopping to proceed or Checkout to view service details;
Fig 14: Order - Configure product.
  • enter Promotional Code in a specific field if you have one;
  • choose Payment Method and click Continue Shopping.
Fig 15: Order - review and checkout.

Admin Area

From the admin area it is possible to command such action as create, terminate, suspend/unsuspend and change IP address or License Key. Nonetheless, these actions can be ordered only on the server provisioning module and will be automatically reproduced for the license provisioning product.

Only change IP address feature has to be ordered manually.

You can also view the details of created license.

Fig 16: KernelCare Licenses For WHMCS admin area.

Client Area

The clients are also able to view their servers license details. And as well as you, they are able to change IP address or License Key of their licenses.

Fig 17: KernelCare Licenses For WHMCS client area.

To change IP address or License Key click Change as shown on the screen above. Then specify IP address or License Key and click Save.

Fig 18: Changing License Key or IP address.

Licenses List

You can view the list of all licenses owned by your client at our add-on → Licenses List.

You can filter the list of licenses by client name, server provisioning products, license provisioning products and license IP address/Key.

Fig 19: Licenses List.

Add-on Licenses List

Note

For WHMCS 7.2.x and later

You can view a list of all product add-on with Provisioning Modules licenses owned by your client at our add-on → Licenses List.

Fig 20: Add-on Licenses List.

Common Problems

After activating the server provisioning product, license provisioning product bounded to it is still pending.

Reason: License IP address may be already taken.

Solution: Change server IP address.

Note

Currently, only key-based licenses are available for Imunify360. Support of IP-based licenses will be added soon.