The Software Health Check provides some simple tests to ensure your server and MediaCP configuration is valid and all services are running optimally.
There are four statuses in total:
- INFO – Provides additional information on the test above the line.
- WARN – A configuration could be improved to provide better performance and/or stability.
- PASS – Test has passed successfully and there is no problem detected
- FAIL – The Test has failed and there is a problem.
Accessing Software Health
The Software Health check is available for Administrators and can be accessed from the side menu under the Administration menu item.
Checking PHP tests
All PHP configurations are automatically deployed when installing or updating the MediaCP so these tests should always PASS given there are no modifications made by the administrator.
Time accuracy and timezone
These tests are to ensure your system time is valid. If the system time is not accurate, even by 1 or 2 seconds, then some functions may not operate correctly. In some scenarios, particularly on virtual machines, the system time can fall behind.
Most operating systems come with automatic time syncronisation utilities. If these tests fail, you should contact your server provider to check and solve the problem.
In previous versions of the MediaCP (many years ago) it was required to set the PHP timezone to match your server. It is now required that the PHP configuration timezone be set to UTC. All stored dates and times in the MediaCP operate by converting from or to UTC time, so it is crucial that this passes.
Checking DNS
DNS resolution converts domain names such as mediacp.net to either IPv4 or IPv6 addresses.
Fast DNS resolution is vital to the applications performance and stability. DNS resolution is used in numourous areas of the system for different reasons.
Should these tests fail, then there is a problem with your System/Server/VPS configuration and it is a problem that your server administrator or hosting provider will need to solve. You should lodge a ticket with your provider if you are unable to solve the problem.
Permissions
Permissions on the content directory and temp paths are vital for the operation of the control panel. A common reason for this test to fail is if you have moved the Media Content Directory to a new location. Should these checks fail then you should ensure that all paths are owned by “mediacp” system user, for example:
chown mediacp:mediacp -R /usr/local/mediacp/;
chown mediacp:mediacp -R /usr/local/mediacp/content/;
Checking HTTP/S access to MediaCP
This test performs and simple HTTP request to your MediaCP application. It is a simple test to check connectivity from within your own system. Should this test fail, then it indicates that the MediaCP URL is unable to be accessed from within your own server. Typically the reasons would include:
a) A DNS resolution problem; or
b) A network/firewall problem, possibly relating to poor NAT configuration
In either scenario, it is likely that you will need to contact your server administrator or service hosting provider to solve the problem.
Checking CRON bitrate/historics
A test to ensure that the regular scheduled tasks are operating for the MediaCP application. Should this fail then you should ensure your cron application is running. On some systems if the load becomes too high, then cron service may fail and not restart. Contact your server administrator or service provider to ensure the cron service is running appropriately.
Wowza Streaming Engine
A series of tests to confirm the connection and authentication to the Wowza Streaming Engine application. Should these tests fail, please check:
- That the ports configured in the System Config -> Plugins -> Wowza Streaming Engine match the configuration from Wowza Streaming Engine Manager
- The authentication provided in System Config -> Plugins -> Wowza Streaming Engine is valid.
- Wowza Streaming Engine and Wowza Streaming Engine Manager services are online:
systemctl status WowzaStreamingEngine;
systemctl status WowzaStreamingEngineManager;
Flussonic Media Server
A series of tests to confirm the connection and authentication to the Wowza Streaming Engine application. Should these tests fail, please check:
- That the ports configured in the System Config -> Plugins -> Flussonic match the configuration from /etc/flussonic/flussonic.conf file
- The authentication provided in System Config -> Plugins -> Flussonic is valid.
- Flussonic Media Server system service is online
service flussonic status;
FTP Integration
If you are having difficutly with FTP then please review the FTP Troubleshooting document.
FFMPEG
Should FFMPEG configuration fail, then please contact MediaCP Support.
