Flussonic Media Server documentation

Catena Quick Start Guide

When you start using Catena, you need to conigure it for working with streams and users:

  1. Adding Flussonic Media Servers into Catena
  2. Adding pipelines
  3. Adding streams into Catena
  4. Adding subscribers into Catena

Adding Flussonic Media Servers into Catena

Catena uses one or more servers with Flussonic Media Server for processing streams.

To add a server into Catena:

  1. Go to the Servers tab and click Add server.
  2. In the dialog that appears, enter information about the Flussonic Media Server instance you want to add and click Save:

    • Address. Your Flussonic Media Server address – http://flussonic_ip:port
    • Input interface and Output address (optional). Used for multicast. If you will not use multicast streams, leave it blank.
    • Login and Password. The username and password to access the Flussonic Media Server you want to add.
    • Timeout seconds (optional). The time interval (in seconds) after which Catena assumes that the server, if it is not answering, is down. By default, Catena sends requests about server state every minute.
    • Channels limit and Total bandwidth (optional). Used to set limits on the number of channels and the bandwidth.

    Catena add server

Adding pipelines

A pipeline is a scenario for Catena that determines what to do with a stream and on which server.

Technically a pipeline is a sequence of steps, each step has one or more servers (streamers) dedicated for a specific role. Roles can be, for example, ingest, transcoding, writing to archive, or delivery to client devices.

If you assign several servers to a step, Catena can, depending on the configuration, choose only a certain server or add the stream to all of the servers and migrate it if the initial server is down.

To add a pipeline:

  1. Go the Pipeline tab and click the New Pipeline button.

    Catena add pipeline

  2. Enter the pipeline name and submit it. The page of the pipeline appears.

    Add pipeline name

  3. Add at least one step to the created pipeline for ingesting the stream on Flussonic Media Server.

    Add pipeline step

    The following data can be added about a step:

    • Seq num. The number of a step in the pipeline.
    • Role. Defines the role of the server(s) added to the pipeline.
    • Options. Sends required stream options on Flussonic Media Server.
    • Single capture. The option is useful for ingesting Internet streams on the steps with trancoder role.
    • Automigrator. Migrates a stream to another server in the pipeline if the original server is down. Works together with the Timeout seconds options in the server configuration.
    • Ondemand. Makes a stream on-demand (rather than live).

    Step fields

  4. Add the server to the created step. Select a server from the list. When you will add streams to the pipeline, they will be created on this server.

    Add server to the pipeline

See also: Load balancing in Catena

Adding streams into Catena

You can add streams manually or by importing an M3U file.

To add a stream manually:

  1. Go to the Stream tab and click the New Stream button.

    Important! Do not use the output link of the stream from your Flussonic Media Server if you want to create a stream on the same server.

    Add stream

  2. After you have clicked Submit, the green button appears.

  3. Click Add to pipeline and select the pipeline where you want to add the stream.

    Add stream to the pipeline

To import streams from an M3U playlist:

  1. Go to the Import tab.
  2. Choose a file from your computer and send it to Catena.

    The streams will be uploaded to Catena and become available on the Streams tab.

    Import streams using m3u

Adding subscribers into Catena

The list of existing subscribers is found on the Subscribers tab.

To add subscribers into Catena:

  1. Go to the Subscribers tab and click Add subscriber.
  2. Fill in the form and submit it.

    Import streams using m3u