Hosting Modules

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. 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.

TEST

• 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.

cPanel Specific Configuration

Setup Server Group(s)

See Hosting Configuration page

Setup the cPanel Server(s)

Go to Server Setup and click Add New. Enter information asked for in the New Server Wizard. When you have completed adding all cPanel servers, go back to the server groups page and assign the correct default server. (Save the groups even if they show the correct default server)

Below are some details for your assistance:

• Server Name: Enter a server name for your reference in AWBS. Do not use spaces.
• Server Group: Assign the server to the correct server group.
• Server Type: cPanel (or cPanel 11)
• Server IP: Enter the server's IP address
• Server URL: Enter the url to the server. Example: http://my.cpanelserver.com
• Server CP: Enter the url given to customers to login to their cPanel account control panel. Example: http://my.cpanelserver.com/cpanel
• Server Cost: Enter your cost for this server. Used for reports only.
• Default NS1: Enter your cPanel nameserver 1 here
• Default NS2: Enter your cPanel nameserver 2 here
• Server User: Enter the cPanel username here. (Reseller account username or root)
• Server Access Key: Paste the Server Access Key obtained in WHM when logged in as the user listed in the 'Server User' field. Do not paste the remarks at the top and bottom of the server access key.
• Update hosting list IP(s): Check if you are changing an existing cPanel server's IP address. This will update all existing hosting packages assigned to this server.
• Update hosting list Servers: Check if you are changing the server's servername. This will update all existing hosting packages assigned to this server.
• Delete Record: Only check this box if you are deleting this server. Caution: DO NOT delete a server that has plans and user packages assigned!

Configure your Hosting Package Types

• Configure types for hosting packages. Each type will display a web page for ordering. Use additional types to create multiple hosting order pages. Most people use the types to group their various hosting plan types, i.e. linux hosting type 1, windows hosting type 2.
• User Group: Should be Default unless you want this page only viewable by a different user group. (not the public)
• Server Group: Select the correct server group.
• Description: Enter what you want displayed as the title on the web page with this type of hosting
• Details1 Name - Details6 Name: Enter display text for the various specs for the plan type. This set of specs willl be used for all hosting plans in this type.

Hint: Once you have added and saved a Hosting Package Type, you can click to view/edit it again and see the correct link to use on your menu for this web page.

Configure your Hosting Plans

• Visible: Check if you want this plan to display on the web page.
• Default Plan: Check if this is the default plan for the type. Each type needs to have one default plan.
• Default Term: Enter the default term you want to display when your customers order. If you have other terms, they will get a selection to change it. Make sure the default term is a configured and available term for the plan.
• Upgrade Group: Set the upgrade group. All plans in this group number will show up as selections when the customer chooses to upgrade their plan. All plans in the same group should be in the same server group for the auto upgrade/downgrade to function properly.
• Package Name: Name the plan as you desire. Do not use any spaces.
• Package Type: Select the correct package type for this plan.
• Server Package: Enter the package name as it appears in WHM.
• Package Desc: Enter the plan description as you wish it to appear on the web page for ordering.
• Reset BW on all existing user hosting: Check if you want to reset all bandwidth stats stored in AWBS database for all existing active accounts on this plan.
• Reseller Plan: Check if this is a reseller plan.
• Pricing: Enter prices for all terms you want to offer. Leave the fields blank if you don't want to offer them. Enter 0.00 if you want to offer them for free.
• Check the Free Domain checkbox if you want to offer a free domain name with this plan/term. (Select available tlds for free domains in the system setup, TLD Setup/Pricing page by checking the Free Option checkbox beside the tld)
• Assign the correct Activation Email Template. Be sure to either add a new email template or edit the existing Hosting Activation email template as desired to give your customers all necessary information they need when their account is activated.
• Complete the Package Display Text section with the plan's specs.

DirectAdmin Specific Configuration

This document is written assuming you have the User Packages setup in DirectAdmin already. If you need assistance with this, plase see the DirectAdmin Reseller Manual

More information about DirectAdmin can be found in the DirectAdmin Admin Manual, DirectAdmin Knowledgebase, and the DirectAdmin Forums

The DirectAdmin module requires OUTGOING port 2222 OPEN on the firewall of your AWBS Server.

Setup Server Group(s)

See Hosting Configuration page

Setup the DirectAdmin Server(s)

