---
title: Adding a Broadcaster Cluster - Linode
slug: zen-master/adding-a-broadcaster-cluster-linode
docTags: 
createdAt: 2024-12-27T16:04:23.488Z
---

When creating a ZEN Master managed Linode Broadcaster cluster, make sure to select an instance type that supports the type of processing that will be done on this cluster. ZEN Master supports both standard CPU instances as well as Nvidia GPU instances on AWS, Azure, Linode, and GCP (including Tesla V100 and T4, which support both HEVC decoding and encoding).

## To add an Linode Broadcaster Cluster:

:::::WorkflowBlock
:::WorkflowBlockItem
In the main navigation, click **Broadcasters**.
:::

:::WorkflowBlockItem
Click **+ Add Cluster**.
The **Create New Broadcaster Cluste**r screen is displayed.

::Image[]{src="https://api.archbee.com/api/optimize/mzxtTQEvCNIdUNgF2kuwJ/4g6Wf-U1nK3F7_qX0Wc0v_create-new-cluster.png" size="90" isUploading="false" position="center" width="1444" height="798" darkWidth="1444" darkHeight="798" showCaption="false"}
:::

:::WorkflowBlockItem
Select Linode to open the Create New Linode Broadcaster Cluster screen:

::Image[]{src="https://api.archbee.com/api/optimize/mzxtTQEvCNIdUNgF2kuwJ/uge3R6DHxYFOo9d8xFbID_configuration-linode.png" size="90" isUploading="false" position="center" width="1438" height="3629" darkWidth="1438" darkHeight="3629" showCaption="false"}
:::

:::WorkflowBlockItem
In the **Info** section, in the **Name** field, type a logical name for the Zixi Cluster resource.
:::

:::WorkflowBlockItem
In the **Tags** field, select one or more of the predefined Tags from the drop-down menu.
Tags are used for access control. By selecting a Tag you are relating this Cluster to an 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](docId\:YpM9tw81ap6nq8sTKv4Rd) .
:::

::::WorkflowBlockItem
In the **Events Configuration Profile** field, select from the dropdown list the profile that you would like to apply to this cluster. By default, the Defaultprofile is applied.

:::hint{type="info"}
Events Profiles consist of a series of rules that determine precisely how various types of Events are logged and what results they trigger.
:::
::::

:::WorkflowBlockItem
In the **DNS Prefix** field, enter a unique domain name for sending the streams to/from this cluster.
:::

:::WorkflowBlockItem
Select the **DTLS** checkbox if you would like to activate DTLS encryption and authentication. (This feature is only supported for Broadcasters running v12.2+.)
:::

:::WorkflowBlockItem
If you selected the **DTLS** checkbox then the **Ignore DTLS certificate when not supported** checkbox appears. Select this checkbox if you would like to enable resources using older versions of Zixi software (\<v12.2) that don't support verification of the ZEN DTLS certificate to connect to this cluster.
:::

::::WorkflowBlockItem
Select the **Log SCTE-35** checkbox if you would like to log SCTE-35 markers for streams on this cluster.

:::hint{type="info"}
- To log SCTE-35 markers, SCTE-35 needs to be enabled both on the Ingest Cluster and in the Source configuration.
- SCTE-35 logging is only available for v13.1.40262+ Broadcasters.
:::
::::

:::WorkflowBlockItem
Select the **RTMP Server** checkbox if you would like to receive RTMP push inputs.
:::

:::WorkflowBlockItem
If you want to configure an alternative path for disaster recovery, in the **Alternative Cluster (Disaster Recovery)** field, select the Cluster that will be used as the alternative path. For more details, see [Disaster Recovery (Alternative Path)](docId\:poo4ZS1-ZjRa1snDylqE0) .
:::

::::WorkflowBlockItem
Fill in your cloud service account details as follows:

:::Paragraph{listStyleType="decimal" indent="2"}
In the **Configuration** section, choose your Linode account from the dropdown selector.
:::

