Installation - Windows Server 2003

Important Installation Notes Difficulty: For Advanced Users Only Estimated Duration: 45 minutes Windows Media Services & MediaCP are compatible on both 32bit & 64bit operating systems. The MediaCP_latest.zip files will appear corrupted if you download with Internet Explorer. We recommend using Google Chrome instead. System Prerequisites: Disk Space: 100MB Minimum, 500MB Recommended Memory: 256MB Minimum, 1GB Recommended Licensing Requirements: 1 Static IP Address & 1 Static Domain Name with access to license.cast-control.net MySQL Configuration: Strict Mode Disabled. You will need to have the Windows Server Installation Disc mounted or inserted in the computer to install Active Directory & Windows Media Services.

 

Table of Contents

• Windows Media Services Installation / Configuration
• Wowza Media Server Installation / Configuration
• Web Server Installation / Configuration
• MediaCP Installation
• What to do next? Advanced Configuration & How To Guides

Configure Server for WMS 

Follow this step only if you plan to use Windows Media Services with the MediaCP.

Important Note!
Windows Media Services integration on MediaCP will only work on 32bit operating systems.
Wowza Media, Shoutcast etc will all function fine on a 64bit operating system.

 

1. Install Active Directory
   Open Start -> Run and type "dcpromo".
   You will see the welcome screen, press Next.
   You will now see the Operating System Compatibility screen, press Next.
   
   Domain Controller Type
   Select "Domain controller for a new domain" and press Next.
   
   Create New Domain
   Select "Domain in a new forest" and press Next.
   
   New Domain Name
   Enter a domain or subdomain name that you wish to associate with the server.
   For example media.mydomain.com
   Press Next when you have entered this.
   
   NetBIOS Domain Name
   You can generally leave this as the default and press Next.
   
   Database and Log Folders
   You can generally leave this as the default and press Next.
   
   Shared System Volume
   You can generally leave this as the default and press Next.
   
   DNS Registration Diagnostics
   If the diagnostic fails, do not worry - select the"Install and configure the DNS server on this computer, and set this computer to use this DNS server as its preferred DNS server".
   Press Next when selected.
   
   Permissions
   Select the first option "Permissions compatible with pre-Windows 2000 server operating systems" and click Next.
   
   Directory Services Restore Mode Administrator Password
   This is an important password to restore your system if you ever need to remove the MediaCP in the future.
   Be sure to enter a secure password and record this for your own records.
   
   Summary
   Press next to begin installign Active Directory & DNS.
   This may take a while. Once this is completed you will need to restart your server.
   
   
   
2. Configure Active Directory for MediaCP
   You will need to create an organisation unit for your windows media services customers.
   This will enable you to secure/lockdown the user accounts used in association with Windows Media Services.
   
   Open Start -> Program Files -> Administrative Tools -> Active Directory Users & Computers.
   Right click on your computer/domain and select New -> Organisational Unit.
   Name this MediaPanel and press OK.
   
   Right click on MediaPanel OU and select New -> Group.
   Name this "MediaPanel" and enter the pre-windows 2000 name as the same.
   Press OK and close Active Directory Users and Computers MMC.
   
   
   
3. Update Administrator account "Member Of"
   For 64bit operating systems, it is crucial that you include all of the following Security Groups under the administrator account.
   
   a) Click on the "Users" Organisational Unit and right click your administrator account.
   b) Now select the "Member Of" tab.
   c) Ensure the following groups are added:
     - Administrators
     - Cert Publishers
     - Domain Admins
     - Domain Controllers
     - Domain Users
     - Enterprise Admins
     - Group Policy Creator Owners
     - Schema Admins
   
   
   
4. Configure LDAP communication for PHP
   Create the folder structure for C:/openldap/sysconf/
   Create a new text file in C:/openldap/sysconf/ldap.conf
   In this text file paste the following:
   TLS_REQCERT never
   TLS_CACERT c:/openldap/sysconf/myserver.pem
   
   Copy the ldap.conf into C:/ldap.conf and C:/windows/system32/ldap.conf
   (Some versions of PHP look in these spots incorrectly for the ldap.conf)
   
   
   
