• How to connect to remote Streaming Engine installations (whitelist)

    By default, Wowza Streaming Engine is configured to accept connections from Wowza Streaming Engine Manager on the localhost. When you start Streaming Engine Manager on the localhost, you can expand the Server information on the Sign In page to see the default localhost connection URL (Wowza Streaming Engine URL = http://localhost:8087).


    This article describes two options for connecting to a remote (non-localhost) Streaming Engine from your local computer:


    Note: Wowza Streaming Engine™ software is required.

    Connect to remote Streaming Engine Manager from local web browser

    1. Make sure that the Wowza Streaming Engine and Wowza Streaming Engine Manager software is started on the same remote server that you want to manage (see How to start and stop Wowza Streaming Engine software).

    2. In a web browser on the local client computer, open Streaming Engine Manager on the remote server with the following URL:
      http://[wowza-ip-address]:8088/enginemanager

      where [wowza-ip-address] is the remote Wowza media server IP address or hostname.

    3. On the Sign In page, enter credentials (user name and password) that are configured in the Streaming Engine software on the remote server (for more information, see Manage credentials).
      DO NOT MODIFY the default Wowza Streaming Engine URL for the local host (http://localhost:8087).


    4. Click the Sign In button.


    Connect to remote Streaming Engine from local Streaming Engine Manager

    Note: This option requires the Wowza Streaming Engine software to be installed on the remote server computer (the Wowza media server that you want to manage) and Wowza Streaming Engine Manager to be installed on the local computer (the client computer that you're using to connect to the remote server).
    To use your local installation of Wowza Streaming Engine Manager to manage remote (non-localhost) Streaming Engine software installations, you must configure security settings on each remote Streaming Engine server computer that you want to manage to allow access from the local manager. This process is called whitelisting.

    On each remote Wowza Streaming Engine server:

    1. Make sure that the Streaming Engine software is stopped (see How to start and stop Wowza Streaming Engine software).

    2. Open the [install-dir]/conf/Server.xml file in the Streaming Engine software installation using a text editor and update the <IPWhitelist> property:
      <RESTInterface>
      	---
      	<IPWhitelist>[client-ip-address]</IPWhitelist>
      	---
      </RESTInterface>
      Where [client-ip-address] is the IP address of the non-localhost computer that has Wowza Streaming Engine Manager installed.

      Notes:
      • You can specify that multiple IP addresses be allowed to connect by entering them as a comma-separated list and/or by using the wildcard (*) character. For example: <IPWhitelist>*</IPWhitelist> or <IPWhitelist>192.168.*.*</IPWhitelist>

      • If the Streaming Engine server is not part of your LAN or it's on the Internet, use the public/WAN IP of the browser/client network.
    3. Save the changes in the Server.xml file.

    4. If the Streaming Engine software was running when you made these changes, restart it to put the changes into effect.

    After a Streaming Engine Manager computer is whitelisted, do the following to connect the whitelisted non-localhost manager to the remote Streaming Engine installation:

    1. Make sure that the Wowza Streaming Engine software is started on the remote server computer that you want to manage (see How to start and stop Wowza Streaming Engine software).

    2. On the local client computer, start Wowza Streaming Engine Manager (see How to start and stop Wowza Streaming Engine software).

    3. On the Sign In page, enter User Name (for example, myUser) and Password. This requires the user name and password credentials to be configured in the Streaming Engine software on the remote computer (for more information, see Manage credentials).


    4. Expand the Server node. Then in Wowza Streaming Engine URL, enter the remote Streaming Engine URL in the form http://[wowza-ip-address]:8087, where [wowza-ip-address] is the remote Wowza Streaming Engine computer's IP address or hostname.


    5. Click the Sign In button.



    Originally Published: 03-12-2014.
    Updated: For Wowza Streaming Engine 4.0.6 on 08-11-2014.

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