• How to reconnect to offline streams (Native RTP, MPEG-TS, RTSP/RTP, SHOUTcast/Icecast)

    If you have native RTP or MPEG-TS streams that go offline frequently, you can configure Wowza™ media server software to monitor the streams and reconnect when they become available.

    You can configure application properties in Wowza Streaming Engine™ Manager or by editing [install-dir]/conf/[application]/Application.xml. If you make changes to Application.xml and you're using Wowza Streaming Engine media server software, any supported settings are displayed in the manager the next time it's started. Wowza Media Server™ software doesn't support Wowza Streaming Engine Manager, so you must edit Application.xml in a text editor if you're running Media Server software.

    Wowza Streaming Engine Manager configuration


    To monitor a temporarily offline stream in Wowza Streaming Engine Manager:

    1. In the manager Welcome page, click the Applications tab at the top of the page.

    2. In the Applications contents panel, click the name of your live application (such as live).

    3. On the live application page Properties tab, click MediaCaster Stream Monitor in the Quick Links bar.

      Note: Access to the Properties tab is limited to administrators with advanced permissions. For more information, see Manage credentials.
    4. Click Edit in the MediaCaster Stream Monitor properties area, select the Enabled check box next to streamTimeout, and then change the default value if desired. This property sets the time (in milliseconds) that the server waits until trying to reconnect to a stream that goes offline.

    5. Click Save, and then restart the application when prompted to apply the changes.

    XML configuration


    To monitor a temporarily offline stream in Application.xml:

    1. Use a text editor to open the [install-dir]/conf/[application]/Application.xml file for your live application and add the following property to the MediaCaster/Properties container. Be sure to add the properties to the correct <Properties> container in Application.xml as there are several such containers in the file.
      <Property>
          <Name>streamTimeout</Name>
          <Value>12000</Value>
          <Type>Integer</Type>
      </Property>
    2. Restart the Wowza media server software to apply the changes.

    In the above example, the server is set to monitor incoming streams and reconnect to a stream if it's offline for more than 12 seconds.


    Originally Published: 09-12-2013.
    Updated: For Wowza Streaming Engine 4.2 on 06-28-2015.

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