Configure Wowza Streaming Engine™ media server software to receive an encoded live stream from an RTMP-based source and play the live stream over all supported streaming protocols.
Video: Connect an RTMP encoder to Wowza Streaming Engine
Configure the live streaming application
Live streams are configured and managed in live applications in Wowza Streaming Engine. You can configure a live application in Wowza Streaming Engine Manager or by setting properties in the application's XML configuration file. Both methods produce the same result; editing Application.xml is the only option if you use Wowza Media Server™ software.
Configure the live application in Wowza Streaming Engine Manager
This example uses the default live application that installs with Wowza Streaming Engine.
You can use Wowza Streaming Engine Manager with the latest version of most web browsers that support HTML5 and Cascading Style Sheets level 3 (CSS 3). We recommend Google Chrome.
- In Wowza Streaming Engine Manager, click the Applications tab at the top of the page and then select the live application in the contents panel.
Start by enabling playback over all supported protocols: Adobe HDS, Adobe RTMP, Apple HLS, Microsoft Smooth Streaming, MPEG-DASH, and RTSP/RTP.
- On the Setup tab of the live application page, make sure all Playback Types are selected. If necessary, click Edit, select them all, and then click Save.
Note: Every time you edit an application's configuration, Wowza Streaming Engine prompts you to restart the application. However, you can wait until all changes are completed before you restart.
Next, disable playback authentication.
- In the contents panel, click Playback Security, and then click Edit.
- Under Client restrictions, select No client restrictions, and then click Save.
Next, enable source authentication for the encoder.
- In the contents panel, click Source Security, and then click Edit.
- On the Source Security page, under RTMP Sources, select Require password authentication.
- Under Client Restrictions, select No client restrictions.
- Click Save and then restart the application.
The application runs whenever Wowza Streaming Engine is running.
Note: For more information about securing source connections to live applications, see Configure security using Wowza Streaming Engine Manager.
You're almost done. To finish, configure the source user name and password to publish to the application.
- Click Server in the menu bar, click Source Authentication in the contents panel, and then click Add Source.
- Enter a Source User Name and Password, and then click Add.
Configure the live application in XML
This section shows you how to configure the live application by editing the Application.xml configuration file in a text editor. If you configured the live application in Wowza Streaming Engine Manager, skip this section.
- Navigate to [install-dir]/conf/live and open Application.xml in a text editor.
- In the <Streams> container element, make sure the <StreamType> property is live. The XML looks like this:
<Streams> ... <StreamType>live</StreamType> ... </Streams>
- Set the <HTTPStreamers> property for all supported HTTP streaming protocols. The XML looks like this:
- Set the <LiveStreamPacketizers> property for HDS, HLS, Microsoft Smooth Streaming, and MPEG-DASH streaming. The XML looks like this:
<Streams> ... <LiveStreamPacketizers>cupertinostreamingpacketizer,smoothstreamingpacketizer,sanjosestreamingpacketizer,mpegdashstreamingpacketizer</LiveStreamPacketizers> ... </Streams>
- In the <RTP> container element, make sure playback authentication is disabled by setting the <PlayMethod> property to none. The XML looks like this:
<RTP> <Authentication> ... <PlayMethod>none</PlayMethod> </Authentication> ... </RTP>
- Save your changes and close Application.xml.
- Navigate to [install-dir]/conf/ and open publish.password in a text editor.
- Add a source user name and password to control RTMP source access. Following is an example of the file with the source name publisherName and a password:
# Publish password file (format [username][space][password]) # username password publisherName [password]
- Save your changes and close publish.password.
- Restart Wowza Streaming Engine or Wowza Media Server.
Publish the source stream to Wowza Streaming Engine
In your encoder, enter the following application connection settings, and then click Publish or Start:
- Server URL – rtmp://[wowza-ip-address]/live
- Stream Name – myStream
- User – publisherName
- password – [password]
To verify that the stream is published, click Incoming Streams for the live application in Wowza Streaming Engine Manager, and then click the stream name. Uptime, network throughput, and other information about the published stream appear on the page.
In Wowza Streaming Engine Manager, click Test Players in the upper-right corner of the live application page.
Each tab in the Test Players window either hosts a test player that can play the live stream, or provides instructions for playing the live stream. The test players are preconfigured to stream the default live stream myStream.
For example, to test playback of the default stream myStream over Adobe HDS, make sure the encoder is sending a stream to the live application in Wowza Streaming Engine and that Adobe Flash is enabled in the browser you're using. Then, click the Adobe HDS tab and click Start.
You can also test your live stream by using the test players online on our Video Test Players webpage.