Software Monitoring and Reporting

OcNOS-RON : System Management Guide : System Management Command Reference : Software Monitoring and Reporting

This document describes software watchdog and reporting related commands.

• clear cores

• copy core

• copy techsupport

• feature software-watchdog

• remove file (techsupport)

• show bootup-parameters

• show cores

• show running-config watchdog

• show software-watchdog status

• show system log

• show system login

• show system reboot-history

• show system resources

• show system uptime

• show techsupport

• show techsupport status

• software-watchdog

• software-watchdog keep-alive-time

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

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

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

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

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

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

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

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 19-31 explains the output fields.

Table 19-31: 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

ldpd Enabled

rsvpd 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

ldpd Enabled Running 0 1 Fresh bootup

rsvpd 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 19-32 explains the output fields.

Table 19-32: 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 19-33 explains the output fields.

Table 19-33: 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 19-33 explains the output fields.

Table 19-34: 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 19-35 explains the output fields.

Table 19-35: 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 19-36 explains the output fields.

Table 19-36: 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 to save support information in a compressed (.gz) file.

The default file path is /var/log/ and the filename is tech_support_YYYY_MMM_DD_HH_MM_SS.tar.gz.

The filename given can be the same as another file; to distinguish them, each of the filenames are appended with a date and timestamp.

If a show techsupport command execution is in progress, any newly issued show techsupport commands are ignored.

If a show techsupport command is executing, and the show running-config command is given, the displayed information is copied from the show techsupport command.

Command Syntax

show techsupport ({all|authd|bgp|cmmd|hostpd|hsl|imi|isis|l2mribd|lag|ldp|mribd|mstp|nd|nsm|oam|onm|ospf|ospf6|pim|ptp|rib|rip|ripng|rsvp|sflow|synce|vrrp})

Parameters:

all

ALL Related Information

authd

AUTHD Related Information

bgp

BGP Related Information

cmmd

CMMD Related Information

hostpd

HOSTP Related Information

hsl

HSL Related Information

imi

IMI Related Information

isis

ISIS Related Information

l2mribd

L2MRIB Related Information

lag

LAG/LACP Related Information

ldp

LDP Related Information

mribd

MRIB Related Information

mstp

MSTP Related Information

NDD Related Information

nsm

NSM Related Information

oam

BFD Related Information

onm

ONM/LLDP Related Information

ospf

OSPF Related Information

ospf6

OSPF6 Related Information

pcep

PCEP Related Information

pim

PIM Related Information

ptp

PTP Related Information

rib

RIB Related Information

rip

RIP Related Information

ripng

RIPNG Related Information

rsvp

RSVP Related Information

sflow

SFLOW Related Information

synce

SYNCE Related Information

vrrp

VRRP Related Information

Default

The default file path for show techsupport is /var/log/.

Command Mode

Privileged EXEC

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show techsupport all

#show techsupport bgp

#show techsupport bgp isis

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-OTN verison 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||ldpd|rsvpd|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||ldpd|rsvpd|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

ldpd

LDP module

rsvpd

RSVP 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