:::Paragraph{listStyleType="decimal" listStart="2" indent="2"}
In the **Region** field, select from the drop-down list the location of the account to be used for this cluster.
:::

:::Paragraph{listStyleType="decimal" listStart="3" indent="2"}
In the **Network Security Group** field, select from the drop-down list a group in your Linode account.
:::

:::Paragraph{listStyleType="decimal" listStart="4" indent="2"}
In the **Image** field, select from the drop-down list an image that is available for this account.
:::

:::Paragraph{listStyleType="decimal" listStart="5" indent="2"}
In the **Instance Size** filed, select the appropriate instance size.
:::
::::

:::WorkflowBlockItem
In the **Activation Key** field, input the activation key for your Zixi Broadcaster license.
:::

:::WorkflowBlockItem
In the **API User** field, enter the username for accessing the Zixi Broadcaster via API.
:::

:::WorkflowBlockItem
In the **API Password** field, enter the password for accessing the Zixi Broadcaster via API
:::

::::WorkflowBlockItem
In the **Broadcaster Version** field, select from the drop-down list the desired Broadcaster version that you would like to run on your cloud service machines.

:::hint{type="info"}
- The Broadcaster versions available for your account can be viewed and modified on the Customer Portal.
- Make sure to select a Broadcaster version that supports the type of processing that will be done on this cluster.
:::
::::

::::WorkflowBlockItem
In the **Authorization Mode** field, select one of the following options:

- **ZEN Master** – ZEN Master automatically verifies the authorization for each ZEN entity (e.g. sources, channels and targets) that accesses the Broadcaster cluster. If you would like to allow access to inputs/outputs that are not configured in ZEN Master, then in the **Allow access…** section, select the **Push Inputs** and/or **Pull Outputs**
- **Global Password&#x20;**– Broadcasters are automatically configured to authorize all connections using a single global password. The global password will be used in the Source Password field when you configure a Source. In the **Password** field, enter the password OR click **Random&#x20;**&#x74;o generate a random password.
- **Free for All&#x20;**– Broadcasters will be automatically configured to allow all inputs/outputs to connect. Select **Inputs** and/or **Outputs** to automatically allow them to connect.
- **Manual** – ZEN will not authorize connections. You will need to authorize each connection independently.

:::hint{type="info"}
All authorization modes other than *Manual* will override the authorization configured on your Broadcasters. Therefore, if you have streams on your Broadcasters that are not configured on ZEN Master, then any mode other than *Manual* or *Free for All* may interrupt those streams.
:::
::::

:::WorkflowBlockItem
If you want to **allow access to inputs not configured in ZEN Master**, check the types you want to allow, and check **Delete Protection** if you do not want to allow these inputs to be deleted via ZEN Master.
:::

:::WorkflowBlockItem
If you would like to adjust the advanced settings, click **Advanced**.
The **Advanced settings** are displayed:

::Image[]{src="https://api.archbee.com/api/optimize/mzxtTQEvCNIdUNgF2kuwJ/4Xw3fPFBfMPFsujSQ5eYN_advanced-linode.png" size="90" isUploading="false" position="center" width="1424" height="3247" darkWidth="1424" darkHeight="3247" showCaption="false"}
:::

:::WorkflowBlockItem
You can adjust the following settings:

1. **Balance Pull Targets**– select one of the following load balancing methods for Pull outputs:
   - **Minimize the number of broadcasters&#x20;**(default)– transfers excess load to other broadcasters only when the allotted capacity on the host broadcaster is filled.
   - **Uniform distribution** – distributes the load equally between all available broadcasters under all circumstances.
