Clustering

OvenMediaEngine supports clustering and ensures High Availability (HA) and scalability.
OvenMediaEngine supports the Origin-Edge structure for cluster configuration and provides scalability. Also, you can set Origin as Primary and Secondary in OvenMediaEngine for HA.
Origin-Edge Configuration
The OvenMediaEngine running as edge pulls a stream from an external server when a user requests it. The external server could be another OvenMediaEngine with OVT enabled or another stream server that supports RTSP. 
The OVT is a protocol defined by OvenMediaEngine to relay stream between Origin-Edge and OVT can be run over SRT and TCP. For more information on the SRT Protocol, please visit the SRT Alliance site.
Origin 
OvenMediaEngine provides OVT protocol for passing streams from the origin to the edge. To run OvenMediaEngine as Origin, OVT port, and OVT Publisher must be enabled as follows :
1
<Server version="5">
2
	<Bind>
3
		<Publishers>
4
			<OVT>
5
				<Port>9000</Port>
6
			</OVT>
7
		</Publishers>
8
	</Bind>
9
	<VirtualHosts>
10
    		<VirtualHost>
11
		    	<Applications>
12
				<Application>
13
					...
14
					<Publishers>
15
						<OVT />
16
					</Publishers>
17
				</Application>		
18
			</Applications>
19
		</VirtualHost>
20
	</VirtualHosts>
21
</Server>
Copied!
Edge
The role of the edge is to receive and distribute streams from an origin. You can configure hundreds of Edge to distribute traffic to your players. As a result of testing, a single edge can stream 4-5Gbps traffic by WebRTC based on AWS C5.2XLarge. If you need to stream to thousands of people, you can configure and use multiple edges.
The edge supports OVT and RTSP to pull stream from an origin. In the near future, we will support more protocols. The stream pulled through OVT or RTSP is bypassed without being encoded. 
In order to re-encode the stream created by OVT and RTSP, the function to put into an existing application will be supported in the future.
To run OvenMediaEngine as Edge, you need to add Origins elements to the configuration file as follows:
1
<VirtualHosts>
2
	<VirtualHost>
3
		<Origins>
4
			<Properties>
5
				<NoInputFailoverTimeout>3000</NoInputFailoverTimeout>
6
				<UnusedStreamDeletionTimeout>60000</UnusedStreamDeletionTimeout>
7
			</Properties>
8
			<Origin>
9
				<Location>/app/stream</Location>
10
				<Pass>
11
					<Scheme>ovt</Scheme>
12
					<Urls><Url>origin.com:9000/app/stream_720p</Url></Urls>
13
				</Pass>
14
				<ForwardQueryParams>true</ForwardQueryParams>
15
			</Origin>
16
			<Origin>
17
				<Location>/app/</Location>
18
				<Pass>
19
					<Scheme>OVT</Scheme>
20
					<Urls><Url>origin.com:9000/app/</Url></Urls>
21
				</Pass>
22
			</Origin>
23
			<Origin>
24
				<Location>/</Location>
25
				<Pass>
26
					<Scheme>RTSP</Scheme>
27
					<Urls><Url>origin2.com:9000/</Url></Urls>
28
				</Pass>
29
			</Origin>
30
		</Origins>
31
	</VirtualHost>
32
</VirtualHosts>
Copied!
The <Origin>is a rule about where to pull a stream from for what request. 
The <Origin>has the ability to automatically create an application with that name if the application you set in <Location> doesn't exist on the server.  If an application exists in the system, a stream will be created in the application.
The automatically created application by <Origin> enables all providers but if you create an application yourself, you must enable the provider that matches the setting as follows.
1
<VirtualHosts>
2
	<VirtualHost>
3
		<Origins>
4
			<Properties>
5
				<NoInputFailoverTimeout>3000</NoInputFailoverTimeout>
6
				<UnusedStreamDeletionTimeout>60000</UnusedStreamDeletionTimeout>
7
			</Properties>
8
			<Origin>
9
				<Location>/this_application/stream</Location>
10
				<Pass>
11
					<Scheme>OVT</Scheme>
12
					<Urls><Url>origin.com:9000/app/stream_720p</Url></Urls>
13
				</Pass>
14
				<ForwardQueryParams>true</ForwardQueryParams>
15
			</Origin>
16
			<Origin>
17
				<Location>/this_application/rtsp_stream</Location>
18
				<Pass>
19
					<Scheme>RTSP</Scheme>
20
					<Urls><Url>rtsp.origin.com/145</Url></Urls>
21
				</Pass>
22
			</Origin>
23
		</Origins>
24
		<Applications>
25
			<Application>
26
				<Name>this_application</Name>
27
				<Type>live</Type>
28
				<Providers>
29
					<!-- You have to enable the OVT provider 
30
					because you used the ovt scheme for configuring Origin. -->
31
					<OVT />
32
					<!-- If you set RTSP into Scheme, 
33
					you have to enable RTSPPull provider -->
34
					<RTSPPull />
35
				</Providers>
36
		
Copied!
<Properties>
NoInputFailoverTimeout (default 3000)
NoInputFailoverTimeout is the time (in milliseconds) to switch to the next URL if there is no input for the set time.
UnusedStreamDeletionTimeout (default 60000)
UnusedStreamDeletionTimeout is a function that deletes a stream created with OriginMap if there is no viewer for a set amount of time (milliseconds). This helps to save network traffic and system resources for Origin and Edge.
<Origin>
For a detailed description of Origin's elements, see:
Location
Origin is already filtered by domain because it belongs to VirtualHost. Therefore, in Location, set App, Stream, and File to match except domain area. If a request matches multiple Origins, the top of them runs.
Pass
Pass consists of Scheme and Url. 
<Scheme> is the protocol that will use to pull from the Origin Stream. It currently can be configured as OVTor RTSP. 
If the origin server is OvenMediaEngine, you have to set OVTinto the <Scheme>. 
You can pull the stream from the RTSP server by setting RTSPinto the<Scheme>. In this case, the <RTSPPull> provider must be enabled. The application automatically generated by Origin doesn't need to worry because all providers are enabled.
Urls is the address of origin stream and can consist of multiple URLs.
ForwardQueryParams is an option to determine whether to pass the query string part to the server at the URL you requested to play.(Default : true) Some RTSP servers classify streams according to query strings, so you may want this option to be set to false. For example, if a user requests ws://host:port/app/stream?transport=tcp to play WebRTC, the ?transport=tcp may also be forwarded to the RTSP server, so the stream may not be found on the RTSP server. On the other hand, OVT does not affect anything, so you can use it as the default setting.
​
Rules for generating Origin URL
The final address to be requested by OvenMediaEngine is generated by combining the configured Url and user's request except for Location. For example, if the following is set
1
<Location>/edge_app/</Location>
2
<Pass>
3
    <Scheme>ovt</Scheme>
4
    <Urls><Url>origin.com:9000/origin_app/</Url></Urls>
5
</Pass>
Copied!
If a user requests http://edge.com/edge_app/stream, OvenMediaEngine makes an address to ovt: //origin.com: 9000/origin_app/stream.
Load Balancer
When you are configuring Load Balancer, you need to use third-party solutions such as L4 Switch, LVS, or GSLB, but we recommend using DNS Round Robin. Also, services such as cloud-based AWS Route53, Azure DNS, or Google Cloud DNS can be a good alternative.
AdmissionWebhooks (beta)
Thumbnail
Last modified 3mo ago
Export as PDF
Copy link
Contents
Origin-Edge Configuration
Origin
Edge
Rules for generating Origin URL
Load Balancer