How To Install Centova Cast on CentOSHow To Install Centova Cast on CentOS

Centova Cast is the leading management platform for Internet radio streams, providing extensive insight and control to stream hosting providers.Centova Cast offers powerful features for both stream hosting providers and individual broadcasters.

Through the Centova Cast web-based administration panel, administrators receive a consolidated overview of all client accounts (optionally across multiple servers) from a single, convenient interface.

System Requirements:

Before installing Centova Cast, you should make sure that your server meets the following basic requirements.

Operating System:

Centova Cast supports the following operation systems:

  • CentOS 5, 6, or 7 (or equivalent RHEL release)
  • Debian Stable
  • Other operating systems based on CentOS or Debian should (in theory) work with Centova Cast, but are untested and officially unsupported.

Database server:

  • MySQL v4.1, v5.0, v5.1, v5.5, or v5.6 database server.

Streaming server:

  • SHOUTcast DNAS v2.x
  • SHOUTcast DNAS v1.9.8
  • IceCast v2.x

Note: that the installer can download and install SHOUTcast DNAS v1/2 and IceCast for you automatically.

Installation Procedure

  1. To begin your full installation of Centova Cast, download the Centova Cast installation script and make it executable: wget -O install.sh install.centova.com/LICENSEKEY chmod a+x ./install.sh Replace LICENSEKEY above with your actual Centova Cast v3 license key from your client area.
  2. Next, decide which streaming server/source software you want Centova Cast to install for you. As of the time of this writing, Centova Cast supports automatic installation of the following:
    • ShoutCast DNAS v2: add –shoutcast2 to the installer commandline
    • ShoutCast DNAS v1: add –shoutcast1 to the installer commandline
    • IceCast: add –icecast to the installer commandline
    • Liquidsoap: add –liquidsoap to the installer commandline
    • ices-cc: add –icescc to the installer commandline
    • sctrans v2: add –sctrans2 to the installer commandline
  3. Run the install.sh script as follows, substituting <options> with any (or all) of the above parameters: ./install.sh <options> For example, to install ShoutCast DNAS v2 with Liquidsoap, you might use: ./install.sh --shoutcast2 --liquidsoap
  4. The installation should complete without error and ask you to visit http://your-ip:2199/ to complete the installation. Open your browser and enter the URL provided by the installer. If you prefer to use a secure (SSL) connection, you can also use https://your-ip:2199/. Centova Cast’s web interface supports both SSL and non-SSL connections on the same port.
  5. The web interface should prompt you to choose an admin password and enter the connection information for your MySQL database. Do so.

At this point Centova Cast should inform you that the installation was successful, and will direct you to the Centova Cast login page where you can begin using Centova Cast.

If your server is using a firewall, see the Firewall Configuration section below before proceeding.

Firewall Configuration

If your server is protected by a firewall, you may need to modify your firewall configuration to allow access to Centova Cast and its streams.

Advanced Installer Options

Advanced users may optionally pass any of the following commandline options to install.sh to further automate the installation process.

  • --channel=edge
    Advanced users wishing to try the latest features and functionality may optionally use the edge branch of Centova Cast. Note that the edge branch is likely to be unstable and contain bugs, as it is the testing branch used by Centova Technologies for testing upcoming releases. Issues in this branch will not receive priority attention, so use caution when selecting this option. The default if no --channel argument is provided is to use the stable branch.
  • --deps
    Instructs the installer to use yum or apt to install all dependencies automatically.
  • --vhosts=PATH
    Configures an alternate path for Centova Cast client data including configuration files, logs, and media. This may be used to place client data on an alternate, larger partition.
  • --force
    Overwrite any existing Centova Cast installation. Note that this will completely remove your entire existing Centova Cast installation and will delete all existing client data. Use with caution.
  • --no-firewall
    Instructs the installer to skip firewall configuration. This option only affects servers using a supported firewall package (currently only CentOS 7 at the time of this writing).

Automating Stage-2 Configuration

Normally, after performing the commandline (install.sh) portion of the installation, Centova Cast prompts the user to visit a web page to finish configuring Centova Cast. This second, web-based portion of the configuration can be automated by passing all of the following options to the install.sh script.

  • --admin-email=EMAIL
    Specifies the administrator E-mail address.
  • --admin-pass=PASSWORD
    Specifies the password to configure for the admin account.
  • --dbname=NAME
    Specifies the MySQL database name to use for Centova Cast.
  • --dbuser=USER
    Specifies the MySQL database username to use for Centova Cast.
  • --dbpass=PASSWORD
    Specifies the MySQL database password to use for Centova Cast.
  • --dbhost=HOST
    (Optional.) Specifies the hostname (or IP address) for the MySQL server. Defaults to localhost.