How to Install Centova Cast v3

Centova Cast Quickstart Guide

 This section assumes you are using a fresh CentOS/RHEL/Debian server with no other control panels installed, and that you do not wish to customize your installation parameters. If a web hosting control panel (CPanel, Plesk, etc.) is installed on your server, see the Custom Installation section instead.

To quickly get up and running with Centova Cast, follow these three easy steps:

• First, 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.

• Run the installation script to install Centova Cast, ShoutCast DNAS v2, and sc_trans v2:

  ./install.sh --shoutcast-all 

  Prefer IceCast? Use this to install IceCast + ices-cc instead:

  ./install.sh --icecast-all 

  Centova Cast will automatically download and install itself and everything you need to get up and running at this point.

• When the installer completes, it will ask you to visit an URL in your web browser to punch in your administrator password and MySQL connection information.

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.

Centova Cast Custom Installation

If you want to use custom installation options, or if you have other components on the server that you don't want disrupted by apt/yum (which is a concern if your server is also running other control panels like CPanel, Plesk, etc.), you can perform the installation manually.

Prepare Your Server

First, ensure that you have installed all of the prerequisite software that Centova Cast requires. The packages that Centova Cast normally requires are:

On Debian: mysql-server findutils wget tar gzip unzip sed grep rsync build-essential debianutils icecast2

On CentOS: mysql-server findutils wget tar gzip unzip sed grep gawk rsync gcc gcc-c++ make which

On servers which also run a web hosting control panel, it's typically safe to use yum or apt to install all of these packages except mysql-server. Most control panels provide their own mysql-server package and installing another one will almost certainly cause problems.

Third-Party Control Panels

If you are using a third-party hosting control panel (CPanel, Plesk, etc.) on the same server as Centova Cast, the control panel may also require preparation.

Specifically:

• If you want to use Centova Cast's port 80 proxy, you must ensure that your other control panel does not attempt to configure its web server on Centova Cast's IP address. This will result in a port conflict, which will cause Centova Cast and/or your control panel's web server to fail to start.

• If you want to use Centova Cast's FTP server, you must ensure that your other control panel does not attempt to configure its FTP server on Centova Cast's IP address. This will result in a port conflict, which will cause Centova Cast and/or your control panel's FTP server to fail to start.

Please consult the documentation for your control panel for assistance in configuring it to exclude an IP address from its control.

Choose your Installation Type

Next, decide what type of an installation you're doing:

• Full Installation
  This includes the Centova Cast web interface. If this is your first Centova Cast v3 installation, then you want this installation type.

• Linux Control Daemon Installation
  This does NOT include the Centova Cast web interface, and is intended for use when you want to add an additional hosting server to an existing Centova Cast web interface. During installation you will need to provide the information for your existing Centova Cast web interface server.

• Windows Control Daemon Installation
  This does NOT include the Centova Cast web interface, and is intended for use when you want to add a Windows Media Services hosting server to an existing Centova Cast web interface. During installation you will need to provide the information for your existing Centova Cast web interface server.

Instructions for each of these installation types are provided in their respective sections.

Centova Cast 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
   • 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 sc_trans v2, you might use:

    ./install.sh --shoutcast2 --sctrans2 

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.

Advanced Installer Options

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

• --channel=unstable
  Advanced users wishing to try the latest features and functionality may optionally use the unstable branch of Centova Cast. Note that the unstable branch is (per its name) 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.

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.

Adding Additional Software to Centova Cast

Centova Cast supports a wide variety of streaming software applications. If you did not install a particular streaming application during the initial installation of Centova Cast, you can always add it later using the instructions in the sections below.

Installed by Centova Cast

Centova Cast can automatically install certain software for you with a single command:

/usr/local/centovacast/sbin/update --add <package> 

Replace <package> in the above command with a valid package name from the following list:

• ShoutCast DNAS v2
  Package name: shoutcast2

• ShoutCast DNAS v1
  Package name: shoutcast1

• IceCast
  Package name: icecast
  Optional: add --icecast-fromsrc to build the latest IceCast from source instead of using a .deb/.rpm package

• sc_trans v2
  Package name: sctrans2

• ices-cc
  Package name: icescc

• MaxMind GeoLite City Database
  Package name: geolitecity

For example, to install ShoutCast DNAS v2:

/usr/local/centovacast/sbin/update --add shoutcast2 

These commands are fully automated and will download and install the requested package automatically. Note that some of these will actually build the package from source, so they may take quite some time to complete.

Manually Installed

If you've manually installed a supported server/source in a custom location, you can use the following command to register it with Centova Cast:

/usr/local/centovacast/sbin/enable_package <package> <pathname> 

Replace <package> with a valid package name from the following list, and <pathname> with the full pathname to the software you've installed:

• ices
  Package name: ICES

• ices v2.x
  Package name: ICES2

• ezstream
  Package name: EZSTREAM

• sc_trans v1.x
  Package name: SCTRANS

• sc_trans v2.x:
  Package name: SCTRANS2

• IceCast
  Package name: ICECAST

• SHOUTcast DNAS v2
  Package name: SHOUTCAST2

• SHOUTcast DNAS v1
  Package name: SHOUTCAST

For example, if you've installed sc_trans v2 yourself and its pathname is /usr/bin/sc_trans:

/usr/local/centovacast/sbin/enable_package SCTRANS2 /usr/bin/sctrans 

The above would tell Centova Cast that you've installed sc_trans v2 at /usr/bin/sc_trans.