Wowza Streaming Engine

README


Version: Wowza Streaming Engine 4.5.0

Wowza Streaming Engine™, formerly Wowza Media Server™, is robust, customizable, and scalable media server software that powers reliable streaming of high-quality video and audio to any device, anywhere.


New Features and Functionality

New Stream Target destinations and capabilities

New destinations: Facebook, SHOUTcast, and Icecast

The Stream Targets feature in Wowza Streaming Engine enables you to send live streams to content delivery networks (CDNs), streaming servers, streaming services, and multicast networks for distributed delivery. The destination distributes your live stream, enabling you to scale your Streaming Engine implementation, computing resources, and delivery options for a variety of scenarios. Wowza Streaming Engine 4.5.0 has new destination options that enable you to send live video streams to Facebook and live audio-only streams to SHOUTcast and Icecast servers. For more information, see How to stream to Facebook Live and How to stream to SHOUTcast and Icecast.

Akamai: Apple HLS ingest and egress over HTTPS

On the Akamai HD network, you can configure endpoints that ingest and deliver all content over HTTPS. Wowza Streaming Engine 4.5.0 has new properties for Apple HLS destination options that take advantage of this capability for Apple HLS streams. You can configure a property to send Apple HLS streams to the Akamai HD network over HTTPS. You can also configure a property to specify that the Apple HLS playlist and chunks are delivered to players over HTTPS. For more information, see How to stream to the Akamai HD network.

Apple HLS delivery to generic stream target

Wowza Streaming Engine 4.5.0 also introduces the ability to create a generic stream target that receives an Apple HLS stream from Wowza Streaming Engine. This feature is aimed at developers who want to do the following:

For more information, see How to send Apple HLS streams to a generic destination.

New integrated live sources from our Works with Wowza partners

Wowza Streaming Engine software has integrated publishing options that simplify live streaming workflows. The Sources (Live) feature for live applications in Wowza Streaming Engine Manager enables you to deliver connection settings for the application to a variety of popular encoders and cameras.

Wowza Streaming Engine 4.5.0 adds Panasonic camcorders and PTZ cameras to its growing lineup of integrated encoders and cameras. For more information, see the following articles:

To see our entire lineup of encoders and cameras that are integrated with Wowza Streaming Engine software, see our Works with Wowza webpage.

New Media Cache source

The Media Cache feature in Wowza Streaming Engine is a read-through caching mechanism that increases the scalability of on-demand video streaming for your Wowza media server configuration. In this release of Wowza Streaming Engine software, we've increased the flexibility of Media Cache deployment options by adding Google Cloud Storage Buckets as a supported media cache source for media files. You can configure Wowza Streaming Engine Manager to request media files from a single bucket linked to a Google Cloud service account. For more information, see How to scale video on demand streaming with Media Cache.

WebM support for MPEG-DASH streams

Wowza Streaming Engine 4.5.0 supports the WebM file format and codecs. WebM streams are compressed with the VP8 and VP9 video codecs and the open-source Vorbis and Opus audio codecs. Your live applications in Wowza Streaming Engine can ingest WebM-encoded source streams or you can transcode an H.264-encoded source stream to the WebM format. For more information, see How to transcode live streams using WebM.

Note: The WebM file format and codecs were supported as a technology preview feature in previous versions of the Wowza Streaming Engine software. We recommend that you update the software to Wowza Streaming Engine 4.5.0 for the best results.
WebSocket server

The WebSocket is a protocol that provides full-duplex communication changes or a single TCP connection. WebSocket is supported by most modern web browsers and can be used with socket servers such as node.js. You can use a new HTTP Provider in Wowza Streaming Engine 4.5.0 to host WebSocket sessions. For more information, see How to create a WebSocket server.

SNMP server

Wowza Streaming Engine 4.5.0 adds support for Simple Network Management Protocol version 2c (SNMPv2c), a network management protocol that you can use to collect information about your Wowza Streaming Engine media server configuration. This lets you add your Wowza media servers to your SNMP-managed network and monitor status for different media server SNMP objects from your SNMP management system. For more information, see How to use SNMP in Wowza Streaming Engine.

APIs for monitoring and extracting live MPEG-TS stream data

MPEG-TS live streams can carry multiple streams of data including audio, video, closed captions, ad markers (SCTE-35, SCTE-104), key length value (KLV), and more. Each stream is identified by a packet indentifier (PID). Wowza Streaming Engine 4.5.0 includes an API for connecting a custom listener to the MPEG-TS ingestion process to insert PID monitors into the stream and a PID monitor API for extracting the stream data whenever data is available on a given PID. The code examples in How to monitor MPEG-TS ingestion to process additional data streams show how to add an MPEG-TS ingestion listener API and PID monitor API to your media server to extract additional stream data and implement a built-in monitor for SCTE-35 markers and KLV data. Listening to other types of MPEG-TS data is also possible using these APIs.

LATM encapsulation

In Wowza Streaming Engine 4.5.0, we added support for Low Overhead Audio Transport Multiplex (LATM) encapsulation of AAC over MPEG-2 transport streams.


System Requirements

Operating systems

Wowza Streaming Engine media server software can only be used on the following operating systems:

Install the Wowza Streaming Engine software on a clean operating system. Upgrading from a previous version of the software isn't supported. If you want to update your earlier version of Wowza Streaming Engine software to Wowza Streaming Engine 4.5.0, see How to update your Wowza Streaming Engine installation for instructions.

Note: To use the Transcoder feature in Wowza Streaming Engine, you must install the software on a 64-bit Windows or Linux operating system that has a 64-bit version of Java.
Java version

Wowza Streaming Engine is a Java application. The installation wizard for the Wowza Streaming Engine 4.5.0 software automatically installs a server version of the Java Runtime Environment (JRE) that is required by Wowza Streaming Engine, making it easier to get your media server up and running.

If you can't or don't want to use the version of Java that installs with the Wowza Streaming Engine software, you can use a different JRE. Wowza Streaming Engine software requires a JRE that supports deploying Java in server environments. Java 6, 7, and 8 are all supported but Java 8 is recommended. For information on how to install a different, supported version of Java and how to instruct the Wowza Streaming Engine installation to use it, see How to manually install and troubleshoot Java with Wowza Streaming Engine.

Browser support for Streaming Engine Manager

You can use Wowza Streaming Engine Manager with the latest versions of most modern web browsers that support HTML5 and Cascading Style Sheets level 3 (CSS 3). We recommend that you use the latest version of the Chrome browser for best results.

Note: Wowza Streaming Engine Manager was tested extensively using the Google Chrome web browser. Manager functionality and performance may vary on other web browsers. Browser updates that occur after this release of the Wowza Streaming Engine software may also impact functionality and performance and Wowza will work to address any new issues as quickly as possible.

Issues and Comments

Test Players

In Wowza Streaming Engine Manager, most application and feature pages have a Test Players button in the upper-right corner that provides access to built-in test players. The test players enable you to playback streams from your application to verify its configuration.

The MPEG-DASH, Adobe RTMP, Adobe HDS, MS Smooth, and Mobile test players have been tested and are supported on the Google Chrome web browser on all supported operating systems.

The Apple HLS test player has been tested and is supported on the Safari web browser on the OS X operating system.

If you run Wowza Streaming Engine Manager in a web browser where the test players aren't supported, they may not work or may not work as expected.

When using the test players, be aware of the following issues:

Tuning Wowza Streaming Engine

Wowza Streaming Engine software features automated tuning for the server and virtual hosts (VHosts), with the ability to manually adjust the settings as needed. The Java heap size, garbage collection (GC) settings, and thread counts are properly set on startup. To make adjustments to these and other settings, go to the Server > Performance Tuning page in Wowza Streaming Engine Manager.

Memory settings

If you encounter OutOfMemory errors while running the server, you may want to increase the maximum size of the Java heap. To do this, go to the Server > Performance Tuning > Java Settings page in Wowza Streaming Engine Manager.

Restarting Wowza Streaming Engine

You may need to restart the Wowza Streaming Engine instance to effect changes, for example to apply sign in credential changes for a user. The feature page will display a message with a Restart button if the server must be restarted for the changes to take effect. On Windows and OS X platforms, you can click the button to apply the changes; however, Linux users must restart the server using the standard Linux service control interface. To control the Wowza Streaming Engine instance from a command shell, type service WowzaStreamingEngine start | stop | restart.

Publishing to Wowza Streaming Engine

By default, the Wowza Streaming Engine software requires that RTMP-based and RTSP-based encoders that initiate connections to live applications provide a user name (source name) and password. You can set up and manage source credentials in Wowza Streaming Engine Manager on the Source Authentication page (click Server > Source Authentication). You can manage the authenticated connection requirement for live applications on the Source Security page (click Applications, click the live application name in the contents panel, and then click Source Security.)

Connecting over RTMPT or RTMPTE

Wowza Streaming Engine is configured to only listen on port 1935 by default. This is the default RTMP port. To connect to the server over RTMPT, go to the Server > Virtual Host Setup page in Wowza Streaming Engine Manager and update the Default Streaming host port setting to use port 80 or connect over RTMPT using port 1935 (example: rtmpt://localhost:1935/[application-name]).

JMX and the Windows service

The JMX interface isn't available unless the Wowza Streaming Engine 4.5.0 service is running as a named user. To configure the service to run as a named user, do the following:

  1. Go to Settings > Control Panel > Administrative Tools > Services.
  2. Right-click the Wowza Streaming Engine 4.5.0 service, and then select Properties.
  3. On the Log On tab, change the Log on as option to This account, and then enter a user name and password for a local user.
Wowza Transcoder hardware acceleration

When running on a Windows 64-bit OS, the Intel Quick Sync hardware acceleration used by Wowza Transcoder is only available when running Wowza Streaming Engine software as a standalone application. When running as a Windows service, the hardware acceleration isn't available due to driver accessibility restrictions and only software encoding is invoked.

Relocating Wowza Streaming Engine

OS X and Linux installers don't provide an option to choose where the base Wowza Streaming Engine files are installed. For OS X, the location is /Library/WowzaStreamingEngine-4.5.0. For Linux, the location is /usr/local/WowzaStreamingEngine-4.5.0. All of the server startup scripts locate the server files through a symbolic link named /Library/WowzaStreamingEngine (OS X) and /usr/local/WowzaStreamingEngine (Linux). If you relocate the base server files, be sure to update the symbolic link using the ln -sf command.

Example Applications

The Wowza Streaming Engine software includes example applications that highlight the server functionality. The examples are located in [install-dir]/examples. The [install-dir]/examples/README.html file describes the available examples and how to install them.

When you run the examples installation script, some example applications won't be installed if an application of the same type is already configured on the server. If you run the examples installation script while Wowza Streaming Engine Manager is running, you must restart the server after the installation is completed (in Wowza Streaming Engine Manager, click Server > Server Setup > Restart). To view the installed example applications, click the Applications tab in the manager.

Documentation

All Wowza Streaming Engine documentation can be found in the User Guides and List of All Articles webpages.

Here are a few direct links to help you get started using the Wowza Streaming Engine software:

Support

Support is available in the following ways: