Flussonic Media Server documentation

Contents

Source Failover

Redundant sources

To maximize service uptime for your subscribers, you can use the Source Failover feature. By specifying multiple sources, you instruct Flussonic to automatically failover to the secondary data sources if the primary source becomes unavailable. This happens when the stream is disconnected, or when there are no incoming frames from the source for more than 10 seconds.
stream rtr {
  url tshttp://10.0.4.5:9000/channel/5;
  url tshttp://10.2.4.5:9000/channel/5;
}

After Flussonic Media Server switches to a secondary source, it will periodically check if the first source is up. When the first source comes back online, Flussonic will fall back to it.

stream rtr {
  url tshttp://10.0.4.5:9000/channel/5 priority=1 source_timeout=60;
  url tshttp://10.2.4.5:9000/channel/5 priority=2 source_timeout=60;
}

source_timeout

The source_timeout option specifies the period of time, in seconds, for which Flussonic will wait for new frames. This option can be specified for both data sources and streams. The source_timeout option of a data source has priority over the source_timeout option of its parent stream. The default value for this option is 60 seconds.

priority

Sources can be assigned priority values. By default, the first source in the list has the highest priority and the last source in the list has the lowest priority. If priority is not specified for some sources, then default order is applied. If priority value of unavailable source is equal to the value of the current source, then Flussonic will not try to fall back to the source that has become unavailable.

Failover Conditions

Flussonic only monitors the time since last frame was received from the source, and switches to another source if there were no incoming frames received within a certain timeframe.

Flussonic doesn't monitor conditions like video or audio loss or increased volume of MPEG-TS CC errors.

Recording

If a DVR location is configured, Flussonic will start archiving video from an active source.

The system makes no distinction between live sources and local video files. If Flussonic switched to a file source the dvr subsystem will write the contents of this file to archive:

It is possible to use a static video as a failover data source.

stream cnn {
  url udp://239.1.2.3:1234;
  url file://vod/backup.mp4;
  dvr /storage;
}

In the example above, the placeholder video would be written to the DVR archive. To avoid writing a placeholder video file to the archive when all of the sources are down, you should use the backup directive instead of a static video URL.