• How to install and configure Wowza Streaming Engine

    This guide will help you to download, install, and configure Wowza Streaming Engine™ 4.0.6 software for live and video on demand (VOD) streaming.

    Contents


    Introduction
    Install Java
    Download and install Wowza Streaming Engine
    Start the software
    Perform a streaming test
    Next steps

    Introduction


    Wowza Streaming Engine (formerly known as Wowza Media Server®) is a high-performance, extensible, and fully interactive media streaming software platform that provides live and on-demand streaming, chat, and remote recording capabilities to a wide variety of media player technologies. One of the benefits of Wowza Streaming Engine is the easy-to-use, browser-based Wowza Streaming Engine Manager for creating and managing live and VOD streams. Before you can start streaming, however, you need to download, install, and configure Wowza Streaming Engine. This involves installing Java, installing the Wowza software, starting the server software in the operating system, starting the Wowza Streaming Engine Manager, and, finally, testing a stream to make sure that everything works.

    Install Java


    Wowza Streaming Engine is a Java 6 (aka 1.6) and Java 7 (aka 1.7) application that requires the installation of a Java Runtime Environment (JRE) that supports deploying Java in a server environment. The following Java packages can be used with Wowza Streaming Engine:

    • Java Development Kit (JDK). The JDK includes a complete JRE as well as tools for developing and debugging server-side applications.

    • Java Server JRE. The Server JRE is for deploying Java applications on servers. Install this package if you want to run Java programs, but not develop them.

    A third type of Java virtual machine, the end-user Java JRE, installs a 32-bit client runtime, not the server runtime that Wowza server software requires. You can run Wowza Streaming Engine on the 32-Java JRE but should do so for evaluation purposes only, and you will need to perform additional configuration.

    For optimal performance and to use the Wowza Transcoder AddOn, we recommend that you deploy Wowza Streaming Engine on a 64-bit operating system with the latest 64-bit Java JDK or Server JRE.

    Note:
    The Wowza Transcoder AddOn is available only for 64-bit Windows and Linux operating systems running a 64-bit Java VM.
    1. Download a 64-bit Java JDK or Server JRE from the Java SE Downloads page or the Java Downloads for All Operating Systems page.

    2. Follow the instructions to install your Java environment.

    3. Validate that you've installed Java correctly by opening a Command Prompt window (Windows) or terminal window (Mac OS/Linux) and entering the command java –version.

    If Java is correctly installed and configured, the command prompt or terminal window displays a version number that's equal to or greater than 1.6.

    Configure a 32-bit Java client for Wowza Streaming Engine

    If you download a 32-bit client version of Java JRE—such as by clicking the Free Java Download button at www.java.com, which is not recommended—use one of the following methods to enable Wowza server software to work with the client runtime.

    1. Navigate to [install-dir]/conf/ and open Tune.xml in a text editor.

    2. Remove the <VMOption>-server</VMOption> property from the file.

    3. Save the file and restart the Wowza server if it was running.

    - OR -

    1. Navigate to your Java installation bin folder, typically located at [java-install-dir]\bin.

    2. Create a folder named server.

      For example, if your default Java installation root is C:\Program Files\java\jre7, create the following folder:
      Code:
      C:\Program Files\java\jre7\bin\server
    3. Copy the contents of the [java-install-dir]\bin\client folder to the [java-install-dir]\bin\server folder.

    4. Confirm that the JAVA_HOME environment variable value matches the Java installation root ([java-install-dir]).

      For example, C:\Program Files\java\jre7. If the variable value is incorrect, see After installing latest Java version, java command is still using old Java (fix) for more information about how to change it.


    Download and install Wowza Streaming Engine


    Note:
    Uninstall any previously installed versions of Wowza server software before installing Wowza Streaming Engine 4.0.6. For instructions on how to preserve your previous Wowza server configuration, see the Wowza Streaming Engine Upgrade Guide.
    1. Go to the Wowza Download Installers page and click Download for the installer for your desired operating system.

    2. When the download completes, do one of the following:

    • Windows: Double-click the installer file, WowzaStreamingEngine-4.0.6.exe, and follow the onscreen instructions.

    • Mac OS: Double-click the WowzaStreamingEngine-4.0.6.dmg file and then double-click the installer package, Wowza Streaming Engine 4.0.6.pkg, and follow the onscreen instructions.

    • Linux: Navigate to the folder that contains the downloaded Linux package and then execute one of the following commands, depending on your platform:


    Red Hat Package Manager systems
    Code:
    sudo chmod +x WowzaStreamingEngine-4.0.6.rpm.bin
    sudo ./WowzaStreamingEngine-4.0.6.rpm.bin
    Debian Package Manager systems
    Code:
    sudo chmod +x WowzaStreamingEngine-4.0.6.deb.bin
    sudo ./WowzaStreamingEngine-4.0.6.deb.bin
    Other Linux systems
    Download WowzaStreamingEngine-4.0.6.tar.bin to any directory and then execute the self-extracting installer:
    Code:
    sudo chmod +x WowzaStreamingEngine-4.0.6.tar.bin
    sudo ./WowzaStreamingEngine-4.0.6.tar.bin

    During the installation process, you'll be asked:

    • To accept the terms of the license agreement.

    • To enter a valid product license key. Wowza emails the license key to you when you download the software. Look for the key in your email in-box.

    • To create a user name and password for an Administrator account. You'll use this account to sign in to the browser-based Wowza Streaming Engine Manager. The user name and password values are case-sensitive.

    • To confirm or change the install location. By default, Wowza Streaming Engine installs files in the following directories:

      • Windows: /Program Files (x86)/Wowza Media Systems/Wowza Streaming Engine 4.0.6/
      • Mac OS:
        • /Applications/Wowza Streaming Engine 4.0.6/
        • /Library/LaunchDaemons/
        • /Library/WowzaStreamingEngine/ (an alias)
        • /Library/WowzaStreamingEngine-4.0.6/
      • Linux: /usr/local/WowzaStreamingEngine-4.0.6/, as the root user

    • If you want to start Wowza Streaming Engine and the Streaming Engine Manager automatically after the installation finishes. Accept the default options Start Wowza Streaming Engine automatically when the system starts and Launch Wowza Streaming Engine Manager in a web browser to configure the server and manager software to start automatically as system services to get up and running most easily. If you don't choose these options, you must start the server software and the manager manually before you can create video streams.




    Start the software


    If, during installation, you didn't elect to start the server and manager software automatically as system services, you must start them manually. Start them by following the instructions for your operating system.

    Start the software as a service (Windows)

    1. Press WIN key + R.

    2. In the Run dialog box, type services.msc and then click OK.

    3. In the Services window, right-click Wowza Streaming Engine 4.0.6 and choose Start.

    4. Confirm that the engine is running by opening a web browser and entering the following URL:

      http://[wowza-ip-address]:1935

      For [wowza-ip-address], use the IP address or domain of the local or remote Wowza server. For example:

      http://localhost:1935

      The browser should display the Wowza Streaming Engine version number. If not, check to see if the server software installed correctly and that TCP port 1935 is open on your router, firewall, and/or software firewall.

      When the Wowza Streaming Engine server software is running, start the Wowza Streaming Engine Manager.

    5. Switch to the Services window, right-click Wowza Streaming Engine Manager 4.0.6, and choose Start.

    Start the software as a service (Mac OS)

    1. Go to /Applications/WowzaStreamingEngine-4.0.6/ and double-click Start Services.

      Running the Start Services application starts both the Wowza Streaming Engine server software and the Wowza Streaming Engine Manager as system services.

    2. Confirm that the engine is running by opening a web browser and entering the following URL:

    http://[wowza-ip-address]:1935

    For [wowza-ip-address], use the IP address or domain of the local or remote Wowza server. For example:

    http://localhost:1935

    The browser should display the Wowza Streaming Engine version number. If not, check to see if the server software installed correctly and that TCP port 1935 is open on your router, firewall, and/or software firewall.

    Start the software as a service (Linux)

    To start Wowza software as a service on Linux, you must be the root user with sudo access. If these instructions don't apply to your Linux distribution, consult your Linux manual.

    1. In a terminal window, enter one of the following commands, depending on your Linux distribution:
      Code:
      sudo service WowzaStreamingEngine start
      -OR-
      Code:
      /etc/init.d/WowzaStreamingEngine start
    2. Confirm that the engine is running by opening a web browser and entering the following URL:

      http://[wowza-ip-address]:1935

      For [wowza-ip-address], use the IP address or domain of the local or remote Wowza server. For example:

      http://localhost:1935

      The browser should display the Wowza Streaming Engine version number. If not, check to see if the server software installed correctly and that TCP port 1935 is open on your router, firewall, and in your iptables.

      When the Wowza Streaming Engine server software is running, start the Wowza Streaming Engine Manager.

    3. In a terminal window, enter one of the following commands, depending on your Linux distribution:
      Code:
      sudo service WowzaStreamingEngineManager start
      -OR-
      Code:
      /etc/init.d/WowzaStreamingEngineManager start

    Perform a streaming test


    Wowza Streaming Engine installs a simple VOD application that you can use to to quickly see if Wowza Streaming Engine is running properly and can serve content. Test this VOD application after you have installed Wowza Streaming Engine and both the engine and manager are running on your system.

    1. Open the Wowza Streaming Engine in a web browser with the following URL:

      http://[wowza-ip-address]:8088/enginemanager

      Where [wowza-ip-address] is the IP address or domain name of the local or remote Wowza server that you want to test.

      Notes:
      • You can use 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 Google Chrome browser for best results.
      • By default, Wowza Streaming Engine is configured to accept connections from Streaming Engine Manager on the localhost. For more information about how to connect to the Streaming Engine from a remote (non-localhost) computer, see How to connect to remote Streaming Engine installations (whitelist).
    2. Sign in to Wowza Streaming Engine Manager with the Administrator account that you created when you installed the Wowza Streaming Engine software.



    3. In Streaming Engine Manager, in the Test Video area of the Home page, click Test Players.



    4. In the Test Players dialog box, click the tab for the streaming protocol that you want to test and click Start.

    The test players for VOD applications are configured to play back the [install-dir]/content/sample.mp4 video file that's installed with the server software. The following figure shows the Adobe HDS test player streaming the sample video.



    Next steps


    Congratulations! When you can successfully play the big buck bunny sample.mp4 file, then Wowza Streaming Engine is running properly and you can start streaming content. To continue, see any of the following articles, depending on what you want to do next.





    Updated: For Wowza Streaming Engine 4.0.6 on 08-11-2014