LiveZilla Live Chat Software
RCM - Resellerclub Mods

Howto install R.D.H.Server Module V3

RDHSM - Resellerclub Dedicated Hosting Server Module
Release Date
Latest Version
20.10.2016
3.12.0

 

Would you like to have it installed by us? - Order installation service for this module here

Document Version: 1.6 - 31-05-2016

Step 1

Resellerclub Mods Management Core Console (Addon)

 

All our products requires the Resellerclub Mods Management Core Console Addon. Download the Addon from the product license details page TAB "Download" and install first this Addon.

If already installed, make sure you run version v1.4.0 or greater.

Visit the install instructions for the ResellerClub Mods Management Core Console Addon if you havent the Addon installed/updated. Once installed/updated and configured your reseller credentials as well as the product license, go ahead with the Module Installation in STEP 2.

Step 2

Upload files and folders

 

Download RDHSM - ResellerClub Dedicated Hosting Server Module from the product license details page TAB "Download". Unzip the file with your prefered decompresion software. Please read carefully all the steps in this document. You should not skip any steps provided.

The following instruction explains where you have to upload folder and files:

  1. Server Module
    Upload the folder "modules" into your whmcsroot/ folder

You are now ready for setup your first Dedicated Server Product!

Step 3

Email Template Setup

 

A standard default welcome email named as "RDHSM - Server Welcome Email" will be automatically installed in Setup » Email Templates once you configure your first Dedicated Server Product.

Setup a Dedicated Server Product in WHMCS

 

The following instruction explains how you have to setup a product in WHMCS. Most of users are yet familiar with this step. However, we strongly recommend to follow each of the steps provided below to assure correct setup. All steps are examples and based on the DS 1 Server Product:

Product Group setup

 

  1. You should create a new global product group for all your Dedicated Server Plans if you do not have any yet created. Goto Setup » Products/Services and click "Create a New Group". Set a Product Group Name, for example "Dedicated Servers" and click the button "Create Group".

    Product Group setup

Server Product Setup

 

  1. Goto Setup » Products/Services, click "Create a New Product", select product type "Dedicated / VPS Server" and select the group you just created in the above step. Name the product, for example "DS 1" and then click "Continue".

    Server Product setup


  2. You are now on the "Edit Product" page. Clic the TAB "Module Settings" and select the Module Name called "Rcmoddhserver". This will load the module configuration:

    Module Settings Dedicated Server Product setup

    Before anything else, select first the LogicBoxes Registrar you have previously configured in the Resellerclub Mods Console Addon (TAB Step 1) and then click the button "Save Changes".

    Select LogicBoxes Registrar


    Now you should see that the module has found "your reseller account credentials" and the API connection has been established successfully. If the API connection has been successfully established, then proceed with the configuration steps below to setup the module for this product, otherwise check your Reseller Account settings in Addons » "ResellerClub Mods Console":

    Dedicated Server Module Settings


  3. Select the "Dedicated Server Plan" from the dropdown menu the module has detect in your LogicBoxes Products account. In this example we use the hosting plan "DS1|105"

  4. Set if you like, other colors for the messages or just leave blank to use the standard values.

  5. The Dashboard check box allows "deactivating" the Management Dashboard in the Client Area. If you do not want allow Customers to manage the Service, then you can activate the checkbox and the Dashboard will not be displayed.

  6. Dashboard Style: Accordingly to your WHMCS design, you can select the apropiate built-in Dashboard design. If you use a custom theme and any of the provided built-in style does not match your theme, then you may have a look at TAB "EXPERT" to learn how you can create easly your own Dashboard design to fit your custom theme.
    • Dashboard Style default for WHMCS template style "default"
    • Dashboard Style five for WHMCS template style "five"
    • Dashboard Style six for WHMCS template style "six"
    • Dashboard Style classic for WHMCS template style "classic"
    • Dashboard Style portal for WHMCS template style "portal"

  7. Select "Automatically setup the product as soon as the first payment is received". This adds an Order immediately into your LogicBoxes account when a customer pays the invoice and if you have sufficient funds available. This is the recommended setup for full automated provisioning and renewals.

  8. Click now the "Details" tab from where you can see the Product Type, Product Group and the Product Name. Create a product description for the Dedicated Server Plan, select the "RDHSM - Server Welcome Email" from the "Welcome Email Dropdownlist" and activate the option "Require Domain". All other options as per your needs:

    Details Server Product setup


  9. Click now the "Upgrade" tab and tick the checkbox "Configurable Options " but do not select any of products from the Packages Upgrade menu:

    Activate Server Module


  10. Under the "Pricing" tab select Payment type "Recurring" and setup your selling prices for Monthly, Quarterly, Semi-Annually and Annually. For the Biennially and Triennially slabs set the value to -1.00 which means "not available and not supported" or simply untick the check boxes.

    NOTE: Make sure you have activated all the pricing/billing slabs for the product in your reseller account!

    TIP! You only need to set the selling prices for the default currency. All other currencies can be updated automatically using the whmcs built-in function "Update Product Prices" from Setup » Payment » Currencies:

    Pricing Server Product setup


  11. Finally click the "Save Changes" and "Back to Product List" button from where you will see the created product:

    Server Product Overview

