Software Monitoring and Reporting
This document describes software watchdog and reporting related commands.
clear cores
Use this clear command to delete the core files present in /var/log/crash/cores
Syntax
clear cores (|WORD)
Parameters
WORD
Core file name
Default
NA
Command Mode
Executive Mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show cores
Core location :/var/log/crash/cores
Core-File-Name
--------------
core_hostpd.9581_20190324_222313_signal_11.gz
#clear cores core_hostpd.9581_20190324_222313_signal_11.gz
#show cores
Core location :/var/log/crash/cores
Core-File-Name
--------------
#
copy core
Use this command to copy the core file to another file.
The core filename is in the form: core_PROCESSNAME.PROCID_YYYMMDD_HHMMSS_signal_SIGNUM.gz
Syntax
copy core FILE (tftp TFTP-URL|ftp FTP-URL|scp SCP-URL|sftp SFTP-URL) (vrf (NAME|management)|)
Parameters
core
Copy Crash core files to remote location. Core file location: /var/log/crash/cores/
FILE
Source file name
TFTP-URL
Destination: tftp:[//server[:port]][/path]
FTP-URL
Destination: ftp:[//server][/path]
SCP-URL
Destination: scp:[//server][/path]
SFTP-URL
Destination: sftp:[//server][/path]
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Default
NA
Command Mode
Privileged EXEC
Applicability
This command was introduced before OcNOS version 1.3.
Example
# copy core core_hostpd.9581_20190324_222313_signal_11.gz scp scp://10.12.16.17/home/ core core_hostpd.9581_20190324_222313_signal_11.gz vrf management
Enter Username:root
Enter Password:
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 681k 0 0 0 681k 0 3588k --:--:-- --:--:-- --:--:-- 3588k
100 681k 0 0 0 681k 0 3588k --:--:-- --:--:-- --:--:-- 3588k
Copy Success
copy techsupport
Use this command to copy the contents of a compressed techsupport file (tar.gz) to another file.
The default filename is in the form: tech_support_YYYY_MMM_DD_HH_MM_SS.tar.gz.
Syntax
copy (log|techsupport) FILE (tftp TFTP-URL|ftp FTP-URL|scp SCP-URL|sftp SFTP-URL) (vrf (NAME|management)|)
Parameters
log
Log file storage; on Linux this refers to /var/log/
techsupport
Tech support file storage; on Linux this refers to /var/log/
FILE
Source file name
TFTP-URL
Destination: tftp:[//server[:port]][/path]
FTP-URL
Destination: ftp:[//server][/path]
SCP-URL
Destination: scp:[//server][/path]
SFTP-URL
Destination: sftp:[//server][/path]
NAME
Virtual Routing and Forwarding name
management
Management Virtual Routing and Forwarding
Default
NA
Command Mode
Privileged EXEC
Applicability
This command was introduced before OcNOS version 1.3.
Example
#copy techsupport tech_support_23_Feb_2019_18_27_00.tar.gz scp scp://10.12.16.17/home/tech_support_23_Feb_2019_18_27_00.tar.gz vrf management
Enter Username:root
Enter Password:
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 72368 0 0 0 72368 0 147k -::- -::- -::- 147k
100 72368 0 0 0 72368 0 147k -::- -::- -::- 147k
Copy Success
#
feature software-watchdog
Use this command to enable software watchdog functionality for all OcNOS modules. This feature is enabled by default.
Use the no form of this command to disable software watchdog functionality.
Command Syntax
feature software-watchdog
no feature software-watchdog
Parameter
None
Default
By default, software watchdog is enabled.
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
#(config)feature software-watchdog
remove file (techsupport)
Use this command to remove techsupport files from "/var/log" directory.
Command Syntax
remove file (techsupport) (all|FILENAME|)
Parameter
techsupport
Tech support option for protocol(s).
all
Remove all files.
FILENAME
Name of the file to be deleted.
Default
N/A.
Command Mode
Exec mode
Applicability
This command was introduced before OcNOS version 6.4.
Examples
OcNOS#remove ?
file file
OcNOS#remove file ?
techsupport Tech Support Option For Protocol(s)
OcNOS#remove file techsupport ?
FILENAME Name of the file to be deleted
all Remove all files
OcNOS#remove file techsupport /var/log/OcNOS_tech_support_all_14_Feb_2019_15_39_34.tar.gz
OcNOS#remove file techsupport all
show bootup-parameters
Use this command to show OcNOS kernel bootup parameters.
Command Syntax
show bootup-parameters
Parameter
None
Command Mode
Execution mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#show bootup-parameters
BOOT_IMAGE=/boot/vmlinuz-3.16.7-g490411a-ec-as7712-32x root=UUID=317567fc-b69e-4
5d9-ab4e-fa1d9e57b
703 console=ttyS1,115200n8 ro
show cores
Use this command to list core files in the system or to display information about a given core file.
When cmlsh logged in via non-root user crashes, core files will not get generated. User can further debug the issue based on CLI-history and logs from /var/log/messages.
Command Syntax
show cores (|WORD details)
Parameter
WORD
Core file name
Command Mode
Execution mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#sh cores
Core location :/var/log/crash/cores
Core-File-Name
--------------
core_nsm.683_20191110_103611_signal_5.gz
core_nsm.712_20191107_171803_signal_11.gz
core_nsm.684_20191112_054937_signal_5.gz
core_yangcli.5695_20191107_171715_signal_11.gz
#
Table P‑1-1 explains the output fields.
Table 1-1: show cores fields
Entry | Description |
|---|
Core-File-Name | Core dump file name. |
show running-config watchdog
Use this command to display watchdog configurations.
Command Syntax
show running-config watchdog
Parameters
None
Command Mode
Privileged EXEC
Applicability
This command is introduced in OcNOS-SP version 5.0.
Example
OcNOS#sh running-config watchdog
software-watchdog keep-alive-time 300
show software-watchdog status
Use this command to display the software watchdog status for each OcNOS module.
Command Syntax
show software-watchdog status
show software-watchdog status detail
Parameter
None
Command Mode
Execution mode
Applicability
This command was introduced before OcNOS version 1.3 and updated in OcNOS version 1.3.4.
Examples
#show software-watchdog status
Software Watchdog timeout in seconds : 60
Process name Watchdog status
============ ===============
nsm Enabled
ripd Enabled
ripngd Enabled
ospfd Enabled
ospf6d Enabled
isisd Enabled
hostpd Enabled
mribd Enabled
pimd Enabled
authd Enabled
mstpd Enabled
imi Enabled
onmd Enabled
HSL Enabled
oamd Enabled
vlogd Enabled
vrrpd Enabled
ndd Enabled
ribd Enabled
bgpd Enabled
l2mribd Enabled
lagd Enabled
sflow Enabled
cmld Enabled
cmmd Enabled
#show software-watchdog status detail
Software Watchdog timeout in seconds : 60
Process Watchdog Process Disconnect Connect Last Restart
Name Status Status Count Count Reason
======= ======== =========== ========== ======= ===============================
nsm Enabled Running 0 1 Fresh bootup
ripd Enabled Running 0 1 Fresh bootup
ripngd Enabled Running 0 1 Fresh bootup
ospfd Enabled Running 0 1 Fresh bootup
ospf6d Enabled Running 0 1 Fresh bootup
isisd Enabled Running 0 1 Fresh bootup
hostpd Enabled Running 0 1 Fresh bootup
mribd Enabled Running 0 1 Fresh bootup
pimd Enabled Running 0 1 Fresh bootup
authd Enabled Running 0 1 Fresh bootup
mstpd Enabled Running 0 1 Fresh bootup
imi Enabled Running 0 1 Fresh bootup
onmd Enabled Running 0 1 Fresh bootup
HSL Enabled Running 0 1 Fresh bootup
oamd Enabled Running 0 1 Fresh bootup
vlogd Enabled Running 0 1 Fresh bootup
vrrpd Enabled Running 0 1 Fresh bootup
ndd Enabled Running 0 1 Fresh bootup
ribd Enabled Running 0 1 Fresh bootup
bgpd Enabled Running 0 1 Fresh bootup
l2mribd Enabled Running 0 1 Fresh bootup
lagd Enabled Running 0 1 Fresh bootup
sflow Enabled Running 0 1 Fresh bootup
cmld Enabled Running 0 1 Fresh bootup
cmmd Enabled Running 0 1 Fresh bootup
Table P‑1-2 explains the output fields.
Table 1-2: show software-watchdog status output fields
Field | Description |
|---|
Process Name | The name of a protocol module. |
Watchdog Status | Status of a protocol module (Enabled or Disabled). |
Process Status | Status of the protocol module Running/Not-running). |
Disconnect Count | Number of times the protocol module disconnected from monitoring module. |
Connect Count | Number of times the protocol module connected to monitoring module. |
Last Restart Reason | Reason why a module disconnected from monitoring module. |
show system log
Use this command to display the system’s log file.
Command Syntax
show system log
Parameters
None
Command Mode
Execution mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show system log
Syslog : enabled File Name : /var/log/messages
Oct 18 18:10:18 localhost rsyslogd: [origin software="rsyslogd" swVersion="8.4.2
" x-pid="541" x-info="http://www.rsyslog.com"] start
Oct 18 18:10:18 localhost systemd[1]: Started Apply Kernel Variables.
Oct 18 18:10:18 localhost systemd[1]: Started Create Static Device Nodes in /dev
.
Oct 18 18:10:18 localhost systemd[1]: Starting udev Kernel Device Manager...
Oct 18 18:10:18 localhost systemd[1]: Started udev Kernel Device Manager.
Oct 18 18:10:18 localhost systemd[1]: Starting Copy rules generated while the ro
ot was ro...
Oct 18 18:10:18 localhost systemd[1]: Starting LSB: Set preliminary keymap...
Oct 18 18:10:18 localhost systemd[1]: Started Copy rules generated while the roo
t was ro.
Oct 18 18:10:18 localhost nfs-common[163]: Starting NFS common utilities:.
Oct 18 18:10:18 localhost systemd[1]: Found device /dev/ttyS0.
Oct 18 18:10:18 localhost systemd[1]: Found device 16GB_SATA_Flash_Drive OcNOS-CONFIG.
Oct 18 18:10:18 localhost systemd[1]: Starting File System Check on /dev/disk/by
-label/OcNOS-CONFIG...
Oct 18 18:10:18 localhost systemd[1]: Starting system-ifup.slice.
Oct 18 18:10:18 localhost systemd-fsck[217]: OcNOS-CONFIG: clean, 85/128016 file
s, 27057/512000 blocks
Oct 18 18:10:18 localhost systemd[1]: Created slice system-ifup.slice.
--More--
Table P‑1-3 explains the output fields.
Table 1-3: show system log fields
Entry | Description |
|---|
Syslog | Status of the protocol (enabled or disabled). |
File Name | Specifies the name of the system log files that you configured. |
show system login
Use this command to display the system’s login history.
Command Syntax
show system login
Parameters
None
Command Mode
Execution mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show system login
eric ttyS0 Wed Oct 19 18:31 still logged in
takayuki ttyS0 Wed Oct 19 18:14 - 18:25 (00:10)
girish ttyS0 Wed Oct 19 16:46 - 17:01 (00:14)
wtmp begins Wed Oct 19 16:46:18 2016
show system reboot-history
Use this command to show the OcNOS reboot history.
Command Syntax
show system reboot-history
Parameters
None
Command Mode
Execution mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#show system reboot-history
#) On Thu Jun 6 06:16:03 2013
Reason: Reset Requested by Active User
Service: NONE
#) On Thu Jun 6 06:21:30 2015
Reason: Reset Requested due to Process Crash
Service: nsm
#
Table P‑1-3 explains the output fields.
Table 1-4: show system reboot-history fields
Entry | Description |
|---|
Reason | Displays the reason, why the fields are reset. |
Service | Name of the service in this protocol. |
show system resources
Use this command to display the system’s current resources.
Command Syntax
show system resources (iteration <1-5>|)
Parameters
<1-5>
The number of times to check the resources before they are displayed.
Command Mode
Execution mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
DELL-6K3#show system resources
load average: 0.11, 0.08, 0.05
Tasks: 113 total, 1 running, 112 sleeping, 0 stopped, 0 zombie
%Cpu(s): 1.1 us, 0.4 sy, 0.0 ni, 98.5 id, 0.0 wa, 0.0 hi, 0.0 si, 0.0 st
KiB Mem: 8181040 total, 736124 used, 7444916 free, 133012 buffers
#show system resources iteration 5
load average: 0.03, 0.06, 0.05
Tasks: 112 total, 3 running, 109 sleeping, 0 stopped, 0 zombie
%Cpu(s): 1.0 us, 0.6 sy, 0.0 ni, 98.4 id, 0.0 wa, 0.0 hi, 0.0 si, 0.0 st
KiB Mem: 8181040 total, 736608 used, 7444432 free, 132976 buffers
KiB Swap: 0 total, 0 used, 0 free. 252416 cached Mem
Table P‑1-5 explains the output fields.
Table 1-5: show system resource fields
Entry | Description |
|---|
Load Average | Number of processes that are running. The average reflects the system load the past 1, 5, and 15 minutes. |
Tasks | Number of processes in the system and how many processes are actually running when the command is issued. |
CPU | Displays the CPU utilization information for processes on the device. |
KiB Mem | The memory field (Mem) shows the virtual memory used by processes. The value in the memory field is in KB and MB, and is broken down as follows: Total: The total amount of available virtual memory, in kibibytes (KiBs). Used:The total amount of used virtual memory, in kibibytes (KiBs). Free: The total amount of free virtual memory, in kibibytes (KiBs) Buffers: The size of the memory buffer used to hold data recently called from disk. |
KiB Swap | The Swap field shows the total swap space available and how much is unused and is broken down as follows: Total: The total amount of available swap memory, in kibibytes (KiBs). Used: The total amount of used swap memory, in kibibytes (KiBs). Free: The total amount of free swap memory, in kibibytes (KiBs). Cache Memory: Memory that is not associated with any program and does not need to be swapped before being reused. |
show system uptime
Use this command to display how lone the system has been up and running.
Command Syntax
show system uptime
Parameters
None
Command Mode
Execution mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
DELL-6K3#show system uptime
19:10:22 up 1 day, 1:01, 1 user, load average: 0.08, 0.05, 0.05
Table P‑1-6 explains the output fields.
Table 1-6: show system uptime fields
Entry | Description |
|---|
Time and up | Current time, in the local time zone, and how long the router or switch has been operational. |
Users | Number of users logged in to the router or switch. |
Load Average | Number of processes that are running. The average reflects the system load the past 1, 5, and 15 minutes. |
show techsupport
Use this command to collect system data for technical support and save the support information in a compressed tar (.gz) file.
• By default, the show techsupport uses the file path /var/log/ and names the file as OcNOS_tech_support_protocolname_DD_MMM_YYYY_HH_MM_SS.tar.gz.
• If this filename already exists, a date and timestamp are appended to differentiate it from previous files.
• When a show techsupport command is already running, any subsequent show techsupport commands issued are ignored until the current command completes.
• If a show techsupport command is in progress and a show running-config command is issued, the displayed information is derived from the ongoing show techsupport command.
Command Syntax
show techsupport ({all|authd|bgp|cmmd|hostpd|hsl|imi|isis|l2mribd|lag|mribd|mstp|nd|nsm|oam|onm|ospf|ospf6|pcep|pim|ptp|rib|rip|ripng|sflow|synce|vrrp|netconf|gnmi})
Parameters
all | Specifies the collection of all types of information. |
authd | Specifies the collection of authentication-related information. |
bgp | Specifies the collection of BGP-related information. |
cmmd | Specifies the collection of chassis management related information. |
hostpd | Specifies the collection of system management related information. |
hsl | Specifies the collection of HSL-related information. |
imi | Specifies the collection of IMM-related information. |
isis | Specifies the collection of ISIS-related information. |
l2mribd | Specifies the collection of Layer 2 Multicast RIB-related information. |
lag | Specifies the collection of LAG or LACP-related information. |
mribd | Specifies the collection of Multicast RIB-related information. |
mstp | Specifies the collection of MSTP-related information. |
nd | Specifies the collection of Neighbor Discovery related information. |
nsm | Specifies the collection of NSM-related information. |
oam | Specifies the collection of BFD-related information. |
onm | Specifies the collection of ONM information. |
ospf | Specifies the collection of OSPF-related information. |
ospf6 | Specifies the collection of OSPF6-related information. |
pcep | Specifies the collection of PCEP-related information. |
pim | Specifies the collection of PIM-related information. |
ptp | Specifies the collection of PTP-related information. |
rib | Specifies the collection of RIB-related information. |
rip | Specifies the collection of RIP-related information. |
ripng | Specifies the collection of RIPNG-related information. |
sflow | Specifies the collection of sFlow-related information. |
synce | Specifies the collection of SYNCE-related information. |
vrrp | Specifies the collection of VRRP-related information. |
netconf | Specifies the collection of NetConf and Callhome related information. |
gnmi | Specifies the collection of gNMI-related information. |
Default
None
Command Mode
Privileged EXEC mode
Applicability
Introduced before OcNOS version 1.3. Introduced the netconf and gnmi parameters in the OcNOS version 6.5.1.
Example
The following command demonstrates how to use show techsupport to collect various types of system information.
#show techsupport all
#show techsupport bgp
#show techsupport bgp isis
#show techsupport gnmi
#show techsupport netconf
show techsupport status
Use this cli to view the status of show techsupport CLI to generate techsupport archive.
Command Syntax
show techsupport status
Parameters
None
Command Mode
Privileged EXEC
Applicability
This command was introduced before OcNOS version 4.2.
Example
#show techsupport status
Tech Support Command Execution Is Complete
##Generated Tech Support File-list
/var/log/OcNOS_tech_support_18_Jun_2021_10_01_38.tar.gz
Tar File is generated at /var/log and file name begins with 'OcNOS_tech_support'
software-watchdog
Use this command to enable the software watchdog feature for an OcNOS module.
Use the no form of this command to disable the software watchdog feature.
Command Syntax
software-watchdog (nsm|authd|bgpd|cmld|hostpd|imi|isisd|lagd|l2mribd| mstpd|mribd|ndd|oamd|onmd|ospfd|ospf6d|pimd|ribd|ripd|ripngd|sflow|vlogd|vrrpd|hsl|cmmd)
no software-watchdog (nsm|authd|bgpd|cmld|hostpd|imi|isisd|lagd|l2mribd| mstpd|mribd|ndd|oamd|onmd|ospfd|ospf6d|pimd|ribd|ripd|ripngd|sflow|vlogd|vrrpd|hsl|cmmd)
Parameters
nsm
NSM module
authd
AUTH module
bgpd
BGP module
cmld
CML module
hostpd
HOSTP module
imi
IMI module
isisd
ISIS module
lagd
LAG module
l2mribd
L2MRIB module
mstpd
MSTP module
mribd
MRIB module
ndd
NDD module
oamd
OAM module
onmd
ONM module
ospfd
OSPF module
ospf6d
OSPF6 module
pimd
PIM module
ribd
RIB module
ripd
RIP module
ripngd
RIPNG module
sflow
SFLOW module
vlogd
VLOG module
vrrpd
VRRP module
hsl
HSL module
cmmd
CMM module
Default
By default, software watchdog is enabled.
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
#(config)no software-watchdog imi
#(config)software-watchdog nsm
software-watchdog keep-alive-time
Use this command to set the software watchdog keep-alive time interval in seconds. The default keep-alive time interval is 60 seconds.
Use the no form of this command to set default keep-alive time interval.
Command Syntax
software-watchdog keep-alive-time <30-1800>
no software-watchdog keep-alive-time
Parameters
<30-1800>
Keep-alive time interval in seconds
Default
By default, software watchdog is enabled and the keep-alive time interval is 60 seconds.
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
#(config)software-watchdog keep-alive-time 100