Category:Resellers

From DarkStar Ventrilo and Game Server Wiki

Jump to: navigation, search

Contents

Overview

DarkStar Reseller Control Panel
DarkStar Reseller Control Panel
DarkStar Reseller Control Panel
The DarkStar Reseller's System is available to anyone wishing to sell Ventrilo -- both individuals and businesses. Our system allows for any individual to quickly and easily manage a full-scale Ventrilo hosting company, and instantly deploy servers in up to 23 unique locations. Our reseller packages start at only $75 per month and come with the following feature breakdown:
  • Instantly Deploy Ventrilo servers globally through our built-in API.
  • Dedicated IP's in 20+ Locations and 11 Countries
  • Use our state-of-the-art AJAX-driven, fully brandable web control panel.
  • Take advantage of the DarkStar RCS total ClientExec or ModernBill integration!
  • Access our XML-based Ventrilo API for custom functionality.
  • At any time, instantly upgrade or downgrade slots.
  • All codecs are enabled for use, with custom hostnames for your users.
  • Same-day Reseller Account Setup, No Long-Term Commitments!


How do I sign up?

To sign up for a DarkStar reseller account, please visit https://www.darkstarllc.com/order. More information on our reseller program can be found at http://www.darkstarllc.com/services/ventrilo-servers/reseller-accounts.php.

Pricing 

300 Users - $75/month		2500 Users - $550/month
450 Users - $112/month		3000 Users - $630/month
600 Users - $150/month		3500 Users - $735/month
800 Users - $200/month		4000 Users - $840/month
1000 Users - $230/month	5000 Users - $950/month
1250 Users - $288/month	6000 Users - $1,140/month
1500 Users - $345/month	7000 Users - $1,330/month
1750 Users - $403/month	8000 Users - $1,520/month
2000 Users - $460/month	9000 Users - $1,710/month
2250 Users - $518/month	10000 Users - $1,900/month


Finding Your Reseller Credentials

After order and payment, so long as you entered a domain for your control panel, you will receive a welcome e-mail detailing your API credentials. If you did not receive this e-mail, you may log into https://my.darkstarllc.com, click View Welcome E-mails, and it should be in the list. Furthermore, your API login credentials are also visible on the account information screen of http://rcs.darkstarllc.com/.


Installing

After order, one of our reseller specialists will setup your account. Please note that while we offer same day Reseller setup, that sometimes certain locations may take time to deploy IP Address space from, due to RIPE, ARIN, LANIC, or APNIC numbering and justification requirements. Once your account is setup, your web control panel will be deployed on our network, at an address of your choice. We recommend using a subdomain from the web site you are selling on, such as ventrilo.yourdomain.com. Our web control panel software cannot be installed on your system -- it must be installed and setup on ours for a number of reasons, including security and ease-of-updates. Once your web control panel is installed, we will provide you with your API information that allows you to custom code your own software to manage your Ventrilo servers. This is not a requirement, as our control panel is fully functional and can be branded, but is there as an extra for those who feel they need to code their own unique implementation.


Plugging into ModernBill or ClientExec

