Set up the Local Diagnostic Web Server

Initial Setup in BrightAuthor:connected

Follow these steps to enable and configure the Local DWS during the player setup process in BrightAuthor:connected:

In BrightAuthor:connected, go the the Admin tab and select Setup.
Under Player Settings > Player Configuration, click the box to enable the Local Diagnostic Web Server.
(Optional) Enter a Password to the DWS for additional network security. The Username will always be “admin”.
(Optional) Under Player Settings > Remote Screenshot, click the box to Enable remote screenshots box if you would like the player to take screenshots of the display area. These screenshots are accessible from the Screenshots tab on the DWS.
Specify other player settings as desired and either save the setup to a file location or add the setup to the Setup Library.

Other Local DWS Setup Methods

You can enable the Local DWS on port 80 (the default) by submitting a networking http_server 80 command through the Registry tab of the Remote DWS as shown below.

Advanced Local DWS Setup

You can also configure the Local Diagnostic Web Server using the BrightSign serial command prompt or a custom script:

BrightScript

The Local DWS can also be enabled in a custom script using the roNetworkConfiguration object. Include the following lines in a autorun.brs script to enable the Local DWS on Ethernet port 80:

nc = CreateObject("roNetworkConfiguration", 0)
rebootRequired = nc.SetupDWS()
if rebootRequired RebootSystem()

Serial Prompt

Enter the following commands in the serial prompt to run the Local DWS on the standard port:

>>registry write networking http_server 80
>>registry flush

A registry flush is necessary if you plan to power cycle the unit after executing the registry command. Registry writes will buffer for a few seconds because the EEPROM and NAND have a limited number of writes (and thus need to protect against carrying out too many writes too quickly).

Setting the Password

By default, the Local DWS is enabled with the player serial number as password. To set a custom password with digest authentication, use the roNetworkConfiguration object:

nc = CreateObject("roNetworkConfiguration", 0)
rebootRequired = nc.SetupDWS({open:"password"})
if rebootRequired RebootSystem()

Use the username “admin” and your chosen password when connecting to the Local DWS.

Access the DWS before Setting up the Player

The Remote DWS is enabled out of the box. To access the Local DWS before setting up the player, DWS Access must be turned on in the Control tab of the Remote DWS.

To access the Local DWS using a web browser on the local network:

Get the IP address of the player:
1. In the Remote DWS, select the IP Address category the Player List gear icon, or find it in the Info tab of the RDWS, or under Network Settings for the selected player.
2. If you don’t have access to the Remote DWS, you can get the IP address by:
  1. Powering off the player by unplugging the power supply.
  2. Removing the SD card (as well as any internal storage devices, if applicable).
  3. Powering on the BrightSign player by reconnecting the power supply.
  4. Waiting for the player to boot up: The IP address of the player will be displayed on the screen.
Enter the IP address of the networked player into the address bar of a web browser:
1. If you've set up the DWS with a password, enter the password. The username is always "admin".
2. If you haven't previously configured the DWS, use the serial number of the player as the password.

IP Address Variants

If the player is still set to factory defaults (i.e. the IP address returns the Device Setup screen), append /index.html to the end of the IP address (for example, 10.1.0.99/index.html).
If the player is configured to use Appspace, append port 8080 to the end of the IP address (for example, 10.1.0.99:8080).
If the player is running the Streaming Server module, append port 80 to the end of the IP address (for example, 10.1.0.99:80).

Alternatively, you can access the Local DWS via the player’s serial number by typing brightsign-<serialNumber>.local into the browser where <serialNumber> is the serial number of the player (for example, brightsign-M2E33P002148.local). Bonjour must be installed to use this on Windows (it will work out of the box on Mac and desktop Linux unless the configuration has been changed).

Documentation