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 More resources

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.6.0 instance to Wowza Streaming Engine 4.7.0 by using the build updater file WowzaStreamingEngine-Update-4.7.0.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.6.0 instance to Wowza Streaming Engine 4.6.0.04 by using the updater file WowzaStreamingEngine-Update-4.6.0.04.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:

Apply an update on Windows (video tutorial)

Apply an update on Windows (step-by-step instructions)

  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.

Apply an update on Linux and OS X (video tutorial)

Apply an update on Linux and OS X (step-by-step instructions)

  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:

  • Administrator/root privileges are required to remove an update.
  • You must stop Wowza Streaming Engine and Wowza Streaming Engine Manager before removing an update. See How to start and stop Wowza Streaming Engine software for more information about how to do this.

Remove an update on Windows (step-by-step instructions)

  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.

Remove an update on Linux and OS X (step-by-step instructions)

  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.

More resources