Changing Software Logging Level via Configuration File

-----------------------------------

Affected Roles: Administrator, Power User

Related Digital Watchdog VMS Apps: DW Spectrum

Software Version: DW Spectrum 6.0

Last Edit: March 24, 2025

-----------------------------------

Application Server Logs

As DW Spectrum runs, the system will create a Server log that keeps a record of all Server transactions in basic text form, while a Desktop Client log keeps a record of all client interactions. In certain cases, to speed up and simplify the troubleshooting process, you may be asked to provide support technicians with Server or Desktop Client logs.

There are multiple ways to obtain these logs:

• Through the DW Spectrum Client application
• Through the application file directory
• By following log files in real-time

This article will outline how to change the Desktop Client and Server logging level of DW Spectrum on Windows, Ubuntu, and Macintosh (client only) using the Windows Registry Editor, or with an Ubuntu or macOS configuration file.

Related Articles

• DW Spectrum – Configuring Log Files with the Desktop Client
• DW Spectrum – Finding Server Logs with File Directory
• DW Spectrum – Modifying Server Logging Level with Web Admin
• DW Spectrum – Following Log Files in Real-Time

Part 1: Changing the Server Configuration File

Windows Registry Editor

1. To increase the logging level using the Registry Editor:
   1. Open the Registry Editor tool.

1. 2. In the Registry Editor, navigate to:

2. Add a logLevel string, and set the desired value (e.g., DEBUG2).

Click OK to save.

3. Restart the Media Server to apply changes.

4. Server logs will be available at:

Ubuntu Configuration File

1. To change the log level, open vi editor and modify the server config file:

2. Add a logLevel string, set the desired value (e.g., DEBUG2), then save the modified file.

3. Restart the Media Server to apply changes

4. Application logs will be available at:

Part 2: DW Spectrum Desktop Client

Windows Registry Editor

1. Stop all running desktop client instances (including Videowall) on the client computer.

2. To increase the logging level using the Registry Editor.
   1. Open the Registry Editor tool.

1. 2. In the Registry Editor, navigate to:

3. Find the logLevel, then double-click to select it.

Set the desired Value data (e.g., DEBUG2) then click OK to save.

4. Start the DW Spectrum Client to apply the changes.

5. The Desktop Client logs are now available in:

C:\Users\%username%\AppData\Local\Digital Watchdog\Digital Watchdog DW Spectrum Client\log

Ubuntu Configuration File

1. Stop all running Desktop client instances (videowall included) on the specific client computer.

2. To change the log level open vi editor and modify the client config file:

3. Find the logLevel string, set the desired value (e.g., DEBUG2), then save the modified value.

4. Start the client to apply changes.

5. Desktop Client logs will be available at:

Macintosh Configuration File

1. Stop all running Desktop client instances (videowall included) on the specific client computer.

2. Open Terminal and convert the Desktop Client's config file from binary to .xml format: 

3. Open the converted config file with the vim command:

4. Find the line <key>logLevel</key> by entering the search command:

5. Enter edit mode by pressing “i" and edit the line directly under the highlighted search result. It should be changed from “<string>none</string>” to “<string>DEBUG2</string>”.

If it cannot be found in the file, create the <key>logLevel</key> entry yourself.

6. Press the ESC button, then type the command “:wq” and press the ENTER key.

7. Desktop Client logs will be available at:

For More Information or Technical Support

DW Technical Support:  866.446.3595 (option 4)

https://www.digital-watchdog.com/contact-tech-support/

______________________________________________________________________________

DW Sales:  866.446.3595                   [email protected]        www.digital-watchdog.com