Difference between revisions of "Template:Networking rutos manual troubleshoot"
(Created page with "===Logging Settings=== ---- The <b>Logging Settings</b> section is used to configure how and where the device stores system log data. The system log is a file that contains in...") |
|||
(8 intermediate revisions by 2 users not shown) | |||
Line 3: | Line 3: | ||
The <b>Logging Settings</b> section is used to configure how and where the device stores system log data. The system log is a file that contains information on various system related events and is useful to engineers for troubleshooting the device. | The <b>Logging Settings</b> section is used to configure how and where the device stores system log data. The system log is a file that contains information on various system related events and is useful to engineers for troubleshooting the device. | ||
− | [[File: | + | [[File:Networking_rutos_manual_administration_troubleshoot_logging_settings_v2.png|border|class=tlt-border]] |
<table class="nd-mantable"> | <table class="nd-mantable"> | ||
Line 17: | Line 17: | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
− | <td>External system log server | + | <td>External system log server</td> |
− | <td> | + | <td>ip; default: <b>none</b></td> |
− | <td>IP address | + | <td>IP address of an external server that will be used to store device logs.</td> |
</tr> | </tr> | ||
<tr> | <tr> | ||
− | <td>External system log server | + | <td>External system log server port</td> |
+ | <td>integer [0..65535]; default: <b>none</b></td> | ||
+ | <td>TCP/UDP port number of the external log server.</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>External system log server protocol</td> | ||
<td>UDP | TCP; default: <b>UDP</b></td> | <td>UDP | TCP; default: <b>UDP</b></td> | ||
<td>Communication protocol used by the external log server.</td> | <td>Communication protocol used by the external log server.</td> | ||
Line 57: | Line 62: | ||
The <b>Troubleshoot</b> section is used to download various files that contain information used for troubleshooting the device. Refer to the figure and table below for information on the Troubleshoot page. | The <b>Troubleshoot</b> section is used to download various files that contain information used for troubleshooting the device. Refer to the figure and table below for information on the Troubleshoot page. | ||
{{#switch:{{{series}}} | {{#switch:{{{series}}} | ||
− | |TAP100 | + | |TAP100 = [[File:Networking_rutos_manual_administration_troubleshoot_troubleshoot_tap100.png|border|class=tlt-border]] |
|#default = [[File:Networking_rutos_manual_administration_troubleshoot_troubleshoot.png|border|class=tlt-border]]}} | |#default = [[File:Networking_rutos_manual_administration_troubleshoot_troubleshoot.png|border|class=tlt-border]]}} | ||
Line 80: | Line 85: | ||
<td>- (interactive button)</td> | <td>- (interactive button)</td> | ||
<td>Downloads the device Troubleshoot file. It contains the device configuration information, logs and some other files. When requesting support, it is recommended to always provide the device Troubleshoot file to Teltonika engineers for analysis.</td> | <td>Downloads the device Troubleshoot file. It contains the device configuration information, logs and some other files. When requesting support, it is recommended to always provide the device Troubleshoot file to Teltonika engineers for analysis.</td> | ||
− | </tr>{{# | + | </tr>{{#ifeq:{{{series}}}|TAP100|| |
<tr> | <tr> | ||
<td>TCP dump file{{#ifeq:{{{series}}}|RUTX||<span class="asterisk">*</span>}}</td> | <td>TCP dump file{{#ifeq:{{{series}}}|RUTX||<span class="asterisk">*</span>}}</td> | ||
Line 88: | Line 93: | ||
<tr> | <tr> | ||
<td>Enable TCP dump{{#ifeq:{{{series}}}|RUTX||<span class="asterisk">*</span>}}</td> | <td>Enable TCP dump{{#ifeq:{{{series}}}|RUTX||<span class="asterisk">*</span>}}</td> | ||
− | <td>off | + | <td>off | on; default: <b>off</b></td> |
<td>Turns TCP dump packets capture on or off.</td> | <td>Turns TCP dump packets capture on or off.</td> | ||
</tr>}} | </tr>}} | ||
</table> | </table> | ||
− | {{#switch:{{{series}}}|TAP100 | + | {{#switch:{{{series}}}|TAP100|RUT2M|RUT9M|TCR1= |
| #default={{#switch:{{{series}}}|RUTX|RUTM=|#default=<font size="-1"><span class="asterisk">*</span> As of {{{series}}}_R_00.07.00, TCPdump is not part of core functionality anymore. To see these options, the TCPdump package must be downloaded from [[{{{name}}}_Package_Manager|Package Manager]].</font>}} | | #default={{#switch:{{{series}}}|RUTX|RUTM=|#default=<font size="-1"><span class="asterisk">*</span> As of {{{series}}}_R_00.07.00, TCPdump is not part of core functionality anymore. To see these options, the TCPdump package must be downloaded from [[{{{name}}}_Package_Manager|Package Manager]].</font>}} | ||
}} | }} | ||
− | {{# | + | {{#ifeq:{{{series}}}|TAP100||====TCP dump==== |
---- | ---- | ||
<b>TCP dump</b> is {{#switch:{{{series}}}|RUTX|RUTM=|#default=an <i>optional</i> downloadable functionality<span class="asterisk">*</span>}} used to capture packets moving through network interfaces. By default, the device does not store TCP dump information. You must enable TCP dump and save the changes before you can download the file. | <b>TCP dump</b> is {{#switch:{{{series}}}|RUTX|RUTM=|#default=an <i>optional</i> downloadable functionality<span class="asterisk">*</span>}} used to capture packets moving through network interfaces. By default, the device does not store TCP dump information. You must enable TCP dump and save the changes before you can download the file. | ||
Line 194: | Line 199: | ||
The <b>Modem Debug</b> section is used to send AT commands to the modem. | The <b>Modem Debug</b> section is used to send AT commands to the modem. | ||
− | {{#ifeq: {{{name}}} | RUTX12 | [[File:Networking_rutos_manual_administration_troubleshoot_modemdebug_v1_RUTX12.png | + | {{#ifeq: {{{name}}} | RUTX12 | [[File:Networking_rutos_manual_administration_troubleshoot_modemdebug_v1_RUTX12.png]] | [[File:Networking_rutos_manual_administration_troubleshoot_modemdebug_v1.png]]}} |
<table class="nd-mantable"> | <table class="nd-mantable"> | ||
Line 229: | Line 234: | ||
This section shows the sent AT commands. | This section shows the sent AT commands. | ||
− | + | Networking_rutos_manual_administration_troubleshoot_athistory_v1.png | |
<table class="nd-othertables"> | <table class="nd-othertables"> |
Revision as of 08:57, 29 September 2023
Logging Settings
The Logging Settings section is used to configure how and where the device stores system log data. The system log is a file that contains information on various system related events and is useful to engineers for troubleshooting the device.
Field | Value | Description |
---|---|---|
System log buffer size | integer; default: 128 | System log buffer size in kibibytes (KiB). |
External system log server | ip; default: none | IP address of an external server that will be used to store device logs. |
External system log server port | integer [0..65535]; default: none | TCP/UDP port number of the external log server. |
External system log server protocol | UDP | TCP; default: UDP | Communication protocol used by the external log server. |
Save log in | RAM memory | Flash memory; default: RAM memory | Specifies which type of memory to use for storing system logs. |
System log file size | integer [10..500]; default: 200 | Maximum size (in kilobytes) of a log file. When threshold is reached, log rotation is performed. Can be set to value from 10kB to 500kB. Smaller the file, larger amount of old logs is saved. |
Compress | off | on; default: off | Compress old rotated logs using GZ format. |
Delete | - (interactive button) | Deletes log file from router. |
Show hostname | off | on; default: off | Show hostname instead of IP address in syslog. |
Troubleshoot
The Troubleshoot section is used to download various files that contain information used for troubleshooting the device. Refer to the figure and table below for information on the Troubleshoot page.
Field | Value | Description |
---|---|---|
System log | - (interactive button) | Displays the contents of the device system log file. The system log contains records of various system related events, such as starts/stops of various services, errors, reboots, etc. |
Kernel log | - (interactive button) | Displays the contents of the device kernel log file. The kernel log contains records of various events related to the processes of the operating system (OS). |
Troubleshoot file | - (interactive button) | Downloads the device Troubleshoot file. It contains the device configuration information, logs and some other files. When requesting support, it is recommended to always provide the device Troubleshoot file to Teltonika engineers for analysis. |
TCP dump file* | - (interactive button) | Downloads the device TCP dump file. TCP dump is a program used to capture packets moving through network interfaces. By default, the device does not store TCP dump information. You must enable TCP dump and save the changes before you can download the file. |
Enable TCP dump* | off |
* As of {{{series}}}_R_00.07.00, TCPdump is not part of core functionality anymore. To see these options, the TCPdump package must be downloaded from [[{{{name}}}_Package_Manager|Package Manager]].
TCP dump
TCP dump is an optional downloadable functionality* used to capture packets moving through network interfaces. By default, the device does not store TCP dump information. You must enable TCP dump and save the changes before you can download the file.
If you enable TCP dump, you will notice additional configuration fields appear. Refer to the figure and table below for realted information.
* You can download the TCPdump package from [[{{{name}}}_Package_Manager|Package Manager]].
Field | Value | Description |
---|---|---|
Enable TCP dump | off | on; default: off | Turns TCP dump packet capture on or off. |
Select interface | network interface; default: br-lan | Only captures packets that move through the specified network interface. |
Select protocol filter | All | ICMP | TCP | UDP | ARP; default: All | Only captures packets that match the specified protocol. |
Select packets direction | Incoming/Outgoing | Incoming | Outgoing; default: Incoming/Outgoing | Only captures packets coming from the specified direction. |
Host | ip | host; default: none | Only captures packets related to the specified host. |
Port | integer [0..65335]; default: none | Only captures packets related to the specified communication port. |
Select storage | RAM memory; default: RAM memory | Specifies where the TCP dump file will be stored. |
Diagnostics
The Diagnostics section is used to execute simple network diagnostic tests, including ping, traceroute and nslookup.
Field | Value | Description |
---|---|---|
Method | Ping | Traceroute | Nslookup; default: Ping | Selects diagnostic method.
|
Protocol | IPv4 | IPv6; default: IPv4 | Selects IP address family for diagnostic test. |
Address | ip | host; default: none | IP address or hostname on which the diagnostic test will be performed. |
Perform | -(interactive button) | Performs diagnostic test when clicked. |