Configure Wowza Streaming Engine™ media server software to recieve an encoded live stream from an RTSP/RTP-based source and play the live stream over all supported streaming protocols.
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.
- On the Setup tab of the live application page, make sure all Playback Types are selected.
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 RTSP Sources, select Require password authentication.
- Select one of the options for Client Restrictions. Restricting source publishing to specific IP addresses or blocking source publishing from specific IP address is recommended for security purposes. See Secure incoming sources for more information about these options.
- Click Save and then restart the application.
The application runs whenever Wowza Streaming Engine is running.
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 HLS and MPEG-DASH streaming. The XML looks like this:
- Set the <LiveStreamPacketizers> property for HLS and MPEG-DASH streaming. The XML looks like this:
<Streams> ... <LiveStreamPacketizers>cupertinostreamingpacketizer,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 RTSP/RTP 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 – rtsp://[wowza-ip-address]:1935/live
- Stream Name – myStream
- User – publisherName
- password – [password]
Note: See the documentation for your source encoder for help configuring it. If your encoder requires authentication, add the credentials before the IP address. Credentials can contain alphanumeric, period (.), underscore (_), and hyphen (-) characters. Other characters must be URL-encoded (percent-encoded).
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.
To test playback, you need the playback URLs for your stream and the playback types, or streaming protocols, you want to test. You can get playback URLs from the Test Playback window in Wowza Streaming Engine Manager or by entering information about the stream on the Video Test Players webpage. For more information about playback URLs, see About playing Wowza Streaming Engine streams.
The Test Playback window generates playback URLs for each protocol based on the page you're on when you click Test Playback. You can also edit the Server (IP address or domain name), Stream or Media File Name, and Application fields to update the playback URLs for all protocols as needed.
To play your stream, enter the playback URL into your player or a mobile browser, depending on the playback type. To learn more about stream playback, see the Players and Playback articles.
You can also test playback using the Video Test Players webpage. Select the tab for the protocol you want to test and enter the playback URL above the player. Entering the server (IP address or domain name), stream name, application name, and application type (VOD or live) will also generate the playback URLs for each protocol. Click Start to play your stream, and then click Stop when you're ready to end your test.