2. **HTTP Streaming Port&#x20;**– You can change the HTTP streaming port from the default (*7777*) to a custom port. The custom port should match the configuration on the Zixi Broadcaster.
3. **Public IP Prefix&#x20;**– enter an appropriate IP prefix based on the example shown in the UI.
4. **Bandwidth Limits**– set the bandwidth limits. Choose one of the two fields: **Input** - **Output**.
5. The **Transcode Thresholds** are used by ZEN Master to determine whether an additional transcoded Channel can be added to the broadcaster. The following thresholds can be adjusted:
   - **CPU Threshold&#x20;**– percentage of CPU being used.
   - **Memory Threshold&#x20;**– percentage of memory being used.
   - **GPU Threshold&#x20;**– percentage of GPU being used.[\[1\]](docId\:bSC39hq98w9O0huBygRLN)&#x20;
   - **GPU Memory Threshold&#x20;**– percentage of GPU memory being used.
   - **GPU Decoder Threshold&#x20;**– percentage of GPU decoder pipeline being used.
   - **GPU Encoder Threshold&#x20;**– percentage of GPU encoder pipeline being used.
6. **Enable Real-time Broadcaster process priority&#x20;**- this setting is deselected by default. You can increase the Broadcaster's process priority by selecting it. This may be beneficial for sending streams to highly sensitive IRDs. However, this should not be done without consulting with your customer success agent. ZEN Master will expect a response form the external server, consisting of a JSON object. The following details need to be configured:
   - Server endpoint - an external authorization URL for the server endpoint.&#x20;
   - Optional authorization header schema and credentials to access the service.
7. If you would like to track usage for this Broadcaster, enter your **Billing Code** details, see [Billing Codes](docId\:lalXJ_N928TeGCPDpBirJ) . (Supported for Broadcasters v14.8+)
8. **External Authorization** - ZEN Master can, in addition to its standard internal authorization process, redirect the authorization of connections to an external service. For example, an external pay-per-view application, which confirms that a requesting end-device belongs to an account that has paid for a live event.&#x20;
   - Server endpoint - an external authorization URL for the server endpoint.
   - Optional Authorization header schema and credentials.
9. If you would like to install AgentZ automatically, select the **Install AgentZ automatically** checkbox. Agent Z is a Sidecar tool that sits on a Zixi Broadcaster, it acquires the system health data and other statistics locally and pushes it to ZEN Master. By enabling this option, ZEN Master will automatically install AgentZ on any existing and future Broadcasters connected to the Cluster. The feature is off by default. Due to AgentZ installation requiring a restart, ZEN Master will not auto-install AgentZ on a Broadcaster that already contains any inputs to avoid disturbing active streams.
10. Leave the **Inject Metadata** option checked to add metadata to packets that can be helpful in diagnosing issues with streams. This setting can be overridden on individual sources.
:::

:::WorkflowBlockItem
Click **Save**.
The new Broadcaster cluster is created in the system and added to the list of Broadcaster clusters. The status should change from *Pending* to *OK* after a few minutes.
:::
:::::

### Notes

1. The GPU thresholds are only relevant for transcoding workflows using Intel Quick Sync or NVIDIA GPUs.

## Parameters for Linode Clusters

| **Parameter**          | **Description**                                                                         |
| ---------------------- | --------------------------------------------------------------------------------------- |
| Region                 | Select from the drop-down list the location of the account to be used for this cluster. |
| Instance Size          | Allocate the space needed in the Linode for ZEN Master                                  |
| Image                  | Select from the drop-down list a image that is available for this cluster.              |
| Network Security Group | Select from the drop-down list a network security group for this cluster.               |
| Activation Key         | Activation Key for your Broadcaster                                                     |
| API User               | API user for your Broadcaster (probably "Admin")                                        |
| API Key                | API Key for your Broadcaster, matching the API user                                     |

### Parameters for All Clusters

