Centova Technologies Inc.

Products and Services

Centova Cast
Customer Support
Centova Technologies

Documentation | Installation Manual | Full Installation

Full Installation

A full installation includes the entire Centova Cast package, including the Centova Cast web interface. If this is your first Centova Cast v3 installation, then you want this installation type.

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.

Generally speaking, Centova Technologies cannot assist in configuring your firewall, but basic instructions for some common firewalls are included in our knowledge base.

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.