Repeat the "Server Product Setup" Steps above for all other Dedicated Server Plans you would like to sell.

TIP! Use the "Duplicate Product" option and simply adjust the duplicated product details, selling prices and select the appropriate product plan from the dropdownlist "Hosting Plan".

When finished with the "Server Product Setup", proceed to the "Configurable Options" from STEP 4 in this document.

Step 4

Configurable Options

 

The next step is setting up configurable options to sell additional IP's and Addons such as cPanel, SAN Storage and WHMCS Licence for all your Dedicated Server Plan's. This setup is mandatory and you need to setup the configurable options even if you would not offer to sell these Addons. However, you can use the hide option to stop the selling of configurable options.

IMPORTANT: Please read all carefully and follow exactly the given setup steps.

Setup Additional Server IPs

 

TIP! If you have our R.V.P.Server Module and/or R.R.D.Hosting Module installed, then you can reuse the same configurable option for selling Additional IP's. You only need to edit and select the newly created Dedicated Server plans from the Menulist "Assigned Products". However, if you require more control over selling prices for each product, then you can create for each module a separate configurable option group for Additional IP's. In this case, be sure to name Group Name and Option Name different.

  1. Goto Setup » Configurable Options and click "Create a new Group"

    Configurable Options Group


  2. You will see in the menu field "Assigned Products (3)" the Server Plans you have created in the "PRODUCT SETUP" step. Insert a "Group name (1)", for example "Server IPs " and insert a "Description (2)", e.g. "Additional Server IPs (ResellerClub VPS and Dedicated Servers)"

  3. Select the Dedicated Server Plans you have created

    NOTE: Select all Dedicated Server Plans you are selling. Multiple selects by pushing Keyboard key "Ctrl". If you have our Module for VPS and/or Reseller Hosting installed, make sure you select also all VPS and Reseller Hosting plans since the same configurable option can be used for all products!


  4. Click the "Save Changes (4)" Button and hold on until you see the "Add new Configurable Option" Button with a new empty table as shown below:

    Manage Configurable Options for Additional IP's


  5. Click the button "Add New Configurable Option (5)". This opens a new window for setup the pricing and other options.

    Setup Configurable Options for Additional IP's


  6. Insert under "Option Name (6)" for example: Server IPs. From the "Option Type (7)" dropdown select "Quantity". Under "Add Option (8)" insert, for example Server IPs. Then Simply click the button "Save Changes (9)" and you will see the pricing tables below:

    TIP! You only need to set the selling prices for the default currency. All other currencies can be updated automatically using the whmcs built-in function "Update Product Prices" from Setup » Payment » Currencies:

    Pricings for Additional IP's


  7. Leave the field "Maximum Allowed (10)" blank for no limit. Setup your "Selling Prices (11)" according the billing cycle product setup, Monthly, Quarterly, Semi-Annually, Annually, Biennially and Triennially. Do not change the Order value. This must be set to 0

  8. Click the "Save Changes (12)" and then the "Close Window (13)" Button. This creates automatically a new entry in the table as shown below:

    Overview Configurable Options


  9. Click "Save Changes (14)" and then the "Back to Groups List (15)" Button.

