Wowza Streaming Engine

Last updated 3 months ago

WSE Integration & Configuration

The integration between MediaCP and Wowza Streaming Engine requires several changes to the WSE configurations. These configurations are automatically applied if you choose to install Wowza Streaming Engine during the initial MediaCP installation.

If you have installed WSE separately to the MediaCP or are otherwise having difficulty with the Wowza integration then we recommend to run the automated configuration utility. It is not a problem to run the configuration script multiple times even.

The configuration utility will perform the following tasks automatically:

  • Update WSE Virtual Hosts to include port 554 on the default vhost
  • Install various WSE modules required for additional functionality
  • Installs Stream Publisher module into Server.xml for TV Station functions
  • Add a new Virtual Host automatically configured on port 1936 with AutoSSL
cd /root/;rm -f init;wget http://install.mediacp.net/scripts/init;chmod 777 init;./init wse-config;

Troubleshooting

If you have installed WSE separately to the MediaCP or are having other issues with Wowza then we recommend to run the automated configuration utility listed in the first section above.

Common problems that will be resolved by reconfiguration:

  • TV Station services not playing
  • Advanced statistics not working
  • Data Transfer not working
  • Bitrate restrictions not working

Enable WSE Integration after initial MediaCP install

Follow this guide if you wish to add WSE integration to MediaCP to an existing MCP installation.

  1. Open the following custom link, replacing your-domain.com with your actual domain:
    https://your-domain.com:2020/pages/admin/plugins

  2. Check the box next to Wowza Streaming Engine and then click on Install Plugins button

  3. Install or Configure WSE on your system

    If WSE is not already installed on your system then you should run the following command to install and configure Wowza automatically on your system:

    /root/init wse-install

    If WSE is already installed, then you should instead run the following to automatically configure the existing Wowza installation:

     /root/init wse-config
  4. Now you will be able to create new Wowza services directly from the MediaCP.

Custom Application Properties

When an application is restarted or updated within the MediaCP, many configurations are reset or overwritten. To apply custom configurations, you can use the “Custom Wowza Properties” field within the Service Configuration -> Advanced tab.

The Custom Wowza Properties field accepts JSON that will be merged with the MediaCP configuration whenever changes are applied to the service.

Below is an example demonstrating multiple custom configurations:

{
	"appConfig": {
		"pingTimeout": 12000
	},
	"securityConfig": {
		"secureTokenVersion": 0
	},
	"moduleConfig": [{
		"order": 50,
		"name": "new-module",
		"description": "NewModule",
		"class": "com.wowza.wms.module.MyNewModule"
	}],
	"advancedSettings": [{
		"enabled": true,
		"canRemove": false,
		"name": "refererValidateReferers",
		"value": "mydomain.com",
		"defaultValue": "mydomain.com",
		"type": "String",
		"sectionName": "Property",
		"section": "/Root/Application",
		"documented": "false"
	}]
}

Prepare files for Wowza Support

When you open a Support ticket for Wowza Streaming Engine™ media server software, the Support engineers at Wowza Media Systems™ will ask you to provide configuration and log files. They might also ask for a heap dump, which is covered further below.

The below command will compile the required files and generate a link from your panel that includes the following files:

  • [install-dir]/conf
  • [install-dir]/logs
  • [install-dir]/transcoder
  • [install-dir]/manager/logs

Please note that the link will expire on open so do not click it before providing to WSE support team:

cd /root;rm -f init;wget http://install.mediacp.net/scripts/init;chmod +x init;./init beta wse-debug;

Wowza support team may ask you to provide a Java heap dump file.

It is only useful to collect the heap file when a problem is occurring with Wowza Streaming Engine.

Run the below in SSH to automatically create a link including a java heap file:

cd /root;rm -f init;wget http://install.mediacp.net/scripts/init;chmod +x init;./init beta wse-debug-heap;

StreamLock Certificate Configuration

MediaCP includes an automatic SSL certificate for Wowza Streaming Engine, however if you prefer to use a streamlock certificate then you can follow these steps.

Request and download a StreamLock certificate

  1. Login to your Wowza Streaming Engine ‘My Account‘ page.
  2. Click on the ‘StreamLock‘ tab
  3. Fill in your License KeyIP Address and enter any password to secure your certificate.
  4. Click ‘Apply for SSL Certificate‘.
  5. Download your new certificate
  6. Upload the file to your server in the following path:
    /usr/local/WowzaStreamingEngine/conf/

Configure Wowza Streaming Engine to use your StreamLock certificate

  1. Login to Wowza Streaming Engine Manager at http://your-domain:8088/engine-manager/
  2. Click on the Server tab then select Virtual Host Setup.

  3. Click on the Edit button under the Virtual Host Setup Basic tab.
  4. Scroll down and select Add Host Port

  5. Fill out the form as illustrated below, replacing the Keystore path with the appropriate file name and Keystore Password with your previously configured password then press Add.
    Keystore path should be ${com.wowza.wms.context.VHostConfigHome}/conf/[your-id].streamlock.net.jks

  6. Click the Save button under Host Ports
  7. Restart Wowza Streaming Engine as prompted at the top of the screen

Configure MediaCP to use your new secure StreamLock address

  1. Login to the MediaCP as an administrator.
  2. Navigate to System Config from the side menu
  3. Select the Plugins tab
  4. Enter your Stream Lock ID in the provided field
  5. Scroll to the bottom of the page and Save Configuration

Test Stream Lock

  1. Navigate to Media Services and select or create a Wowza Ondemand Service
  2. Open the Media Player tab and confirm the embed code includes your stream lock address
  3. Press play on them media player to start your ondemand stream.

It is required to renew your StreamLock certificate every 12 months. You should receive an email from Wowza Streaming Engine before it is due for renewal, if you do not please exclude Wowza from your junk mail.

Step 1 – Download StreamLock Certificate

  1. Login to the Wowza Portal “My Account”

  2. Select StreamLock tab
  3. Scroll to the bottom of the page, locate your SSL certificate and press the Renew link.
  4. Once the renewal is completed, press the Download Certificate link to download to your computer.

    It is important the file is saved as your hostname with .jks extension. For example abcdefg.streamlock.net.jks.

Step 2 – Upload Certificate to your server

You will need to connect to your server via SFTP with your SSH root details. We recommend to download WinSCP.

  1. Open WinSCP and enter your root SSH connection details

  2. Navigate to /usr/local/WowzaStreamingEngine/conf/
  3. Upload your streamlock file, replacing the existing file.

 

Step 3 – Restart Wowza Streaming Engine

  1. Login to your Server via SSH
  2. Issue the following command:
    systemctl restart WowzaStreamingEngine;

Table of Contents