Revision as of 18:02, 14 January 2020

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 Server

1. Navigate to Setup > Products/Services > Servers and click on Add New Server.
   

   CentovaCast Setup
2. On the Add New Server page, fill out the fields below.
   1. Name - Set this to the hostname of the machine on which Centova Cast is running.
   2. IP Address: Set this to the IP address of the machine on which Centova Cast is running.
   3. Hostname: Enter the complete hostname to your Centova Cast installation, for example: centovacast.yourdomain.com
   4. Module: Select Centovacast from the list.
   5. Username: Set this to: admin
   6. Password: Enter your Centova Cast administrator password.
   7. Port: Specify the Port Number for your Installation (default 2199)
   8. Secure: Tick this box if your Centova Cast installation utilizes SSL connections
3. All other fields can be ignored. When finished, click Create Server.

Setting Up a CentovaCast Product

1. Navigate to Setup > Products/Services > Products/Services
2. Click the Create a New Product button
3. Select Shared Hosting Account and select a suitable product group and name. Then, click Continue.
4. On the Module Settings tab, fill out the following fields:
   1. 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.
   2. 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.
   3. 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.
   4. 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.
   5. 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.
   6. 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.
5. Complete the settings under the other tabs (for example setting pricing via the Pricing tab) in the usual manner], then click Save Changes

The next 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:

1. Navigate to Setup > Products/Services > Configurable Options
2. Click Create a New Group button
3. Enter a name and description for the group. This can be anything you like to identify these options, such as "CentovaCast Configuration Options"
4. Select your CentovaCast products from the Assigned Products list. Ctrl+Click to select more than one
5. Click Save Changes
6. Click the Add New Configurable Option button
7. 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 CentovaCast:
   1. 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.
   2. 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.
   3. 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 CentovaCast treats this as a numeric value in megabytes, and will strip any non-numeric characters out of this value before attempting to use it.
   4. 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 CentovaCast treats this as a numeric value in megabytes, and will strip any non-numeric characters out of this value before attempting to use it.
8. When finished, click Save Changes to create your changes.

The CentovaCast 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