Your Setup for selling Additional IP's for your Dedicated Server Plans has been finished. Proceed now with the configurable option setup for the WHMCS Addon.

Setup WHMCS Addon

 

TIP! If you have our R.V.P.Server Module installed, then you can reuse the same configurable option for selling the WHMCS addon. You only need to edit and select the newly created Dedicated Server plans from the Menulist "Assigned Products". However, if you want more control over selling prices for each product, then you can create for each module a separate configurable option group for the WHMCS addon. In this case, be sure to name Group Name and Option Name different.

  1. Goto Setup » Configurable Options and click "Create a new Group"

    Configurable Options Group


  2. You will see in the menu field "Assigned Products (3)" the Dedicated Server Plans you have created in the "PRODUCT SETUP" step. Insert a "Group name (1)", for example "WHMCS Addon" and insert a "Description (2)", e.g. "WHMCS License Addon (ResellerClub VPS and Dedicated Servers)"

  3. Select the Dedicated Server Plans you have created

    NOTE: Select all Dedicated Server Plans you are selling. Multiple selects by pushing Keyboard key "Ctrl". If you have our Module for VPS Server installed, make sure you select also all VPS Server plans since the same configurable option can be used for all products!


  4. Click the "Save Changes (4)" Button and hold on until you see the "Add new Configurable Option" Button with a new empty table as shown below:

    Manage Configurable Options for WHMCS Addon


  5. Click the button "Add New Configurable Option (5)". This opens a new window for setup the pricing and other options.

    Setup Configurable Options for WHMCS Addon


  6. Insert under "Option Name (6)" for example: WHMCS Addon. From the "Option Type (7)" dropdown select "Yes/No". Under "Add Option (8)" insert, for example WHMCS Addon. Then Simply click the button "Save Changes (9)" and you will see the pricing tables below:

    TIP! You only need to set the selling prices for the default currency. All other currencies can be updated automatically using the whmcs built-in function "Update Product Prices" from Setup » Payment » Currencies:

    Pricings for WHMCS Addon


  7. Setup your "Selling Prices (10)" according the billing cycle product setup, Monthly, Quarterly, Semi-Annually, Annually, Biennially and Triennially. Do not change the Order value. This must be set to 0

  8. Click the "Save Changes (11)" and then the "Close Window (12)" Button. This creates automatically a new entry in the table as shown below:

    Overview Configurable Options


  9. Click "Save Changes (13)" and then the "Back to Groups List (14)" Button.

Your Setup for selling WHMCS Licences with your Dedicated Server Plans has been finished. Proceed now with the configurable option setup for the Cpanel Addon.

Setup cPanel Addon

 