5. Install & Configure Secure Certificate
   Open Start -> Control Panel -> Add or Remove Programs.
   Select "Add/Remove Windows Componants".
   Check Certificate Services then press Yes when prompted.
   Press Next.
   
   Select Enterprise root CA then press Next.
   Enter the common name as the NetBios Domain Name and press Next.
   Continue steps until installation is completed.
   
   Open Start -> Administrative Tools -> Certificate Authority.
   Right click your server and select Properties.
   Select View Certificate then select Details tab and press the "Copy to File..." button.
   Export a Base-64 encoded X.509 (.CER) to your desktop as myserver.cer
   
   Download http://downloads.sourceforge.net/gnuwin32/openssl-0.9.8h-1-bin.zip
   Open the zip file and drag bin to C:/bin/ (We will delete this later)
   Move the myserver.cer into C:\bin\myserver.cer
   Open Start -> Run and type cmd.exe then hit enter.
   Enter the following and press enter, this will create the myserver.pem certificate in c:\openldap\sysconf\myserver.pem:
   C:\bin\openssl.exe x509 -in c:\bin\myserver.cer -out C:\openldap\sysconf\myserver.pem
   
   
   
6. Install Windows Media Services
   Open Start -> Administrative Tools -> Configure Your Server Wizard.
   Select Streaming Media Server when prompted and press Next until installed.
   
   
7. Configure Windows Media Services
   Open Start -> Administrative Tools -> Windows Media Services.
   Select your server (usually HOSTxxxxx).
   On the right hand side of the WMS MMC Console select the Properties tab then select Authorization.
   Right click WMS Publishing Points ACL Authorization and select Properties (also ensure it is enabled).
   Select Add then select Object Types.. and tick Groups. 
   Add the Security Group of "MediaPanel" and allow them to Read and Write (Not Create!).
   
   
   That is it, you have now pre-configured your system to use Windows Media Services
   
   
   

Configure Wowza Media Server 

1. Install Java JDK
   Download and install the latest Java JDK from http://www.oracle.com/technetwork/java/javase/downloads/java-se-jdk-7-download-432154.html
   We recommend JDK over JRE as JDK will allow you to manage your Wowza Media Server using the Java Console.
   
   
2. Install Wowza Media Server 3
   Download and install the latest Wowza Media Server 3 from http://www.wowza.com/pricing/installer
   
   
3. Install Additional Wowza Libraries
   Download and extract http://www.cast-control.net/files/setup_win_extra.zip 
   Open MediaSecurity_2.0.zip then open MediaSecurity/lib and drag the two jar files into "C:\Program Files (x86)\Wowza Media Systems\Wowza Media Server 3.x.x\lib"
   Open wms-plugin-collection.zip and do the same (only 1 jar file).
   
   Open [WowzaDir]/conf/Server.xml and change the value for JMX Romote Configuration to "true" after the change has been completed the file should look like this:
   
   

   <Root>        <Server>               <JMXRemoteConfiguration>                       <Enable>true</Enable>                              <IpAddress>localhost</IpAddress>                              <RMIServerHostName>localhost</RMIServerHostName>

   
   
   All other values in this file should be left with their default settings.
   
   
4. Update VHosts.xml and Authentication.xml
   Open [WowzaDir]/conf/VHosts.xml
   Change "Name" to "default".
   Change "ConfigDir" to “${com.wowza.wms.ConfigHome}/vhosts/default”.
   
   Open [WowzaDir]/conf/Authentication.xml
   Update the the value for the first two instances of "passwordFile" to the following:
   ${com.wowza.wms.context.VHostConfigHome}/conf/${com.wowza.wms.context.Application}/publish.password
   
   
5. Update VHost.xml
   Open [WowzaDir]/conf/VHost.xml
   Change "1935" to "1935,554" to support Android/Blackberry.
   
   
   
6. Update admin.password
   Open [WowzaDir]/conf/admin.password and configure a username and password seperated by a space on a new line.
   For example: admin changeme
   
   
7. Create the virtual host
   Create a new directories for [WowzaDir]/vhosts/default
   Copy applications, content, conf, keys and logs into [WowzaDir]/vhosts/default/
   
   
8. Restart Wowza Media Server
   Open Start -> Run and type in "services.msc".
   Locate Wowza Media Server, right click and select Restart.
   
   Congratulations! Your Wowza Media Server is now ready for MediaCP.

 

Configuring Web Server 

The following instructions will install XAMPP with Apache & MySQL.
If you prefer to use your own MySQL server, you must NOT start or stop the MySQL service in XAMPP control panel.

1. Older Windows 2003 or 2008
   You may be required to install the Microsoft Visual C++ 2008 Redistributable.
   Download: x86 x64
   
   
2. Download & Install Google Chrome
   This is required to download the MediaCP Application.
   You can download google chrome from http://www.google.com/chrome
   
   
3. Download & Configure XAMPP
   Download the XAMPP from http://www.apachefriends.org/download.php?xampp-win32-1.7.7-VC9.zip
   
   The file is approximately 160MB and includes:
    a) Webserver, PHP & MySQL (XAMPP)
   
   Extract the files to C:/xampp/
   
   
4. Configure Webserver on Port 2000
   Open C:/xampp/apache/conf/httpd.conf in WordPad.
   Press CTRL + F to find "Listen 80" and change this to "Listen 2000".
   
   Press CTRL + F to find "conf/extra/httpd-ssl.conf" and place a hash (#) at the beginning of the line
   This line should now look like: #Include "conf/extra/httpd-ssl.conf"
   
   Save and close the httpd.conf file.
   
   
5. Configure LDAP and CURL extension for PHP
   Open C:/xampp/php/php.ini in WordPad.
   
   Press CTRL + F to find "php_curl.dll" and uncomment this line (delete the ; before the line).
   Press CTRL + F to find "php_ldap.dll" and uncomment this line (delete the ; before the line).
   
   Save and close the php.ini file.
   
   Copy C:/xampp/php/libsasl.dll into C:/Windows/libsasl.dll
   (some php versions have difficulty finding this file, it is necessary for LDAPS secure connection)
   
   
6. Start XAMPP, MySQL & FileZilla FTP Server
   Open C:/xampp/setup_xampp.bat
   Wait for it to say "Press any key to continue..." then close the window.
   This will configure xampp for your system.
   
   Open C:/xampp/xampp-control-3-beta.exe
   a) Check the service box next to "Apache" to install the apache service. Run as Administrator and uncheck "Run this program with restricted access"
   b) Check the service box next to mySQL to install the MySQL service. Run as Administrator and uncheck "Run this program with restricted access"
   c) Check the service box next to FileZilla to install the FileZilla FTP Service. Run as Administrator and uncheck "Run this program with restricted access"
   
   
7. Configure XAMPP & MySQL Authorisation
   Open  the browser on the server and navigate to http://localhost:2000/security/index.php
   Update the MySQL root password and configure the XAMPP Directory username/password.
   REMEMBER THESE DETAILS!!!
   
   
8. Congratulations! XAMPP is now configured to support the Media Control Panel.

 

Install Media Control Panel 

 

1. Configure Prerequisites / 3rd Party Media Servers
   Download http://www.cast-control.net/files/setup_win_extra.zip
   Open setup_win_extra.zip and drag "CastControl" into C:/xampp/CastControl/
   
   Move C:/xampp/CastControl/rrdtool/DejaVuSansMono-Roman.ttf and VeraMono.ttf into C:/Windows/Fonts/
   
   
2. Download MediaCP
   Latest Stable: http://www.cast-control.net/files/MediaCP_latest.zip
   Latest Unstable: http://www.cast-control.net/files/MediaCP_latest_rc.zip
   
   
3. Extract into XAMPP
   Extract the .zip to your desktop.
   Move all files inside the upload_and_rename/ directory into C:/xampp/htdocs/
   Delete the C:/xampp/htdocs/index.html
   
   
4. Install Ioncube Loader
   You now must install the ioncube loader for your operating system.
   You can do this by accessing the wizard at http://localhost:2000/ioncube/loader-wizard.php
   Select Local Install.
   Follow the instructions and remember to restart XAMPP -> Apache when you finish.
   
   
