Revision as of 19:04, 4 May 2018

Supported Features

In addition to the above, this module also supports the following non-standard functions: Start, Stop and Restart Stream

Centova Cast is an internet radio stream hosting control panel. To find out more about it, please refer to http://www.centova.com/pages/cast/

The guides below explain how to setup and utilise the Centova Cast integration with WHMCS.

Setting Up a CentovaCast Product

1. Login to WHMCS, go to Setup, and then click Manage Servers. Then, click Add New Server.
2. On the Add New Server page, fill out the following fields:

Name - Set this to the hostname of the machine on which Centova Cast is running.

IP Address: Set this to the IP address of the machine on which Centova Cast is running.

Hostname: Enter the complete URL to your Centova Cast installation, for example:
     http://centovacast.yourdomain.com/cast/

Type: Select Centovacast from the list.

Username: Set this to: admin

Password: Enter your Centova Cast administrator password.

All other fields can be ignored. When finished, click Create Server.

1. Next, go to Setup, and then click Products/Services. Then, click Create a New Product.
2. Select Shared Hosting Account and select a suitable product group and name. Then, click Continue.
3. On the Module Settings tab, fill out the following fields:

Module Name - Select "Centovacast" from the list.

Account template name - Enter the name of the Centova Cast account template to use for this
package. You can create your account templates in Centova Cast by clicking “Account Templates”
This feature allows you to predefine completely custom configurations for each package.

Max listeners - Specify the maximum number simultaneous listeners for this stream. You may
optionally leave this blank to use the value specified in the account template.

Max bit rate - Specify the maximum bit rate (in kbps) for this stream. You may optionally
leave this blank to use the value specified in the account template.
*Data transfer limit - Specify the monthly data transfer limit for this stream. You may
optionally leave this blank to use the value specified in the account template.

Disk quota - Specify the disk quota for this stream (which must be large enough to
accommodate all of this server's configuration files, log files, and any media uploaded for
the autoDJ). You may optionally leave this blank to use the value specified in the account
template.

Start server - Set this to “yes” to automatically start the server after provisioning, or
“no” if you want the user to start it manually before using it. Note that this only applies
to non-autoDJ streams; if an autoDJ is enabled, it cannot be started until media is uploaded.

1. This step is optional. If you would like to allow your users to “build their own” packages, and have WHMCS to prompt the user for various stream limit options (bit rate, data transfer limit, etc.) and be able to set custom pricing for each option, click the Configurable Options tab.
2. Next, click the the Add New Configurable Option link, and follow the directions to create one of the following options. Note that in all cases, the “Option Name” field is case-sensitive and must precisely match what is shown below or the option will not be recognized by Centova Cast.

Max listeners - This allows the user to specify a custom listener limit. Enter Max listeners
in the Option Name field to begin. Next, in the Add Option field, enter the number of
listeners, then enter the extra fee for this number of listeners, and click Save Changes.
Repeat this process for each listener limit you wish to offer.

Max bit rate - This allows the user to specify a custom maximum bit rate (in kbps). Enter Max
bit rate in the Option Name field to begin. Next, in the Add Option field, enter the bit rate,
then enter the extra fee for this bit rate, and click Save Changes. Repeat this process for
each bit rate you wish to offer. Note that Centova Cast treats this as a numeric value in
kbps, and will strip any non-numeric characters out of this value before attempting to use it.

Data transfer limit - This allows the user to specify a custom data transfer limit (in MB per
month). Enter Data transfer limit in the Option Name field to begin. Next, in the Add Option
field, enter the limit (in MB), then enter the extra fee for this limit, and click Save
Changes. Repeat this process for each limit you wish to offer. Note that Centova Cast treats
this as a numeric value in megabytes, and will strip any non-numeric characters out of this
value before attempting to use it.

Disk quota - This allows the user to specify a custom disk quota (in MB). Enter Disk quota
in the Option Name field to begin. Next, in the Add Option field, enter the quota (in MB),
then enter the extra fee for this quota, and click Save Changes. Repeat this process for each
quota you wish to offer. Note that Centova Cast treats this as a numeric value in megabytes,
and will strip any non-numeric characters out of this value before attempting to use it.

1. All other fields should be filled out in the usual manner, as when creating any other WHMCS product. When finished, click Save Changes to create your product.

The Centova Cast module is now ready to use, and will function like any other built-in WHMCS module (CPanel, Plesk, etc.)

Common Error Codes

• Unsupported protocol: - this indicates you have an incorrect value for hostname field in the server setup. Double check to ensure you have entered the full URL to Centova Cast as instructed in the steps above.

• Invalid source/server type: - this indicates you haven't entered an account template name in the products module settings, or that the name entered is invalid and not found within the Centova Cast system.

For further assistance, Centova's documentation is available @ http://www.centova.com/docs/cast/centovacast_install.pdf