Diagnostics using PuTTY

This section provides instructions on using the PuTTY application to obtain diagnostic information about gateway operation. PuTTY is a freely distributed client for remote access protocols, including SSH, Telnet and rlogin. PuTTY can also connect to devices via serial port.

For additional information on configuring and using PuTTY, please refer to the documentation on the PuTTY application.

Connecting a computer to the gateway via USB-UART adapter

To use PuTTY for diagnostics of Kaspersky IoT Secure Gateway 100,

Use the USB-UART adapter available in the distribution kit to connect a computer to the UART diagnostic connector located under the right-side cover of the device (see the figure below).

Location of the UART diagnostic connector

UART diagnostic connector contacts

When connecting the USB-UART adapter to the UART diagnostic connector, make sure you match the proper contacts of the diagnostic connector (see the table below).

Purpose of UART diagnostic connector contacts

Example of connecting a USB-UART cable to a UART diagnostic connector

If the colors of the adapter wires differ from those presented in the table and in the figure, refer to the text label on the connectors or circuit board of the USB-UART adapter.

Configuring a connection to the gateway in PuTTY

To configure a connection in PuTTY:

1. Run the PuTTY application.

   The PuTTY Configuration dialog box is displayed at startup. The Session option is selected by default in the Category panel of the dialog box.

2. In the Specify the destination you want to connect to → Connection type settings block, select the Serial option.
3. In the Serial line field, specify the name of the serial port corresponding to the connected USB-UART adapter (for example, /dev/ttyUSB0 in Linux or COM8 in Windows).

   In Linux, you can identify the port name by running the ls /dev/ttyUSB* command. If this command returns multiple names, you can run it again with the USB-UART adapter connected and then disconnected. The name that appears when the adapter is connected will be the one you're looking for.

   In Windows, you can identify the port name by running Device Manager. In the console tree, open the Ports (COM and LPT) folder and find the object corresponding to the connected USB-UART adapter. The object name will contain the name of the port in parentheses. For example, Prolific USB-to-Serial Comm Port (COM8).

4. In the Speed field, set the data transfer speed value at 115200 baud/sec.
5. In the Category panel, select Session → Logging.
6. In the Session logging settings group, select the All session output option.
7. In the Log file name field, specify the path to the event log file.

   You can specify the file name in the following format: KISG100LOG_&Y_&M_&D_&T.log. In this case, a new log file will be created for each new PuTTY connection session, and the date and time of the session start will be automatically added to the file name.

8. In the Category panel, select Session.
9. In the Load, save or delete a stored session settings block, in the Saved Sessions field, specify the name of the connection with the gateway (for example: KISG100).
10. Click Save.

Page top

Obtaining diagnostic information in PuTTY

To obtain a log file containing diagnostic information:

1. Connect a computer to the gateway via USB-UART adapter.
2. Run the PuTTY application.
3. In the Load, save or delete a stored session settings block, select a previously saved connection with the gateway (for example: KISG100).
4. Click Load.

   As a result, the previously saved values for the gateway connection settings will be loaded.

5. Click Open.

PuTTY will open a terminal window that displays the diagnostic information received from the gateway. The displayed information is also written to the event log file that was specified in the Log file name field when configuring the connection with the gateway.

The table below lists possible problems with PuTTY when receiving diagnostic information in Linux, and the ways to resolve these problems.

Potential problems with PuTTY when working in Linux

Page top

Verifying information from the diagnostics log

This section provides instructions on performing diagnostics for Kaspersky IoT Secure Gateway 100 based on information from the diagnostics log file. To obtain the diagnostics log file, connect the gateway to a computer via the USB-UART adapter and use the PuTTY application.

Diagnostics of KasperskyOS startup

Open the diagnostics log file. Successful startup of

Diagnostics of OPC UA operation

The

If these messages are absent from the event log file or are different from the messages listed above, the OPC UA client is likely experiencing operational problems.

Diagnostics of MQTT client operation

The

If these messages are absent from the event log file or are different from the messages listed above, the MQTT client is likely experiencing operational problems.

Diagnostics of the navigation (routing) service for transmitted data

The routing service was successfully started if the diagnostics log contains the following messages:

If these messages are absent from the event log file or are different from the messages listed above, the OPC UA client is likely experiencing operational problems.

Checking and configuring the date and time

You can check the date, time and time zone set on the hardware clock of the gateway based on the following message in the diagnostics log:

If the date on the gateway hardware clock is incorrect or exceeds the validity date of

If the date and time do not match the current exact time according to UTC, it is recommended to configure the date and time and set the time zone. Prior to changing the date, time or time zone, you should extract the microSD card from the device.

The time is configured in the terminal window of the PuTTY application.

To configure the time,

Run the command time hh:mm:ss, where hh refers to hours, mm refers to minutes, and ss refers to seconds.

To configure the time zone,

Run the command timezone -s hh:mm, where hh:mm refers to the UTC offset in hours and minutes.

To display the current time,

Run the command time.

To configure the date,

Run the command date mm/dd/yyyy, where mm refers to the month, dd refers to the day, yyyy refers to the year.

To display the current date,

Run the command date.