Updating Flussonic Watcher¶
Update the management server and streamers as a compatible set of components. Before changes, preserve a verified database backup and file configuration, record package versions and schedule a maintenance window: the installer stops services and runs database migrations.
Returning packages to an earlier version does not restore the database schema or data. A rollback plan must include a pre-upgrade backup or a consistent system snapshot.
Updating and rolling back the Watcher management server¶
Update the Watcher management server¶
- Create and verify a backup. Preserve
/etc/watcher,/etc/centraland the HTTP(S) entry-point settings you use. -
Record installed packages:
dpkg-query -W -f='${Package} ${Version}\n' \ flussonic-watcher watcher-standalone watcher-vms watcher-streamer \ flussonic flussonic-central flussonic-pythonPackages not used by your installation option may be absent from the output.
-
Update the APT index and check the plan for your installation type:
apt-get update apt-get --simulate install flussonic-watcher=26.11For management without a local streamer, use
watcher-standalone=26.11. Do not switch installation types during a routine update. -
If the package set matches the plan, install:
apt-get install flussonic-watcher=26.11
The installer upgrades the Watcher schema, migrates Central and synchronizes configuration, then starts services. On installations with a local media layer it also restarts that layer, so viewing and recording can be interrupted.
After completion, check systemctl --failed, Watcher login and cluster state. Open camera live video and archive playback. The watcher-streamer and media engine versions may differ: in 26.11 the package requires flussonic >= 26.09, and APT chooses an available version according to your constraints.
Intermediate management server update: installing master¶
The master repository is not a test branch: changes from it are included in the next release.
curl -L http://apt.flussonic.com/repo/binary/gpg.key > /etc/apt/trusted.gpg.d/flussonic.gpg
echo "deb http://apt.flussonic.com/repo master/" > /etc/apt/sources.list.d/flussonic.list
apt update
apt install flussonic-watcher
Return Flussonic Watcher to an official release¶
Server with a local streamer:
curl -L http://apt.flussonic.com/repo/binary/gpg.key > /etc/apt/trusted.gpg.d/flussonic.gpg
echo "deb http://apt.flussonic.com/repo binary/" > /etc/apt/sources.list.d/flussonic.list
apt update
apt install flussonic-watcher=26.11 watcher-vms=26.11 watcher-streamer=26.11
Server without a local streamer:
curl -L http://apt.flussonic.com/repo/binary/gpg.key > /etc/apt/trusted.gpg.d/flussonic.gpg
echo "deb http://apt.flussonic.com/repo binary/" > /etc/apt/sources.list.d/flussonic.list
apt update
apt install watcher-standalone=26.11 watcher-vms=26.11
You do not need to remove Watcher or its dependencies before changing the repository. Do not run apt autoremove as part of this procedure.
Roll back to an earlier Flussonic Watcher version¶
Before rollback, prepare:
- Packages — earlier Watcher, media layer and Central versions with their dependencies.
- Data backup — the pre-upgrade database and corresponding file configuration.
- Stop/start plan — prevent old processes from using an incompatible database schema.
- Verification — login, user permissions, cameras and archive playback.
Inspect version dependencies without changing the system:
apt-cache show flussonic-watcher=26.11
apt-cache show watcher-streamer=26.11
Substitute the target version. The 26.11 distribution links flussonic-watcher, watcher-vms and watcher-streamer through exact dependencies. watcher-standalone has an exact dependency on watcher-vms.
Use a consistent system snapshot or a previously tested sequence of installing old packages and restoring the database. Changes made after the backup are absent from it. If no suitable backup exists, agree on a procedure with support before downgrading.
Updating and rolling back streamers¶
Update a streamer to the current release¶
Update one streamer at a time, first checking reserve capacity and zones: the remaining servers must have permission and resources to accept its cameras.
apt-get update
apt-get --simulate install watcher-streamer=26.11
apt-get install watcher-streamer=26.11
systemctl status flussonic --no-pager
The package itself applies configuration by reloading the running service. Updating dependencies can restart the media engine. After each server, check video and new recording before proceeding to the next.
Intermediate streamer update: installing master¶
The master repository is not a test branch: changes from it are included in the next release. Changing the repository on the management server does not change package sources on streamers.
curl -L http://apt.flussonic.com/repo/binary/gpg.key > /etc/apt/trusted.gpg.d/flussonic.gpg
echo "deb http://apt.flussonic.com/repo master/" > /etc/apt/sources.list.d/flussonic.list
apt update
apt install watcher-streamer
service flussonic restart
Return a streamer to an official release¶
curl -L http://apt.flussonic.com/repo/binary/gpg.key > /etc/apt/trusted.gpg.d/flussonic.gpg
echo "deb http://apt.flussonic.com/repo binary/" > /etc/apt/sources.list.d/flussonic.list
apt update
apt install watcher-streamer=26.11
service flussonic restart
Roll back a streamer to an earlier version¶
Check target dependencies with apt-cache show. Confirm compatibility of existing archive format with the target media engine. Installing an old package neither converts archives nor restores previous configuration.
If the service fails to start, collect diagnostics:
systemctl status flussonic --no-pager
journalctl -u flussonic --since '-15 minutes' --no-pager
Save package versions, the error and the change time for support.