5. Run the MediaCP Setup
   From your local PC, open http://your-domain.com:2000/setup/setup.php
   
   Enter your license key and press Proceed.
   You will be prompted with a file permissions check, press Next.
   
   Database Configuration
   Enter the database password you configured earlier on.
   For Database Name, if you are using the root username enter anything you like - for example "mediacp".
   The database will automatically be created if it does not exist.
   
   Set the RRDtool binary path to "C:/xampp/CastControl/rrdtool/rrdtool.exe"
   
   Complete the remaining details on this page and press Submit Details
   
   Scheduled Task Configuration
   WARNING! IF YOU ARE USING PLESK, DO NOT CREATE THE SCHEDULED TASK THROUGH THE CONTROL PANEL.
   
   Open Start -> Control Panel, right click Scheduled Tasks and select Explore
   Click "Add a new scheduled task"
   This will open the scheduled tasks wizard, click next.
   
   On the next step you will be prompted to select an application, scroll down if necessary and select "Command Prompt". Click Next and where requested to enter a task name enter "MediaCP" which describes the purpose of this individual task.
   
   Click next, ignore the Start time on this page and click next once again.
   
   Enter "NT AUTHORITY\SYSTEM" or simply "SYSTEM" for the username field and leave Password BLANK .
   
   On the final page, select "Open Advanced Properties when i click finish" and click "Finish".
   
   In the "Run" field you will need to enter the following:
   C:\xampp\php\php.exe -c C:\xampp\php\php.ini C:\xampp\htdocs\scanner\cron.php auto=1
   
   Select the Schedule tab then press Advanced.
   Check the box for Repeat Task and set "Every 1 minutes".
   Check "Duration" and set to "24 hours"
   Check the box next to "if the task is still running, stop it at this time."
   Apply all settings.
   
   
6. Application Module Preperation
   Check all the boxes except for services you do not wish to install then press Continue Setup Process.
   
   Windows Media Server
   

   Domain	The domain name that you configured for Active Directory: Example: www.mydomain.com
   Username	You must enter your Administrator username here (usually Administrator)
   Password	You must enter the administrator password here
   OU	This is the organisational unit you configured above. This should be set to "MediaPanel" if you followed the entire guide.
   Group	This is the security group you configured above. This should be set to "MediaPanel" if you followed the entire guide.
   UserSwitchOndemand	Allow Customer to change service to Ondemand Streaming
   UserChangeFromOndemand	Allow a Customer with Ondemand Service to change to Shoutcast or Live Streaming.
   WindowsUsernamePrefix	Apply a prefix to all windows user accounts that are created.
   ShowWMPlayer	Whether to display a windows media player on the webpage or not.

   
   
   Wowza Media Server
   

   WowzaDir	The full path using backslashes to Wowza Media Server Example: C:\Program Files (x86)\Wowza Media Systems\Wowza Media Server 3.x.x\
   AdminUserPass	Enter the username and password configured earlier seperated by a colon.
   OnDemandDir	This is where Media Files are stored. default stores Media Files in C:/xampp/htdocs/content/ To change this, enter the full path to where you prefer to store these: Example: D:\Media\ Be sure the directory already exists!
   FtpIntegration	These options are now deprecated. Configure FTP Settings after installation
   UserSwitchOndemand	Allow Customer to change service to Ondemand Streaming
   UserChangeFromOndemand	Allow a Customer with Ondemand Service to change to Shoutcast or Live Streaming.
   ShowRTMPLink / RTSP / RTMPT	Show Direct RTMP/RTSP/RTMPT links on customers service overview.
   ShowJWPlayer	Display a Flash Player with embed code for the customer.
   BitrateThreshold	Percentage that the customer is allowed to stream over their services bitrate limit. We recommend 5% as sometimes Flash Media Encoder can use slightly more than the rates configured.

   
   
   Icecast 2.3.2
   Select Operating System as Windows.
   Executable path is C:/xampp/CastControl/Icecast2/icecast2console.exe
   Share is C:/xampp/CastControl/Icecast2/
   
   Shoutcast 1.9.8
   Select Operating System as Windows.
   
   Shoutcast 2
   Select Operating System as Windows.
   
   sctransv2 (AutoDJ)
   Select Operating System as win32.
   
   
   
7. Firewall Exceptions
   You may wish to add program exceptions for the following:
   Shoutcast C:/xampp/htdocs/files/shoutcast198/windows/sc_serv.exe
   Icecast C:/xampp/CastControl/Icecast2/Icecast2Console.exe
   
   Congratulations! Cast-Control Media Control Panel is now installed!
   We highly recommend reading our Quickstart Guide to get started.
   If you have difficulty, please refer to our windows server 2003 troubleshooting document.

 

What to do next? 

Now that the control panel basics are installed you can either configure additional features or begin creating your media services.

Wowza Media Server Tuning Guide
It is highly recommend to run the Wowza Media Server Tuning Guide if you have installed Wowza Media Server.
Click here for more information.

Control Panel Configuration

• Configure FTP Server Integration
• Configure WHMCS Billing Module or Configure Blesta Billing Module
• Configure MSN Messenger Service Control
• Configure SMS Sending / Automation Features

 

• Create a Shoutcast Server
• Create a Wowza Media Service
• Create a Wowza Media Service
• Create a Windows Media Service