Go to Server Setup and click Add New. Enter information asked for in the New Server Wizard. When you have completed adding all DirectAdmin servers, go back to the server groups page and assign the correct default server. (Save the groups even if they show the correct default server)

Below are some details for your assistance:

• Server Name: Enter a server name for your reference in AWBS. Do not use spaces.
• Server Group: Assign the server to the correct server group.
• Server Type: DirectAdmin
• Server IP: Enter the server's IP address
• Server URL: Enter the url to the server. Example: http://my.DirectAdminserver.com
• Server CP: Enter the url given to customers to login to their DirectAdmin account control panel Example: http://my.DirectAdminserver.com:2222
• Server Cost: Enter your cost for this server. Used for reports only.
• Default NS1: Enter your DirectAdmin nameserver 1 here
• Default NS2: Enter your DirectAdmin nameserver 2 here
• Server User: Enter the DirectAdmin username here. (Reseller account username or root)
• Server Password: Enter your DirectAdmin Password here.
• Update hosting list IP(s): Check if you are changing an existing DirectAdmin server's IP address. This will update all existing hosting packages assigned to this server.
• Update hosting list Servers: Check if you are changing the server's servername. This will update all existing hosting packages assigned to this server.
• Delete Record: Only check this box if you are deleting this server. Caution: DO NOT delete a server that has plans and user packages assigned!

Configure your Hosting Package Types

• Configure types for hosting packages. Each type will display a web page for ordering.
• Use additional types to create multiple hosting order pages. Most people use the types to group their various hosting plan types, i.e. linux hosting type 1, windows hosting type 2.
• User Group: Should be Default unless you want this page only viewable by a different user group. (not the public)
• Server Group: Select the correct server group.
• Description: Enter what you want displayed as the title on the web page with this type of hosting
• Details1 Name - Details6 Name: Enter display text for the various specs for the plan type. This set of specs willl be used for all hosting plans in this type.

Hint: Once you have added and saved a Hosting Package Type, you can click to view/edit it again and see the correct link to use on your menu for this web page.

Configure your Hosting Plans

• Visible: Check if you want this plan to display on the web page.
• Default Plan: Check if this is the default plan for the type. Each type needs to have one default plan.
• Default Term: Enter the default term you want to display when your customers order. If you have other terms, they will get a selection to change it. Make sure the default term is a configured and available term for the plan.
• Upgrade Group: Set the upgrade group. All plans in this group number will show up as selections when the customer chooses to upgrade their plan. All plans in the same group should be in the same server group for the auto upgrade/downgrade to function properly.
• Package Name: Name the plan as you desire. Do not use any spaces.
• Package Type: Select the correct package type for this plan.
• Server Package: Enter the package name as it appears in your DirectAdmin (Under Reseller Level, Modify User Packages, Or Add Package if you need to create the matching DirectAdmin Package)
• Package Desc: Enter the plan description as you wish it to appear on the web page for ordering.
• Reset BW on all existing user hosting: Check if you want to reset all bandwidth stats stored in AWBS database for all existing active accounts on this plan.
• Reseller Plan: Check if this is a reseller plan.
• Pricing: Enter prices for all terms you want to offer. Leave the fields blank if you don't want to offer them. Enter 0.00 if you want to offer them for free.
• Check the Free Domain checkbox if you want to offer a free domain name with this plan/term. (Select available tlds for free domains in the system setup, TLD Setup/Pricing page by checking the Free Option checkbox beside the tld)
• Assign the correct Activation Email Template. Be sure to either add a new email template or edit the existing Hosting Activation email template as desired to give your customers all necessary information they need when their account is activated.
• Complete the Package Display Text section with the plan's specs.

HyperVM

This document is written assuming you have the Resource packages, and OsTemplates setup in your HyperVM.

More information about HyperVM can be found at the HyperVM FAQ Page or the LxLabs Support Forums.

The HyperVM module requires OUTGOING ports 8887 and 8888 OPEN on the firewall of your AWBS Server.

Setup Server Group(s)

See Hosting Configuration page

Setup the HyperVM Server(s)

Go to Server Setup and click Add New. Enter information asked for in the New Server Wizard. When you have completed adding all HyperVM servers, go back to the server groups page and assign the correct default server. (Save the groups even if they show the correct default server)

Below are some details for your assistance:

• Server Name: Enter a server name for your reference in AWBS. Do not use spaces.
• Server Group: Assign the server to the correct server group.
• Server Type: HyperVM
• Server IP: Enter the server's IP address
• Server URL: Enter the url to the server. Example: http://my.HyperVMserver.com
• Server CP: Enter the url given to customers to login to their HyperVM account control panel Example: http://my.HyperVMserver.com:8887
• Server Cost: Enter your cost for this server. Used for reports only.
• Default NS1: Enter your HyperVM nameserver 1 here
• Default NS2: Enter your HyperVM nameserver 2 here
• Server User: Enter the HyperVM username here. (Usually admin)
• Server Password: Enter your HyperVM Password here.
• Control Port: Enter your HyperVM Control Port (Usually 8887 or 8888 by default)
• Update hosting list IP(s): Check if you are changing an existing HyperVM server's IP address. This will update all existing hosting packages assigned to this server.
• Update hosting list Servers: Check if you are changing the server's servername. This will update all existing hosting packages assigned to this server.
• Delete Record: Only check this box if you are deleting this server. Caution: DO NOT delete a server that has plans and user packages assigned!

Hint: Once you have added and saved the server setup, you can click to view/edit it again and test the connection by using the [Query server for Package names by clicking here] link. It would be a good idea to print the popup window as it contains packnames, ostemplate name, and syncservers which you will need later for setting up your HyperVM Packages.

Configure your Hosting Package Types

• Configure types for hosting packages. Each type will display a web page for ordering. Use additional types to create multiple hosting order pages. Most people use the types to group their various hosting plan types, i.e. linux hosting type 1, windows hosting type 2.
• User Group: Should be Default unless you want this page only viewable by a different user group. (not the public)
• Server Group: Select the correct server group.
• Description: Enter what you want displayed as the title on the web page with this type of hosting
• Details1 Name - Details6 Name: Enter display text for the various specs for the plan type. This set of specs willl be used for all hosting plans in this type.

Hint: Once you have added and saved a Hosting Package Type, you can click to view/edit it again and see the correct link to use on your menu for this web page.

Configure your Hosting Plans

• Visible: Check if you want this plan to display on the web page.
• Default Plan: Check if this is the default plan for the type. Each type needs to have one default plan.
• Default Term: Enter the default term you want to display when your customers order. If you have other terms, they will get a selection to change it. Make sure the default term is a configured and available term for the plan.
• Upgrade Group: Set the upgrade group. All plans in this group number will show up as selections when the customer chooses to upgrade their plan. All plans in the same group should be in the same server group for the auto upgrade/downgrade to function properly.
• Package Name: Name the plan as you desire. Do not use any spaces.
• Package Type: Select the correct package type for this plan.
• Server Package: Enter the package name as it appears in your HyperVM (Use the Query server for Package names option under the HyperVM Server Setup section. You need to find the Package Real Name In the Resource Package Name Results that you want setup)
• Package Desc: Enter the plan description as you wish it to appear on the web page for ordering.
• Reset BW on all existing user hosting: Check if you want to reset all bandwidth stats stored in AWBS database for all existing active accounts on this plan.
• Reseller Plan: Check if this is a reseller plan.
• Pricing: Enter prices for all terms you want to offer. Leave the fields blank if you don't want to offer them. Enter 0.00 if you want to offer them for free.
• Check the Free Domain checkbox if you want to offer a free domain name with this plan/term. (Select available tlds for free domains in the system setup, TLD Setup/Pricing page by checking the Free Option checkbox beside the tld)
• Assign the correct Activation Email Template. Be sure to either add a new email template or edit the existing Hosting Activation email template as desired to give your customers all necessary information they need when their account is activated.
• Complete the Package Display Text section with the plan's specs.

Configuring Hosting Package Specifics

Edit/View the package(s) created in Configure your Hosting Plans

At the bottom of each page you should see Package Specifics (Needed by some Server CP's)

The following details will need to be entered for your VPS to setup correctly:

• Send VM Email (on or off): Turn this on if you want HyperVM to E-Mail the client
• Number of IPs: Number of IP's to assign to VPS
• OS Template: OsTemplate to use. Example: centos-5-i386-full (Can be found using Query server for Package names under the HyperVM Server Setup section.)
• Syncserver: The syncserver variable is the destination server where the VPS is to be created. It must be the exact name as in the Servers tab in the HyperVM web interface. So basically use localhost for the hardware node itself or a hostname or an IP for one of your HyperVM slave servers.
• Type (xen or openvz): Enter your VPS Type