| **Parameter**                                                                      | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ***Info***                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Name                                                                               | Specify the name of the Broadcaster Cluster in ZEN Master.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Tags                                                                               | Select one or more of the predefined Tags from the drop-down list.<br />Tags are used for access control. By selecting an Tag, you are relating this Broadcaster Cluster 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](docId\:YpM9tw81ap6nq8sTKv4Rd) .                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Events Configuration Profile                                                       | Select from the dropdown list the profile that you would like to apply to this Cluster. By default, the *Default&#x20;*&#x70;rofile is applied.<br />Note: *Events Profiles* consist of a series of rules that determine precisely how various types of Events are logged and what results they trigger.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| DNS Prefix                                                                         | Specify a unique domain name for sending Sources to this cluster.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| IP Whitelist                                                                       | Select this checkbox if you would like to control access to this cluster by limiting access to Push inputs and Pull outputs to specific IP address (for an AWS cluster this will enable you to control the AWS security groups).<br />Note: If you select **IP Whitelist**, then you must use ZEN Authorization mode for this cluster.<br />Note: If you selected **IP Whitelist** then after configuring the Broadcaster Cluster you must input the IPs that will have access to this cluster, see [Adding IPs to the Whitelist](docId\:RicoDzjUvWVliz6i2QTgX) .                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| DTLS                                                                               | Select this checkbox if you would like to encrypt the stream dynamically using DTLS. (This feature is supported for v12.2+ Broadcasters)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Ignore DTLS certificate when not supported (for DTLS)                              | Select this checkbox if you would like to enable resources using older versions of Zixi software (\<v12.2) that don't support verification of the ZEN DTLS certificate to connect to this cluster.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Load Balance Pull Targets                                                          | Select one of the following load balancing methods for Pull outputs:<br />- **Minimize the number of broadcasters** (default) – transfers excess load to other broadcasters only when the allotted capacity on the host broadcaster is filled.<br />- **Uniform distribution** – distributes the load equally between all available broadcasters under all circumstances.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Log SCTE-35                                                                        | Select this checkbox if you would like to log SCTE-35 markers for streams in this cluster.<br />Note: To log SCTE-35 markers, SCTE-35 needs to be enabled both on the Ingest Cluster and in the Source configuration.<br />Note: SCTE-35 logging is only available for v13.1.40262+ Broadcasters.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| RTMP Servers                                                                       | Select this checkbox if you need to receive RTMP push inputs.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| RTMP Server Port                                                                   | Specify the port in the Broadcaster that will be used to receive the RTMP push inputs.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Inject Metadata on Inputs                                                          | Allows Zixi create a PID that carries information about what hops a feed has travelled through on the way to its destination, it includes things like CC errors and IAT at each hop. The information is useful for debugging issues with streams.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ***Configuration (for Manual)***                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Management Type                                                                    | Select **Manual.&#x20;**&#x41;fter creating a manual Broadcaster cluster, you must configure each Broadcaster instance for use in the cluster. To do this, see [Adding a Broadcaster to a Manual Cluster](docId\:xYscySO498lY77ZjQr-51) .                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Authorization Mode                                                                 | Select one of the following options:<br />- **ZEN Master** – ZEN Master automatically verifies the authorization for each ZEN entity (e.g. Sources, Channels and Targets) that accesses the Broadcaster cluster. If you would like to allow access to inputs/outputs that are not configured in ZEN Master, then in the **Allow access…** section, select the **Push Inputs** and/or **Pull Outputs**<br />- **Global Password&#x20;**– Broadcasters are automatically configured to authorize all connections using a single global password. The global password will be used in the Source Password field when you configure a Source. In the **Password** field, enter the password OR click **Random&#x20;**&#x74;o generate a random password.<br />- **Free for All&#x20;**– Broadcasters will be automatically configured to allow all inputs/outputs to connect. Select **Inputs** and/or **Outputs** to automatically allow them to connect.<br />- **Manual** – ZEN will not authorize connections. You will need to authorize each connection independently.<br />Note: All authorization modes other than *Manual* will override the authorization configured on your Broadcasters. Therefore, if you have streams on your Broadcasters that are not configured on ZEN Master, then any mode other than *Manual* or *Free for All* may interrupt those streams. |
| Allow access to inputs not configured in ZEN Master (for ZEN Master Authorization) | Select the **Push Inputs** checkbox if you would like to automatically allow access to Push Inputs. Select the **Pull Outputs** checkbox if you would like to automatically allow access to Pull Outputs.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Termination Protection                                                             | Select the **Deletion protection** checkbox if you want to prevent deletion of the Broadcaster Cluster.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |