MediaCP Manual
    1. Getting Started
    2. Sales Questions
    3. Frequently Asked Questions
    4. Transcoder System Benchmarks
    5. Start your own streaming platform
    1. Product Licensing
    2. Change account currency
    1. Introduction
    2. Installation & Upgrade
      1. System Requirements
      2. Versions & Releases
      3. Installation
      4. Upgrading
      5. SSL Certificates
      6. Streaming Servers
        1. MediaCP Video
        2. Wowza Streaming Engine
        3. Flussonic Media Server
        4. Video Feature Comparison
        5. Icecast 2 / Icecast KH
        6. Shoutcast 2
    3. Billing Integration
      1. WiseCP Integration Guide
      2. WHMCS Integration Guide
      3. Clientexec Integration Guide
      4. Blesta Integration Guide
      5. Billing Platform Comparison
    4. Migrate from other software
      1. Migrate From Centovacast
      2. Migrate From AzuraCast
    5. Backup & Restoration
      1. Backup MediaCP
      2. Restore MediaCP
      3. Transfer to another server
    6. Administration
      1. MediaCP System Commands
      2. Admin Tools
      3. Custom Web Service Configurations
      4. Change MediaCP domain name
      5. Port 80 / 443 Proxy
      6. Move media to another hard disk
      7. Custom Language Translations
      8. Custom Facebook App
      9. Branding Your Panel
      10. Secure your server
      11. Setup CSF Firewall
      12. Troubleshooting Login Errors
      13. Reset Admin Password
    7. Scaling
      1. MediaCP CDN Capabilities
      2. Scale with Wowza and CloudFront CDN
      3. MediaCP Video with CloudFront CDN
      4. MediaCP Video with CDN Proxy
    8. Troubleshooting
      1. MySQL Database Troubleshooting
      2. Reporting Troubleshooting
      3. Troubleshooting Liquidsoap AutoDJ
      4. Video Relay Troubleshooting
      5. Disk Troubleshooting
      6. Grant access to support team
      7. Troubleshooting Wowza Streaming Engine
      8. FTP Troubleshooting
    9. AI Integration
    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. Send email to Customer
      5. Login as another Customer
      6. Reset Customer Password
    5. Reseller Accounts
      1. Reseller Plans
      2. Create a Reseller Account
    6. Administrator Accounts
      1. Create a new Administrator
    7. Media Services
      1. Creating a Media Service
      2. Deleting a Media Service
    8. Announcements
      1. Managing Announcements
      2. Creating Announcement
      3. Deleting Announcement
    9. Statistics
    10. Stream Events
    11. Software Health
    12. Software Updates
    13. Email Templates
    14. API
    1. Introduction
    2. Audio Operation Manual
      1. Basics 101
      2. Station Overview
      3. Media Library
      4. Playlists
        1. General Rotation
        2. Jingles & Advertising
        3. Scheduling
        4. Repeat Protection
      5. Live DJ Connections
      6. Live Stream Recording
      7. DJ Manager
      8. Fallback, Backup and Intro Files
      9. Country Blocking
      10. HTML5 Player
      11. AutoDJ Crossfade
      12. Stream Proxy
      13. Audio Processing
      14. Stream Authentication
      15. Public Page
      16. Widgets & Links
      17. Audio Stream Events
      18. Reporting
    3. Video Operation Manual
      1. Basics 101
      2. Service Overview
      3. File Manager
      4. Scheduling
      5. Streaming to Your Service
      6. Stream Targets
      7. GeoIP Country Locking
      8. Public Page
      9. Widgets & Links
      10. Video Stream Events
      11. Reporting
    4. Reseller Operations Manual
      1. Reseller Dashboard
      2. Customers
      3. Media Services
    5. AI Integration
    6. API
    1. Custom Domain Names
    2. Wowza and Flussonic on same system
    3. Submit a feature request
    4. Build and Publish Custom Roku Channel App
    5. Responsible Disclosure
    6. Youtube Stream Publisher App
    7. Shoutcast 2 Admin Guide
    1. Getting started with Audio Streaming
    2. Shoutcast 2 Live Broadcasting
    3. Icecast Live Broadcasting
    4. Broadcasting with AutoDJ
    5. DJ Accounts
    6. GeoIP Country Locking
    7. HTML5 Audio Player
    8. Mount Points
    9. Managing Your Media
    10. Managing Media Using FTP
    11. Statistics
    12. Shoutcast 2 Premium
    1. Getting started with video streaming
    2. Live Streaming Overview
    3. TV Station Overview
    4. Ondemand Video Streaming
    5. GeoIP Country Locking
    6. VAST Advertising
    7. Relay & IP Camera
    8. Stream Recording
    9. Connecting your encoder
    10. Preparing Your Media Files
    11. Managing Media Using FTP
    12. Understanding Video Playlists
    13. Embedding player on your website
    14. Smooth Streaming and Content Transition
    15. Video Transcoding (Adaptive Bitrate Streaming)
    16. Stream Watermark​
    17. DVR Rewind
    18. Statistics
    19. Facebook Live Streaming
    20. Youtube Stream Publishing
    21. Twitch Stream Publishing
    22. Shoutcast 2 Stream Publishing
    23. Icecast Stream Publishing
    24. RTMP Stream Publishing
    1. Cloud Video Overview
    2. Admin Manual - Cloud Video
      1. Team & Staff Members
      2. Plans & Customers
      3. WHMCS Billing Provisioning Module
      4. Login to your cloud platform
      5. Dashboard - A First Look
      6. Branding your platform
      7. Event Webhooks
      8. Activating VOD on Customer Plan
      9. API
    3. User Manual - Cloud Video
      1. Login to your video platform
      2. First Look
      3. Creating a Channel
      4. Channel Overview
      5. Broadcasting
      6. Broadcasting with OBS
      7. Stream Transcoding (ABR)
      8. Stream Watermarking
      9. Recording
      10. Media Content
      11. Live Events
      12. Live Paywall
      13. 30 Minute Rewind
      14. Fallback Video
      15. Video Players
      16. TV Channels - 24x7 UGC
        1. TV Event Scheduling
        2. Channel Guide Widgets
      17. Video on Demand
      18. Relay Channels
      19. VOD Playlists
      20. Publishing
      21. Bandwidth Utilisation
      22. Viewing Analytics
      23. Publish Zoom Meetings
      24. Advertising
      25. Restreaming IP Cameras
    4. Video Guide Series
    5. Streaming Best Practices
    6. Feature Comparison
    7. Roadmap & Release Notes

