Perform a silent installation of Wowza Streaming Engine

You can use the silent installation process to install Wowza Streaming Engine™ media server software without any manual interaction. This unattended installation approach provides the convenience of automating the installation of a large number of Wowza Streaming Engine instances.

Prerequisites


Complete a request form

Submit a request to use a Wowza Streaming Engine silent installer using the Wowza Media Systems™ DocuSign form. Allow 24 hours for the Wowza team to process your request. Once your request is approved, you will receive information including a silent install key.

Configure the response file

The WSE4.opt Response file is used to control the silent install process. Download a sample WSE4.opt file to help you customize your installation. At a minimum, you must configure the silent install key and Wowza Streaming Engine license key values in this file. You must configure a separate response file for each Wowza Streaming Engine instance that you install.

Download Wowza Streaming Engine software

Silent installation of Wowza Streaming Engine only works with Wowza Streaming Engine production builds. To silently install a Wowza Streaming Engine instance on Windows, macOS, and Linux operating systems, you can download the latest Wowza Streaming Engine installers for these operating systems from the Wowza Streaming Engine Downloads webpage. 

Perform the installation


This section describes how to perform a silent installation of Wowza Streaming Engine, using command-line syntax specific to the supported operating systems. The syntax that's shown assumes that the silent installer and WSE4.opt response file are located in the same folder and that you replace [version] with the Wowza Streaming Engine software version number (4.x.x).

Note: We recommend using a 64-bit operating system for optimal performance and to enable use of the Transcoder feature.

Windows installers

WowzaStreamingEngine-[version]-windows-installer.exe --optionfile wse4.opt

macOS installers

sudo WowzaStreamingEngine-[version]-osx-installer.app/Contents/MacOS/installbuilder.sh --optionfile wse4.opt

Linux installers

chmod +x ./ WowzaStreamingEngine-[version]-linux-x64-installer.run sudo ./ WowzaStreamingEngine-[version]-linux-x64-installer.run --optionfile wse4.opt

Linux package managers

Red Hat

sudo rpm –Uvh WowzaStreamingEngine-[version]-linux-x64-installer.rpm

Debian

sudo dpkg –i WowzaStreamingEngine-[version]-linux-x64-installer.deb
 
Note: We recommend that you use the Linux installer to install Wowza Streaming Engine. Only advanced Linux users should install the software using a package manager.

Add a license key and administrator credentials


After the installation is complete and before you can start the software, you must create a Server.license file that stores your license key for the media server software and an admin.password file that stores your administrator credentials for Wowza Streaming Engine Manager.

Add a Server.license file

  1. Create a file named Server.license in the Wowza Streaming Engine installation directory ([install-dir]/conf/) for your operating system:
    • Windows – %WMSCONFIG_HOME%\conf\Server.license
    • macOS – /Library/WowzaStreamingEngine/conf/Server.license
    • Linux – /usr/local/WowzaStreamingEngine/conf/Server.license
  2. Enter each license key on a new line.

Add an admin.password file

  1. Create a file named admin.password in the Wowza Streaming Engine installation directory ([install-dir]/conf/) for your operating system:
    • Windows – %WMSCONFIG_HOME%\conf\admin.password
    • macOS – /Library/WowzaStreamingEngine/conf/admin.password
    • Linux – /usr/local/WowzaStreamingEngine/conf/admin.password
  2. To provide administrator account access to advanced property, server listener, and module settings, which are reserved for expert Wowza Streaming Engine users, add credentials to the file, specifying the advUser group as shown in the following example:
     
    # Admin password file (format [username][space][password][space][group]) 
    # username password group|group 
    Admin AdminPassword admin|advUser


    Administrators can create accounts for other users with full administrative access to Wowza Streaming Engine Manager or with read-only privileges.

Start the software


Now that installation is complete, you can start the software. See Start and stop Wowza Streaming Engine for details.

Note: If you install the software using a package manager, after the installation is completed, you must start the software as a service (the ability to start the software automatically isn't supported). For details, see Start and stop Wowza Streaming Engine as a service (Linux).

Troubleshooting


During the silent installation of the Wowza Streaming Engine software, a log file named bitrock_installer.log is created. You can review this file if issues arise during the silent installation process.

On Windows, the log is created in the user's local Temp directory (usually C:\Documents and Settings\[Username]\Local Settings\Temp).

On Linux and OS X, the log file is created in the /tmp directory.

Note:

If a bitrock_installer.log file already exists from a previous installation, the installer will create a new log file with one of the following unique file names:

  • bitrock_installer_[pid].log
  • bitrock_installer_[pid]_[uid].log

The [pid] value is the process program identifier. If a log file is present with this value, a new log file is created with the [uid] value as a unique identifier in the file name.