NOTE: cPanel/WHM Addon is only for "Unmanaged Dedicated Servers". The new Managed Dedicated Servers comes with the cPanel/WHM Addon automatically activated.

  1. Goto Setup » Configurable Options and click "Create a new Group"

    Configurable Options Group


  2. You will see in the menu field "Assigned Products (3)" the Dedicated Server Plans you have created in the "PRODUCT SETUP" step. Insert a "Group name (1)", for example "Cpanel/WHM Addon" and insert a "Description (2)", e.g. "Cpanel Addon (Resellerclub Dedicated Servers)"

  3. Select the Dedicated Server Plans you have created. Multiple selects by pushing Keyboard key "Ctrl"

  4. Click the "Save Changes (4)" Button and hold on until you see the "Add new Configurable Option" Button with a new empty table as shown below:

    Manage Configurable Options for Control Panel Addon


  5. Click the button "Add New Configurable Option (5)". This opens a new window for setup the pricing and other options.

    Setup Configurable Options for Control Panel Addon


  6. Insert under "Option Name (6)" for example: "Cpanel/WHM". From the "Option Type (7)" dropdown select "Yes/No". Under "Add Option (8)" insert for example "Cpanel/WHM". Order must be set to 1. Then Simply click the button "Save Changes (9)" and you will see the next step:

    TIP! You only need to set the selling prices for the default currency. All other currencies can be updated automatically using the whmcs built-in function "Update Product Prices" from Setup » Payment » Currencies:

    Pricings for Control Panel Addon


  7. Setup your "Selling Prices (10)" according the billing cycle product setup, Monthly, Quarterly, Semi-Annually and Annually. For the Biennially and Triennially slabs set the value to 0.00. Do not change the Order value. This must be set to 1

  8. Click the "Save Changes (11)" and then the "Close Window (12)" Button. This creates automatically a new entry in the table as shown below:

    Pricings for Control Panel Addon


  9. Click "Save Changes (13)" and then the "Back to Groups List (14)" Button.

Your Setup for selling the cPanel Addon with your Dedicated Server Plans has been finished. Proceed now with the configurable option setup for the SAN Storage Addons

Setup SAN Storage Addons

 

  1. Goto Setup » Configurable Options and click "Create a new Group"

    Pricings for SAN Storage Addon


  2. You will see in the menu field "Assigned Products (3)" the Dedicated Server Plans you have created in the "PRODUCT SETUP" step. Insert a "Group name (1)", for example "SAN Storage" and insert a "Description (2)", e.g. "Additional Webspace (Resellerclub Dedicated Servers)"

  3. Select the Dedicated Server Plans you have created. Multiple selects by pushing Keyboard key "Ctrl"

  4. Click the "Save Changes (4)" Button and hold on until you see the "Add new Configurable Option" Button with a new empty table as shown below:

    Configuration for SAN Storage Addon


  5. Click the button "Add New Configurable Option (5)". This opens a new window for setup the pricing and other options.

    Configuration for SAN Storage Addon


  6. Insert under "Option Name (6)" for example: "SAN Storage 50GB". From the "Option Type (7)" dropdown select "Quantity". Under "Add Option (8)" insert for example "SAN Storage 50GB". Order must be set to 1. Then Simply click the button "Save Changes (9)" and you will see the next step:

    TIP! You only need to set the selling prices for the default currency. All other currencies can be updated automatically using the whmcs built-in function "Update Product Prices" from Setup » Payment » Currencies:

    Pricing for SAN Storage Addon


  7. Setup your "Selling Prices (10)" according the billing cycle product setup, Monthly, Quarterly, Semi-Annually and Annually. For the Biennially and Triennially slabs set the value to 0.00. Do not change the Order value. This must be set to 1

  8. Click the "Save Changes (11)" and then the "Close Window (12)" Button. This creates automatically a new entry in the table as shown below:

    Overview for SAN Storage Addon


  9. You have now the first SAN Storage Addon successfully created!

  10. Click the "Add new Configurable Option Button (13)" and then repeat the Steps 5 to 8 to add the other SAN Storage Addons for 100GB, 200GB, 300GB and 500GB. When repeating the steps for all other SAN Storage Addons, simply set the corresponding "Option Name (6)" and "Add Option (8)", set your pricings and set the correct order number!


    VERY IMPORTANT!

    The Order for each Configurable option is mandatory:
    • SAN Storage 50GB = 1
    • SAN Storage 100GB = 2
    • SAN Storage 200GB = 3
    • SAN Storage 300GB = 4
    • SAN Storage 500GB = 5

  11. Finally and once finished the 5 Addons setup, you should see the following 5 table entries:

    Overview for SAN Storage Addon


  12. The Sort Order here does not matter. Here you can re-sort the addons if you whish. Click the "Save Changes (14)" and then the "Close Window (15)" Button.

