Enabling Advanced Logging on an Nx12, Nx6, Hx6, or iQ6 Telephone System

Updated by Bryan Jones

Scope

This document covers a number of Telos Talk Show systems, including;

  • Nx6 (legacy product)
  • Nx12 (legacy product)
  • Hx6
  • iQ6

The actual logging available may vary from product to product depending on options but the steps remain the same.

This is intended to be a helper when directed by telos to enable or disable some additional logging. We are not able to detail here what each logging item provides. It would likely be incomprehensible and the logging output often requires a software engineer to decode them.


Description

Logging is enabled and recorded by a Telnet connection. There are no internal logs that are saved. If you want to save these logs you will need to use a terminal program that has this capability. In this example, we'll use PuTTy, a free terminal program available from https://putty.org/. You can use any terminal program you like.

These logging functions are intended to be used for debugging only and not full-time logging. Some logging options are intense and will degrade the performance of the unit. For this reason, we suggest you only enable logging "as needed" and turn it off once you have captured the problem.


Configure PuTTy

  1. Open PuTTy
  2. Click on Session in the left side menu
  3. Ether the IP Address of your Talk Show system in the Host Name field
  4. Select Telnet connection type
  5. Enter port 24 in the Port field
  6. Next, click the Logging link in the left side menu (below Session)
  7. Under the Session Logging heading, select All session output
  8. In the Log file name field, click Browse. Find a location on your local computer to store the log files and assign a file name. Here, we are storing it on the Desktop and are using the filename Hx6.log.
  9. Click the Open button at the bottom to start the Telnet session

You should have a window that looks like this and shows the >> prompt


Configuration

Once you connect, you are greeted with the above banner and prompt.

Login

From the >> prompt, send "login Telos". The connection will echo the command you sent and respond with Logged in with user rights. Note - Telos must have a capital T

>>login Telos
login Telos
Logged in with user rights.
>>

List available logging sources

From the >> prompt send "log." A list of log options is shown.

>>>>log
log
0 - All error log 1 - LWCPDevice
2 - HTMLcomm 3 - INT1
4 - POTScard 5 - Trace
6 - StudioLine 7 - Studio
8 - SharedLineMan 9 - PhoneLine
10 - PHFmessage_send 11 - Nx12Client
12 - MyServer 13 - MyHw
14 - Menu 15 - MainApp
16 - LineManager 17 - LineHandler (inc PLL)
18 - LWCPClientThread 19 - Hybrid
20 - DDFrontPanel 21 - FPWindow
22 - VXManager 23 - CallDirectorVX
24 - CallDirectorAP2x12 25 - Connect64
26 - CallDirector 27 - CallDirDevice
28 - CDDFpHelper 29 - AudioMan
30 - Application 31 - APCore
32 - APClientThread 35 - Parallel Manager
The list of options will change depending on the exact product, its configuration, and the software version.

Enable logging options

The same "log" command is used to enable logging options using the log command plus a number (or numbers). For example, "log 16 18" enables the Line Manager AND LWCPClientThread.

>>log 16 18
log 16 18
Log 16 (LineManager) was enabled!
Log 18 (LWCPClientThread) was enabled!
>>

Disable logging options

Send the log command again with the menu numbers you want to disable. Note the confirmation says "was disabled!"

>>log 16 18
log 16 18
Log 16 (LineManager) was disabled!
Log 18 (LWCPClientThread) was disabled!
>>

Show what log options are enabled

Send the command "log" again with no options. An asterisk (*) will appear next to any currently enabled options. Note - log option 2 (HTMLcomm) as an asterisk indicating that it's enabled.

>>log
log
0 - All error log 1 - LWCPDevice
* 2 - HTMLcomm 3 - INT1
4 - POTScard 5 - Trace
6 - StudioLine 7 - Studio
8 - SharedLineMan 9 - PhoneLine
10 - PHFmessage_send 11 - Nx12Client
12 - MyServer 13 - MyHw
14 - Menu 15 - MainApp
16 - LineManager 17 - LineHandler (inc PLL)
18 - LWCPClientThread 19 - Hybrid
20 - DDFrontPanel 21 - FPWindow
22 - VXManager 23 - CallDirectorVX
24 - CallDirectorAP2x12 25 - Connect64
26 - CallDirector 27 - CallDirDevice
28 - CDDFpHelper 29 - AudioMan
30 - Application 31 - APCore
32 - APClientThread 35 - Parallel Manager


How did we do?