• How to set up live stream repeater edge for Apple HTTP Live Streaming (cupertinostreaming)

    Note: This article is for an older Wowza™ product or technology that either has been updated or is no longer supported. For the current version of this article, see How to configure a live stream repeater.
    Live stream repeater is a method for delivering a single live stream across a multiple server deployment to many viewers. The setup uses an origin/edge configuration where the source stream is published to an origin server and the stream is made available for playback on multiple edge servers. This article provides instructions for setting up the live stream repeater edge to stream a live stream to Apple iOS devices.

    Note: iOS version 3.0 or greater is required.

    Live Stream Repeater (Cupertino Streaming)

    1. Download and install Wowza Media Server 2.1.2 or greater on the origin server and all edge servers.
    2. Configure the origin server (for more information, see How to configure a live stream repeater). You should use an application with StreamType set to 'live' or 'rtp-live' (or a variant).
    3. Create a new Wowza Media Server application on each of the edge servers:
      1. Create the folder [install-dir]/applications/liveedge.
      2. Create the folder [install-dir]/conf/liveedge and copy the [install-dir]/conf/Application.xml file to this new folder.
      3. Open the newly copied Application.xml file in a text editor and make the following changes:
        • Change the Streams/StreamType value to liverepeater-edge.
          <StreamType>liverepeater-edge</StreamType>
        • Set the Streams/LiveStreamPacketizers value to cupertinostreamingrepeater.
          <LiveStreamPacketizers>cupertinostreamingrepeater</LiveStreamPacketizers>
        • Set the Repeater/OriginURL value as follows:
          <Repeater>
          	<OriginURL>wowz://[origin-ip-address]/live</OriginURL>
          </Repeater>
          Where [origin-ip-address] is the ip address of the origin server.
    4. Start Wowza Media Server.
    5. Send the stream to the origin server or use Stream Manager to start the stream on the origin server.
    6. To play the stream on an iOS device, open the Safari web browser and create a new bookmark with the following URL:
      http://[edge-ip-address]:1935/liveedge/[stream-name]/playlist.m3u8
      Where [edge-ip-address] is the IP address of one of the edge servers running Wowza Media Server and [stream-name] is the name of the live stream being sent to the origin server.


    Note: For redundancy, you can define multiple origin servers for a single stream by specifying two origin URLs separated by the pipe character (|) character. For example:
    <Repeater>
    	<OriginURL>wowz://[origin1-ip-address]/live|wowz://[origin2-ip-address]/live</OriginURL>
    </Repeater>

    Note: The above setup defines a single origin server per-application. Each stream that is played through that application will use the Repeater/OriginURL value to locate the origin server for that stream. You can also configure per-stream routing by using stream names that include the full path to the source stream. This must be done using either the StreamNameAlias package or .stream files. For example, to use this method to repeat the stream wowz://[origin-ip-address]/live/_defininst_/myStream using the .stream file method, you would create the file [install-dir]/content/myStream.stream on each of the edge servers with the content:
    wowz://[origin-ip-address]/live/_definst_/myStream
    Where [origin-ip-address] is the ip address of the origin server.

    On the iOS device, you would then use the following URL to play the stream:
    http://[edge-ip-address]:1935/liveedge/myStream.stream/playlist.m3u8

    Note: If you have configured the stream for secure delivery on the origin by following the instructions in How to secure Apple HTTP Live Streaming (AES-128, external method), then the streams sent between the origin and edge servers will be encrypted and the streams delivered from the edge to the iOS devices will be encrypted. The key URL defined for the stream at the origin will be used on all edges.

    Note: The WOWZ™ protocol is a new TCP-based messaging protocol in Wowza Media Server 3.5 and is used for server-to-server communication. It's enabled by default. If one of the Wowza Media Servers in the origin/edge configuration isn't running Wowza Media Server 3.5, an RTMP connection will be established between the servers instead.