Installation

Read before installing: how do I change my password?

In order to change the administrator password, you can edit the config file /etc/flussonic/flussonic.conf and change the value of the edit_auth directive, or do the same via the Web interface under System -> Config -> Global options.

When you are done manually editing the config file, do not forget to make Flussonic read the new settings by running the following command:

/etc/init.d/flussonic reload

Installing on Debian / Ubuntu

Installing Flussonic using Debian installation package

Supported architectures: amd64 и armhf. i686 is not supported.
Required OS version: Ubuntu 12.04 and newer, Debian 7 wheezy and newer.

Installing Flussonic using Debian package:

wget -q -O - http://debian.erlyvideo.org/binary/gpg.key | apt-key add -;
echo "deb http://debian.erlyvideo.org binary/" > /etc/apt/sources.list.d/erlyvideo.list;
apt-get update;
apt-get -y install flussonic flussonic-ffmpeg flussonic-python

Now you are ready to start Flussonic

/etc/init.d/flussonic start

Open in browser Flussonic admin web interface on the page http://flussonic-ip:8080/ and paste there license key that you have received (change "flussonic-ip" to the real address of the server). On this page you can change administrator login and password.

License key stored in /etc/flussonic/license.txt file, you can put the key there before start.

You can check whether your Flussonic installation is correct by visiting http://flussonic-ip:8080/ where flussonic-ip is the address of the hosting server to which you installed the software. You can also run the following command:

/etc/init.d/flussonic status

Now installation is complete, and Flussonic is ready to operate. However, for best performance with a high client volume, we suggest you do some system tuning.

Installing RPM on Centos / Redhat etc.

Installing Flussonic from Yum repository:

cat > /etc/yum.repos.d/Flussonic.repo <<EOF
[flussonic]
name=Flussonic
baseurl=http://debian.erlyvideo.org/rpm
enabled=1
gpgcheck=0
EOF
yum -y install flussonic-erlang flussonic flussonic-ffmpeg flussonic-python
# Save the key in /etc/flussonic/license.txt
/etc/init.d/flussonic start

Number of open descriptors

By default, in OS Linux the max number of open files per process is set to 1024. This means that once the number of connections goes slightly over 1000, new connections will be refused even though there is still enough resources. Add the following lines to /etc/security/limits.conf:

root            soft    nofile 65536
root            hard    nofile 65536

The number of open descriptors exceeds the number of client connections.

Updating Flussonic

To install updates, simply update the packages and install Flussonic:

apt-get update
apt-get -y install flussonic
/etc/init.d/flussonic restart

Which version is currently installed?

dpkg -l | grep flussonic
# ii  flussonic   3.71.14   amd64        Videostreaming server

How to revert to the previous version?

It is sometimes necessary to install previous version. To do this, you must specify exact version of flussonic package and its dependencies.

Suppose you want to version 4.5.20. Get dependencies versions using apt-cache:

apt-cache show flussonic=4.5.20 | egrep '^(Depends|Suggests):'
Depends: flussonic-erlang (=18.2.1), flussonic-python (=2.7.3)
Suggests: flussonic-ffmpeg (>= 4.2)

Install packages with these versions:

apt-get install flussonic=4.5.20 flussonic-erlang=18.2.1 flussonic-python=2.7.3 flussonic-ffmpeg=4.2

For convenience, here are commands for installing versions 4.5.20 .. 4.5.23:

apt-get install flussonic=4.5.20 flussonic-erlang=18.2.1 flussonic-python=2.7.3 flussonic-ffmpeg=4.2
apt-get install flussonic=4.5.21 flussonic-erlang=18.2.1 flussonic-python=2.7.3 flussonic-ffmpeg=4.2
apt-get install flussonic=4.5.22 flussonic-erlang=18.3 flussonic-python=2.7.3 flussonic-ffmpeg=4.2
apt-get install flussonic=4.5.23 flussonic-erlang=18.3 flussonic-python=2.7.3 flussonic-ffmpeg=4.2

Starting and stopping Flussonic

Use the following commands:

to start the service:

/etc/init.d/flussonic start

to stop the service:

/etc/init.d/flussonic stop

to restart the service:

/etc/init.d/flussonic restart

to reconfigure with client connections live:

/etc/init.d/flussonic reload

System requirements

Please see the minimum system requirements to the host server for running Flussonic in the table below. In reality, the requirements may slightly vary depending on the number of concurrent connections to Flussonic server.

Minimum system requirements

For stable streaming video playback with a high volume of concurrent connections, we recommend distributing the traffic load among several real servers. For detailed information on clustering of Flussonic servers, please see the Clustering section.

Please note that when files on disk are used as the data source, the disk subsystem bears the main burden. Consequently, when planning the host server architecture for running Flussonic, special attention should be paid to the hard disk performance. For more detail on this subject, please see file streaming.

If the host server is protected with a firewall, exception rules must be set for ports and protocols used by Flussonic.

For the commercial version, it is also vital that Flussonic itself has access to the Internet via HTTP and HTTPS protocols.

Windows32 installation

We recommend not to use Windows at all for any server-side tasks but if you really need, you can try to use our win32 build.

Install erlang: http://debian.erlyvideo.org/binary/otp_win32_19.exe
and Flussonic: http://debian.erlyvideo.org/binary/flussonic-4.6.16.exe

Prepare license key before installation, you will require it.