Migrate from Windows to Linux

Last updated 6 years ago

General Migration Notes

  • Before migrating to a new server, we recommend upgrading to the latest version of the MediaCP.
  • A valid license is required to complete the restoration process.
  • Transferring of files can often take hours to complete, be sure to leave enough time before terminating your old server.
  • Before completing a migration, you should request that both old and new server IP addresses be added to your software license.
  • The restoration process will prompt you for a custom media content path if you wish to relocate your media files to another disk during the migration

Wowza Streaming Engine Notes

  • If you have custom Wowza Streaming Engine configurations, such as multiple VHosts configured, you are required to migrate these configurations manually to the new server once the MediaCP is deployed on the new server.
  • If you have configured a custom Ondemand Directory from Admin -> System Config -> Plugins -> Wowza Streaming Engine, then you must manually copy this directory to the new server and specify the new path after migration.

1. Prepare DNS records

It is highly recommend to lower the Time To Live (TTL) of your DNS records to 300 before migration.

2. Create Linux compatible backup file

Complete the following process to create a migration/backup file that is compatible with Linux.

  1. Download and save the latest version of the installation software:
    http://install.mediacp.net/MediaCP-Install.exe

  2. Run MediaCP-Install.exe

  3. Select option [4] Linux Migration
 
Once completed, the backup file will be placed in C:/

3. Transfer backup to new server

The easiest way to transfer the backup to the new server is directly via SSH connection using a utility such as WinSCP.

  1. Install WinSCP on your Windows Server
  2. Open WinSCP and connect to your new Linux Server
  3. Upload (drag and drop) the backup file from C:/ drive into /root/

4. Restore the MediaCP

The restoration utility will perform the following:

  1. Install MediaCP
  2. Install Wowza Streaming Engine (if supported by license)
  3. Restoration will then automatically replace MediaCP files, database and media content with the backup from your windows server
  4. Attempt to start all your media services

Start the restoration utility with the following command on the new server
cd /root;rm -f init;wget http://install.mediacp.net/scripts/init;chmod +x init;./init restore

a) You will be prompted for your license key and the path to the backup file.

b) You will also be prompted to specify a location for your media content files. If you wish to leave this as default, simply press return. If you wish to install the media files to a different location, you may do so here and a symlink will be created automatically from /usr/local/mediacp/content to the new location.

The path to the backup file should be similar to /root/mediacp_201911180000.tar
(be sure to replace mediacp_201911180000.tar with the name of your backup file).

5. Check new server is running appropriately

We recommend thoroughly testing your panel before switching DNS records.

Firstly, on your new server in SSH open /etc/hosts (nano /etc/hosts) and ensure your domain name is mapped to the loopback address 127.0.0.1. See the below image example

You can do this by updating your systems hosts file to point your domain name at the new server, so only you can see the new server and your customers will still access the original server.

Open your systems hosts file:

  1. Navigate to C:\Windows\System32\drivers\etc 
  2. Right click hosts file and Open with “Wordpad”
  3. Add a new line containing your new servers IP Address and your domain name, separated by a single space. It should look like the below.
  4.  Close all instances of your web browser then start it again and you should be accessing the new server.
 
Once you have successfully tested the new server, remove the line from the hosts file and restart your web browser again.

6. Update DNS Records

a. Wowza Streaming Engine StreamLock

  1. Login to wowza.com Portal
  2. Select the StreamLock tab
  3. Scroll down and select the Change link next to your stream lock certificate
  4. Input your new servers IP Address and press save

b. MediaCP Domain Name

Update your DNS record to point to the new server.

Table of Contents