Your Product Setup is completely done and you can start selling Dedicated Server Plans. Optionally, you may have a look at the tab's "TEMPLATE" and "EXPERT" to learn more about styling and customizing your own Dashboard.

Template

Dashboard Setup

 

There is no special setup needed for implementing the Dedicated Server Management Dashboard. It will be displayed based on the style settings and automatically if not deactivated in the Product Setup tab "Module Settings".

Dedicated Server Dashboard

If the Dashboard is not displayed on the client area details page for the product even if you haven't deactivated the same, then you have to check if the smarty variable {$moduleclientarea} is present in your customized clientareaproductdetails.tpl template file:

  1. Open the "clientareaproductdetails.tpl" from your active template folder.

  2. Check if you have the following code in your clientareaproductdetails.tpl:

    For WHMCS classic and portal template:

    <div align="center">{$moduleclientarea}</div>
    

    For WHMCS default based templates:

    {if $moduleclientarea}<div class="moduleoutput">{$moduleclientarea|replace:'modulebutton':'btn'}</div>{/if}
    

    if the above code is not present, then you need to insert it just above the statement "{if $username}"


  3. Upload your modfied files back into your whmcs active template folder.

Expert

Customizing Dashboard

 

The R.D.H.Server Module allows you to offer your own and fully customized Management Dashboard. The following smarty variables are available to build your own dashboard for your customized template design.

The following smarty variables are available:

  • {$domainid} = Domain ID (string)
  • {$rc_bandwidth} = Allocated bandwidth (string)
  • {$rc_space} = Disk space (string)
  • {$rc_space_type} = Disk type (string)
  • {$rc_space_raid} = RAID type (string)
  • {$rc_ram} = RAM Memory (string)
  • {$rc_ram_type} = RAM Type (string)
  • {$rc_cpu} = No of Cpu (string)
  • {$rc_cpu_speed} = Cpu speed (string)
  • {$rc_cpu_type} = Cpu type (string)
  • {$rc_rcplanname} = The Dedicated Server Plan name (string)
  • {$rc_osinfo} = Operating system (string)
  • {$rc_status} = The status of the Dedicated Server service: Active, Suspended, etc. (string)
  • {$rc_adminuser} = Root (string)
  • {$rc_adminpass} = Root Password (string)
  • {$rc_ips_array} = All IPs of the server (array)
  • {$rc_primaryip} = Server primary IP (string)
  • {$rc_defaultips} = Default assigned IPs, <br /> separated (string)
  • {$rc_dedicatedips} = Additional IPs, <br /> separated (string)
  • {$rc_serverpanelbutton} = Prestyled form button for Server Management Control Panel Auth login (string)
  • {$rc_panelservicename} = service-name for auth login (string)
  • {$rc_whmcslicense} = WHMCS License Key and buy url (string)
  • {$rc_cpanelbutton} = Prestyled form button for cPanel access (string)
  • {$rc_nocpanel} = link to buy cpanel addon (string)
  • {$rc_cpanelurl} = raw url to access cpanel (string)
  • {$rc_sanaddons} = SAN Storage Addon information and buy url (string)
  • {$rc_sanaddons_array} = SAN Storage Addon information (array)
  • {$rc_dhserverdetails_array} = The complete Dedicated Server Plan details (array)
  • {$buy_whmcsaddon} = WHMCS Addon Order link (string)
  • {$buy_ipsaddon} = Additional IP Addon Order link (string)
  • {$buy_paneladdon} = cPanel/WHM Addon Order link (string)
  • {$buy_sanaddon} = SAN Storage Addon Order link (string)
  • {$active_color} = Font Color for status message "Active" as HEX value (string)
  • {$suspend_color} = Font Color for status message "Suspended" as HEX value (string)
  • {$inactive_color} = Font Color for status message "InActive and Pending " as HEX value (string)
  • {$ns1} = The configured DNS Server name
  • {$ns2} = The configured DNS Server name
  • {$module} = Identifies the name of the module: rcmoddhserver

