Personal tools
Namespaces

Variants
Actions

EasyDCIM Dedicated Servers For WHMCS

From ModulesGarden Wiki
(Difference between revisions)
Jump to: navigation, search
Line 342: Line 342:
 
*Cost - price per Mbps unit above the '' 'Soft Limit' '' value
 
*Cost - price per Mbps unit above the '' 'Soft Limit' '' value
 
E.g. If '' 'Soft Limit = 100' '' and '' 'Cost = 0.500' '' and the client exceeds the bandwidth by 10 Mbps, reaching to '' '110 Mbps' '', they will be additionally charged with ''$5 USD'' (''10 x 0.500''). <br />
 
E.g. If '' 'Soft Limit = 100' '' and '' 'Cost = 0.500' '' and the client exceeds the bandwidth by 10 Mbps, reaching to '' '110 Mbps' '', they will be additionally charged with ''$5 USD'' (''10 x 0.500''). <br />
−
'' '''Note:''' The percentile billing required the standard overages bandwidth billing to be enabled. It will be also calculated during the execution of the [https://docs.whmcs.com/Crons#System_Cron WHMCS system cron].
+
'' '''Note:''' The percentile billing requires the standard billing of bandwidth  overages to be enabled. It will be also calculated during the execution of the [https://docs.whmcs.com/Crons#System_Cron WHMCS system cron].
 
|}
 
|}
 
{|
 
{|
Line 353: Line 353:
 
*OrderID - the number used to link the product with EasyDCIM order number  
 
*OrderID - the number used to link the product with EasyDCIM order number  
 
*ServerID - the number used to link the product with EasyDCIM server ID
 
*ServerID - the number used to link the product with EasyDCIM server ID
−
*bandwidthUsageFromRegistrationDate - if set to '' 'on' '', the billing cycle for transfer usage will be billed monthly starting from the date of product registration (e.g. from the 15th to the 15th of the following month). <br />Otherwise, usage charges will be calculated on the last day of each month as in [https://docs.whmcs.com/Disk_Space_and_Bandwidth_Overage_Billing default WHMCS cycle].
+
*bandwidthUsageFromRegistrationDate - if set to '' 'on' '', the billing cycle for transfer usage will be billed monthly, starting from the date of product registration (e.g. from the 15th to the 15th of the following month). <br />Otherwise, usage charges will be calculated on the last day of each month as in [https://docs.whmcs.com/Disk_Space_and_Bandwidth_Overage_Billing default WHMCS cycle].
−
*percentileUsage - the entire current usage, basing on which the value above the one specified previously in the percentile configuration will be calculated.
+
*percentileUsage - the entire current usage. If the value specified previously in the percentile configuration is exceeded, the additional charge will be calculated accordingly.  
 
|}
 
|}
 
{|
 
{|
Line 362: Line 362:
 
=Management=
 
=Management=
 
{|
 
{|
−
|style="padding: 10px 0px 30px 15px;"|'''In this section we will show you all the possibilities of EasyDCIM Dedicated Servers For WHMCS.'''<br/>
+
|style="padding: 10px 0px 30px 15px;"|'''In this section we will show you all possibilities of EasyDCIM Dedicated Servers For WHMCS.'''<br/>
 
Our module allows you to offer and manage EasyDCIM servers right in your WHMCS system.
 
Our module allows you to offer and manage EasyDCIM servers right in your WHMCS system.
 
|}
 
|}
Line 368: Line 368:
 
{|
 
{|
 
|style="padding: 10px 0px 15px 15px;"|
 
|style="padding: 10px 0px 15px 15px;"|
−
As soon as you set up a server for a client, you can request various actions and view server details from WHMCS admin area.<br/>
+
As soon as you set up a server for a client, you can request various actions and view server details from the WHMCS admin area.<br/>
 
'' The 'Log In To Panel' '' button allows you to immediately log in to the client's EasyDCIM control panel.<br/>
 
'' The 'Log In To Panel' '' button allows you to immediately log in to the client's EasyDCIM control panel.<br/>
−
'' The 'Change Password' '' action alters the SSH access details to the client's server while '' 'Update Order Information' '' allows you to manually check if the server's matching order has been found and assigned.
+
'' The 'Change Password' '' action alters the SSH access details to the client's server while '' 'Update Order Information' '' allows you to manually check if a server matching the one specified in the order has been found and assigned.
 
|}
 
|}
 
{|
 
{|
Line 383: Line 383:
 
{|
 
{|
 
|style="padding: 0px 0px 20px 15px;"|Below the mentioned functions, there are various usage graphs and statistics available at your disposal.<br/>
 
|style="padding: 0px 0px 20px 15px;"|Below the mentioned functions, there are various usage graphs and statistics available at your disposal.<br/>
−
'' '''Note:''' By default, there are 5 types of statistics displayed. If you need more you can add them though the '''configuration.json''' file located in /yourWHMCS/modules/servers/EasyDCIM/Config. ''
+
'' '''Note:''' By default, there are 5 types of statistics displayed. If you need more, you can add them though the '''configuration.json''' file located in /yourWHMCS/modules/servers/EasyDCIM/Config. ''
 
|}
 
|}
 
{|
 
{|
Line 391: Line 391:
 
==Client Area==
 
==Client Area==
 
{|
 
{|
−
|style="padding: 10px 0px 20px 15px;"|In the client area, your customers can view all details concerning their servers, manage their status remotely as well as log in to their EasyDCIM control panel with a single click.
+
|style="padding: 10px 0px 20px 15px;"|In the client area your customers can view all details concerning their servers, manage their status remotely as well as log in to their EasyDCIM control panel with a single click.
 
|}
 
|}
 
{|
 
{|
Line 397: Line 397:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|Additionally, you can explore several usage graphs.
+
|style="padding: 0px 0px 20px 15px;"|Additionally, they can explore several usage graphs.
 
|}
 
|}
 
{|
 
{|
Line 403: Line 403:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|You can also view information about the traffic billing.<br />
+
|style="padding: 0px 0px 20px 15px;"|As well as view information about the traffic billing.<br />
 
'' '''Note:''' Available time intervals depend on the date of the product registration.
 
'' '''Note:''' Available time intervals depend on the date of the product registration.
 
|}
 
|}
Line 410: Line 410:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|As well as reinstall OS on your server.
+
|style="padding: 0px 0px 20px 15px;"|And also reinstall OS on their server.
 
|}
 
|}
 
{|
 
{|
Line 416: Line 416:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|Moreover, it is possible to control your reverse DNS. You can either edit the already existing records or create new ones.  
+
|style="padding: 0px 0px 20px 15px;"|Moreover, it is possible for your clients to control their reverse DNS. They can either edit the already existing records or create new ones.  
 
|}
 
|}
 
{|
 
{|
Line 422: Line 422:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|To create a record, just fill in the necessary information.
+
|style="padding: 0px 0px 20px 15px;"|To create a record, all your clients need to do is fill in the necessary information.
 
|}
 
|}
 
{|
 
{|
Line 428: Line 428:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|Your newly created record will appear on the list.
+
|style="padding: 0px 0px 20px 15px;"|The newly created record will appear on the list.
 
|}
 
|}
 
{|
 
{|
Line 434: Line 434:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|If you are using ''Dell'' or ''SuperMicro'' servers you can also access the KVM console.
+
|style="padding: 0px 0px 20px 15px;"|If your clients are using ''Dell'' or ''SuperMicro'' servers, they can also access the KVM console.
 
|}
 
|}
 
{|
 
{|
Line 440: Line 440:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|It will launch a ''Java'' applet that will automatically connect to your server.<br/>
+
|style="padding: 0px 0px 20px 15px;"|It will launch a ''Java'' applet that will automatically connect to your client's server.<br/>
−
'' '''Note:''' Your browser needs to have Java enabled with the correct permissions to make the console functioning.''
+
'' '''Note:''' The browser needs to have Java enabled with the correct permissions to make the console functioning.''
 
|}
 
|}
 
{|
 
{|

Revision as of 11:06, 12 April 2018

Contents

About EasyDCIM Dedicated Servers For WHMCS

EasyDCIM Dedicated Servers For WHMCS will allow you to move the provisioning and management of EasyDCIM servers directly to your WHMCS.

The module will let you handle all crucial aspects of created servers, including their status and the SSH password.
Concurrently, your customers will be able to overview their servers, access KVM console, manage rDNS records and more, all without leaving your website.

  • Admin Area Features:
✔ Create/Terminate/Suspend/Unsuspend Server
✔ Boot/Reboot/Shutdown Server
✔ Change Server SSH Access Details
✔ View Server Details
✔ View Server Resource Usage Graphs
✔ Generate Default Configurable Options
✔ Configure Server:
✔ Server Model
✔ Server Location
✔ OS Template
✔ Server Resources
✔ Toggle Automatic Order Acceptance And Server Matching
✔ Define Required Devices
✔ Define Required Item Models:
✔ HDD Model
✔ SSD Model
✔ RAM Model
✔ CPU Model
✔ Define Client Area Features
✔ Choose OS Templates Available For Rebuilding
✔ Choose OS Templates Available For Rebuilding
✔ Control Service Actions And Email Notifications
✔ Determine Monthly Interval Of Bandwidth Usage
✔ Define Percentile Billing Of Bandwidth Overage
✔ One Click Login To EasyDCIM:
✔ User Control Panel
✔ Admin Panel
✔ Toggle Debug Mode
  • Client Area Features:
✔ Boot/Reboot/Shutdown Server
✔ Receive Email Notification On Complete Server Creation
✔ Change Server Hostname
✔ Change Server SSH Password
✔ View Server Details
✔ Access KVM Console (Dell And SuperMicro Servers)
✔ Rebuild Server OS Using OS Templates And Your Own Credentials
✔ View Server Resource Usage Graphs
✔ View Traffic Statistics
✔ One Click Login To User Control Panel
  • Configurable Options:
✔ Server Model
✔ Server Location
✔ OS Template
✔ Service Access (Hidden By Default
✔ Bandwidth
✔ Additional IP Addresses
✔ HDD Size
✔ SSD Size
✔ RAM Size
✔ CPU Cores
✔ Custom - To Be Displayed In EasyDCIM Service Configuration
  • Advanced Billing Integration:
✔ Bill For Current Bandwidth Usage
✔ Apply 95th Percentile Billing Of Bandwidth Overages
  • General Info:
✔ Integrated With Advanced Billing For WHMCS v3.2.2 And Later - Actual Server Resource Usage Billing (read more)
✔ Integrated With Server Allocator For WHMCS - Automatic Assignment Of Specified Servers To Products (read more)
✔ Multi-Language Support
✔ Supports EasyDCIM v1.4.3 and Later
✔ Supports PHP 5.6 Up To PHP 7.2
✔ Supports WHMCS Template Six
✔ Supports WHMCS V7

Installation and Configuration

This tutorial will show you how to successfully install and configure EasyDCIM For WHMCS.

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

Installation

1. Log in to our client area and download the module.
ED 1.png
2. Upload and extract the files into the main WHMCS directory.

Files in your WHMCS directory should look like on the following screen.

ED 2 2.png

Configuration of Server

3. Now, we will show you how to configure a new product.

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

ED 3.png
4. Next, choose 'EasyDCIM' from the 'Type' dropdown menu.

Fill in your server name, IP address, username and password, then press 'Save Changes'.
Note: The password can be found in your EasyDCIM administrator user profile listed as 'API Key'.

ED 4.png
5. After configuring your server, you can check the connection.

In order to check the connection with an EasyDCIM server, edit the server configuration and press 'Test Connection' as shown on the screen below.

ED 5.png
6. The next step is creating a server group. To do so, click on 'Create Server Group'.
ED 6.png
7. Enter the name, click on your previously created server, press 'Add' and 'Save Changes' afterwards.
ED 7.png

Configuration of Product

9. In order to create and configure a product, go to 'Setup' → 'Products/Services' → 'Products/Services'.

Click on 'Create a New Group'.

ED 8.png
10. Enter the product group name and press 'Save Changes'.
ED 9.png
11. Once you have a product group, you can assign your product to it.

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

ED 10.png
12. Next, choose your product group, enter your product name and then press 'Continue'.
ED 11.png
13. Now, go to the 'Module Settings' section, choose both 'EasyDCIM' and your previously created server group from dropdown menus.

Do not forget to click 'Save Changes'.

ED 12.png
14. Before configuring the product, set up the EasyDCIM cron job which can be found here.
ED 13.png
15. The module configuration is only partly obligatory. The server will be assigned based on the provided configuration, and will therefore match only those options that have been specified.

Default Options:

  • Model (required) - the EasyDCIM server model
  • Location (required) - a desired server location
  • OS Template - reinstall server with a chosen OS template before delivering it to client
  • Bandwidth - define traffic limitation per server in a preferred monthly cycle
  • Additional IP Addresses - the number of additional IP addresses assigned to a server
  • HDD/SSD/RAM Size - a required amount of memory in specific parts (note: 1GB is equal to 1024 MB)
  • CPU Cores - the number of CPU cores

Product Configuration

  • Auto Accept - automatically run server matching, server will be provisioned in a few moments
  • Require PDU - the provisioned server has to be connected to a PDU device
  • Require Switch - the provisioned server has to be connected to a Switch device
  • Debug Mode - use only when performing troubleshooting
  • Service Access Level - configure the access level to control the features available to your clients. These levels and features are defined in your EasyDCIM at 'Clients' → 'Services' → 'Access Level' tab.

Items Model

  • Specify whether a chosen part has to be of a specific model, e.g. match the server using `Intel Xeon E3-1220 v5` CPU.

Client Area Features

  • Define elements available to your customers in your WHMCS client area.

Service Actions

  • Choose service actions to send chosen email notifications to selected administrators instead of performing provisioning actions immediately.
    Leave the fields unchecked to perform WHMCS module commands in a default manner.

Service Notification

  • Choose the email template that will be sent to the client when creation of the ordered server is finished.
ED 14.png
15. Now, you can optionally generate the default configurable options to allow placing orders tailored to your customers' needs.

We recommend viewing and modifying them to fit your provisioning capabilities. You can find them under 'Setup' → 'Products/Services' → 'Configurable Options'.
Note: You can also add your own configurable options which will be then displayed under 'Service Configuration' in your EasyDCIM backend.
Important: Any configurable option will overwrite its counterpart from the 'Module Settings'of a product.

ED 15.png
16. Additionally, you can set up a percentile billing for additional traffic.

Note: This option is possible only if you do not have Advanced Billing Form WHMCS module installed. If you need a bit more advanced billing integration, please go here for more information.
Go to the 'Other' tab and enable 'Overages Billing' . First, define the standard overages bandwidth billing and then set the following percentile values:

  • Soft Limit - bandwidth usage in Mbps above which the customer will be additionally charged for the used transfer
  • Cost - price per Mbps unit above the 'Soft Limit' value

E.g. If 'Soft Limit = 100' and 'Cost = 0.500' and the client exceeds the bandwidth by 10 Mbps, reaching to '110 Mbps' , they will be additionally charged with $5 USD (10 x 0.500).
Note: The percentile billing requires the standard billing of bandwidth overages to be enabled. It will be also calculated during the execution of the WHMCS system cron.

ED 15 1.png

Custom Fields

Once the configuration of the module settings has been completed, the following custom fields will be created automatically.
Note: These fields will not be visible to clients by default.
  • OrderID - the number used to link the product with EasyDCIM order number
  • ServerID - the number used to link the product with EasyDCIM server ID
  • bandwidthUsageFromRegistrationDate - if set to 'on' , the billing cycle for transfer usage will be billed monthly, starting from the date of product registration (e.g. from the 15th to the 15th of the following month).
    Otherwise, usage charges will be calculated on the last day of each month as in default WHMCS cycle.
  • percentileUsage - the entire current usage. If the value specified previously in the percentile configuration is exceeded, the additional charge will be calculated accordingly.
ED 15 2.png

Management

In this section we will show you all possibilities of EasyDCIM Dedicated Servers For WHMCS.

Our module allows you to offer and manage EasyDCIM servers right in your WHMCS system.

Admin Area

As soon as you set up a server for a client, you can request various actions and view server details from the WHMCS admin area.
The 'Log In To Panel' button allows you to immediately log in to the client's EasyDCIM control panel.
The 'Change Password' action alters the SSH access details to the client's server while 'Update Order Information' allows you to manually check if a server matching the one specified in the order has been found and assigned.

ED 16.png
Our module allows you to boot/reboot/shutdown server as well as view its details.
ED 17.png
Below the mentioned functions, there are various usage graphs and statistics available at your disposal.

Note: By default, there are 5 types of statistics displayed. If you need more, you can add them though the configuration.json file located in /yourWHMCS/modules/servers/EasyDCIM/Config.

ED 18.png

Client Area

In the client area your customers can view all details concerning their servers, manage their status remotely as well as log in to their EasyDCIM control panel with a single click.
ED 19.png
Additionally, they can explore several usage graphs.
ED 20.png
As well as view information about the traffic billing.

Note: Available time intervals depend on the date of the product registration.

ED 21.png
And also reinstall OS on their server.
ED 22.png
Moreover, it is possible for your clients to control their reverse DNS. They can either edit the already existing records or create new ones.
ED 23.png
To create a record, all your clients need to do is fill in the necessary information.
ED 24.png
The newly created record will appear on the list.
ED 25.png
If your clients are using Dell or SuperMicro servers, they can also access the KVM console.
ED 26.png
It will launch a Java applet that will automatically connect to your client's server.

Note: The browser needs to have Java enabled with the correct permissions to make the console functioning.

ED 27.png

Advanced Billing Integration

EasyDCIM Colocation For WHMCS supports integration with the Advanced Billing For WHMCS module.
This allows you to charge your customers for total bandwidth and 95th percentile billing for additional traffic.

Note: We suggest to run the cron only once per hour (with the interval of 3600 seconds).
This is due to the fact that while generating an invoice, only the last billed record is taken into account, so there is no need to collect data more often.

ED 28.png
Once the relevant options are enabled, your clients will also be able to view billing for the current usage in your client area.
ED 39.png

Tips

1. Note that placing two identical orders may result in assigning servers with slightly different parameters.

It stems from the way EasyDCIM server matching works. It matches a server basing on the resources and models mentioned in the order, without considering other resources.
While it attempts to find a server matching the order completely, in case it fails, server that fulfills more requirements than others will be assigned.
More information about server provisioning flow can be found on EasyDCIM documentation page.

2. As this server supports the templates system, any changes made in the server's templates files will be saved after the upgrade process.
3. Since the 1.3.0 version, the 'monthlyTrafficLimit|Monthly Traffic Limit' configurable option has been changed to 'Bandwidth|Bandwidth' .
Remember to change it manually after updating the module.
4. In '/yourWHMCS/modules/servers/EasyDCIM/Config' location you can find 3 additional config files:

- configuration.json - where you can set created user role ('2' by default) as well as add and manage graphs diplayed in client and admin area
- emailTemplates.json - where you can edit email templates that are automatiacally created after first run of EasyDCIM module
- hooks.json - where you can activate/deactivate hooks used by the module or add your own

Update Instructions

Essential guidance through the process of updating the module is offered here.

Common Problems

1. When you have problems with connection, check whether your SELinux or firewall does not block ports.
Retrieved from "https://www.docs.modulesgarden.com/index.php?title=EasyDCIM_Dedicated_Servers_For_WHMCS&oldid=38381"
Navigation
WHMCS Modules
WHMCS Widgets
Tools And Applications
Translations
cPanel Modules
General
FAQ
Community
EasyDCIM Dedicated Servers For WHMCS