Hosting Modules

From AWBS Wiki
Revision as of 21:46, March 30, 2009 by Samdrams (Talk | contribs)

Jump to: navigation, search

Table of Contents

  1. Hosting Configuration - Read First!
  2. cPanel Module
  3. cPanel with WHMSonic Module
  4. DirectAdmin Module
  5. DotNetPanel Module
  6. eNom Hosting Module
  7. Ensim Module
  8. Helm Module
  9. Hostopia Module
  10. HyperVM Module
  11. Interworx Module
  12. ISP Manager Module
  13. LxAdmin Module
  14. Plesk Module
  15. TCAdmin Module
  16. Teamspeak Module
  17. VDS Manager Module
  18. VirtualMin Module
  19. Zervex Module
  20. Alternate Order Wizard
  21. Sub Domain Hosting
  22. Load Balancing

Hosting Configuration - Read First!

In the AWBS Configuration, Module Setup page, make sure you have enabled all hosting control panels that you will use/configure.

In the AWBS Configuration, System Options page, set all preferences as desired for your company.

>>Do the following in order to setup the structure for your hosting configuration properly.<<

  1. Setup server groups. (Screenshot)
    Use the server groups to form load balancing groups and/or categories. Example: put all cpanel servers in group1 and all helm servers in group2.
    Note: You must have at least one server group.
  2. Setup your server(s). Add all hosting servers you will be setting up client hosting on. Select the correct server group. Refer to the specific control panel configuration pages for detailed help for your server type.
  3. Go back to server groups and select a default server for each group and save. Save the record even if the correct group shows up.
  4. Setup hosting package types. These types will categorize your hosting plans in groups to be displayed together on a web page for ordering. Create a hosting package type for each web display page you want on your site.
    Hint: Once you have setup a type, you can click to edit and you will find a link to use on your menu for that type's display page.
  5. Setup your hosting plans in the hosting plan setup page. Refer to the hosting control panel specific configuration pages for detailed help for setting up your plans correctly.


  • Place a test order for hosting using your test user account (create an account for testing if you did not already).
  • Log back in as admin, go to the job queue. Your new order should be in the open job queue if you have 'Process all hosting orders immediately' set to True in the System Options area. The new order will show up in the pending queue if you have 'Process all hosting orders immediately' set to False in the System Options.
  • Click the run link to the left of the new order in the job queue to manually process the order. A popup window will open and display the progress of the communication to the hosting server. If all is configured properly, the hosting account will be created on the hosting server and the user account will receive an email notifying them their hosting account is active and give them login details as per the email template you have assigned to the hosting plan in the hosting plan configuration page.

If there are any errors, you can click to edit the job and check the 'return' field for any errors reported by the hosting server's API. To get more information for troubleshooting, you can place the job queue in debug mode by clicking the debug mode link at the top of the job queue, then run the job again. Details of the communication will appear in the popup window when the job runs in debug mode. It is recommended to leave debug mode set to off unless you need to troubleshoot a problem/error.

Alternate Order Wizard

(Note: Alternate Order Wizard feature available version 2.8.0 and newer)

The alternate order wizard can be enabled for either hosting or dedicated server ordering (not both).

The alternate order wizard uses the AWBS API, to use it you'll need to add your server's main IP to the Extended System Configuration, remote_list setting.
(If you see 'Domain not available' for all domain searches, you have not configured the API for access)

Enable the alternate order wizard on a per package basis by editing each hosting package you want to use the alternate order wizard and set the Use Alternate Order Wizard setting to True and save.

Enable the alternate order wizard on a per type basis by editing the hosting package type and set Use Alternate Order Wizard to True and save.

Menu links are available both in the hosting package type setup page and hosting package setup pages to use on your website or menu as desired.

There are 3 settings in the order.php engine file.

$carton = "0"; // 0 - send customers right to the payment page (skip the cart), 1 - send orders to the cart
$apiurl = ""; //(no trailing slash) if blank will use this url (complete if using a different url than your AWBS site)
$emptycart = "1"; //Empty the cart prior to adding the new package? This will remove all items from the cart

Note: The order.php engine file, template and includes are all open source, edit as desired!

Sub Domain Hosting


Load Balancing

Load balancing is used to have hosting accounts provisioned equally among a group of servers.

To activate load balancing for any server group, check the box that says: Activate Load Balancing in the Configuration >> Server Groups >> [desired server group] setup page.

AWBS will take new orders and check for the server in that group with the least number of accounts on it and provision to that server.

Notes: Control panel types that support over bandwidth billing will pull the account numbers from the server stats data pulled from the servers. Control panel types that do not support the server stats data gathering will pull the account numbers from AWBS's hosting manager.

Alternate use of the Load Balancing system

This will provision accounts based on user selection of server location (datacenter).

1) Assign all servers to the proper server location (Create locations as needed and note the ID for use below) Configuration >> Server Locations

2) Custom Field Management (Add new) - Name: serverlocation - Type: Pulldown - Text Display: Datacenter Choice

- Default Value: |9999:No Preference|1:Sarasota DC|2:Tampa DC|3:Cairo DC|4:Artic Circle DC| These are your server locations as set in AWBS. You will need your servers in your server groups correctly assigned to locations.

The format is: |location id number from AWBS:Name shown to customer|

- Response Required - Visible When Ordering