Cinegy Route Manager

Reading time ~7 minutes

Cinegy Route Manager allows you to manage the streams and channels that are being registered by Cinegy Route Directory Service.

Once Cinegy Route Manager is started, the following connection dialog box appears:

stream_manager_connect

Enter the "localhost" if Route Directory Service is installed on your PC locally; otherwise, enter the Route Directory Service IP address or the network name in case it is being used remotely.

Note
 Please make sure Route Directory Service is running; otherwise your connection cannot be established.

Once the connection is successfully established, the main dialog box appears:

VoIP Registry

Using Route Manager, you can organize and set up the physical source and virtual destination groups used for managing IP streams and channels being registered by Route Directory Service.

The left hand panel displays physical and virtual groups for currently connected Route Directory Service in the tree-like structure.

Below this tree, there is a player where the video stream of the selected network source is previewed:

player

player_start_stop_button

You can start/stop the playback by pressing the corresponding buttons.

player_show

To hide the player, remove the selection of the "Show Player" option.

Once you click the "Physical Sources" or a physical source group, all the available network physical sources with their corresponding information will be displayed in the top part of the right hand panel of the manager window. All the available programs for the selected source are listed in the table below.

The virtual destinations structure allows the user to classify incoming physical streams into logical virtual groups.

All the publicly visible sources are marked in bold.

Important
 Refer to the Visibility Management article for details on the ingest metadata configuration.

All the sources and programs in the tables in the right hand panels can be sorted by pressing the corresponding column header, except for the "Programs" column for the sources and the "Channels" column for the programs.

Objects Copying and Moving

Cinegy Route Manager allows you to copy and/or move folders and channels. To copy objects and paste them to a desired location, use the "Copy" and "Paste" context menu commands respectively:

copy command

To move the object(s) from one source group to another, use the "Cut" and "Paste" context menu commands.

Connection

connect

To establish new connection to Route Directory Service or change the service if you are already connected, press the "Connect…​" button located in the main toolbar or in the "File" menu. The connection dialog box will appear. Enter the Route Directory Service network name or IP address.

If connection is successful, the server network name will be shown in the bottom left corner of the window; otherwise, the not connected status will be shown there and all the functions will be disabled.

Refreshing Content

To renew the physical sources and virtual destinations and groups with the updated ones from Route Directory Service, press the refresh_button button located in the main toolbar or use this function in the "View" menu. The keyboard shortcut is F5.

Physical Sources

Physical Source Groups

Grouping the physical sources can help the operator to organize and simplify managing of the multicast IP streams.

Add_group_button

To create a new physical source group, choose the "Physical Sources" object and press the "Add…" button on the main toolbar. The following dialog box appears:
Add physical source group

Enter a group name here and define its visibility parameters using the "Visible To…​" button.

change_group_button

To change the name or visibility parameters of the existing physical source group, use the "Change…" button in the main toolbar.

Delete_group_button

To delete an existing physical source group, select the required group and press the "Delete" button in the main toolbar. The following dialog box will appear asking you to confirm your decision:

Delete_confirmation_dialog
Note
 The procedure for creating, editing and deleting virtual destination groups is the same as for operations with physical source groups.

Physical Source Creation

add_network source

To add a new physical source, select the physical group, in which you would like to create it, and press the "Add…" button located in the main toolbar of Route Manager. The following dialog box appears:
edit network source

Here define the following parameters:

  • Name – a stream name;

  • Stream type – the stream protocol type (RTP, UDP or SRT);

  • IP & port – the source IP (multicast group IP) and port number;

    Caution
    		 Port 8888 is the default service port; it cannot be used here.

  • Default service – default service ID; it defines which service (program) from the stream will be used by default. Defining this parameter (when it is not 0), provides you with the ability to manage the whole stream as the program and this very program will be used as the default service for this stream.

    When working with the single-program stream, the only existing program is always used as the default service.

    The defined service ID is automatically updated after the program reloading.

    Note
    		 The service ID is 0 by default.

visible_to_button

Press the "Visible To…​" button to define the visibility parameters for the current network source.

To load the stream information directly from either DVB or MPEG2 stream, press "Load" and use the corresponding option to create the list of all available channels automatically:

load_from_dvb_stream

Program Creation

+add

To add a channel manually for the current physical source, use the "Add…" button in the "Add physical source" toolbar. The following dialog box appears:
edit_program_window

Enter the program name, service ID and a Program Identification (PID) number here.

Note
 The program PID number should be unique.

+add

Press the "Add…​" button to add a new stream to the "Streams" list for the program you are creating. The following dialog box appears:

edit_stream_window

Enter a name for the new stream and define its type (video or audio) and PID number. Press "OK" to create the stream.

Note
 The program PID number should be unique.

In this dialog box you can also define which streams to use in the current program by selecting the corresponding stream(s) in the "Use" column:

in use

change button

Press the "Change…​" button to edit the selected object.

delete button

Press the "Delete" button to remove the selected object.

Virtual Destinations

Virtual destinations are intended to create source IP streams using the dynamic physical source IP streams switch. This allows the operator to change the physical source IP stream any time without the necessity for re-configuring all the clients to listen to the new IP stream. When the virtual destination IP stream is changed, all the clients will receive updated info in a few seconds without interrupting the playback.

Important
 Refer to the Cinegy Route Browser article for details on configuring virtual destinations.

Virtual Destination Groups

Virtual destination groups are intended to organize incoming IP streams into logical groups.

Important
 Creating, deleting and editing virtual destination groups is similar to the physical source groups operation.

Virtual destination groups will be shown as separate tabs in the Cinegy Route Control application.

Virtual Destination Creation

+add

To add a new virtual destination, choose "Virtual Destinations" or select a desired virtual group, in which you would like to create a destination and press the "Add…" button in the main toolbar. The following dialog box appears:
edit virtual destination

Enter a virtual destination name here and define its visibility parameters using the "Visible To…​" control.

Important
 Visibility configuration is described in the Visibility Management article.

Secondary Events

Cinegy Route Manager allows users to add events to network streams which are controllable via the secondary events through Cinegy Event Manager.

+add

To add a secondary event for the current virtual source, use the "Add…" button in the "Source change triggered secondary events" section. The following dialog box appears:
edit_secondary_event

Here define the following parameters:

  • Name – the name of the secondary event;

  • Device – the device that will receive the event;

  • Command – the command;

  • OP1 – the command option 1;

  • OP2 – the command option 2;

Having defined parameters, press "OK".

change button

Press the "Change…​" button to edit the selected object.

delete button

Press the "Delete" button to remove the selected object.

run button

Press the "Run" button to send the event to Cinegy Event Manager for further processing.

Processing Nodes

Processing nodes are intended to create and edit sets of various video and audio streams. You can select only one video stream from the primary video sources and up to four audio streams from the secondary audio sources. In processing nodes it is possible to mix audio streams, edit the audio delay and signal level values. When the set of video and audio streams is changed, all the clients will receive the updated information in a few seconds without interrupting the playback.

The processing groups and nodes can be created, edited and deleted in the same way as virtual destination groups and nodes.