MediaCP Manual
    1. Getting Started
    2. Sales Questions
    3. Frequently Asked Questions
    4. Transcoder System Benchmarks
    5. Start your own streaming platform
    1. Change account currency
    2. Product Licensing
    1. Introduction
    2. Installation & Upgrade
      1. System Requirements
      2. Versions & Releases
      3. Installation
      4. Upgrading
      5. Streaming Servers
        1. Nginx-Rtmp Video Server
        2. Flussonic Media Server
        3. Icecast 2 / Icecast KH
        4. Wowza Streaming Engine
      6. SSL Certificates
    3. Billing Integration
      1. WHMCS Integration Guide
    4. Migrate from other software
      1. Migrate from Centovacast
    5. Backup & Restoration
      1. Backup MediaCP
      2. Restore MediaCP
      3. Transfer to another server
    6. Administration
      1. Custom Web Service Configurations
      2. Reset Admin Password
      3. Port 80 / 443 Proxy
      4. MediaCP System Commands
      5. Change MediaCP domain name
      6. Move media to another hard disk
      7. Secure your server
      8. Troubleshooting Login Errors
    7. Scaling
      1. Scale with Wowza and CloudFront CDN
      2. Nginx-Rtmp with CloudFront CDN
    8. Troubleshooting
      1. Grant access to support team
      2. Troubleshooting Wowza Streaming Engine
      3. FTP Troubleshooting
      4. MySQL Database Troubleshooting
      5. Reporting Troubleshooting
      6. Troubleshooting Liquidsoap AutoDJ
      7. Video Relay Troubleshooting
    1. Introduction
    2. Administrators Dashboard
    3. System Configuration
      1. General
      2. Services
      3. Video Players
      4. Albums
      5. Email
      6. Plugins
      7. Statistics
      8. Backups
      9. Custom HTML
      10. Misc
    4. Customer Accounts
      1. Managing existing Customers
      2. Create a new Customer
      3. Deleting a Customer
      4. Login as another Customer
      5. Send email to Customer
      6. Reset Customer Password
    5. Reseller Accounts
      1. Reseller Plans
      2. Create a Reseller Account
    6. Media Services
      1. Creating a Media Service
      2. Deleting a Media Service
    7. Announcements
      1. Managing Announcements
      2. Creating Announcement
      3. Deleting Announcement
    8. Statistics
    9. Software Health
    10. Software Updates
    11. Email Templates
    12. API
    1. API Documentation
    2. Custom Domain Names
    3. Shoutcast 2 Admin Guide
    4. Wowza and Flussonic on same system
    5. Submit a feature request
    6. Wowza Custom Properties
    1. Shoutcast 2 Live Broadcasting
    2. DJ Priorities
    3. HTML5 Audio Player
    4. Broadcasting with AutoDJ
    5. Shoutcast 2 Premium
    6. Mount Points
    1. Getting started with video streaming
    2. Live Streaming Overview
    3. TV Station Overview
    4. Ondemand Video Streaming
    5. Relay & IP Camera
    6. Connecting your encoder
    7. Managing your media files
    8. Embedding player on your website
    9. Video Transcoding (Adaptive Bitrate Streaming)
    10. Image Logo or Watermark Overlay on Video Stream
    11. nDVR Live Streaming
    12. Shoutcast 2 Stream Publishing
    13. Facebook Live Streaming
    14. Youtube Stream Publishing
    15. Icecast Stream Publishing
    16. Twitch Stream Publishing
    17. Periscope Stream Publishing
Troubleshooting Wowza Streaming Engine

Last updated 6 months ago

Many integration issues can be solved by Reconfiguring the MediaCP Integration, which will automatically validate and configure Wowza Streaming Engine to work with the MediaCP Software. Read more about how the integration works.

MediaCP provides an interface and some additional features on top of Wowza Streaming Engine. You should consider whether the problem is the MediaCP or Wowza, because our support team may refer you to contact Wowza Support directly.

Reconfigure MediaCP Integration

The following issues are solved by running the configuration utility:

  • TV Station channels will not broadcast or play the schedule on time
  • Statistics is missing data or completely empty
  • Bandwidth or Data Transfer is not being recorded
  • Bitrate limitations on a channel/service is 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

Common Problems & Solutions

If your problem is not listed here then we recommend also reviewing the Wowza Streaming Engine Known Issues page.

TV Station Schedules will not play on time

This problem is typically caused by daylight savings time changes on your server. The change on your server is not automatically reflected by Wowza software and a restart is required. You can restart Wowza Streaming Engine by running the following command:

systemctl restart WowzaStreamingEngine;

Should the issue persist then we recommend to Reconfigure MediaCP Integration.

Facebook or other Stream Targets are not working or will not broadcast

You should check that port 1935 is opened OUTBOUND from your server to the internet. This is typically the source of the problem.

Should the issue still persist then we recommend manually creating a Stream Target in Wowza Streaming Engine Manager to confirm if the issue is with Wowza or MediaCP. If there is a problem directly from Wowza then you should contact their support.

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

The media could not be loaded, either because the server or network failed or because the format is not supported

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 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 wse-debug-heap;

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

Table of Contents