How to migrate Wowza Streaming Engine to a new media server instance

This guide provides instructions on how to migrate Wowza Streaming Engine™ media server software from one server instance to another. For example, if you need to move media server settings and content to a newer version of the Streaming Engine software on the same computer or to different server hardware, or to a virtualized platform.

Read these instructions carefully before you start migrating Wowza Streaming Engine to a new server instance. To get an overview of the migration process, you can watch this video.

Contents


Overview of Migrating Wowza Streaming Engine to a New Media Server Instance (Video Tutorial)
Step-by-Step Upgrade Instructions

Overview of Migrating Wowza Streaming Engine to a New Media Server Instance (Video Tutorial)

Step-by-Step Upgrade Instructions

Notes:

  1. On the old server instance that you're migrating FROM, stop the Wowza Streaming Engine services. See How to start and stop Wowza Streaming Engine software for instructions on how to stop services on your operating system.

    Important:

    • You should stop Wowza Streaming Engine services to avoid being charged for a second instance (for Subscription keys) or to avoid a startup error (for Perpetual keys) when you create the new server instance to which you'll migrate your content and settings.
    • Do NOT uninstall Wowza Streaming Engine software for the old server instance yet.
  2. Create a backup of the Wowza Streaming Engine installation folder ([install-dir]) for the old server instance.

    Important: Remove the following file from the backup: [install-dir]/conf/jmxremote.access

  3. Install a new media server instance using the latest Wowza Streaming Engine software and your current license. See How to install and configure Wowza Streaming Engine if you need installation instructions.

    Notes:

    • If you install a new media server instance on the same computer as the old server instance, you'll be prompted by Wowza Streaming Engine Setup to choose the instance to activate after installation is completed. Choose the latest Wowza Streaming Engine software instance.
    • You can request an R&D license and use this license key when you install Wowza Streaming Engine for the new server instance. This enables you to run the old and new server instances at the same time. You can then thoroughly test the new server software before migrating files from your backup.
  4. Copy the following folders (or files within the folders as indicated) from your backed up Wowza Streaming Engine server instance to the new Wowza Streaming Engine server instance:
    • [install-dir]/applications: All application folders.
    • [install-dir]/conf: Server configuration files. Important: Do NOT copy the [install-dir]/conf/jmxremote.access file from your backup.
    • [install-dir]/content: On-demand video files, caption files, stream files, etc.
    • [install-dir]/keys: Encryption key files if your media server is integrated with Digital Rights Management (DRM) systems.
    • [install-dir]/lib: Important: Copy ONLY your customized module (.jar) files to the new instance.
    • [install-dir]/logs: Copy if needed (for example, for client billing).
    • [install-dir]/manager/conf: Wowza Streaming Engine Manager configuration files.
    • [install-dir]/transcoder: Copy custom Transcoder template files.
  5. On the new server instance, delete the [install-dir]/conf/Server.guid and [install-dir]/conf/Admin.guid files.
  6. Start (or restart) the Wowza Streaming Engine and Wowza Streaming Engine Manager services for the new server instance and test your new server instance configuration.

    Notes:

    • If your migrated content files included sidecar captions for on-demand streams, you must re-enable closed captioning on the new server instance. For details, see How to serve sidecar caption files for on-demand streaming.
    • If you need to roll back to your previous configuration, shut down the new server instance and start the Wowza Streaming Engine services again on the old server instance.

Uninstalling the old Wowza Streaming Engine software instance

After you've successfully started Wowza Streaming Engine and Wowza Streaming Engine Manager on the new media server instance, and fully tested the basic functionality and applications, you can uninstall your old Wowza Streaming Engine server instance.

  • Windows – Go to the Programs and Features Control Panel, click Wowza Streaming Engine [old-instance-version], and then click Uninstall.
  • OS X – Go to /Applications/Wowza Streaming Engine [old-instance-version] and double-click Wowza Streaming Engine Uninstall.
  • Linux – Run the following commands:
    cd /usr/local/WowzaStreamingEngine-[old-instance-version]
    sudo ./uninstall

Important: If the computer is running the Windows operating system, AND you migrated your media server settings and content to a newer version of the Streaming Engine software on the same computer, you must back up Wowza Streaming Engine environment variables. After you uninstall the old media server instance, restore the environment variables from the backup to allow your new Wowza Streaming Engine server instance to continue to work.=red>

  1. Open an elevated Command Prompt and run the SET command to export Wowza system variables to a file. For example:
    C:\> set | find "WMS" > myWowzaVars.txt
    Exports all Wowza system variable names and their values to a file named myWowzaVar.txt in Windows drive C.
  2. Uninstall the old media server instance, and then restart the media server.
  3. Open the System Properties dialog box (click Start, click Run, and in the Run dialog box, enter SystemPropertiesAdvanced), and then click the Environment Variables button.
  4. Under System variables, click New, and then in the New System Variable dialog box, copy a variable name and its value from the Wowza system variables that you exported into Variable name and Variable value, and then click OK. Repeat this step for all of the Wowza variables (WMSAPP_HOME, WMSCONFIG_HOME, WMSINSTALL_HOME, WMSJAVA_HOME, and WMSMGR_HOME).
  5. Click OK to close the Environment Variables and System Properties dialog boxes, and then restart the media server.

If you're having problems or want to discuss this article, post in our forum.