Load and lock an appinstance with a Wowza Streaming Engine server listener

Use the ServerListenerLoadAndLockAppInstances server listener for Wowza Streaming Engine™ media server software when you need to have an application load and remain loaded until the Wowza Streaming Engine server is shut down. The server listener can be configured to load multiple applications or application instances on the server.

Contents


Prerequisites
Installation
Configuration
Properties
Usage
For developers

Prerequisites


Wowza Streaming Engine 4.0.0 or later is required.

Installation


  1. Download wse-plugin-loadandlockinstances.zip.
     
  2. Extract the contents from the downloaded (zipped) package, and then copy the lib/wse-plugin-loadandlockinstances.jar file from the package to the lib folder in your Wowza Streaming Engine installation ([install-dir]/lib).
     
  3. Restart Wowza Streaming Engine.

Configuration


To enable the server listener, add the following server listener definition to your server. See Configure server listeners for details.

Base Class
com.wowza.wms.plugin.LoadAndLockAppInstances

Properties


After enabling the server listener, you can adjust the default settings by adding the following properties to your server. See Configure properties for details.

Path
Name
Type
Value
Notes
/Root/Server loadAndLockVHost String myVHost Name of Virtual Host on which to load the applications. This string is needed only if there are custom Virtual Hosts. (default: _defaultVHost_)
/Root/Server loadAndLockApplications String live1, live2, live3/myInstance Comma-separated list of applications and application instance names to load. If the default application instance (_definst_) is to be loaded, then you can use the application name without the application instance name. For example, the value live1, live2, live3/myInstance loads the default application instance on the live1 and live2 applications and loads an application instance named myInstance on the live3 application.

Usage


Specify the applications and application instances that you want to load for each virtual host by leveraging the appropriate properties above.

For developers


  • Get the source code on GitHub