====== nCompass Control Interface Down Alarms ======
<color #db5f0b>Nov 2023</color>
\\ 
\\ 

----
When using nCompass Equipment Status Monitor (ESM), all sorts of alarms can be shown, alarms regarding inputs, alarms regarding services and hardware alarms. One of the hardware alarm types is to do with the network interfaces on your hardware devices. 
\\ 
\\ 
If you have a server (say an Encoder) that has an interface alarm, this comes from the unit and is reported by nCompass in ESM. The reason for the alarm is for another topic, but one issue is that you will get alarms from unused network interfaces by default.
\\ 
\\ 
{{ :ncc_interfrace_down_001.jpg?nolink&900 |}}
\\ 
We can see from the alarm raised in the Active Alarms section of ESM that interface eno4 is in alarm.
\\ 
\\ 
{{ :ncc_interfrace_down_002.jpg?nolink&600 |}}
\\ 
\\ 
There are two ways we can deal with this alarm:
\\ 
\\ 
----
==== Mask Alarm in ESM ====
The first way is to ignore the alarm in ESM. We can right click on the alarm and seclect 
\\ 
\\ 
{{ :ncc_interfrace_down_003.jpg?nolink&600 |}}
\\ 
This will bring up a second window called 'Alarm Overrides'
\\ 
\\ 
{{ :ncc_interfrace_down_004.jpg?nolink&600 |}}
\\ 
From here we can set the Severity to say Ignore, this alarm would then disappear from nCC ESM (it will still be visible on the actual hardware device UI if it has one).
\\ 
\\ 
The issue with this method is that nCompass will ignore any 'eno4' alarm now from ANY device. So this is not a great way to deal with this issue (but with some hardware it might be the only way).
\\ 
\\ 
----
==== Resolve Alarm on Device (Preferred) ====
The second (and better) way to deal with this is to deal with the alarm on the hardware so that nCompass Control ESM never sees the alarm.
\\ 
\\ 
In the example of say an Encoding Live or a Multiplexer, a Linux based device, then we can deal with this within Linux.
\\ 
\\ 
First SSH in to the device and login.
\\ 
\\ 
For CentOS/Alma Linux navigate to the /etc/sysconfig/network-scripts directory. This is where you can see your interface configuration files.
\\ 
<file>
ll

-rw-r--r--. 1 root root 280 Aug  7 12:16 ifcfg-eno1
-rw-r--r--. 1 root root 272 Aug  7 11:04 ifcfg-eno2
-rw-r--r--. 1 root root 272 Aug  7 11:04 ifcfg-eno3
-rw-r--r--. 1 root root 263 Nov 10 14:24 ifcfg-eno4
</file>

Here we can see the configuration file for eno4 - <color #ed1c24>ifcfg-eno4</color>
\\ 
\\ 
We can see the contents of the file using the <color #ed1c24>cat</color> command:
\\ 
<file>
cat ifcfg-eno4

TYPE=Ethernet
PROXY_METHOD=none
BROWSER_ONLY=no
BOOTPROTO=static
DEFROUTE=no
IPV4_FAILURE_FATAL=no
IPV6INIT=yes
IPV6_AUTOCONF=yes
IPV6_DEFROUTE=yes
IPV6_FAILURE_FATAL=no
NAME=eno4
UUID=f6354b95-a63e-4f4c-aee9-e43e29537fe2
DEVICE=eno4
ONBOOT=yes
NM_CONTROLLED=yes
</file>

Depending on your device, the default config may differ, but the two lines we are interested in are:
\\ 
<file>
ONBOOT=yes
NM_CONTROLLED=yes
</file>

Edit the <color #ed1c24>ifcfg-eno4</color> file and change both the ONBOOT and NM_CONTROLLED lines to end in <color #ed1c24>no</color>.
\\ 
\\ 
ONBOOT=<color #ed1c24>no</color>
\\ 
NM_CONTROLLED=<color #ed1c24>no</color>
\\ 
\\ 
Save the configuration file and reboot the server.
\\ 
\\ 
After the reboot, the active alarm in nCC will disappear, although this might take a minute or so.
\\ 
\\