• Wowza Streaming Engine for Amazon EC2: Quick Start Guide

    This guide describes the minimum requirements to launch a Wowza Streaming Engine™ for Amazon Elastic Compute Cloud (Amazon EC2) instance, and stream your first video. To learn more about how to enable additional streaming formats and for more advanced deployment scenarios, see the Wowza Streaming Engine for Amazon EC2 User's Guide.

    Contents


    Video tutorial
    Introduction
    Create an AWS account
    Choose a licensing option
    Launch the instance
    Get the instance public domain name and ID
    Sign in to Wowza Streaming Engine Manager and test the instance
    Terminate the instance

    Video tutorial



    Introduction


    This guide describes how to install and configure Wowza Streaming Engine media server software on Amazon EC2, a web service that provides resizable compute capacity in the cloud. Amazon EC2 is a cloud-computing platform that virtualizes computing resources as virtual machines. A single virtual machine configuration is registered as an Amazon Machine Image (AMI). Wowza Media Systems® provides Amazon Linux AMIs with pre-configured and tuned versions of the Wowza Streaming Engine software that are ready to start using the Amazon Web Services (AWS) Management Console and Wowza Streaming Engine Manager.

    This guide assumes basic familiarity with Wowza Streaming Engine software. If you've never used Wowza Streaming Engine software, our free 180-day trial license is a good option to try the software. To get a trial license, complete the Wowza Streaming Engine Trial request form. The Wowza Streaming Engine Trial Edition download includes the Wowza Streaming Engine software, documentation, and examples. The Wowza Streaming Engine User's Guide contains comprehensive documentation about how to install and use the software.

    Amazon will still charge for running instance time, storage, and bandwidth if you deploy Wowza Streaming Engine software on Amazon EC2 with a trial license. If you just want to learn how the Streaming Engine software works, use the trial license with a Streaming Engine software installation on your local computer before deploying a Streaming Engine instance on Amazon EC2. After you have your client-side and server-side applications up-and-running on your computer, use this guide to learn how to quickly deploy a Wowza Streaming Engine for Amazon EC2 instance. For more extensive deployment documentation, see the Wowza Streaming Engine for Amazon EC2 User's Guide.

    Create an AWS account


    You must have an Amazon Web Services (AWS) account before you can deploy Wowza Streaming Engine on Amazon EC2. You can create a free AWS account at http://aws.amazon.com/.

    Choose a licensing option


    There are multiple ways to license Wowza Streaming Engine software on Amazon EC2 instances. We recommend that you use one of the AWS Marketplace licensing options (described below) when deploying a Wowza Streaming Engine EC2 instance. AWS Marketplace offers streamlined methods for configuring and launching your EC2 instance and always provides the latest generation instance types.

    Note: Additional licensing options are available. See the Wowza Streaming Engine for Amazon EC2 User's Guide for more information.

    Option 1: AWS Marketplace - Bring Your Own License (BYOL)

    If you already have a license for Wowza Streaming Engine software (or plan to purchase one), use this licensing option. You can use any Wowza Streaming Engine subscription or perpetual license key with your Wowza Streaming Engine for EC2 instance. Pro Edition licenses, which enable unlimited use of the Transcoder (for 64-bit instances only), nDVR, and DRM features in the Streaming Engine software, are fully supported.

    Amazon will send you a monthly invoice for your running instance time, storage, and bandwidth consumption. If you license the Streaming Engine software with a subscription license key, you'll also get a monthly invoice from Wowza for usage of the Streaming Engine software.

    Notes:
    • You can purchase monthly subscription and perpetual Pro Edition licenses for Wowza Streaming Engine on our Wowza Streaming Engine Pricing webpage. A Pro Edition license works with Wowza Streaming Engine 4.1.1 (and later) public AMIs and enables unlimited use of the Transcoder, nDVR, and DRM features.

    • If you have a Wowza Streaming Engine subscription or perpetual license, your license will continue to work with all Wowza Streaming Engine public AMIs under the terms of your license agreement. If you want to advance to a Wowza Streaming Engine Pro Edition license, see Advance to Wowza Streaming Engine Pro for details.

    Option 2: AWS Marketplace - Standard

    This licensing option enables you to purchase a Wowza Streaming Engine AMI that already has a license for the Streaming Engine software. Because the license is embedded in the software, you can't use your own license for Wowza Streaming Engine. This option provides the convenience of a combined monthly invoice from Amazon for running instance time, storage, bandwidth consumption, and Wowza Streaming Engine usage; however, it doesn't provide access to the Transcoder, nDVR, and DRM features.

    Launch the instance


    This section describes how to launch Wowza Streaming Engine AMIs into the Amazon EC2 console from AWS Marketplace. The EC2 Console is a web interface that enables you to configure the Wowza Streaming Engine instance details from a web browser before you launch it. Many users find that it's easier to use the console instead of the EC2 command line tools.

    To launch a Wowza Streaming Engine for Amazon EC2 instance, do the following (we recommend that you leave all optional settings at their default values unless specified otherwise below):

    1. Go to the AWS Marketplace webpage that corresponds to your chosen licensing option:

      Wowza Streaming Engine 4: Bring Your Own License

      -or-

      Wowza Streaming Engine 4: Standard

    2. Review the details, click Continue, and then sign in using your AWS account.

    3. On the Manual Launch tab, select a Wowza Streaming Engine software version, and then click Launch with EC2 Console for the region you want to use. The selected image will launch in the EC2 Console and the Choose an Instance Type page will be displayed.

      Notes:
      • Wowza provides public Amazon Linux AMIs that are pre-configured for all EC2 regions. To reduce latency, you can launch Wowza Streaming Engine instances with the EC2 Console in geographical locations that are closer to your audience or that are nearest to a publisher (an encoder or camera) that delivers a live stream to the Wowza Streaming Engine EC2 instance. To provide high levels of redundancy, you can launch Wowza Streaming Engine instances in multiple geographical locations. For help in choosing a region that meets your requirements, see Regions and Availability Zones.

      • You can click the 1-Click Launch tab to get your Wowza Streaming Engine EC2 instance up-and-running quickly. You specify a few settings up-front on this tab, and then the EC2 instance details are configured for you during the launch process. This option, however, DOES NOT allow you to start your Wowza Streaming Engine EC2 instance with a custom configuration. In addition, if you use an AWS Marketplace BYOL license for Wowza Streaming Engine software, you must add your license key after the instance is started to properly license the software. If you use an AWS Marketplace Standard license for Wowza Streaming Engine software, you're required create a key pair for use with the instance. For details about how to use the 1-Click Launch option, see "Launch with AWS Marketplace 1-Click" in the Wowza Streaming Engine for Amazon EC2 User's Guide.
    4. On the Choose an Instance Type page, select the instance type that you want to use. The instance type specifies the hardware configuration for your EC2 instance. To select a different instance type, select the filtering option to show All instance types, and then click the instance type that you want to use in the list. If you're not sure which instance type to select, see Amazon EC2 Instance Types. Because pricing per instance-hour can vary based on the selected instance type, also review the Amazon EC2 Pricing page.

    5. Click the Next: Configure Instance Details button to configure details for your selected instance type. The Configure Instance Details page enables you to configure optional settings for your selected instance type.

      If you launched an AWS Marketplace BYOL AMI


      On the Configure Instance Details page, under Advanced Details, you can enter your license key (or license keys if applicable) for the Wowza Streaming Engine software. In User data, select the As text option, and then enter the key-value pair data for your license keys into the text box, using the following format:

      WZA_wowzaServerLicenseKey=[license-key]

      Replace [license-key] with the license key for your Streaming Engine software. If applicable, add license keys for the Transcoder, nDVR, and DRM features, using the pipe (|) character between the license key values. For example:

      WZA_wowzaServerLicenseKey=ENGP4-12345-abcde-12345-abcde-12345|TRNU4-12345-abcde-12345-abcde-12345|DVRA4-12345-abcde-12345-abcde-12345|DRMA4-12345-abcde-12345-abcde-12345

      Notes:
      • Make sure that the Input is already base64 encoded check box is cleared.

      • If you don't specify a license key for the Streaming Engine software, the instance uses a temporary license key after you launch. You must replace the temporary license key with a valid license key for the Wowza Streaming Engine software. For more information, see "Add a license key for Streaming Engine software" in the Wowza Streaming Engine for Amazon EC2 User's Guide.

      • In the User data field, you can also use a WZA_startupPackageURL key-value pair to specify a startup package to use when starting your instance. The full URL to the startup package and license key data is specified using comma-delimited key-value pairs:

        WZA_startupPackageURL=[url-to-startup-package],WZA_wowzaServerLicenseKey=[license-key]|[license-key]

        A startup package allows the Wowza Streaming Engine EC2 instance to have a custom configuration when it launches. If you don't specify a startup package in the User data field now, a default startup package with live, vod, and vods3 streaming applications is used. For more information, see "Wowza Streaming Engine Configuration Startup Packages" in the Wowza Streaming Engine for Amazon EC2 User's Guide.

      • If you launched an AWS Marketplace Standard AMI, the license key is already embedded in the software and can't be changed. In addition, AWS Marketplace Standard AMIs always use the default startup package.

    6. On the Configure Security Group page, select the option to create a new security group, and then fill out the form to define the firewall rules for your instance in the selected region. For the purposes of this guide, add rules to open port 1935 in the firewall for RTMP streaming and the port range 8086-8088 for Wowza Streaming Engine Manager. To do this for RTMP streaming, click Add Rule, select Custom TCP rule for the Type, enter 1935 in Port Range, and select Anywhere in Source. Repeat this step to enable the port range 8086-8088. For more information about additional rules to add for streaming and for managing the Streaming Engine software, see "Create a security group" in the Wowza Streaming Engine for Amazon EC2 User's Guide.

    7. Click Review and Launch, and then on the Review Instance Launch page, click Launch. A dialog box will be displayed asking that you either select an existing key pair or a create a new key pair. A key pair enables you to use Secure Shell (SSH) to connect to your Amazon EC2 instance after you launch it. For the purposes of this guide, we'll not use a key pair. In the dropdown list, select the option Proceed without a key pair, select the Acknowledgement check box, and then click Launch Instances.

      Note: If you want to use SSH to connect to and manage this instance later, see "Create a key pair" in the Wowza Streaming Engine for Amazon EC2 User's Guide.
    8. In the Launch Status page, click the View Instances button to see the status of your EC2 instance. It may take several minutes for your instance to launch. After the Instance State changes from pending to running, the instance is started. It might take an additional minute or two after that before Wowza Streaming Engine is available for streaming.

    Important: You'll start incurring charges for your running instance from when it boots until you stop (terminate) it. When you no longer need the instance, follow the instructions in Terminate the instance to stop incurring charges.

    Get the instance public domain name and ID


    You must use the public domain name (or hostname) and instance ID of your running instance to access the instance remotely for configuration using Wowza Streaming Engine Manager, to connect to the instance using Secure Shell (SSH), and for streaming. To get the public domain name and instance ID of your instance, do the following:

    1. In the Navigation pane of the AWS Management Console, under Instances, click Instances.

    2. Select the running instance.

    3. In the lower pane, click the Description tab. The Public DNS value is the public domain name of your running instance and the Instance ID is the ID for the instance.

    4. Make note of these values as they're used throughout the rest of this guide.

    Sign in to Wowza Streaming Engine Manager and test the instance


    Wowza Streaming Engine Manager enables you to easily configure, manage, and monitor the Wowza Streaming Engine software. The browser-based manager enables publishers with a diverse range of technical abilities to have greater control and confidence when streaming video. To learn about the different parts of the Streaming Engine Manager user interface, see How to find your way around Wowza Streaming Engine Manager. For an introduction in creating and managing streaming applications and performing some basic administrative functions, see How to get started as a Wowza Streaming Engine Manager administrator.

    To quickly verify that your Wowza Streaming Engine for EC2 instance is working correctly:

    1. Enter the following URL in a web browser to connect to Wowza Streaming Engine Manager:

      http://[public-domain-name]:8088/enginemanager

      Replace [public-domain-name] with the Public DNS value for the instance. (See Get the instance public domain name and ID.)

    2. Sign with the user name wowza and a password. The password is the Instance ID. (See Get the instance public domain name and ID.)

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

      The Test Players window that opens includes test players that are pre-configured to stream the sample.mp4 video file in the Streaming Engine software installation over various streaming formats. Each tab in the Test Players window either hosts a test player that you can use to play the video file or provides instructions for playing the video file.

    4. Click one of the tabs in the Test Players window (for example, the Adobe HDS tab), and then click Start.

      The sample.mp4 video file should start to play. You're now ready to configure and use your Wowza Streaming Engine instance on Amazon EC2.

    Terminate the instance


    When you terminate an instance, you'll lose all changes or files that you have on the server. If you have anything that you don't want to lose, be sure to save it to Amazon Simple Storage Service (Amazon S3) or to Amazon Elastic Block Store (EBS) before terminating the instance or you'll lose data.

    When you terminate an instance, you'll lose all changes or files that you have on the server. If you have anything that you don't want to lose, be sure to save it to Amazon Simple Storage Service (Amazon S3) or to Amazon Elastic Block Store (EBS) before terminating the instance or you'll lose data. After you've saved your data, do the following to terminate the instance:

    1. In the Navigation pane, under Instances, click Instances.

    2. Select the running instance that you want to terminate.

    3. Click the Actions button, click Instance State, and then click Terminate. The Instance State column for the selected instance will show shutting-down and then terminated.

    Important: Amazon recommends that you confirm that the machine reaches the terminated state before you sign out. You'll continue to be charged for instances that fail to shut down correctly.

    Originally Published: 03-30-2011.
    Updated: For Wowza Streaming Engine 4.1.2 on 04-19-2015.