Personal tools
Namespaces

Variants
Actions

EasyDCIM Dedicated Servers For WHMCS

From ModulesGarden Wiki
Revision as of 11:29, 29 May 2017 by Peter (Talk | contribs)

Jump to: navigation, search

Contents

About EasyDCIM Dedicated Servers For WHMCS

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

Module will let your clients overview and manage their servers directly from your client area.
They will be able to for example reboot servers or view resource usage graphs.

  • 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 Accepting And Server Matching
✔ Define Required Devices
✔ Define Required Item Models:
✔ HDD Model
✔ SSD Model
✔ RAM Model
✔ CPU Model
✔ Define Client Area Features
✔ Control Service Access Level
✔ One Click Login To EasyDCIM:
✔ User Control Panel
✔ Admin Panel
✔ Toggle Debug Mode
  • Client Area Features:
✔ Boot/Reboot/Shutdown Server
✔ Change Server SSH Password
✔ View Server Details
✔ Reinstall Server OS Using OS Templates
✔ View Server Resource Usage Graphs
✔ View Traffic Statistics
✔ One Click Login To User Control Panel
  • General Info:
✔ Multi-Language Support
✔ Supports EasyDCIM v1.2.0 and Later
✔ Supports PHP 5.4 Up To PHP 7
✔ Supports WHMCS Templates Five and Six
✔ Supports WHMCS V6 and V7
  • Configurable Options:
✔ Server Model
✔ Server Location
✔ OS Template
✔ Monthly Traffic Limit
✔ Additional IP Addresses
✔ HDD Size
✔ SSD Size
✔ RAM Size
✔ CPU Cores

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 your client area and download the module.
ED 1.png
2. In the downloaded file you will find two packages that support different PHP versions.
As presented on the screen below, the first one is dedicated to PHP 7, while the second one is aimed at PHP 5.4 up to PHP 5.6.

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

ED 2.png
3. Extract the downloaded file and choose the one with the right PHP version. Upload and extract the PHP file into the main WHMCS directory.

The content of PHP version files should look like this.

ED 2 2.png

Configuration of Server

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

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

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

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

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

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

ED 5.png
7. It is time to create a server group, to do so click on 'Create Server Group'.
ED 6.png
8. Enter name, click on your previously created server, press 'Add' and afterwards 'Save Changes'.
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 product group name and press 'Save Changes'.
ED 9.png
11. When 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. Afterwards, choose your product group, enter your product name and then press 'Continue'.
ED 11.png
13. Now go to 'Module Settings' section, choose both 'EasyDCIM' and your previously created server group from dropdown menus.

Next, 'Save Changes'.

ED 12.png
14. Before configuring product, set up EasyDCIM cron job which can be found here.
ED 13.png
15. Module configuration is partially non-mandatory. The server will be assigned basing on the defined configuration and matching only the filled out options.

Default Options:

  • Model (required) - EasyDCIM server model
  • Location (required) - desired server location
  • OS Template - reinstall server with a chosen OS template before delivering it to client
  • Monthly Traffic Limit - bandwidth limit per server
  • Additional IP Addresses - number of additional IP addresses assigned to a server
  • HDD/SSD/RAM Size - required amount of memory in specific parts, note 1GB is equal to 1024 MB
  • CPU cores - number of CPU cores

Product Configuration

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

Items Model

  • Basically, define if a chosen part has to be of a specific model, for example match server using `Intel Xeon E3-1220 v5` CPU.

Client Area Features

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

Service Actions

  • Choose service actions to send email notifications instead of performing provisioning actions immediately. Leave the fields unchecked to perform WHMCS module commands in a default manner.
ED 14.png
15. Now, optionally you can generate default configurable options to allow orders tailored to your clients needs.

We recommend viewing and modifying them to fit your provisioning capabilities. You can find them under 'Setup' → 'Products/Services' → 'Configurable Options'.
Note: Any configurable option will overwrite its counterpart from product 'Module Settings'.

ED 15.png

Management

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

Our module allows you to offer EasyDCIM via 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 WHMCS admin area.
'Log In To Panel' button allows you to immediately log into client's EasyDCIM control panel.
'Change Password' action changes SSH access details to the client's server while 'Update Order Information' allows you to manually check if server matching 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 them, there are various usage graphs are available at your disposal.
ED 18.png

Client Area

In the client area of the module 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, below you can find numerous usage graphs.
ED 20.png
You can also view information about traffic billing.
ED 21.png
As well as reinstall OS on your server.
ED 22.png
Moreover, it is possible to control your reverse DNS. You can either edit the already existing records or create new ones.
ED 23.png
To create a record just fill in the necessary information.
ED 24.png
Your newly created record will appear on the list.
ED 25.png

Tips

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

It is the result of 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 fulfilling 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 templates system, any changes made in the server's templates files will be saved after the upgrade process.

Common Problems

1. When you have problems with connection, check whether your SELinux or firewall does not block ports.
Navigation
WHMCS Modules
WHMCS Widgets
Translations
cPanel Modules
General
FAQ
Community
EasyDCIM Dedicated Servers For WHMCS