Adding SRT Targets
- Eli Pielet (Writec) (Unlicensed)
- Alon Men
- alon.men@zixi.com
- eli.pielet (Unlicensed)
ZEN Master can send a Source directly to an SRT Pull Target.
When this method is used, the stream is not protected by the Zixi protocol.
The following procedure describes how to add an SRT Target in ZEN Master. In addition, an explanation of each of the configuration parameters is given in the table below.
To add a new SRT Target:
- In the main navigation, click Targets.
- Click + Add.
The Create New Target window is displayed.- Click on SRT.
The Create New SRT Target window is displayed.
- Click on SRT.
- In the Info section, in the Name field, enter a logical name for the SRT Target.
- In the Tags field, select one or more of the predefined Tags from the drop-down list.
Tags are used for access control. By selecting an Tag, you are relating this Target to that Tag. Tags are associated with certain roles (through the Users & Roles screen), and roles, in turn, are associated with users and user groups. If you would like to create a new Tag, see Creating a Tag. In the Events Configuration Profile field, select from the dropdown list the profile that you would like to apply to this Target. By default, the Default profile is applied.
Events Profiles consist of a series of rules that determine precisely how various types of Events are logged and what results they trigger.
- The Target's location is used to represent it in the proper position in the Map display (see Maps). By default, the location is determined automatically based on the Target's IP. If you would like to manually set the location of the Target (Optional), use the following procedure:
- Click on the Edit icon next to the Location field.
A search box is shown below the Location field. - Enter identifying info for the location (e.g. street address, zip code, coordinates).
Search results are displayed below the search box as you type. - Click on the desired location.
The selected location populates the Location field.
- Click on the Edit icon next to the Location field.
In the Configuration section, under Channel Type, select the type of Channel that the Target will receive. Options are: ZEN Master Channel or MediaConnect Flow.
The Target will only become functional once a Channel has been assigned to it. However, you can configure the Target settings and then add a Channel to the Target after the initial configuration.
- If you selected Zen Master Channel, skip to step 14.
If you selected AWS MediaConnect Flow, follow steps 9-13, then skip to step 23. - For a MediaConnect Flow, under AWS MediaConnect Flow, select a flow from the drop-down list.
- For a MediaConnect Flow, in the Port field, enter the port number of the receiving end.
For a MediaConnect Flow, in the CIDR Allow List field, enter the range of IP addresses that should be allowed to contribute content to your source.
The whitelist CIDR block is a range of IP addresses that should be allowed to contribute content to your source. These IP addresses must be in the form of a Classless Inter-Domain Routing (CIDR) block; for example, 10.0.0.0/16. The source needs to be in the range covered by this CIDR block. Any IP address within this range is allowed to send content to this flow.
- For a MediaConnect Flow, in the Latency [ms] field, enter the latency in milliseconds.
- For a Zen Master Channel, in the Channel field, select from the drop-down list the Channel that will be sent to the Target. (Optional field)
- For a Zen Master Channel, In the Source Preference field, select one of the following options:
- Any Source – the Target will establish a connection to any available source in the Channel. Upon any disconnects with the current source, the Target will reconnect to another available source in the Channel.
- Primary Sources Only – the Target will establish and maintain connection to a source designated as Primary in the Channel. Upon loss of connection to that source, the Target will establish a connection to another available Primary source in the Channel.
- Backup Sources Only – the Target will establish and maintain connection to a source designated as Backup in the Channel. Upon loss of connection to that source, the Target will establish connection to another available Backup source in the Channel.
Specific Source – the Target will only establish a connection to the source specified by the user and will not try to connect to any other source in the Channel.
It is not possible to select "Prefer Primary Sources" or "Prefer Backup Sources". This means you cannot have a Target failover from a Primary to a Backup source in the Channel unless "Any Source" is selected.
- For a Zen Master Channel, under Type, select the method for sending the stream. Options are: Pull or Push.
- For a Zen Master Channel, if you selected Pull (Listener) method, then do the following
- In the Port field, enter the port that the server will listen on.
- In the Bind to local NIC by CIDR field, you can enter the CIDR that represents the IP range where the desired NIC is accessed. (Optional)
- For a Zen Master Channel, if you selected Push (Caller) method, then do the following:
- In the Host field, enter the hostname or IP address of the receiving device.
- In the Port field, enter the target port on the receiving device.
- In the Stream ID field, enter the Stream ID that matches the stream in the SRT feed.
- For a Zen Master Channel, in the Latency [ms] field, enter the latency in milliseconds.
- For a Zen Master Channel, in the Password field, enter the SRT stream access credentials – Password. Click show to display the password.
For a Zen Master Channel, under Encryption, if you would like to encrypt the stream, select one of the encryption methods. Options are: Disabled (default), AES 128, AES 192 or AES 256.
The encryption and decryption for SRT Targets is done automatically based on the password string, there is no need to enter a decryption key on the Target input.
- For a Zen Master Channel, if Pull (Listener) method was selected, select the Prefer Private Broadcaster IP checkbox if you would like ZEN to configure connections to use private broadcaster IPs when available. The default behavior when this is not selected is to prefer the use of public IPs.
For a Zen Master Channel, if Push (Caller) method was selected, select the Single Output checkbox if you would like to limit the output to a single stream.
This setting is required for servers that do not properly support concurrent connections.
By selecting Single Output you will be losing Failover functionality.
- If you would like to apply a PID Mapping profile to this Target, then in the PID Mapping Profile field, select the desired profile from the dropdown list. For more information, see PID Mapping Profiles.
- In the Initial State section, select the Disabled checkbox if you would like to disable this Target upon initial configuration.
Select the Muted checkbox if you would like to disable error/recovery notifications for this Target upon initial configuration.
You can Enable/Unmute the Target at any time.
- If you would like to track usage for this Target, click on Advanced and enter your Billing Code details, see Billing Codes. (Supported for Broadcasters v14.8+)
- Click Save.
SRT Target Configuration Parameters Table
Parameter | Description |
Info | |
---|---|
Name | Specify a name for the SRT Target in ZEN Master. |
Tags | Select one or more of the predefined Tags from the drop-down list. Tags are used for access control. By selecting an Tag, you are relating this Target to that Tag. Tags are associated with certain roles (through the Users & Roles screen), and roles, in turn, are associated with users and user groups. If you would like to create a new Tag, see Creating a Tag. |
Events Configuration Profile | Select from the dropdown list the profile that you would like to apply to this Target. By default, the Default profile is applied. Note: Events Profiles consist of a series of rules that determine precisely how various types of Events are logged and what results they trigger. |
Location (Optional) | The Target's location is used to represent it in the proper position in the Map display (see Maps). By default, the location is determined automatically based on the Target's IP. Enter identifying info for the location (e.g. street address, zip code, coordinates) and select the desired location from the suggestions that are shown. |
Configuration | |
Channel Type | Select the type of Channel that the Target will receive. Options are: ZEN Master Channel or AWSMediaConnect Flow. |
For AWS MediaConnect Flow: | |
AWS MediaConnect Flow | Select an AWS MediaConnect Flow from the drop-down list. |
Port | Enter the number of the port on the receiving end |
CIDR Allow List | Enter the range of IP addresses that should be allowed to contribute content to your source. Note: These IP addresses must be in the form of a Classless Inter-Domain Routing (CIDR) block; for example, 10.0.0.0/16. The source needs to be in the range covered by this CIDR block. Any IP address within this range is allowed to send content to this flow. |
For Zen Master Channel: | |
Type | Select the method for receiving the stream. Options are: Pull or Push. |
Channel (Optional) | Select from the drop-down list the Channel that will be sent to the Target. Note: The Target will only become functional once a Channel has been assigned to it. However, you can configure the Target settings and then add a Channel to the target after the initial configuration. |
Source Preference | Select from the drop-down list one of the following:
Note: It is not possible to select "Prefer Primary Sources" or "Prefer Backup Sources". This means you cannot have a Target failover from a Primary to a Backup source in the Channel unless "Any Source" is selected. |
For Pull Method (Zen Master Channel Only): | |
Port | Enter the Target port on the receiving device. |
Bind to local NIC by CIDR | Enter the CIDR that represents the IP range where the desired NIC is accessed. |
For Push Method (Zen Master Channel Only): | |
Host | Enter the Target port on the receiving device. |
Port | Enter the Target port on the receiving device. |
Stream ID | Enter the Stream ID that matches the stream in the SRT feed. |
For All Methods: | |
Latency [ms] | Enter the latency in milliseconds. |
Password (Zen Master Channel Only) | Enter the SRT stream access credentials – Password. Click show to display the password. |
Encryption (Zen Master Channel Only) | If you would like to encrypt the stream, select one of the encryption methods. Options are: Disabled (default), AES 128, AES 192 or AES 256. Note: The encryption and decryption for SRT Targets is done automatically based on the password string, there is no need to enter a decryption key on the Target input. |
Prefer Private Broadcaster IP (for Pull method) | Select this checkbox if you would like ZEN to configure connections to use private broadcaster IPs when available. The default behavior when this is not selected is to prefer use of public IPs. |
PID Mapping Profile (optional) | If you would like to apply a PID Mapping profile to this Target, then select the desired profile from the dropdown list. To create a new PID Mapping Profile, see Adding PID Mapping Profiles. |
Initial State | |
Disabled | Select this checkbox if you would like to disable this Target upon initial configuration. |
Muted | Select this checkbox if you would like to disable error/recovery notifications for this Target upon initial configuration. |
Advanced | |
Billing Code | If you would like to track usage for this Target, enter your Billing Code details, see Billing Codes. (Supported for Broadcasters v14.8+) |
Billing Password | Enter the password that corresponds to this billing code. |
External ID | The ID that is used when integrating ZEN Master with an external ESNI/ESAM server. For more detail, contact your Zixi representative. |