Skip to content

Updating Watcher or rolling back to previous version

We recommend updating Flussonic Watcher regularly to the latest release. Usually releases come out at the beginning of each month.

If necessary, you can always revert to a previously installed version.

You can also install a rolling update (the so-called master branch) of Flussonic Watcher on the Managing server and Flussonic Media Server on Streamers. The rolling update may have features that will be included in the next release but not yet available in the current release. This version is not guaranteed to be stable and should only be used for testing and evaluation purposes. Please use the release on live sites.

Updating or rolling back the Managing server

Updating Watcher Managing server

Run the following commands to update Watcher:

apt-get update
apt-get -y install flussonic-watcher

During the update, Watcher automatically migrates the database to work with the new version.

Installing a rolling update (master) to the Watcher Managing server

Remove the currently installed version of Flussonic Watcher and its dependencies:

apt remove flussonic-watcher

Change the repository to the one with the rolling updates and install Flussonic Watcher:

echo "deb http://apt.flussonic.com/repo master/" > /etc/apt/sources.list.d/flussonic.list;
apt update;
apt install flussonic-watcher;

Returning Watcher Managing server to the major release

Remove the currently installed version of Flussonic Watcher and its dependencies.

apt remove flussonic-watcher

Change the repository to the one with official releases and install Flussonic Watcher:

echo "deb http://apt.flussonic.com binary/" > /etc/apt/sources.list.d/flussonic.list;
apt update;
apt install flussonic-watcher;

Note

We strongly recommend that you back up your database every day and before you update Watcher.

Rolling back Watcher Managing server to the previous version

To rollback to the previous version of Watcher, follow these steps:

  • Create a backup copy of the database so that if necessary you can quickly restore the service:

    sudo -u postgres pg_dump watcher > watcher-$(date +%s)_backup_dump.sql

  • Determine dependencies:

    apt-cache show flussonic-watcher=20.06 | egrep 'Depends|Suggests:' Depends: flussonic (>= 19.12), flussonic-python (=20.05.1), postgresql (>= 9.6)

  • Install the required version and its corresponding dependencies:

    apt install flussonic-python=20.05.1 flussonic-watcher=20.06

  • Restart the service:

    service flussonic restart

Updating and rolling back the Streamers

Updating your Streamers to the current release

Run these commands on each streamer:

apt-get update
apt-get -y install flussonic
service flussonic restart

Installing a rolling update (master) on Streamer

Remove the currently installed version of Flussonic and its dependencies:

apt remove flussonic

Change the repository to the one with rolling updates and install Flussonic:

echo "deb http://apt.flussonic.com/repo master/" > /etc/apt/sources.list.d/flussonic.list;
apt update;
apt install flussonic;
service flussonic restart

Returning the Streamer to the current release

Remove the currently installed version of Flussonic and its dependencies.

Warning

Before removing the packages, create a backup of the configuration files located in the directory /etc/flussonic and the .db files in the directory /opt/flussonic/priv.

apt remove flussonic

Change the repository to the one with official releases and install Flussonic:

echo "deb http://apt.flussonic.com binary/" > /etc/apt/sources.list.d/flussonic.list;
apt update;
apt install flussonic;
service flussonic restart

Warning

If Flussonic fails to start, run the commands systemctl status flussonic.service and journalctl -xe and send their output to our technical support team.

Rolling the Streamer back to the previous version

To do this, you must specify the exact version of the flussonic package and its dependencies.

Suppose you want to revert to version 22.11.

Get dependencies' versions by using apt-cache:

    apt-cache show flussonic=22.11  | egrep '^(Depends|Suggests):'

Result will be like:

    Depends: flussonic-erlang (=24.0.6.3), flussonic-transcoder-base (=22.08.3)

Install packages with these versions:

    apt-get install flussonic=22.11 flussonic-erlang=24.0.6.3 flussonic-transcoder-base=22.08.3

Warning

Before installing packages create a backup of the configuration files in the directory /etc/flussonic and .db files in the directory /opt/flussonic/priv.