Howto Style your own Dashboard

 

  1. Create an empty file with your html editor or any text file editor such as notepad and add your customized html code. A valid Complete Code Example is available below.

  2. Save the file as clientarea.tpl and upload it into the /whmcsroot/modules/servers/rcmoddhserver/ folder

  3. Goto to the Products Setup TAB "Module Settings" and deactivate the Built-in Dashboard

Complete Code Example

 

{*
 * RCM Dedicated Server Management Dashboard Template
 *
 * @package		Resellerclub Mods (gIF)
 * @author		Resellerclub Mods contact[at]resellerclub-mods.com
 * @copyright	Copyright (c) resellerclub-mods.com 2011-2016
 * @license		http://www.resellerclub-mods.com/en/terms-of-service/eula.html
 * @link		http://www.resellerclub-mods.com/
 * @version		v3.11.1
 *}
 
<div align="center">
	<h2>{$LANG.rcdhs_managementtitle}</h2>
	{if $rc_status eq "Active"}
		<table cellpadding="5" cellspacing="5">
			<tr>
				<td><h4>{$LANG.rcdhs_statustitle}</h4></td>
				<td>
					<span style="color:{if $active_color}{$active_color}{else}#006600{/if};">{$rc_status}</span>
				</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcdhs_logindetails}</strong></td>
				<td>{$rc_adminuser} / {$rc_adminpass}</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcdhs_controlpanelstitle}</strong></td>
				<td><div style="float:left;padding:2px;">{$rc_serverpanelbutton}</div></td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcdhs_addoncopatitle}</strong></td>
				<td><div style="float:left;padding:2px;">{$rc_cpanelbutton}</div></td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcdhs_primaryiptitle}</strong></td>
				<td>{$rc_primaryip}</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcdhs_assignedipstitle}</strong></td>
				<td>{$rc_defaultips}</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcdhs_additionalipstitle}</strong></td>
				<td>{$rc_dedicatedips}</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcdhs_sanspacetitle}</strong></td>
				<td>{$rc_sanaddons}</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcdhs_addonwhmcstitle}</strong></td>
				<td>{$rc_whmcslicense}</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcdhs_serverostitle}</strong></td>
				<td>{$rc_osinfo}</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcdhs_webspacetitle}</strong></td>
				<td>{$LANG.rcdhs_raidtitle} {$rc_space_raid} {$rc_space_type} {$rc_space} {$LANG.rcdhs_megabytetitle}</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcdhs_bandwidthtitle}</strong></td>
				<td>{$rc_bandwidth} {$LANG.rcdhs_megabytetitle}</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcdhs_srvramtitle}</strong></td>
				<td>{$rc_ram_type} {$rc_ram} {$LANG.rcdhs_megabytetitle}</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcdhs_srvcputitle}</strong></td>
				<td>{$rc_cpu} x {$rc_cpu_speed} {$LANG.rcdhs_gigaherztitle} {$rc_cpu_type}</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcdhs_ns1title}</strong></td>
				<td>{$ns1}</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcdhs_ns2title}</strong></td>
				<td>{$ns2}</td>
			</tr>
		</table>
	{else}
		<table>
			<tr>
				<td><h4 style="width:30%">{$LANG.rcdhs_statustitle}</h4></td>
				<td>
					<span style="color:{if $inactive_color}{$inactive_color}{else}#FC7202{/if};">{$LANG.rcdhs_serverreparing}</span>
				</td>
			</tr>
		</table>
	{/if}
</div>

Latest Tweets

More Tweets from resmods

Latest News

Black Friday and Important News!

Black Friday is coming and will start tonight! Don't miss it and get the best possible discount on our complete Portfolio!
Read more...

About Us

Who we are, what we do and everything else about Resellerclub Mods, a gIF Business Project: