• How to get started as a Wowza Streaming Engine Manager administrator

    This guide will help you create and manage streaming apps and perform some basic administrative functions using Wowza Streaming Engine™ media server software.

    Contents


    Introduction
    Manage credentials
    Create applications
    Configure properties
    Configure modules
    Configure server listeners
    Configure streaming ports
    Add license keys
    Change the default log level
    Install example applications
    More resources

    Introduction


    Wowza Streaming Engine Manager enables you to easily set up, manage, monitor, and measure streams using a web browser on your computer, tablet, or phone. By extending programmatic and command-line configuration and management of the Wowza Streaming Engine software to a web-based user interface, publishers with a diverse range of technical abilities can have greater control and confidence when streaming video.

    Manage credentials


    The first time you start Wowza Streaming Engine Manager, you'll be asked to sign in with the case-sensitive user name and password that you created when you installed the Wowza Streaming Engine software. This account has administrator access to enable control of the Streaming Engine software through the manager, but it doesn't provide default access to the advanced server and applications settings that are configured on the Properties, Modules, and Server Listeners tabs of Wowza Streaming Engine Manager.



    After you sign in, you can enable access to the advanced settings for the default administrator account as well as add accounts for other users.

    Enable access to advanced administrative settings

    1. In Streaming Engine Manager, click the Server tab and then click Users in the contents panel.

    2. On the Users page, click the Edit icon for the user name for the administrator account.


    3. Select the Allow access to advanced properties and features check box.



    4. Click Save.

    Wowza Streaming Engine Manager signs you out and you must sign in to the manager again.

    Create user accounts

    New user accounts can have either administrative or read-only access to Wowza Streaming Engine Manager.

    1. In Streaming Engine Manager, click the Server tab and then click Users in the contents panel.

    2. On the Users page, click Add User.


    3. Specify a User Name, Password, Access Level, and Preferences for the user.

      • Enter the same value in the Password and Confirm Password fields. Remember, the user name and password are case-sensitive.

      • Give the user Read-Only or Administrator access to the Wowza Streaming Engine server.

      • Select Allow access to advanced properties and settings to give Administrator users the ability to edit advanced settings or give Read-Only users the ability to view advanced settings.


    4. Click Add.

    Create applications


    To begin using Wowza Streaming Engine, you must create an application. Wowza Streaming Engine supports three types of live applications and three types of video on demand (VOD) applications:

    • Live Single server or origin - Live single-server applications deliver live streams directly to players. Live origin applications deliver streams to other servers running Wowza Media Server™ or Wowza Streaming Engine, scaling delivery for a larger number of players. A default Live single-server or origin application is included in the Wowza Streaming Engine installation.

    • Live Edge - Live edge applications ingest live streams from an origin server that's running Wowza Media Server or Wowza Streaming Engine and deliver the live streams to players.

    • Live HTTP Origin - Live HTTP origin applications deliver live streams to an HTTP caching infrastructure using HTTP streaming protocols (MPEG-DASH, Apple HLS, Adobe HDS, and Microsoft Smooth Streaming).

    • VOD Single server - VOD single-server applications stream video on demand files to players. A default VOD single-server application is included in the Wowza Streaming Engine installation.

    • VOD Edge - VOD edge applications ingest video on demand files from a Media Cache source and stream the VOD files to players.

    • Live HTTP Origin - Live HTTP origin applications deliver live streams to an HTTP caching infrastructure using HTTP streaming protocols (MPEG-DASH, Apple HLS, Adobe HDS, and Microsoft Smooth Streaming).

    • VOD HTTP Origin - VOD HTTP origin applications deliver video on demand files to an HTTP caching infrastructure using HTTP streaming protocols (MPEG-DASH, Apple HLS, Adobe HDS, and Microsoft Smooth Streaming).

    Create a simple VOD application

    1. In Wowza Streaming Engine Manager, click the Applications tab and then click Add Application in the contents panel.

    2. On the Add Application page, click the VOD Single server button to select that application type.



    3. In the New Application dialog box, enter a name, such as myapplication, and then click Add.

      .


      The application details page shows that, by default, the VOD Single server application can be played on Adobe Flash Player; Apple iPhone, iPad, or iPod touch devices; Microsoft Silverlight; DASH players, and RTSP/RTP-based players.


    4. Click Save.

    Create other types of applications

    For instructions on creating other types of applications, see the following tutorials:


    Configure properties


    Properties provide a way to tune and modify the default application configuration. Properties can also be used by the server to pass data from applications to custom modules. In Wowza Streaming Engine Manager, you enable and add properties using the Properties tab of a feature or application detail page.

    Note: Access to the Properties tab requires an administrator user with advanced permissions.

    Enable default properties

    1. In the Streaming Engine Manager contents panel, click the server feature or application whose properties you want to configure.

    2. On the server feature or application details page, click the Properties tab.

    3. In the Quick Links bar, click the link for the correct property section.



    4. In the property section, click Edit.

    5. To enable a property, do either of the following:

      • Click the Enabled check box for the property and then select the option True for the property (if required).

      • Click the Enabled check box for the property and then specify an appropriate Value.

    6. Click Save and then restart the server or application.

    Add a custom property

    1. In the Streaming Engine Manager contents panel, click the server feature or application to which you want to add properties.

    2. On the Server Setup or the application details page, click the Properties tab.

    3. In the Quick Links bar, click Custom.

    4. In the Custom properties section, click Edit and then click the Add Custom Property button.

    5. In the Add Custom Property dialog box, specify property settings and then click Add.



    6. Click Save and then restart the server or application.

    Configure modules


    Modules are Java classes that load dynamically with an application and provide additional functionality. The Wowza Streaming Engine software includes several built-in, optional server-side modules; for descriptions, see the Wowza Streaming Engine User's Guide. In addition, a downloadable package of additional utility modules, called the Module Collection, is available on the Wowza Support site. Finally, many AddOn packages use modules for their functionality.

    You can see a list of an application's loaded modules on the Modules tab of the application page in Wowza Streaming Engine Manager. The modules load in the order they appear in the list--the module at the top of the list loads first; the module at the bottom of the list loads last. In general, new modules are added to the end of the list.

    Note: Access to the Modules tab requires an administrator user with advanced permissions.


    You can use the Wowza IDE to develop custom modules and then add them to Wowza Streaming Engine.

    To add a custom module to Wowza Streaming Engine, follow these steps:

    1. In Wowza Streaming Engine Manager, click the desired application in the contents panel.

    2. On the details page, click the Modules tab.

    3. Click Edit and then click the Add Module button.

    4. In the Add New Module dialog box, complete the required fields:

      • Name - Should be unique.

      • Description - Additional, useful information about the module. Not used in any operations.

      • Fully Qualified Class Name - The path to the Java class that provides the module's functionality. The Java class that makes up a server-side module is most often bound to a .jar file in the Streaming Engine software installation.



    5. Click Add.

    6. Click Save and then restart the application.

    Configure server listeners


    Server listeners are Java classes that provide notification of events that occur at the server level and extend server functionality.

    Server event listeners and VHost event listeners are called when events occur at the server or VHost level. Other event listeners can be invoked using API methods and are called when events occur that the listener is configured to listen for. Wowza also includes ready-to-use server listeners in its Module Collection.

    You can see a list of listener methods on the Server Listeners tab of the Server Setup page in Wowza Streaming Engine Manager. The methods are called in the order they appear in the list--the method at the top of the list is called first; the method at the bottom of the list is called last. The values that are specified by the last listener that's called are always used.

    Note: Access to the Server Listeners tab requires an administrator user with advanced permissions.


    The Fully Qualified Class Name is the path to the Java class that provides the server listener's functionality.

    Follow these steps to add a custom server listener:

    1. In Wowza Streaming Engine Manager, click the Server tab and then click Server Setup in the contents panel.

    2. On the details page, click the Server Listeners tab.

    3. Click Edit and then click the Add Server Listener button.

    4. In the Add Server Listener dialog box, specify the Base Class and then click Add.



    5. Click Save and then restart the server.

    Configure streaming ports


    Wowza Streaming Engine uses the following default ports for streaming:

    TCP 1935 RTMP/RTMPE/RTMPT/RTSP-interleaved streaming/WOWZ™
    TCP 8086-8088 Administration
    UDP 6970-9999 RTP UDP streaming

    If desired, you can configure additional ports for streaming in Wowza Streaming Engine Manager. Wowza Streaming Engine cannot share ports with other programs or services, so make sure that there are no other programs or services running that share the added ports. The following ports are also commonly used for streaming:

    TCP 80 Adobe HDS, Apple HLS, Microsoft Smooth Streaming, MPEG-DASH streaming, RTMPT
    TCP 443 RTMPS, HTTPS
    TCP 554 RTSP

    To add a port, follow these steps.

    1. In Wowza Streaming Engine Manager, click the Server tab and then click Virtual Host Setup in the contents panel.

    2. On the details page, click Edit, scroll down to the Host Ports section of the page, and click the Edit icon for the Default Streaming host port.


    3. Add the ports to the comma-delimited Port(s) list and click Apply.


    4. Click Save and then restart the server.

    Note: Make sure that the ports you use for streaming are open on your firewall. In many enterprise environments, you'll need the approval and the assistance of a network administrator to modify settings in the core router or firewall. In home or small-office environments, you may have to configure "port forwarding" traffic of the port you're using to the port and IP address of your server. For more information, see your router or firewall documentation.

    Add license keys


    The license key you enter when you run Setup to install an instance of Wowza Streaming Engine software is displayed in the License Keys box in Wowza Streaming Engine Manager. If you switch your licensing option for the Streaming Engine instance, you can replace the existing license key with the new license key without reinstalling the software. If you purchased license keys to enable the integrated Transcoder, nDVR, and DRM technologies for use with the licensed server instance, you can add these license keys. All license key values are stored in the [install-dir]/conf/Server.license file in the Wowza Streaming Engine installation.

    To add license keys in Wowza Streaming Engine Manager, do the following:

    1. Click the Server tab, and then click Server Setup in the contents panel.

    2. On the Server Setup page, click Edit.

    3. In the License Keys box, enter your license key for the Wowza Streaming Engine software. If you need to enter multiple license keys (for example, for the media server software and for the Wowza Transcoder, Wowza nDVR, and Wowza DRM technologies), enter each license key on a separate line.

    4. Click Save, and then click Restart Now at the top of the Server Setup page when prompted. The new license(s) take effect after the server is restarted.

    Note: After you restart the server, Wowza Streaming Engine Manager displays the first and last five digits of the license keys that you entered in the License Keys box to help protect this information.

    Pro Edition licenses for Wowza Streaming Engine

    Perpetual Pro Edition and Monthly Subscription Pro Edition licenses for Wowza Streaming Engine software provide for unlimited connections to the media server software instance and enable use of the Wowza Transcoder, Wowza nDVR, and Wowza DRM technologies that are integrated with each licensed instance.

    The Perpetual Pro Edition licensing option is best for stable, long-term demand. A Perpetual Pro Edition license key purchased after December 22, 2015 has an EPBP4 prefix and is for use with one Streaming Engine instance and the integrated Transcoder, nDVR, and DRM technologies.



    For licensing details, see Wowza Streaming Engine Perpetual Pro Edition pricing information.

    The Monthly Subscription Pro Edition license is best for variable demand. You can install as many instances of the Streaming Engine software as needed using the same license key and enable the Transcoder, nDVR, and DRM technologies integrated with each instance. A Monthly Subscription Pro Edition license key has an ENGM4 prefix.



    For Monthly Subscription Pro Edition pricing information, see Pay-as-you-go Monthly Billing.

    Notes:
    • If you purchased a Perpetual Pro Edition license for Wowza media server software before December 23, 2015, your license key has an EPBU4 prefix and it licenses the Streaming Engine software and the Wowza Transcoder and Wowza nDVR technologies. A separate license key is provided to enable the Wowza DRM technology integrated with the server instance (you don't have to enter the DRM license key in the License Keys box unless you want to enable this technology in the media server software).

    • If you purchased a license for Wowza media server software before January 1, 2015, contact sales@wowza.com to learn more about how to license the software.

    Trial Edition licenses for Wowza Streaming Engine

    A Trial Edition license for the Wowza Streaming Engine software expires after 180 days. When you acquire a new, paid license for the software, you must delete the Trial Edition license key from the License Keys box and then add the new, paid key. If you're not sure if a license key is a Trial Edition key, you can find it in the email that you received from Wowza when you downloaded the trial software.

    Note: You don't need to reinstall the media server software or re-create its settings when you replace the Trial Edition license key with a paid license for the software.

    Change the default log level


    Wowza Streaming Engine log files are written to [install-dir]/logs. The default logging level (INFO) enables monitoring and collects information to help troubleshoot most issues while adding minimal load to the server. When working with Wowza to troubleshoot an issue, you may be asked to temporarily turn on debug logging (increase the amount of information written to the logs). To do this, open [install-dir]/conf/log4j.properties in a text editor and change the log level on the first line from INFO to DEBUG. Debug logging shouldn't be used in a production environment due to its increased load on the server.

    Install example applications


    The Wowza Streaming Engine software includes example streaming applications that highlight the server functionality and to help you get started. The examples are located in [install-dir]/examples. After you install Wowza Streaming Engine, you can install the example streaming applications and configure the application settings in Wowza Streaming Engine Manager.

    1. Install the example files following the instructions for your operating system:

      • (Windows) In Windows Explorer, click Start > All Programs (or All Apps) > Wowza Streaming Engine 4.5.0 > Examples. Then, double-click installall.bat.
      • (OS X) In the Finder, go to /Library/WowzaStreamingEngine-4.5.0/examples/ and double-click installall.command.
      • (Linux) Enter the following commands in a terminal window:
        cd /usr/local/WowzaStreamingEngine-4.5.0/examples
        ./installall.sh
      Note: The default installation of Wowza Streaming Engine includes fully functional live and vod applications, so live and vod example applications aren't installed.

    2. Go to the Server Setup page in Streaming Engine Manager and click Restart Server in the upper-right corner of the page. Then, click the Applications tab in the manager to see the installed example applications in the contents panel.


    Notes:
    • You may need to refresh the Streaming Engine Manager browser page to see the example applications in the contents panel.

    • See the README.html file located at [install-dir]/examples/README.html for more information about the example applications.

    More resources




    Originally Published: 08-11-2014.
    Updated: For Wowza Streaming Engine 4.5.0 on 06-23-2016.

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