| Expand | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
|
The Diagnostic Web Server (DWS) allows you to view and modify various settings on a networked BrightSign player. This page will walk you through setting up and using the Diagnostic Web Server.
There are two types of DWS:
Remote DWS : You can access the DWS (RDWS): accessible over the Internet with BrightAuthor:connected or a web browser.
Local DWS : You can access the DWS on (LDWS): accessible over the local network with the BrightSign App or a web browser or the BrightSign Shell.
The Remote and Local DWS variants provide nearly the same functionality , with a few exceptions that are noted in this documentbelow.
DWS Versions
This document describes the DWS as of OS8OS 8. See the attached document for documentation on the DWS before OS8OS 8.
| View file | ||
|---|---|---|
|
Setting up the DWS
The Diagnostic Web Server DWS is enabled out of the box. If you'd like to access the DWS before performing the player setup process, skip down to the Accessing the DWS section. Otherwise, follow the below steps to configure the DWS during the player setup process.
...
In BrightAuthor:connected, go the the Admin tab and select Device Setup.
Under Advanced Device Player Settings, select Device Configuration > Player Configuration, click the box to enable the Local Diagnostic Web Server.
(Optional) Enter a Password for the DWS for additional network security. The User name Username will always be “admin”.
(Optional) Under Advanced Device Player Settings, select Remote Snapshot and check the Enable remote snapshots > 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 Snapshots Screenshots tab on the DWS.
Specify other player settings as desired and publish the setup files.
...
either save the Setup to a file location or add the Setup to the Setup Library.
...
BrightAuthor:connected Network tab (Properties Section)
...
| Code Block |
|---|
nc = CreateObject("roNetworkConfiguration", 0)
rebootRequired = nc.SetupDWS()
if rebootRequired RebootSystem() |
Setting the Password
By default, the DWS is enabled with the player serial number as password. To set a custom password with digest authentication, use the roNetworkConfiguration object:
...
Use the username “admin” and your chosen password when connecting to the DWS.
Accessing
...
the
...
DWS
...
Remote DWS
In BrightAuthor:connected, go to the Network tab and locate the player you wish to access. Click the 
icon to access the DWS of that player.
...
The Diagnostic Web Server user interface consists of several tabs. This section details the information and settings offered by each tab.
...
Info
This page provides general information about the player and its current status:
Time: The current time as it is configured on the player. On the local DWS, you can select the
icon to configure the time on the player:Automatically: Click Use Client to set the time of the player using the current time of the browser/application.
Manually: Enter a Time and Date to set on the player. These values will go into effect the moment you click the Set Time button. If you would like to interpret the date/time using the time zone of the player, check the Apply Timezone box. Otherwise, the date/time will be applied as a UTC value.
...
Name: The user-supplied name of the player
Description: An optional user-supplied description for the player
Model: The model number of the player
Unique ID: The serial number of the player
<Ethernet/WiFi> IP: The IP address of the player
<Ethernet/WiFi> MAC: The media access control (MAC) address of the player
Boot Version: The current version of the primary boot loader
BrightSign OS BrightSignOS Version: The current OS version of OS installed on the player
Video Mode: The current video output resolution. You can change the video resolution in the Video tab.
Uptime: The amount of time the player has been powered on and working correctly
Power Source: Displays the power source (for example, AC)
PoE: The status of the PoE interface (applicable to PoE capable models only)
...
...
Log
This page provides a log of system processes and events on the player. The output is similar to the information generated through a serial, Telnet, or SSH connection.
...
Set Password (Local DWS only): Set a new password for DWS authentication on the local network.
Reboot Player: Reboot the player remotely.
Reboot with Crash Report: Reboot the player and save a crash-report file to the "brightsign-dumps" folder. BrightSign support may request the crash report when helping you troubleshoot the player.
Factory Reset: Reset the player to factory defaults, erasing all persistent registry settings for networking, security, and other applications.
Recovery URL: Set a new recovery URL, which is used by the player to retrieve setup information if there is an autorun-related failure.
DWS Access: Enable/disable DWS access on the local network.
SD /
...
microSD / MSATA /
...
USB
This page provides information related to the storage device attached to the player.
File Uploads
You can use this page to upload files to the player storage. Files are uploaded to the currently selected directory. To upload files, click the Browse button to select one or more files, then click Upload Files. File uploads are limited to 10MB on the Remote DWS.
File Listing
This page also provides a listing of all files on the storage device. Depending on the type of file, there will be several options:
...
Network Configuration: View extensive information about network interface settings.
Network Diagnostics: Run network diagnostics. This process may take some time to complete, especially when certain tests fail.
DNS Lookup: Test the specified DNS address to check whether name resolution is working.
Ping: Ping a device with the specified IP address or DNS name.
Trace Route: Perform a standard traceroute diagnostic on the specified IP/DNS address. Check the Resolve IP Addresses box to resolve the specified DNS name.
Network Neighborhood: Display information on the current network neighborhood.
Network Packet Capture: Allows the capture and collection of live network packet data from the network interfaces connected to the BrightSign player.
Disable Autorun: Force the player to reboot and disable the autorun script when the device restarts. This allows the unit to display the firmware OS version and IP address on screen (if the unit is connected to a local network). If the player has a serial port, you will be able to access the system shell over a null-modem serial cable.
Storage Formatting: Takes you to the Format Storage page, which allows you format storage devices attached to the player.
Storage: Select a storage device. You can only format storage devices that are currently unformatted; storage that already contains content files or autorun scripts cannot be reformatted.
File system: Select a supported file system to use when formatting the storage device.
Telnet/SSH: Allows you to enable Telnet and SSH for your player. This lets you access the BrightSign application console when serial port (the default I/O for the application console) is inaccessible. Not that we do not recommend enabling either Telnet or SSH in a production environment for security reasons. A Port Number can be set for Telnet, and a Port Number and SSH Password can be set for SSH as shown in the image below:
...
...
Screenshots
This page allows you to view Remote Snapshots Screenshots of the visual output of the player.
Click the New Snapshot Screenshot button to take a snapshotscreenshot. Once the snapshot is screenshot has been taken, you can click the thumbnail to view a full-size image of the snapshotscreenshot.
Video
This page provides several diagnostic tools related to the video settings of the player:
HDMI Status: Whether each player HDMI® connection (indicated as HDMI-1, HDMI-2, etc.) is “Active” or “Inactive”
Current Video Mode: The video resolution currently being output on each HDMI connection (indicated as HDMI-1, HDMI-2, etc.). If the player is set to a 4K video mode, this field will also indicate whether the10-bit colorspace and/or HDR (high dynamic range) is currently being output.
Power Save: Disables HDMI output, the syncs for VGA output, and/or the DAC output for component video for each HDMI connection (indicated as HDMI-1, HDMI-2, etc.). The absence of a signal will cause some monitors to go into standby mode.
EDID Information: Displays the EDID data returned from one or more monitors attached to the player’s HDMI ports (indicated as HDMI-1, HDMI-2, etc.). This information can be copied and pasted into a text editor.
Change Video Mode: Changes the display mode/resolution of the player on all video outputs (HDMI®, VGA, and Component). The device will reboot and disable the current autorun script (similar to the Disable Autorun button in the Diagnostics tab). Otherwise, the autorun script will reset the video mode of the player by default.
EDID Information: Returns the EDID information from a compatible monitor.
Advanced
BrightSign OS BrightSignOS Update: Instruct the player to download a .bsfw firmwareOS-update file from the specified URL. After the file has been downloaded, the player will reboot and update its BrightSign OS BrightSignOS version.
Storage Location: Enter the storage location and select View to temporarily access the player storage location.
BrightSign OS Logs: Select the level of detail you prefer in the BrightSignOS logs and then select Set to apply that setting.
...
Select View Registry Dump to view the player registry. You can copy the output to the clipboard or download it to a text file.
To submit registry commands, add registry entries, or delete registry entries, enter that information in the empty field under Command and then select Submit. You must reboot the player to see changes to the registry.
...
...