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.
-
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
.