• How to stream to another Wowza Streaming Engine instance

    The Stream Targets feature in Wowza Streaming Engine™ live streaming software allows you to send live streams to widely distributed destinations. For example, you can send a live stream from one Wowza Streaming Engine software instance to a second server running Wowza Streaming Engine software. This gives you flexibility in expanding and scaling your Streaming Engine implementation, computing resources, and delivery options.

    This article explains how to configure two Wowza Streaming Engine servers so that you can send a live stream from one to the other over RTMP. To do so, you create a live application in each server instance, and send the stream from the first instance to the second by using the Stream Targets feature.

    If you're using Wowza Transcoder to transcode multiple bitrates, you can enable the Transcoder on the first Wowza Streaming Engine instance and send the adaptive bitrate set of streams to a target application on a second Wowza Streaming Engine instance by creating a stream target for each rendition.

    You also have the option to transcode on the target application. Your first Wowza Streaming Engine instance can ingest one high bitrate stream and send it to the target application for which Transcoder enabled. This configuration is useful for distributing the transcoding workload and where uplink bandwidth to the source instance is limited.

    Note: Wowza Streaming Engine 4.2 or later is required. In earlier versions of Wowza media server software, you must use the Push Publishing module to send a live stream to another Wowza media server for distributed delivery.

    Contents


    Configure a target application to receive and distribute the stream
    Create a source application to ingest the live source video
    Create a stream target to send the stream to the target application
    Enable Stream Targets
    Test the connection
    More resources

    Configure a target application to receive and distribute the stream


    Start by creating a live target application on the Wowza Streaming Engine instance that will deliver the live stream for final viewing.

    1. Sign in to Wowza Streaming Engine manager, click the Applications tab at the top of the page, and then click live in the contents panel.

    2. Click Copy in the upper-right corner of the live application detail page.

    3. In the Copy Application dialog box, name the copy liveTarget and then click OK.


    Create a source application to ingest the live source video


    Next, create a live application that will ingest the live stream from an H.264 live encoder or camera. This live application on the source Wowza Streaming Engine instance will send the stream to the liveTarget application on the target Wowza Streaming Engine instance.

    1. Sign in to Wowza Streaming Engine manager, click the Applications tab at the top of the page, and then click live in the contents panel.

    2. Click Copy in the upper-right corner of the live application detail page.

    3. In the Copy Application dialog box, name the copy liveSource and then click OK.

    4. In the contents panel, click Sources (Live).

    5. Select the camera or encoder that you want to use as your video source, and complete the steps to connect it to Wowza Streaming Engine. For more information, see How to connect a live source to Wowza Streaming Engine.

      Note: By default, Wowza Streaming Engine requires RTMP and RTSP sources to provide a user name and password to connect to a live application. For information on how to turn off authentication, see Managing live source authentication settings.

    Create a stream target to send the stream to the target application


    After the source application is created, it must be configured to send the stream to the target application. Give the liveSource application the details of your liveTarget application so Wowza Streaming Engine can send the stream there.

    1. In the contents panel, click Stream Targets and then click Add Stream Target.

    2. On the Select Destination page, select Wowza Streaming Engine and then click Next.

    3. On the Destination Options page, click Next. Wowza Streaming Engine will send the stream over RTMP to the liveTarget application on the second Wowza Streaming Engine instance.

    4. On the Configure Target page, provide the following information:

      • Stream Target Name - A descriptive name for this target setup in Wowza Streaming Engine. The name must be unique and can't contain less-than (<), greater-than (>), colon ( : ), quotation (' and "), forward slash (/), backslash (), pipe (|), question mark (?), asterisk (*), double-dot (..), or tilde (~) characters.

      • Source Stream Name - The name of the incoming stream that you specified in Wowza Streaming Engine when you set up the video source.

      • Destination Application Name - The name of the application in the second Wowza Streaming Engine instance. In this article, it's liveTarget.

      • Destination Application Instance - The name of the application instance in the second Wowza Streaming Engine instance. Leave blank to send the stream to the default application instance (_definst_).

      • Destination Host - The hostname or IP address of the second Wowza Streaming Engine instance. You can find this information the Connection Settings panel on the Wowza Streaming Engine Manager Home page.

      • Destination Port - The port number for your connection. RTMP connections use port 1935 by default.

      • Destination Stream Name - The destination stream name.

      • User Name and Password - The user name and password required to connect to the liveTarget application.

        Note: By default, Wowza Streaming Engine requires live encoders to provide a user name and password to connect to a live application. The liveSource application is acting as an H.264 live encoder in this workflow, so the liveTarget application authenticates the liveSource application by default. For information on how to turn off authentication in the liveTarget application, see Managing live source authentication settings.
    5. Click Finish.

    Note: If you're using the Wowza Transcoder in the source application, you must create a stream target for each rendition. Repeat the steps above in Create a stream target to send the stream to the target application for each rendition that you want to send to the target for adaptive bitrate playback. The easiest way to do this is to create the first stream target, click the Copy icon for the target, and change the Stream Target Name, Source Stream Name, and Destination Stream Name in the new target. For clarity, we recommend including the bitrate in the Stream Target Name.

    Then, for each stream target you create, set the stream target Adaptive Streaming property to true. To do this:

    1. On the Stream Targets page, click the Edit icon for the stream target.

    2. On the Advanced tab, click Edit. Access to the Advanced tab is limited to administrators with advanced permissions. For more information, see Manage credentials.

    3. Set Adaptive Streaming to true, and then click Save.

    To enable playback of the adaptive bitrate set of streams on the target Wowza Streaming Engine instance, you must describe the bitrates that are available to players in a Synchronized Multimedia Integration Language (SMIL) file. For details, see How to do adaptive bitrate streaming.

    For details on configuring the Wowza Transcoder, see How to set up and run Wowza Transcoder for live streaming.

    Enable Stream Targets


    Before you stream, make sure to enable the Stream Targets feature for the liveSource application you created.

    If you don't see a checkmark next to Stream Targets in the contents panel of the application, click Stream Targets in the contents panel and then click Enable Stream Targets. When prompted, click Restart Now so your change takes effect. When Stream Targets is enabled, a checkmark appears next to Stream Targets in the contents panel and the Stream Targets page shows Status is Enabled.



    If the Status of an individual stream target is Disabled, click the Enable icon for the stream in the Actions column.



    When a stream target is enabled, its status on the Stream Targets page is one of the following:

    • Waiting. The target is enabled but is not yet pushing the stream to the target Wowza Streaming Engine destination because either the target's configured source stream isn't connected to the source Wowza Streaming Engine input or the source Wowza Streaming Engine instance has not completed initializing the connection to the target Wowza Streaming Engine instance.

    • Active. The source Wowza Streaming Engine instance successfully connected to the target Wowza Streaming Engine destination and is actively pushing the stream.

    • Error. The source Wowza Streaming Engine instance unsuccessfully tried to connect to the target Wowza Streaming Engine destination. Make sure the target's configured source stream is connected to the Wowza Streaming Engine input. Errors might be due to an invalid target configuration or issue with the destination server.

    The status of each stream target updates automatically if your Wowza Streaming Engine application has fewer than 100 stream targets. If your application has more than 100 stream targets, you can click Refresh to update the status.

    Test the connection


    Configure your encoder and then test the live stream.

    1. Start the stream in the H.264 camera or encoder that's publishing to the liveSource application in your first instance of Wowza Streaming Engine.

      The liveSource application ingests the stream and sends it to the liveTarget application on your second Wowza Streaming Engine instance.

    2. In both the liveSource application and the liveTarget application, verify that the stream is working by clicking Incoming Streams in the contents panel in Wowza Streaming Engine Manager, and then clicking the stream name.

      The stream details page displays the Status of the stream (Active) as well as details about connections, uptime, and throughput for the live stream.

    3. Click Stop Stream at the top of the live stream detail page to end your test stream, and then stop the stream in the source camera or encoder.

    More resources




    Originally Published: 06-16-2015.
    Updated: For Wowza Streaming Engine 4.4 on 02-02-2016.

    If you're having problems or want to discuss this article, post in our forum.