Wowza Streaming Engine for Linux on Amazon EC2: Quick Start Guide

This guide describes how to install and configure Wowza Streaming Engine™ media server software on Amazon Elastic Compute Cloud (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 and Windows 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.

Note: The latest pre-configured Streaming Engine virtual machine runs Wowza Streaming Engine software version 4.7.5. See the Wowza Streaming Engine 4.7.5 Release Notes.

Contents


Video tutorial: How to install and configure Wowza Streaming Engine for Linux on Amazon EC2
Getting started
Create an AWS account
Choose an AWS Marketplace software subscription
Launch the instance Get the instance public domain name and ID
Access the instance remotely
Sign in to Wowza Streaming Engine Manager and test the instance
Terminate the instance
How to cancel your subscription
More resources

Video tutorial: How to install and configure Wowza Streaming Engine for Linux on Amazon EC2


Getting started


This guide assumes basic familiarity with Wowza Streaming Engine software. If you've never used Wowza Streaming Engine software, our free Trial license is a good option to try it out. To get a Trial license, complete the Wowza Streaming Engine Free Trial request form. The Wowza Streaming Engine Trial 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.

Create an AWS account


You must have an Amazon Web Services (AWS) account before you can deploy Wowza Streaming Engine on Amazon EC2.

Sign in or create an AWS account

Choose an AWS Marketplace software subscription


Our AWS Marketplace software subscription options offer streamlined methods for configuring and launching your EC2 instance, and use current generation instance types and hardware virtual machine (HVM) virtualization for better performance.

Option 1: Wowza Streaming Engine (Linux BYOL)

If you already have a license for Wowza Streaming Engine software (or plan to purchase one), use this software subscription. You can use any Wowza Streaming Engine Subscription or Perpetual license key.

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

Note: You can purchase Subscription and Perpetual licenses for Wowza Streaming Engine software on our Wowza Streaming Engine Pricing webpage. If you already have a license, it will continue to work with all Wowza Streaming Engine public AMIs under the terms of your license agreement. If you want to upgrade your older license, see our Software Upgrade Options for details.

Option 2: Wowza Streaming Engine (Linux PAID)

This software subscription enables you to purchase a Wowza Streaming Engine AMI with an embedded license for the Streaming Engine software. The embedded license enables unlimited use of the Transcoder (for 64-bit instances only), nDVR, and DRM features in the Streaming Engine software. This option provides the convenience of a combined monthly invoice from Amazon for running instance time, storage, bandwidth consumption, and Wowza Streaming Engine usage.

Note: These software subscriptions replace the legacy AWS Marketplace - Bring Your Own License and AWS Marketplace - Standard software subscriptions. If you've already purchased a legacy software subscription, you can continue to use the software until you cancel your subscription in your AWS account.

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 for the software subscription that you want to use:

    Wowza Streaming Engine (Linux BYOL)

    -or-

    Wowza Streaming Engine (Linux PAID)
     
  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 nearly 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 the live source (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 1-Click Launch with a Wowza Streaming Engine (Linux BYOL) subscription, you must add your Wowza Streaming Engine software license key after the instance is started to license the software. If you use 1-Click Launch with a Wowza Streaming Engine (Linux PAID) subscription, you must create a key pair for use with the instance. For details on how to use the 1-Click Launch option, see Launch with AWS Marketplace 1-Click.
  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 a Wowza Streaming Engine (Linux 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 Sign in to Wowza Streaming Engine Manager and test the instance.
    • 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 How to use Wowza Streaming Engine startup packages to configure an Amazon EC2 instance.
    • If you launched a Wowza Streaming Engine (Linux PAID) AMI, the license key is already embedded in the software and can't be changed. In addition, these 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 Amazon EC2 security groups for EC2 Linux instances.
     
  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 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 more information, see Amazon EC2 Key Pairs for Linux instances.
     
    • To configure a key pair: In the dropdown list, select Choose an existing key pair to use a key pair that you've already created for use with Wowza Streaming Engine or Create a new key pair. If you choose to create a new key pair, make sure to download the private key file and store it in a safe and accessible location. For both options, you must have access to the selected private key file; without it, you won't be able to access your instance.

    • To continue without configuring a key pair: In the dropdown list, select Proceed without a key pair.

    Then select the Acknowledgement checkbox and click Launch Instances.
  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.

Launch with AWS Marketplace 1-Click

Notes:
  • Important: The 1-Click Launch option uses a default startup package with live, vod, and vods3 applications that are configured to use recommended settings for streaming. It DOES NOT let you customize your Wowza Streaming Engine configuration with a startup package. If you want to launch your Wowza Streaming EC2 instance with a custom Wowza Streaming Engine software configuration, you must use the EC2 console to launch your instance.
  • The 1-Click Launch option requires that you select an existing key pair before you can launch the Wowza Streaming Engine for Amazon EC2 instance. For more information, see Amazon EC2 key pairs for a Linux instance.
  1. Go to the AWS Marketplace webpage for the software subscription that you want to use:

    Wowza Streaming Engine (Linux BYOL)

    -or-

    Wowza Streaming Engine (Linux PAID)
     
  2. Review the details, click Continue, and then sign in using your AWS account.
     
  3. On the 1-Click Launch tab, select a Wowza Streaming Engine software Version, a Region, and an EC2 Instance Type.
  4. In the Security Group list, select Create new based on seller settings. This creates a security group that has all of the required firewall rules for streaming and for managing the Wowza Streaming Engine software.

    If you already created a security group for use with Wowza Streaming Engine software in the selected region, you can select it in the Security Group list instead.

  5. In the Key Pair list, select the key pair you created for use with the Wowza Streaming Engine software.
  6. Click Launch with 1-Click.

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.

Note: If you require a persistent public IP address that can be assigned to and removed from instances as needed, you can use a static IP address that's designed for dynamic cloud computing called an Elastic IP address. An Elastic IP address is associated with your account (not with a particular instance). For more information, see Elastic IP Addresses (EIP).

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 (hostname) 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.

Access the instance remotely


Note: An Amazon EC2 Linux instance can only be accessed remotely if you configured a key pair launching the instance.

There are multiple ways to access a Linux instance remotely, but for the purposes of this article, we'll use the Secure Shell (SSH) method. You may need to open a secure session to your Amazon EC2 instance using SSH in order to start and stop the Wowza Streaming Engine software or to reconfigure the media server. Public AMI instances use a public/private key pair to log in instead of a password. The public key half of this is embedded in your instance, allowing you to use the private key to log in securely without a password. You can use the key pair that you created for the region or when launching the instance. On Windows operating systems, you can open a secure session by using the PuTTY Secure Shell client. For more information, see Connecting to your Linux instance using SSH. For information about connecting to your Linux instance from a Windows operating system, see Connecting to your Linux instance from Windows using PuTTY.

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 to 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 the 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 in with the user name wowza and a password. The password is the Instance ID. (See Get the instance public domain name and ID.)
     
  3. If you launched a Wowza Streaming Engine BYOL AMI but didn't supply a license for the Wowza Streaming Engine software, you must replace the temporary license key. Do the following:
    • In Wowza Streaming Engine Manager, click the Server tab at the top of the page, and then click Server Setup in the contents pane.
    • On the Server Setup page, click Edit, and then replace the temporary license key value in the Lince Keys box with your Subscription or Perpetual license key for the Wowza Streaming Engine software. If applicable, add separate license keys for the Transcoder, nDVR, and DRM features. Each license key should be on a separate line.
    • Click Save, and then click Restart Now when prompted to apply changes.
  4. On the Home page in Streaming Engine Manager, 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.
     
  5. 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. 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.

How to cancel your subscription


Be sure to terminate all running instances for the subscription that you want to cancel, then do the following:

  1. Sign in to your AWS account management page.
  2. Under Your software, click Manage your software subscriptions.
  3. On the Your Software webpage, find the software subscription that you want to cancel and click Cancel subscription.

More resources


How to update your Wowza Streaming Engine software on Amazon EC2 (Wowza Streaming Engine video tutorial)

Connect to the Linux instance that you launched and transfer files between your local computer and your instance

Wowza Streaming Engine for Windows on Amazon EC2: Quick Start Guide


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