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=testing
    Advanced users wishing to try the latest features and functionality may optionally use the testing branch of Centova Cast. Note that the testing branch is likely to be unstable and contain bugs, as it is the 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.

  • --force
    Overwrite any existing Centova Cast installation. Note that: this will completely overwrite your entire existing Centova Cast installation and will delete all existing client changes. 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).

  • --secure=example.com --email=adming@example.com
    The installer will attempt to automatically configure Centova Cast to listen on ports 80 and 443, enable the web proxy feature, and issue a free Let's Encrypt certificate for your installation, using the provided domain name and email. IMPORTANT: this feature requires the provided domain name to be correctly configured, to point to the server's main IP address before running install.sh.

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.