Documentation | Installation Manual | Billing Integration
This section contains instructions and a back-end module for integrating Centova Cast with iHost v3.2 or better (or iPanel v4.2 or better, which works identically). This will allow you to use iHost or iPanel to provision and manage accounts in Centova Cast.
The Centova Cast module for iHost is located in:
Note that while we refer exclusively to iHost throughout this document for simplicity, the same instructions apply identically if you are using iPanel.
The following prerequisites must be met to use Centova Cast with iHost:
- Centova Cast must already be installed and configured.
- iHost v3.2+ or iPanel v4.2+ must be installed and configured. Familiarity with configuring iHost and setting up servers and packages is required.
Please be sure that you are able to meet these requirements before proceeding.
iHost already bundles a copy of the Centova Cast integration module. To ensure that you have the
latest and most compatible version of the Centova Cast iHost module, however, you should begin by
copying the contents of
/usr/local/centovacast/extra/billing/ihost/centovacast to your iHost
backend/centovacast/ directory. For example:
cp -r /path/to/centovacast/extra/billing/ihost/centovacast \ /home/username/public_html/ihost/backend/
When finished, you should have a directory structure such as:
To configure iHost for use with Centova Cast, perform the following steps:
First, you need to configure iHost to access your Centova Cast server. To begin, login to iHost and click Configuration, then Configure Servers. Under Add server, you should find a Centova Cast server type in the drop down list. Select Centova Cast and click Create.
On the "Create Server" page, fill out the following fields:
Set this to the
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.
In most cases, you should enter
adminhere. If you are not a Centova Cast licensee and you are instead using a Centova Cast reseller account from another hosting provider, you would enter your reseller account's username here.
Enter your Centova Cast administrator password here. Again, if you are using a reseller account, you would enter your reseller account's password here.
- Primary nameserver, Secondary Nameserver These values are not used by Centova Cast, but are required by iHost. Simply enter the hostname of your Centova Cast server as a placeholder.
- URL to Centova Cast
Set this to the complete URL to your Centova Cast installation. (Do not include the
/admin/index.php, etc. which you may see in your web browser's URL bar upon logging in to Centova Cast.)
When finished, click Create server.
Centova Cast is now ready for use with iHost, and will function like any other built-in iHost server module (CPanel, DirectAdmin, etc.)
More specifically, to create a Centova Cast package, simply click on the Manage Packages link, and then:
Under New package, select the server you created above, choose Streaming Radio Hosting (Centova Cast) as the package type, and click Create.
Configure all of the usual product options required by iHost.
Fill out the following Centova Cast-specific fields:
- 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 logging in as
adminand clicking Management > Templates. This feature allows you to predefine completely custom configurations for each package.
- Maximum 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.
- Maximum 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 enter
unlimitedto specify unlimited data transfer, or leave this blank to use the value specified in the account template.
- Disk space 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 enter
unlimitedto specify an unlimited quota, or leave this blank to use the value specified in the account template.
- Start server
Set this to
yesto automatically start the server after provisioning, or
noif 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.
- Mount point limit
Specify the maximum number of mount points the client may create (for ShoutCast v2 and IceCast streams). You may optionally leave this blank to use the value specified in the account template.
- Port 80 proxy
Specify whether the port 80 proxy may be used with this stream (assuming port 80 proxy support has been enabled on the server). You may optionally leave this blank to use the value specified in the account template.
- AutoDJ support
Specify whether the autoDJ may be used with this stream. You may optionally leave this blank to use the value specified in the account template.
- Max accounts
This option is only used when creating a reseller account. Specifies the maximum number of client accounts that the reseller is permitted to create. You may optionally leave this blank to use the value specified in the account template.
- Max bandwidth
This option is only used when creating a reseller account. Specifies the bandwidth limit for the reseller. See the bandwidth limit option in the administrator's manual for more information about the purpose of this value. You may optionally leave this blank to use the value specified in the account template.
- Account template name
The Centova Cast module should now be ready to use.
For more information about setting up products in iHost, please refer to the iHost manual.