Difference between revisions of "Kloxo Specific Configuration"

Revision as of 12:54, November 9, 2009

LXAdmin is now known as Kloxo and was released as opensource on Nov 3rd 2009. This document is good for both LXAdmin and Kloxo.

This document is written assuming you have Kloxo already installed. If you need assistance with this, please see the Kloxo Installation page

More information about Kloxo can be found on the Kloxo Webpage, and the Kloxo Forums

The Kloxo module requires OUTGOING port 7777(https) and/or port 7778(http) OPEN on the firewall of your AWBS Server.

Setup Server Group(s)

See Hosting Configuration page

Creating an API user in Kloxo

To create an API user in Kloxo first login to your Kloxo control panel as an Admin.

Then got the Configuration Menu, and select API Users.

Once the API User screen opens click Create API User.

You will be presented with the following fields:

• ID: Pd9ksH3sMN0TZNyCJFTx (This is auto-generated by Kloxo and cannot be changed)
• KEY: vHl1OTqEpaW5dVfwr8Q5 (This is auto-generated by Kloxo and cannot be changed)
• IP Address: Enter the OUTGOING IP Address of your AWBS Server
• Status: Set to Active

Once this is all configured click the Add API User button.

Setup the Kloxo 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 Kloxo 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: Kloxo
• Server IP: Enter the server's IP address
• Server URL: Enter the url to the server. Example: http://my.Kloxoserver.com
• Server CP: Enter the url given to customers to login to their Kloxo account control panel Example: http://my.Kloxoserver.com:5353
• Server Cost: Enter your cost for this server. Used for reports only.
• Default NS1: Enter your Kloxo nameserver 1 here
• Default NS2: Enter your Kloxo nameserver 2 here
• API ID: Enter the Kloxo API ID here. (See Creating an API user in Kloxo)
• API Key: Enter your Kloxo API Key here.
• Update hosting list IP(s): Check if you are changing an existing Kloxo 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 Kloxo (When logged into your Kloxo Control panel as Admin, under Plans)
• 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. (Not needed/used with Kloxo)
• 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 Kloxo to setup plans correctly:

• Template Name: Enter the OS Template name. This is the File name before the extension. For example if the OS Template filename is set to centos-5.0-x86.tar.gz in your Kloxo control panel, then the name you enter here is: centos-5.0-x86
• Node: Usually localhost unless running a multi-node Kloxo.
• Number of IPs: The number of IP Addresses you want initially assigned to this package.
• VPS Type (OpenVZ or Xen): Set the VPS Type. Currently only OpenVZ is supported by Kloxo.