iHost Integration

iHost 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:

/usr/local/centovacast/extra/billing/ihost/

Note that while we refer exclusively to iHost throughout this document for simplicity, the same instructions apply identically if you are using iPanel.

Prerequisites

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.

Installation

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 directory's 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:

/home/username/public_html/ihost/backend/centovacast/

Configuration

To configure iHost for use with Centova Cast, perform the following steps:

  1. 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.

  2. On the "Create Server" page, fill out the following fields:

    • Status
      Set this to the Active All
    • Hostname
      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.
    • Username
      In most cases, you should enter admin here. 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.
    • Password
      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 /login/index.php, or /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:

  1. Under New package, select the server you created above, choose Streaming Radio Hosting (Centova Cast) as the package type, and click Create.

  2. Configure all of the usual product options required by iHost.

  3. 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 admin and 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 unlimited to 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 unlimited to specify an unlimited quota, or 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.
    • 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.

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.