• How to migrate Wowza Streaming Engine to a different server

    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 your Wowza software to another server hardware or to a virtualized platform.

    Read these instructions completely before you start migrating Wowza Streaming Engine to a new server.

    Notes:
    1. On the old server, stop the Wowza Streaming Engine services.

      Important: Be sure to stop Wowza Streaming Engine services on the old server. If Wowza Streaming Engine processes are running on the old server, you may either be charged for a second instance (for Subscription keys) or get a startup error (for Perpetual keys).
      Do not uninstall Wowza Streaming Engine on the old server yet.

      See How to start and stop Wowza Streaming Engine software for instructions on how to stop services on your operating system.

    2. On the old server, create a backup of the Wowza Streaming Engine [install-dir].

    3. On the new server, install Wowza Streaming Engine using your current license. See How to install and configure Wowza Streaming Engine if you need installation instructions.

      A few words about license keys:

      • The Wowza Streaming Engine software version and build on the new server should be the same as on the old server. If you're using a later Wowza software version on the new server, consider updating your current instance first and testing the new version before migrating.

      • You can request an R&D license and use this license key when you install Wowza Streaming Engine on the new server. This would allow you to run both the old and new server instances at the same time. You can then thoroughly test the new server before migrating your applications.

    4. Copy the following folders from the old Wowza Streaming Engine server to the new Wowza Streaming Engine server:

      • [install-dir]/conf
      • [install-dir]/applications
      • [install-dir]/transcoder
      • [install-dir]/manager/conf

    5. On the new server, delete the Server.guid and Admin.guid files from [install-dir]/conf/.

      The new server will regenerate these files.

    6. Copy any custom modules and content from the old Wowza Streaming Engine server to the new Wowza Streaming Engine server.

    7. On the new server, start Wowza Streaming Engine and Wowza Streaming Engine Manager and test all of your applications.

    8. After you've successfully started Wowza Streaming Engine and Wowza Streaming Engine Manager on the new server, and all basic functionality and applications have been fully tested, uninstall Wowza Streaming Engine from the old server.

    9. (Optional) 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.

    Originally Published: For Wowza Streaming Engine on 08-14-2015.
    Updated: 10-21-2015.

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