v3_EN_OriginCluster

HOME > EN(3.0) > OriginCluster

OriginCluster

Design

About the design of Origin Cluster, please read the Issue#464.

Remark: Origin cluster only supports RTMP, use Edge to transmux RTMP to FLV.

Config

The config for origin cluster:

vhost __defaultVhost__ {
    # The config for cluster.
    cluster {
        # The cluster mode, local or remote.
        #       local: It's an origin server, serve streams itself.
        #       remote: It's an edge server, fetch or push stream to origin server.
        # default: local
        mode            local;

        # For origin(mode local) cluster, turn on the cluster.
        # @remark Origin cluster only supports RTMP, use Edge to transmux RTMP to FLV.
        # default: off
        # TODO: FIXME: Support reload.
        origin_cluster      on;

        # For origin (mode local) cluster, the co-worker's HTTP APIs.
        # This origin will connect to co-workers and communicate with them.
        # please read: https://github.com/ossrs/srs/wiki/v3_EN_OriginCluster
        # TODO: FIXME: Support reload.
        coworkers           127.0.0.1:9091 127.0.0.1:9092;
    }
}

• mode: The mode of cluster, it should be local for origin cluster.
• origin_cluster: Whether enable origin cluster.
• coworkers: The HTTP APIs of other origin servers in the cluster.

Remark: When the origin server serves a client, a player or edge server, it would query the coworkers when it does not own the stream. The HTTP API response message includes fields for whether owns the stream, and stream information. If the stream exists in other origin, it will redirect the client to that origin by RTMP302. Server response error when stream does not exist in any origin server.

Usage

To use origin cluster, please read #464.

We also recommend to use a edge server please read here. The edge server can transmux RTMP to HTTP-FLV, supports fault-tolerance.

2018.02