MediaCP Manual
Wowza Streaming Engine

Last updated 1 day ago

MediaCP provides a beautiful user-friendly interface as well as a large offering of additional functionality to Wowza Streaming Engine, with a direct integration via REST API.  The Media Control Panel supports Wowza Streaming Engine version 4.8.13+1.

Read more about features available in MediaCP

Frequently Asked Questions

How does MediaCP Integration work?

Wowza Streaming Engine can be automatically installed and configured during the installation of the MediaCP product, this is the recommended way to install Wowza Streaming Engine on your system. Simply follow our standard Installation Instructions and you will be prompted to install Wowza Streaming Engine through the process.

How much does Wowza cost?

Wowza Streaming Engine pricing is available on their website at Wowza Streaming Engine Pricing page.

As of July ’21, the pricing starts at $145 USD per month for Basic, which includes a standard level of support with Wowza Streaming Engine.

It is noted on the website that this includes a “maximum of 10 concurrent channels per instance per month”. This language can be confusing however “concurrent channel” refers only to any Wowza Application (or MediaCP service) that includes Transcoder features. You will only be billed additionally if you use more than 10 Applications/Services that use Transcoder.  There is no limit or additional billing for the number of MediaCP services that use Wowza. Read more about this on the wowza webstie here.

What changes are made to Wowza by MediaCP?

Generally we try to keep it simple and as close to a default WSE installation as possible, however there are several changes that our software makes during the installation process:

  • Automatic configuration of port 1936 for SSL services
  • Automatic configuration of port 554 on the default VHost
  • Automatic configuration of SSL for WSE Manager on port 8089
  • Automatic configuration of Production mode, where the default installation is in a development mode.
  • Installation of additional modules for TV Station and other functionality
How can i add Wowza to my MediaCP installation?

Simply follow the Enable WSE Integration after initial MediaCP install steps in this article below.

Troubleshooting

Many integration issues can be solved by running our configuration utility, including some of the below:

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

It is safe to run this at any time, even if you have completed the integration previously. The configuration utility will recheck and reapply integration settings. Follow the instructions below:

  1. Login to your servers SSH as root
  2. Run the following command to run the configuration utility:
    /root/init wse-config

Crashing, high hemory/heap usage, high cpu or other instability

If you are experiencing instability in Wowza Streaming Engine then we recommend the following actions:

  1. Install Java JDK 12 directly into WSE by running the following in SSH as root:
    sh -c "$(curl -sSL https://www.mediacp.net/tools/wse-jdk-12.txt)"
  2. If WSE has been previously upgraded from an earlier version then we recommend to reinstall Wowza Streaming Engine using our utility
  3. Enable WSE Conscrypt provider to improve SSL performance and reduce CPU usage

If the problems persist after performing these actions, then you should contact Wowza Technical Support. We also recommend to prepare and submit configuration files using our guide.

Statistics are not being recorded

Please make sure you are running Wowza Streaming Engine 4.8.14 or newer. Wowza Streaming Engine 4.7.7 is no longer supported by the latest versions of MediaCP (2.9 and 2.10) due to differences in the statistics output between Wowza 4.7 and 4.8.

IP Camera and Shoutcast streams are not starting automatically

This can be solved by recreating the WSE StartupStreams.xml file. Run the following in SSH to recreate the file and restart Wowza Streaming Engine:
echo "<?xml version=\"1.0\" encoding=\"UTF-8\"?><Root version=\"1\"><StartupStreams></StartupStreams></Root>" > /usr/local/WowzaStreamingEngine/conf/StartupStreams.xml;
systemctl restart WowzaStreamingEngine;
Now proceed to restart all your IP Camera or Shoutcast services from MediaCP services, or run the following to restart ALL MediaCP services:
/usr/bin/mediacp restart services

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;

How to guides

Enable WSE Integration after MediaCP install

Follow this guide if you wish to add WSE integraation 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 systemIf 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.

Applying 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"
	}]
}

Install StreamLock Certificate

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.

The Wowza StreamLock Certificate lasts for 12 months, you will need to setup a reminder in 11 months to renew the certificate. Renewing the certificate is a manual process and we also have a guide on this page.

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.

Renew StreamLock Certificate

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;

Change Wowza License Key

1. Login to your server via SSH

2. Run the following command:

nano /usr/local/WowzaStreamingEngine/conf/Server.license

3. Remove the old license key and paste your new license.

4. Save and restart Wowza Streaming Engine.with the command below:

systemctl restart WowzaStreamingEngine;

Reinstall Wowza Streaming Engine

1. Login to your server via SSH as root user

2. Uninstall Wowza Streaming Engine
a) Run the following command on your server to bring up the MediaCP setup utility

/root/init

b) Select option [4] Admin Tools

c) Now select option [8] Wowza Streaming Engine – Uninstall and follow the process through to removing Wowza Streaming Engine.

3. Install Wowza Streaming Engine
a) Run the following command on your server to bring up the MediaCP setup utility

/root/init

b) Select option [4] Admin Tools

c) Now select option [3] Wowza Streaming Engine – Install and follow the process through to complete Wowza Streaming Engine installation.

4. Check and copy new password for user “mediacp” at /usr/local/WowzaStreamingEngine/admin.password

5. Update password in MediaCP -> System Config -> Plugins -> Wowza Streaming Engine -> Admin Password

6. Restart all your services using the below command line, or manually within the MediaCP. This will recreate all the services into Wowza.

mediacp restart services;

Table of Contents