Technical Information Bulletin – Network Logging Purpose

Technical Information Bulletin – Network Logging
TIB003 7 July, 2016
Purpose:
This Technical Information Bulletin documents the Network Logging features available on every
Ctek SkyRouter using firmware release 6.00.02 or newer. It also includes the advanced logging
management capabilities provided in the TCOPlus option. These features are intended to be
used selectively to identify and isolate network issues.
Note: This Technical Information Bulletin supersedes TIB001, which remains available for
historical reasons to document a previous generation of logging capabilities that may still be
deployed in certain cases.
Scope:
This Technical Information Bulletin specifically addresses the operation of the logging feature and
interpretation of logging information. Logging is available in every SkyRouter firmware release
and can be enabled or disabled at any time; the default (factory) setting for logging is on
(enabled).
Theory of Operation
Network logging occurs on every Ctek SkyRouter unless it has been disabled by a configuration
choice. The logging feature is controlled by a configuration file named “log_conf” found in the
directory “/etc/conf.d”. The log_conf file is a simple ASCII text file that contains the following
variables:
LOGTIME – Specifies interval between samples in five (5) second ticks. For example, setting this
variable to 3 would indicate that a sample will be taken approximately every 15 seconds. A zero
(0) setting will turn off logging. The factory default setting is 1, meaning every 5 seconds.
LOGLENGTH – Specifies the size in bytes to which the log file will be allowed to grow. In the
worst case the storage requirement will be twice this value since an old and new version of the
log file is always maintained. The factory default setting is 50000, meaning 50000 bytes. Contact
Ctek support for advice on changing the log size.
Network logging is accomplished by storing a highly compressed form of the information in a
circular queue implemented as /etc/s4100/s4100_ev_log.new and /etc/s4100/s4100_ev_log.old.
When the new file grows to the size where it exceeds the LOGLENGTH setting, in the
configuration file it is renamed to be old and logging continues in a freshly created new file. This
circular process repeats until the configuration file parameter LOGTIME is set to 0 (zero) and a
restart is performed. While information is stored on the SkyRouter in a highly compressed format
it is made available to users in a text format that is command line accessible and, if TCOPlus is
installed can also be viewed from the administrative screens. To retrieve the log using the
command line interface connect to the unit using FTP and execute the ftp command get log.txt.
A copy of the complete log file will be placed on your client computer.
Ctek Inc.
Technical Information Bulletin – Network Logging
TIB003 7 July, 2016
Note: For security purposes, the FTP server application on SkyRouters using release 6.00.02 or
newer is disabled as a factory default. To enable FTP for log retrieval contact Ctek for support
information.
When viewed with a text editor, network log files retrieved through FTP will be formatted as
shown below. For Windows users we recommend using the Wordpad (not Notepad) text editor to
view the log file as formatted.
A log file, when viewed through the TCOPlus logging option will appear as shown below.
The remainder of this document will describe the log file entries, which are common to both the
FTP and TCOPlus viewing options.
Ctek Inc.
Technical Information Bulletin – Network Logging
TIB003 7 July, 2016
Note: Each log file entry is prefixed with a time stamp, and the midnight (0001 hours) also contains the date. The time and date information is
based on the SkyRouter’s selected time source, which in most cases is the cellular network, but could also be a Network Time Server, or GPS.
Description (not shown in log entry)
Environment Status
Variable
Carrier Status
Radio Temp:
System Temp:
Voltage:
Carrier:
IP Status
IP:
State Change
Entering: (new state)
Ctek Inc.
Possible Values
Degrees C
Degrees C
Volts
None
Name of Carrier
None
IP Address
Power-up
Idle
Initialize
Configure
Connect
Connecting
Connected
Re-connect
Standoff
Reboot
Low Power Mode
Timed Wait
Radio Program Mode Init
Radio Program Mode Done
Technical Information Bulletin – Network Logging
TIB003 7 July, 2016
Description (not shown in log entry)
Variable
From: (previous state)
Ctek Inc.
Possible Values
Account Reset Init
Account Reset Done
Account OTA Init
Account OTA Done
Account PRL Update Init
Account PRL Update Done
Account Man. Update Init
Account Man. Update Done
Power-up
Idle
Initialize
Configure
Connect
Connecting
Connected
Re-connect
Standoff
Reboot
Low Power Mode
Timed Wait
Radio Program Mode Init
Radio Program Mode Done
Account Reset Init
Account Reset Done
Account OTA Init
Account OTA Done
Account PRL Update Init
Account PRL Update Done
Technical Information Bulletin – Network Logging
TIB003 7 July, 2016
Description (not shown in log entry)
Variable
Account Man. Update Init
Account Man. Update Done
Connecting Bad Parms
Connecting No Parms
Connecting Timeout
Connected Timeout
Re-connect Timeout
Update Reboot
CGI Reboot
SMS Reboot
SMS Enable
Excess Data
PAD Reboot
XML Reboot
Radio Programming Complete
Account Reset Complete
Account Manual Update Complete
Account OTA Activation Complete
Account PRL Update complete
Carrier HFA Timeout
dBm
Figure of merit
CDMA Band 0
CDMA Band 1
2 reserved
CDMA Band 3
CDMA Band 4
CDMA Band 5
Reason:
RF Status
Possible Values
RSSI
RSRQ
Band
Ctek Inc.
Technical Information Bulletin – Network Logging
TIB003 7 July, 2016
Description (not shown in log entry)
Variable
Possible Values
CDMA Band 6
CDMA Band 7
CDMA Band 8
CDMA Band 9
CDMA Band 10
CDMA Band 11
CDMA Band 12
CDMA Band 13
CDMA Band 14
CDMA Band 15
CDMA Band 16
17 reserved
18 reserved
19 reserved
20 reserved
21 reserved
22 reserved
23 reserved
24 reserved
25 reserved
26 reserved
27 reserved
28 reserved
29 reserved
30 reserved
31 reserved
32 reserved
33 reserved
Ctek Inc.
Technical Information Bulletin – Network Logging
TIB003 7 July, 2016
Description (not shown in log entry)
Variable
Possible Values
34 reserved
35 reserved
36 reserved
37 reserved
38 reserved
39 reserved
GSM 450
GSM 480
GSM 750
GSM 850
GSM 900
GSM 900
GSM 900
GSM 1800
GSM 1900
49 reserved
50 reserved
51 reserved
52 reserved
53 reserved
54 reserved
55 reserved
56 reserved
57 reserved
58 reserved
59 reserved
60 reserved
61 reserved
Ctek Inc.
Technical Information Bulletin – Network Logging
TIB003 7 July, 2016
Description (not shown in log entry)
Variable
Possible Values
62 reserved
63 reserved
64 reserved
65 reserved
66 reserved
67 reserved
68 reserved
69 reserved
70 reserved
71 reserved
72 reserved
73 reserved
74 reserved
75 reserved
76 reserved
77 reserved
78 reserved
79 reserved
WCDMA 2100
WCDMA 1900
WCDMA 1800
WCDMA 1700
WCDMA 850
WCDMA 800
WCDMA 2600
WCDMA 900
WCDMA 1700
WCDMA 1700
Ctek Inc.
Technical Information Bulletin – Network Logging
TIB003 7 July, 2016
Description (not shown in log entry)
Variable
Possible Values
WCDMA 1500
91 reserved
92 reserved
93 reserved
94 reserved
95 reserved
96 reserved
97 reserved
98 reserved
99 reserved
100 reserved
101 reserved
102 reserved
103 reserved
104 reserved
105 reserved
106 reserved
107 reserved
108 reserved
109 reserved
WLAN 2400
WLAN 2400
WLAN 2400
WLAN 2400
WLAN 2400
WLAN 5000
WLAN 5000
WLAN 5000
Ctek Inc.
Technical Information Bulletin – Network Logging
TIB003 7 July, 2016
Description (not shown in log entry)
Variable
Possible Values
WLAN 5000
WLAN 5000
LTE Band 1
LTE Band 2
LTE Band 3
LTE Band 4
LTE Band 5
LTE Band 6
LTE Band 7
LTE Band 8
LTE Band 9
LTE Band 10
LTE Band 11
LTE Band 12
LTE Band 13
LTE Band 14
LTE Band 17
LTE Band 33
LTE Band 34
LTE Band 35
LTE Band 36
LTE Band 37
LTE Band 38
LTE Band 39
LTE Band 40
LTE Band 18
LTE Band 19
LTE Band 20
Ctek Inc.
Technical Information Bulletin – Network Logging
TIB003 7 July, 2016
Description (not shown in log entry)
Network Status
Variable
Possible Values
LTE Band 21
LTE Band 24
LTE Band 25
LTE Band 41
LTE Band 42
LTE Band 43
Unknown
No Service
CDMA 1xRTT
CDMA 1xEVDO
AMPS
GSM
UMTS
WLAN
GPS
LTE
Unknown
Not Registered
Registered
Searching
Denied
Unknown
Disconnected
Connected
Suspended
Authenticating
Attached
Detached
Service
Service State
Session
APN
Ctek Inc.
Technical Information Bulletin – Network Logging
TIB003 7 July, 2016
Description (not shown in log entry)
Variable
Roam
Possible Values
Roaming
Home
Partner
Unknown
CDMA 1xRTT
CDMA 1xEVDO Rev 0
GPRS
WCDMA
EV-DO Rev A
EDGE
HSDPA WCDMA
WCDMA HSUPA
HSDPA HSUPA
LTE
EV-DO Rev A EHRPD
HSDPA+ WCDMA
HSDPA+ HSUPA
DC_HSDPA+ WCDMA
DC_HSDPA+ HSUPA
HSDPA+ 64QAM
HSDPA+ HSUPA
TDSCDMA
TDSCDMA HSDPA
Unknown
Dormant
Active
Ready
Locked
Bearer
Bearer State
UIM
Ctek Inc.
Technical Information Bulletin – Network Logging
TIB003 7 July, 2016
Description (not shown in log entry)
Variable
Possible Values
Removed
Unknown
Mobile Network Code
Mobile Country Code
MNC
MCC
Ctek Inc.
Download PDF
Similar pages