• How to update your Wowza Streaming Engine installation

    This guide provides step-by-step instructions for updating your licensed Wowza Streaming Engine™ media server software installation to a newer version. When you update your Wowza Streaming Engine software, your current installation is automatically backed up in case you want to remove the update later.

    Notes:
    • Wowza Streaming Engine software updaters can't be used to install a new Wowza Streaming Engine instance. For that, you must use an installer. We provide installers for the latest version of Wowza Streaming Engine software on our Downloads webpage.

    • The instructions in this article can't be used to update an existing Wowza Media Server™ software instance. See How to upgrade Wowza Media Server software to Wowza Streaming Engine.

    Contents


    About Wowza Streaming Engine updates
    Applying an update
    Removing an update

    About Wowza Streaming Engine updates


    Updates for Wowza Streaming Engine software are packaged in a ZIP archive updater file using the naming convention WowzaStreamingEngine-Update-[version].zip where [version] is the update version.

    Build updaters

    Build updaters enable you to update your current Wowza Streaming Engine instance to the latest officially released server software build. For example, you can update your Wowza Streaming Engine 4.0.0 instance to Wowza Streaming Engine 4.4.1 by using the build updater file WowzaStreamingEngine-Update-4.4.1.zip.

    Software updaters

    Between server software builds, we produce updaters so you can get the latest bug fixes and improvements for your Wowza media server software, and get early access to new features being developed. When you run a software updater, you might, for example, update your Wowza Streaming Engine 4.0.0 instance to Wowza Streaming Engine 4.3.0.02 by using the updater file WowzaStreamingEngine-Update-4.3.0.02.zip.

    To get an updater, sign in to your Account Management page using your Wowza account and then check the My Downloads tab for your account for available updaters.

    Note: You must have an active Maintenance and Support contract to receive updaters. The Maintenance and Support contract entitles you to free full upgrades and dot-release updates for Wowza Streaming Engine software, and email technical support. If you have a valid license for Wowza Streaming Engine software, you can create an account on Wowza.com and then sign in to your Account Management page to find available updaters on the My Downloads tab.

    Applying an update


    Notes:

    Windows

    1. Extract the updater .zip file contents and then copy the included WowzaStreamingEngine-Update-[version] folder to your [install-dir]/updates directory (where [install-dir] is the install directory of Wowza Streaming Engine).

    2. Open an elevated command prompt:

      1. Click Start, and then in the Search programs and files box type Command Prompt.

      2. In the search results, right click on the Command Line program, and then click Run as administrator.

    3. Execute the following command to change the active directory to the location of update.bat:
      cd [install-dir]/updates/WowzaStreamingEngine-Update-[version]/windows
      Note: Instead of typing out the file path, you can copy the directory from the Finder window and right click in the Command Prompt window to paste the selection.
    4. Execute the following command to apply the update:
      update.bat
    5. Follow the prompts on the command line. You'll see something similar to the following:
      update.bat
      Verifying running as administrative user
      Verifying Java 1.6 or greater is available
      Locating Wowza Streaming Engine installation directory
      Running Wowza Streaming Engine update installer
      
      This will update your installation at : [install-dir]
      
      Currently installed version           : Wowza Streaming Engine <version> - Build <#>
      
      This will update your installation to : Wowza Streaming Engine <version> - Build <#>
      
      Are you sure you want to continue? (y/n)
      y
      Wowza Streaming Engine <version> Release Notes
      
              Version: Wowza Streaming Engine <new version>
      
      This document describes the detailed changes in Wowza Streaming Engine <new version>. For more information about the features and known issues in this version of the server, see the README.txt file in the files directory of this update.
      
      ========================================
      Changes in <new version> Build <#>
      
      ...
      
      Press enter/return to continue
      
      Detected operating system: windows
      Checking file versions.
      Backing up current files.
      Successfully created backup: [path-to-backup-file]
      Updating installation.
      Restoring correct file permissions
      The update process completed successfully.
    6. At this time your Wowza Streaming Engine installation is updated and you must restart the server. See How to start and stop Wowza Streaming Engine software for more information about how to do this.

    DO NOT DELETE the WowzaStreamingEngine-Update-[version].zip file. You'll need this file if you want to remove the update later. Only that version of the update tool will remove that version of the update. See Removing an update for more information about remove (rollback) updates.

    Linux and OS X

    1. Extract the updater .zip file contents and then copy the included WowzaStreamingEngine-Update-[version] folder to your [install-dir]/updates directory (where [install-dir] is the install directory of Wowza Streaming Engine).

    2. Open a Terminal window and execute the following command to change the active directory to the location of update.sh:

      Linux:
      cd [install-dir]/updates/WowzaStreamingEngine-Update-[version]/linux
      OS X:
      cd [install-dir]/updates/WowzaStreamingEngine-Update-[version]/osx
      Note: Instead of typing out the file path, you can drag and drop the folder from Finder into the Terminal window to automatically enter the folder location.
    3. Change to root or use the sudo command if you have sudo privileges to perform the following commands:

      1. If you must restore the execute permissions on the initial update scripts, execute the following command:
        sudo chmod +x *.sh
      2. Execute the following command to apply the update:
        sudo ./update.sh
    4. Follow the prompts on the command line. You'll see something similar to the following:
      ./update.sh
      Verifying running as administrative user
      Verifying Java 1.6 or greater is available
      Locating Wowza Streaming Engine installation directory
      Running Wowza Streaming Engine update installer
      
      This will update your installation at : [install-dir]
      
      Currently installed version           : Wowza Streaming Engine <version> - Build <#>
      
      This will update your installation to : Wowza Streaming Engine <version> - Build <#>
      
      Are you sure you want to continue? (y/n)
      y
      Wowza Streaming Engine <version> Release Notes
      
              Version: Wowza Streaming Engine <new version>
      
      This document describes the detailed changes in Wowza Streaming Engine <new version>. For more information about the features and known issues in this version of the Server, see the README.txt file in the files directory of this update.
      
      ========================================
      Changes in <new version> Build <#>
      
      ...
      
      Press enter/return to continue
      
      Detected operating system: [linux]|[osx]
      Checking file versions.
      Backing up current files.
      Successfully created backup: [path-to-backup-file]
      Updating installation.
      Restoring correct file permissions
      The update process completed successfully.
    5. At this time your Wowza Streaming Engine installation is updated and you must restart the server. See How to start and stop Wowza Streaming Engine software for more information about how to do this.

    DO NOT DELETE the WowzaStreamingEngine-Update-[version].zip file. You'll need this file if you want to remove the update later. Only that version of the update tool will remove that version of the update. See Removing an update for more information about remove (rollback) updates.

    Removing an update


    Notes:

    Windows

    1. Extract the updater .zip file contents and then copy the included WowzaStreamingEngine-Update-[version] folder to your [install-dir]/updates directory, if you don't already have it there from applying the update.

    2. Open an elevated command prompt:

      1. Click Start, and then in the Search programs and files box type Command Prompt.

      2. In the search results, right click on the Command Line program, and then click Run as administrator.

    3. Execute the following command to change the active directory to the location of update.bat:
      cd [install-dir]/updates/WowzaStreamingEngine-Update-[version]/windows
      Note: Instead of typing out the file path, you can copy the directory from the Windows Explorer window and right click in the Command Prompt window to paste the selection.
    4. Execute the following command to remove the update:
      update.bat -u
    5. Follow the prompts on the command line. You'll see something similar to the following:
      update.bat -u
      Verifying running as administrative user
      Verifying Java 1.6 or greater is available
      Locating Wowza Streaming Engine installation directory
      Running Wowza Streaming Engine update installer
      
      This will uninstall Wowza Streaming Engine <update version> - Build <#> from your system.
      
      This will be removed from your installation at : [install-dir]
      
      Detected operating system: windows
      Found backupfile.  [backup-file-name]
      Restoring from detected backup: [path-to-backup-file]
      Restoring to version: Wowza Streaming Engine <old version> - Build <#>
      Are you sure you want to continue? (y/n)
      y
      Restoring from [path-to-backup-file]
      Restoration complete.
    6. At this time your Wowza Streaming Engine update is rolled back and you must restart the server. See How to start and stop Wowza Streaming Engine software for more information about how to do this.

    Linux and OS X

    1. Extract the updater .zip file contents and then copy the included WowzaStreamingEngine-Update-[version] folder to your [install-dir]/updates directory, if you don't already have it there from applying the update.

    2. Open a Terminal window and execute the following command to change the active directory to the location of update.sh:

      Linux:
      cd [install-dir]/updates/WowzaStreamingEngine-Update-[version]/linux
      OS X:
      cd [install-dir]/updates/WowzaStreamingEngine-Update-[version]/osx
      Note: Instead of typing out the file path, you can copy the directory from your Windows Explorer window and right click in the Command Prompt window to Paste the selection.
    3. Change to root or use the sudo command if you have sudo privileges to perform the following commands:

      1. If you must restore the execute permissions on the initial update scripts, execute the following command:
        chmod +x *.sh
      2. Execute the following command:
        update.sh -u
    4. Follow the prompts on the command line. You'll see something similar to the following:
      update.sh -u
      Verifying running as administrative user
      Verifying Java 1.6 or greater is available
      Locating Wowza Streaming Engine installation directory
      Running Wowza Streaming Engine update installer
      
      This will uninstall Wowza Streaming Engine <version> - Build <#> from your system.
      
      This will be removed from your installation at: [install-dir]
      
      Detected operating system: [linux]|[osx]
      Found backup file:  [backup-file-name]
      Restoring from backup:[install-dir]/updates/backup/[backup-file-name]
      Restoring to version: Wowza Streaming Engine <old version> - Build <#>
      Are you sure you want to continue? (y/n)
      y
      Restoring from backup: [install-dir]/updates/backup/[backup-file-name]
      Restoration complete.
    5. At this time your Wowza Streaming Engine update is rolled back and you must restart the server. See How to start and stop Wowza Streaming Engine software for more information about how to do this.

    Originally Published: 02-11-2014.
    Updated: For Wowza Streaming Engine 4.4.1 on 03-02-2016.