Wowza Media Server Pro for Riverbed Steelhead Installation Guide
Wowza Media Server Pro for Riverbed Steelhead Installation Guide Version 2.0 Wowza Media Systems, Inc. 1153 Bergen Parkway, #181 Evergreen, CO 80439 Phone (888) 778.7997 - Fax (408) 904.5396 Email: info@wowzamedia.com 2006-2009 Wowza Media Systems, Inc. All rights reserved. 2
Third-Party Information This document contains links to third-party websites that are not under the control of Wowza Media Systems, Inc. ( Wowza ) and Wowza is in no way responsible for any of the content on any linked site. If you access a third-party website mentioned in this document, then you do so at your own risk. Wowza provides these links only as a convenience, and the inclusion of any link does not imply that Wowza endorses or accepts any responsibility for the content on third-party sites.. Trademarks Wowza, Wowza Media Systems, Wowza Media Server and related logos are registered trademarks of Wowza Media Systems, Inc., and may be registered in the United States or other countries. Adobe and Flash are registered trademarks of Adobe Systems Incorporated, and may be registered in the United States or other countries. Riverbed Technology, Riverbed RiOS, Steelhead and the Riverbed logo are trademarks or registered trademarks of Riverbed Technology, Inc. and may be registered in the United States or other countries. Other product names, logos, designs, titles, words, or phrases mentioned herein are the property of their respective owners, may be trademarks, service marks or trade names of such owners and may be registered in the United States or other countries. Copyright Notices Installation Guide: 2009 Wowza Media Systems, Inc. All rights reserved. Java ID3 Tag Library and JLayer 1.0 (classic): 1991, 1999 Free Software Foundation, Inc. Java Runtime Environment Version 6 Update 11: 2008 Sun Microsystems, Inc. Log4j and Mina: 2006 The Apache Software Foundation VMware tools from VMware Workstation 6.0.5: 2008 VMware, Inc. Ubuntu 7.10: 2007 Canonical Ltd. 3
Table of Contents Overview...5 Before You Begin...5 Steelhead Model Compatibility...5 Installing the Wowza Pro RSP Package...6 Configuring the Wowza Pro RSP Package...11 Assigning an IP Address to the Wowza Pro RSP Package... 11 Configuring the DNS in the Wowza Pro RSP Package... 13 Configuring the Host File in the Wowza Pro RSP Package... 14 Changing the Time Zone on the Wowza Pro RSP Package... 15 Configuring the Wowza Pro RSP Package Data Flow...15 Entering the Wowza Pro RSP License Key...18 4
Overview W owza Media Server Pro for Riverbed Steelhead (Wowza Pro RSP) provides efficient streaming of live and on-demand Flash video in the enterprise while reducing WAN traffic associated with video delivery. Wowza Pro server software is installed on Steelhead appliances in a protected partition in Riverbed s RiOS Service Platform (RSP). The Wowza Pro software download package for RSP includes the following: Wowza Media Server Pro software Ubuntu Linux OS Java Runtime Environment (JRE) VMWare Tools from VMWare Workstation Deploy the Wowza Media Server Pro with these four steps: Installing the Wowza Pro RSP package Configuring the Wowza Pro RSP package Configuring the Wowza Pro RSP data flow Entering the Wowza Pro RSP license key Note: Wowza Pro RSP is pre-loaded with a 3-connection license key. For commercial operation, a paid Wowza Pro RSP Unlimited edition license key is required. Before You Begin The RSP Installation Image and license needs to be installed and started prior to installing Wowza Pro RSP Package. Contact Riverbed for instructions on how to obtain and install a RSP license. You also need to install and start the RSP Installation image. See section Installing the RSP Installation Image in the Riverbed Services Platform Installation Guide. Steelhead Model Compatibility Wowza Pro RSP is only compatible with the following Riverbed Steelhead: The 250, 520, 550, 1020, 1520, 2020 use the 32-bit Wowza Pro RSP package The 1050, 2050, 5050, 6050 can use the 32-bit OR 64-bit Wowza Pro RSP package 5
Installing the Wowza Pro RSP Package Prior to the installation procedure, you must request a Wowza Pro RSP package download URL from the following web site: http://www.wowzamedia.com/riverbed.html. You need the download URL to upload the Wowza Pro RSP package to the Steelhead. To begin: Figure 1 1. Place the Wowza Pro RSP package on the Steelhead. a. Log on to the Riverbed Steelhead UI. b. Select Configure>Branch Services>RSP Package. The RSP Package page opens. c. Click the Add Package tab (Figure 1). 6
Figure 2 d. Add the Wowza Pro RSP package via URL, or upload a file already on the local machine. e. Click Add. You receive a confirmation message when it completes (Figure 2). Click Local Name for package specifics. You can enter a new name for the package when uploading it to the Steelhead for the first time. 2. Install the Wowza Pro RSP package in an available slot (Figure 3). Note: If desired, you can change the name of the slot in the Slot Name field and click Update Slot. Proceed with the following instructions. Once the slot is filled, then slot name cannot be changed without first uninstalling the package from the slot. a. From an available slot, select the Wowza Pro RSP package from the Package File Name drop-down menu. b. Click Update Slot. The package decompresses into the slot. This can take five to ten minutes. 7
Figure 3 The original package is still available on the Steelhead. You receive confirmation when it is complete. 3. Configure and enable (power on) the package (Figure 4). a. In the Memory Footprint field, change the memory if needed. b. Leave default not watching in Watchdog field. (Figure 4). 8
Figure 4 c. Optionally, check Optimization Network Interfaces to associate the network interface of the package to a VLAN. (Figure 5). 9
Figure 5 d. If you have changed any information click Update Slot. Allow the slot to update and then click Enable Slot. If you have not changed any of the defaults only click Enable Slot. 10
Configuring the Wowza Pro RSP Package There are three steps to configure the Wowza Pro RSP package: 1. Assign the RSP Pro Package an IP address 2. Configure the DNS in the RSP Pro Package 3. Configure the Host File in the RSP Pro Package Optionally, you can change the time zone for the RSP Pro package. Assigning an IP Address to the Wowza Pro RSP Package To assign the Wowza Pro RSP package an IP address: 1. From the RSP Packages page, click Launch VM Console in the slot details. The VMWare Infrastructure Web access Login dialog opens. 2. Login to the VMware Infrastructure Web Access dialog: Use the same login and password you used to log into the Steelhead UI. Note: The VMware remote console plugin needs to be installed. See the Riverbed Services Platform Installation Guide. 3. From the VMware Infrastructure Web Access Page, click any where in the window to open the virtual machine. The Wowza Package console opens (Figure 6). 11
Figure 6 4. Login to the Wowza Pro RSP package. Login: wowza Password: password 5. At the Wowza package prompt type: sudo nano /etc/network/interfaces (Figure 7). Important: It is not recommended to use DHCP with the Wowza Pro RSP Package, because transparency (DNAT) needs a single IP to redirect traffic to. a. Enter password again. You are now in the interface file. b. To assign an IP address to the package, change the line iface eth0 inet dhcp to iface eth0 inet static. c. Next line type : address [your ip address] 12
Figure 7 d. Next line type: netmask [your subnet mask] e. You can optionally add three lines for Gateway, Network and Broadcast. 6. Type CTRL X to exit 7. Press Y to save the file 8. At File Name to Write press return. Configuring the DNS in the Wowza Pro RSP Package To configure the DNS in the Wowza RSP Pro Package (Figure 8). 1. At the Wowza prompt, type: sudo nano /etc/resolv.conf 2. Change search localdomain to search [your domain] 3. Change nameserver to nameserver [your dns server] 13
Figure 8 4. Type CTRL X to exit 5. Press Y to save the file 6. At File Name to Write press return. Configuring the Host File in the Wowza Pro RSP Package Finally, to configure the Host File in the RSP Pro Package: 1. At the Wowza prompt type: sudo nano /etc/hosts 2. On the second line change 127.0.1.1 to the static IP address you assigned the package. 3. Replace localdomain with [your domain]. 4. Type CTRL X to exit 14
5. Press Y to save the file 6. At File Name to Write press return. Changing the Time Zone on the Wowza Pro RSP Package Please note that the default time zone for the RSP Pro package is EST. To change the time zone, at the Wowza prompt type dpkg-reconfigure tzdata and follow the prompts. To have the changes take affect we need to reboot. Complete the following steps: 1. From the VMware remote console window, press Ctrl Alt. This releases the focus off this window. 2. Close the VMware remote console. 3. Close the VMware Infrastructure Web Access Page. 4. Go back to the RSP Package page. 5. To restart the package, disable and re-enable the slot. a. Click Disable Slot. b. Wait a two minutes. c. Open the slot. d. Click Enable Slot. Configuring the Wowza Pro RSP Package Data Flow Once the Wowza Pro RSP package has an IP address, you are ready to begin configuration: 1. Place the Wowza Pro RSP package in the data flow (Figure 9). 2. Select the appropriate position from the dropdown, select the wowzaopt vni and click Add. 15
Figure 9 3. Configure the dataflow rules and transparent proxy behavior (Figure 10). a. Click the VNI b. Create appropriate LAN to WAN rule to redirect Flash requests into local instance (refer to the Riverbed Console Management Guide on adding rules). i. Enter the destination IP: typically the datacenter Wowza Pro Server IP address optional ii. Enter Flash destination port: 1935 iii. Select redirect traffic to slot. iv. Click Add. The wowzaopt vni is configured with the set rules. 16
Figure 10 4. Configure the transparent proxy behavior (Figure 11). a. Click Enable DNAT. b. Enter the Wowza Pro RSP package IP address. c. Click Apply. Note: If desired, you can create a WAN to LAN rule. 17
Figure 11 Entering the Wowza Pro RSP License Key To install the Wowza Pro license key: 1. Log into the Wowza Pro RSP package. a. Log on to the Riverbed Steelhead UI. b. Select Configure>Branch Services>RSP Package. The RSP Package page opens. 18
c. Click the Wowza Pro RSP slot. d. Click Launch VM Console in the slot details. The VMWare Infrastructure Web access Login dialog opens. e. Login to the VMware Infrastructure Web Access dialog: Use the same login and password you used to log into the Steelhead UI. Note: The VMware remote console plugin needs to be installed. See the Riverbed Services Platform Installation Guide. f. From the VMware Infrastructure Web Access Page, click any where in the window to open the virtual machine. The Wowza Package console opens. g. Login to the Wowza Pro RSP package. Login: wowza Password: password *** 2. Change directories to /usr/local/wowzamediapro/conf 3. Type: Sudo nano server.licence 4. Replace the entire contents of the file with the Wowza Pro license key. 5. Type CTRL X to exit. 6. Press Y to save the file. 7. At File Name to Write press return. 8. Restart the Wowza Pro Server, type: /etc/init.d/wowzamediapro restart Make sure you can see the network and can ping the necessary servers. 9. Optional step: change the Wowza user password to something more secure. a. At the Wowza RSP Package prompt, type: passwd b. Follow the prompts on the screen. 19