Create a new Administrator
It is possible to create a new Administrator account from the Customers interface. This is functionally identical to creating a Customer or Reseller Account, outside of selecting Administrator as the Account Type. Username – The username is used to login to a Administrator account. Typically this will be the same as the email account. Password […]
Administrator Accounts
Administrator accounts are designed to be able to manage all aspects of the panel including customers, services, announcements, reseller plans, configuration options and more. An Administrator should be able to login to the panel and complete any of the tasks outlined in the Admin User Manual. If you lose access to your Administrator account you […]
Troubleshooting Login Errors
MySQL Server Unreachable This error occurs because MySQL has crashed or cannot start. The cause of this error is commonly not enough disk space on the disk which the MediaCP is installed on*. Another cause can be too many requests for the database causing MySQL to crash. Steps to repair can be found in our […]
Deleting a Media Service
Deleting a Media Service will permanently delete the service. The action cannot be undone and the Media Service cannot be restored. Audio Services When deleting an Audio Service, the users uploaded media tracks are not deleted as they belong to the Customer account and not the Media Service. You should delete the Customer account or manually […]
Creating a Media Service
An Administrator can create Media Services from the Media Control Panel from various locations: There is a button on the Administrators Dashboard labelled “Add Service”; There is a “Create a new server” button on the Media Services listing page; There is a “Create Service” button on the Customer Overview page The creation interface is different […]
Deleting Announcement
Deleting will permanently delete the announcement, removing it from display on all interfaces. The action cannot be undone and the Announcement cannot be restored. An alternative to deletion, is to use the Announcement Expire On field to define when to hide the message from all interfaces. This is a great alternative to ensure there is […]
Managing Announcements
Columns ID # – The unique ID of the announcement stored in the database Subject – The Title or Subject as configured on an announcement Published – Whether the announcement is currently published or unpublished based on the Publish and Expiry dates configured on the announcement Publish On – The date and time when the […]
Creating Announcement
Parameters Subject – The subject is displayed above the announcement in a bold display Content – The message displayed to users/visitors can include styling (bolding, italics, headings, etc), links and even images. Publish On – The date and time when the announcement is to be displayed Expire On – The date and time to automatically unpublish and […]
Misc
Includes advanced configurations that don’t belong to any other category. API Access This configuration controls access to the MediaCP API. The API allows remote commands to be securely communicated through the platform, it is often used for integration into external systems such as Billing Systems or to enhance a Workflow. Some examples of API usage: […]
Backups
Automatic backups can be configured to run daily and/or weekly in the background on the system at a time of your choosing. The automatic backups are compatible with our restoration utility process. Backing up of Media Contents and Historical Data can be a disk intensive operation. If the backup process is too intensive then you […]
Statistics
The Statistics tab provides advanced configuration for Historical Reporting and Statistics. Historical Reporting heavily utilises the database with millions of records, as such caching is required to improve performance and server stability. An increase in caching time may improve CPU and Memory consumption and a reduction in caching time will do the opposite. Historical Reporting […]
Plugins
The Plugins configuration page provides advanced integration settings for each type of Media Service. It is generally not recommended to make changes here without the guidance of MediaCP support staff.
Overview The MediaCP sends emails to both administrators and customers for various reasons including: New Account provisioning Account Password reset Monthly statistic reports Service welcome emails Service notifications including bitrate abuse and suspension notifications MediaCP Email Configuration SMTP The default email configuration uses your server’s default sendmail configuration, which may be blocked by spam filters […]
Albums
Album Covers are provided for Audio Streaming Services such as Shoutcast and Icecast. By default, the iTunes API will be used to obtain album covers when one is not provided. It is recommended, however not required, to include an album cover on all uploaded tracks rather than use the API. iTunes The iTunes API is […]
Custom HTML
Custom HTML code is typically used to adjust the design of the control panel or add additional features such as a live chat widget. You should never use this component to add an custom messages or notices to the control panel, since this may break the display or function of the MediaCP interface. Such notices […]
Video Players
The software currently supports a number of different video players both free and commercial. This configuration allows the administrator to which video players are available, their configuration and the default to be displayed on each service. If more than one video player is enabled, the Customer will be able to select their preferred from the […]
General
General License Key – Changes to license key are applied instantly and on save will trigger validation and update to the MediaCP license servers MediaCP Full URL – The full URL for the Media Control Panel including the port. This used by the MediaCP for the control panel and services. Locale Default Language – The selected language […]
Services
General Custom Domain Names – Provides the ability to configure a custom domain name on a per-service basis that differs from the configured Host Address. Custom Domain names are available currently for Audio Services including Shoutcast and Icecast and are not available for video streaming services. Before Custom Domain Names can be enabled you must […]
Reset Customer Password
It is possible for a Customer to reset their own password by using the Forgotten Password link on the Login Screen. This requires a valid Customer email address and a valid Email Configuration. In the event that the Customer is unable to successfully reset their own password then an Administrator can reset the Customer password […]
Send email to Customer
System Email Configuration The Email Configuration must be valid for this function to work. You can test email delivery from the Software Health page. × Dismiss alert It is possible to send a HTML email to a Customer through the administrative Customers interface. By default emails are sent from the Email Address configured in System […]
Create a Reseller Account
A Reseller Account is a standard Customer account that has a Reseller Plan assigned. Create a new Customer During creation of the Customer, specify the Reseller Plan Upon creation, the Customer will have Reseller capabilities and be marked as a Reseller account
Reseller Plans
Reseller Plans can be accessed through a link on the Administrators Dashboard. A Reseller is capable of creating and managing their own Customers and Media Services. Creating a Reseller Plan The creation process is very simple and includes only a single field for the Reseller Plan Name. Once you have specified a name for the […]
Deleting a Customer
Deleting a Customer account will immediately and permanently delete the account and any media services that belong to this Customer. This action cannot be undone and the Customer or it’s related Media Services cannot be restored.
Create a new Customer
It is possible to create a new Customer account from the Customers interface. Username – The username is used to login to a Customer account. Typically this will be the same as the email account. Password – Enter the initial password for the Customers account login. The password must be a length of at least […]
Login as another Customer
As an Administrator, it is possible to login to any other Customer account within the Media Control Panel. Simply press the Login button next to the Customer account and you will be logged into their account immediately. Return to Administration It is possible to return to your administrator account by using the normal logout function […]
Managing existing Customers
Customer Overview Basic Information Important customer information is displayed in this section. Customer ID – The unique ID of a Customer user account. Username – The username is used to login to a Customer account. Typically this will be the same as the email account. Name – The Customers full name used to identify the account […]
Introduction
This is the administrators user manual for the Media Control Panel software. The manual provides detailed information on all software components relevant to the administrator, it is a reference on how each component is designed to function. AdministratorsDashboard SystemConfiguration CustomerAccounts ResellerAccounts MediaServices Announcements Statistics SoftwareHealth SoftwareUpdates EmailTemplates API Administration
API
A comprehensive RESTful API is available and accessible by Administrators, Resellers and Customers. It is documented by POSTMAN at the link below. View Postman API Documentation Authentication All requests to the API must be authenticated with either: Header including Authorization: Bearer {api-key} URL parameter of “auth”, for example https://yourdomain.com:2020/api/0/media-service/list?auth={api-key} Examples List Media Services curl –location […]
Email Templates
The Email Templates page provides you with various templates that will be sent out to your customers automatically. These can all be edited to your specification. Account Newpassword This email will be sent out to accounts when a new password has been set. Account Resetpassword This email will be sent out to accounts when a […]
Software Updates
The Software Updates page provides your license information, software version and release tier preference. Accessing Software Updates The Software Updates page is available for Administrators and can be accessed from the side menu under the Administration menu item. Product This will show you the product you are subscribed to such as Audio Starter Audio Unlimited […]
Software Health
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 – […]
Statistics
Widgets / Components Disk Usage Notice / Warning A notice is displayed at the top of the page when the system disk where MediaCP is installed is at greater than 85% usage. The warning is to allow the administrator time to reduce the disk usage before the system runs out of available disk space. Connections, […]
Announcements
Announcements are a great way to keep users informed of changes, maintenance and other information. These notices are displayed in multiple locations depending on the type of user, typically they are displayed in the location that is the most prominant for that user: Guests / Login Page – Displayed on the login page before a […]
Media Services
A Media Service represents a streaming service that is provisioned for a Customer. Audio Services will start a new instance of the binary (Shoutcast, Icecast, AutoDJ) and Video Services will utilise APIs and filesystem configuration files to deploy “applications” within the Video Streaming Engine. Actions of Start, Stop, Restart and Delete and processed in the […]
Reseller Accounts
A Reseller account is simply a standard Customer user account with a Reseller Plan associated. Once the Customer account has a Reseller Plan associated, it will be labelled as a Reseller. A Reseller is capable of creating and managing their own Customers and Media Services, it is typically used to resell streaming services without the […]
Customer Accounts
Customer accounts are designed with in a traditional user access approach by providing a single user login. This traditional approach ensures that a Customer only requires a single login to manage all of their media services. Some competitor products use a non-traditional approach providing separate credentials for every media service. Typically the reason behind this […]
System Configuration
The Media Control Panel provides a large array of configurations to ensure that it can be customised to suit the requirements of the implementation, be it for a single radio station, a church streaming their services or a service provider selling to their clients.
Administrators Dashboard
The Administrators Dashboard provides a snapshot of what is happening within your Media Control Panel. Getting Started The Getting Started section is displayed after you first install the Media Control Panel software. This component provides a basic guide on important steps that should be completed on every installation. Once the component is dismissed, it will […]