DarkStar has developed two custom-tailored plugins for both ModernBill (v4.4.x) and ClientExec (v3.x). These plugins will work out of the box, on any server that has ClientExec or ModernBill installed. The only other requirement is that you enable a user@208.100.17.* to connect to your billing MySQL database -- otherwise login sharing will not function for your control panel (meaning, your users won't be able to login). These plugins are both easily installable and configurable directly inside of ModernBill and ClientExec.


Installing our ModernBill v4.4.x Plugin

To install your ModernBill plugin, perform the following:

  • Download the plugin from http://rcs.darkstarllc.com/plugins.php.
  • Login to your ModernBill installation, and go to the System Configurations area (Tools -> System Config).
  • Click on Server Modules, and then click Edit besides "(mod_ventrilo)."
  • Leave the Server Name blank, and enter "http://api.darkstarllc.com/api.php" (without quotes) for the DarkStar API URL.
  • Enter your Remote ID (provided to you).
  • Enter your Remote Access Key (provided to you).
  • Enter your Reseller ID # (provided to you).
  • Ensure Enable DarkStar Module is set to Yes.
  • Ensure "Current Accounts" is set to 0.
  • Ensure Maximum Accounts is set to *.
  • Ensure Server Group is assigned to Group 1, Default Server Group.
  • Ensure Server Fill Order is set to 1.
  • Create your packages (however you want) under Group 1.
  • Go to System Configs -> Package Settings -> Package Setup -> Order Group 1
  • Click on a package to begin assigning the plugin to it.
  • Under package features, click Add. The "Type" should be "Config" and the "Name" should be "server_module" and the "Value" should be "mod_ventrilo"
  • Add another one. Type should be "Config" "Name" -> "server_group" and the "Value" should be "1".
  • Add another one. Type should be "Config" "Name" -> "ventrilo_slots" and the "Value" should be the number of slots appropriate to this package.
  • For Package Addons, click add. Add-on Title should be Location, Enabled set to Yes, Can Upgrade set to No, Add-on Group Type set to Other, Order Group set to 1, and Display Order set to 0. Internal server value for server api is to be set to ventrilo_location_id. It needs to be a select list (click Build Select List), and add the following locations that you see in the screenshot below (the one that says Location Select List). After you are done, ensure you hit Save, and then Submit.
  • For each package, you will need to ensure that they are configured as above.
  • Ensure your API Queue is setup to be run on CRON (Check the ModernBill manual), configure your Welcome E-mails, Signup E-mails, and you are all set!


WHMCS v3.6+ Plugin

To install the plugin:

1. Upload the ventrilo folder into modules/servers directory on your WHMCS FTP (use http://rcs.darkstarllc.com/downloads/WHMCS_Ventrilo_Plugin_v1.0.zip).

2. Configure the module inside of WHMCS and add a new server for it (you can leave the information pretty much blank -- it's just a container and doesn't really hold any information that's valuable).

3. You'll need to edit config.client.php on your modules/servers/ventrilo FTP directory -- and setup the variables there. The API information you need is provided to you in your Reseller welcome information e-mail.

4. Finalize your Product/Service setup. You must create only one package for ventrilo servers. Slots will be an "Option" that they select after selecting to order a Ventrilo server.

5. Once that's setup, you'll need to add two custom fields to the product/service you just created.

  • Server Address (not on order form, not required). Name it EXACTLY like that. Type is text box.
  • Data Center (on order form, required). Drop Down. Value -> 3|Chicago,4|Dallas,6|New York,14|Atlanta,8|Los Angeles,12|Seattle,16|Montreal,11|Toronto,7|London,26|Brasil,17|Germany,20|Amsterdam,21|Denmark,10|Tampa,15|Virginia,18|France,19|Ireland,22|Singapore,23|Hong Kong,25|Israel

6. You'll need to now add Configuration Options called "Slots" -- you can configure this however you want. Just make sure the value for each is a number, and does not contain letters.

7. Test your system -- create a new order, and use WHMCS to "Create" the account. Ensure it's successful, and that your server shows up in the reseller control panel system. You'll need to also of course configure your welcome e-mail inside of WHMCS.


WHMCS v4.x Plugin

To install the plugin:

1. Upload the ventrilo folder into modules/servers directory on your WHMCS FTP (use http://rcs.darkstarllc.com/downloads/WHMCS_Ventrilo_Plugin_v2.0.zip).

2. Configure the module inside of WHMCS and add a new server for it (you can leave the information pretty much blank -- it's just a container and doesn't really hold any information that's valuable).

3.

  • You'll need to edit config.client.php on your modules/servers/ventrilo FTP directory -- and setup the variables there. The API information you need is provided to you in your Reseller welcome information e-mail.
  • If you're using a different Configuration Option Variable Name other than "Slots" -- you will need to specify it in this file for configoptions_VOICE_SLOTS_VARIABLE_NAME.
  • If you're using a different Custom Field Variable Name other than "Data Center" -- you will need to specify it in this file for customfields_DATA_CENTER_VARIABLE_NAME.

4. Finalize your Product/Service setup. You must create only one package for ventrilo servers. Slots will be an "Option" that they select after selecting to order a Ventrilo server.

  • Go to Setup -> Products/Services.
  • Click Create New Product Group.
  • Type "Ventrilo Servers" (or something similar).
  • Click Create New Product.
  • Under Details, choose Product Type: Other
  • Product Group: Ventrilo Servers (or what you entered above).
  • Enter the product details.
  • Welcome E-mail: Other Product/Service Welcome E-mail (or another you created).
  • Under Pricing Tab... ensure Payment Type is Recurring. Price should be $0.01 monthly, $0.01 quarterly, $0.01 semi-annually, $0.01 annual, $0.01 bi-annual.
  • Under Module Settings Tab ... choose Module Name: Ventrilo. Default Install Server is Use System Default If Applicable. Choose 'Automatically setup the product as soon as the first payment is received.' Save changes.
  • Under Custom Fields Tab ... You need to add the following custom field. Field Name -> Data Center, Field Type: Drop Down, Field Options: (enter exactly as shown without quotes or ending period): "3|Chicago,4|Dallas,6|New York,14|Atlanta,8|Los Angeles,12|Seattle,16|Montreal,11|Toronto,7|London,26|Brasil,17|Germany,20|Amsterdam,21|Denmark,10|Tampa,15|Virginia,18|France,19|Ireland,22|Singapore,23|Hong Kong,25|Israel,30|Norway,31|Sweden,32|Poland." Check the "Show on Order Form" box. Check the "Required Field" box. Click Save Settings.
  • Under Custom Fields Tab ... You need to add the following custom field. Field Name -> Server Address, Field Type: Text Box. Click Save Settings.
  • Under the left navigation menu under "Products/Services" (left hand portion of the screen), click "Conigurable Options." Once loaded, click "Create A New Group." Type in the group name as "Slots" and enter a description. Click the "Ventrilo Servers - Ventrilo Server" Assigned Product in the list (or whichever you are assigning it to). Once added, click the "Add New Configurable Option" button. For Option Name, enter "Slots" and Option Type: Dropdown. In the "Add Option" text box, enter "10 Slots" (or your first amount you want listed) and hit Save Changes. You can then adjust the pricing for this particular option, and adjust the ordering of display. To add a new slot option, simply enter data into the "Add Option" and hit Save Changes to add the new slot option. When done, choose Save Changes, and close the Window. Choose Save Changes. Click Products/Services to go back to your Product.

7. Test your system -- create a new order, and use WHMCS to "Create" the account. Ensure it's successful, and that your server shows up in the reseller control panel system. You'll need to also of course configure your welcome e-mail inside of WHMCS.

ClientExec v3.x Plugin

To install the plugin:

1. Upload the ventrilo folder to your Client Exec plugins/server directory.

2. Alter functions.inc.php and configure your Welcome E-mail. Please be warry of white space after EOF; and <<<EOF -- any white space after that text will break the plugin.

3. Alter config.ventrilo.php and adjust your location data. You will need to reference the location id numbers in your RCS Web control panel's Account Information section.

4. Login to Client Exec, and go to Admin -> Servers. Fill in the necessary Plugin Configuration data, including the following:

  • Plugin: Ventrilo
  • Domains quota: (empty)
  • Remote Id (provided)
  • Remote Access Key (provided)
  • Reseller Id (provided)
  • Server IP Custom Field -> Ventrilo IP
  • Server Port Custom Field -> Ventrilo Port
  • Server Admin Password Custom Field -> Admin Password

5. Modify available plugin events, and check:

  • Create, Delete, Suspend, Unsuspend.

6. Modify General Properties

  • Server Name: Ventrilo Control
  • Host Name: yourwebcp.yourdomain.com (no HTTP, no /).
  • Shared IP: (Enter your control panel ip).
  • Stats URL: (Leave empty).
  • Viewable by Customers: (Unchecked)

7. Name Servers

  • (Leave both blank).

8. Server IP Management

  • (Leave everything blank).

9. Setup Custom User Fields.

  • Go to System Setup -> Custom User Fields
  • Under Select Custom Field Type, choose Package Fields from the drop down listing.

10. Add "Admin Password" Custom Field.

  • Under Add New Domain Field, enter "Admin Password" and hit Add New Field.
  • Check Is Required, and Show in Sign up. Size is 20. Then hit Update.

11. Add "Ventrilo IP" Custom Field.

  • Under Add New Domain Field, enter "Ventrilo IP" and hit Add New Field.
  • Leave all items unchecked, size 20. Then hit update.

12. Add "Ventrilo Port" Custom Field.

  • Under Add New Domain Field, enter "Ventrilo Port" and hit Add New Field.
  • Leave all items unchecked, size 20. Then hit update.

13. Configure Location as Package Addon.

  • Under System Setup -> Package Mgmt, configure the following.
  • Select the package under the list at the bottom that you want to modify.
  • Under Package Addons, click the Add New button.
  • Name -> Location.
  • Plugin variable -> Custom variable. Custom plugin variable name: Location.
  • For each location, fill in a row detail below. Enter 0.00 (or desired price for each).
  • For each location, Price Detail -> Chicago (or location name)
  • For each location, Plugin var value -> Chicago (or location name).
  • After filling in one location completely, hit New Row, and when finished, Save Changes.


ModernBill v5.x Plugin

At this time we have no plans on supporting version 5 of ModernBill. Due to the pricing structure of ModernBill 5, we encourage our customers to use ClientExec instead -- it offers a feature set that, while not comparable to ModernBill 5, should work just fine for our resellers, and the plugin is supported. If we come across a reseller using version 5 of ModernBill, we will definitely write a plugin for it.


Branding Your Web Panel

All DarkStar Reseller panels are required to be installed on our servers unless permission is granted. The system is automatically installed once a valid host name is entered into our systems (which should have been done on the order form). To brand your web panel, you can login to our panel server with the following information:

  • FTP Address: <yourpanelurl>
  • FTP Username: ftp@<yourpanelurl>
  • FTP Password: <your billing password>

You can edit the following files to brand your panel:

  • /libraries/init.php
  • /libraries/login.php
  • /css/*
  • /images/*


Allowing your customers to access your control panel

All control panels have the ability out-of-the-box to support your customers with Standard Authentication. Our Standard Authentication mode is simple -- and does not integrate into any billing system. You simply enter an e-mail address, and password -- into the "MetaData" section of your server in the Reseller Control System (RCS). When you list your servers in RCS, you'll see each one has a drop down of actions. The MetaData option is in that drop down. Simply select it, make your changes, and presto -- you have a usable login for your customer.


Common errors on login sharing with WHMCS

  • What do I do if I receive a "Host '69.147.234.178' is not allowed to connect to this MySQL server" message? 
Ensure your mysql server accepts connections from us. If you have trouble, contact your web host.

This category currently contains no pages or media.

Retrieved from "http://wiki.darkstarllc.com/index.php/Category:Resellers"
Personal tools