4.30 NetInterfacesDown

Use this Knowledge Script to monitor the up and down status of network interfaces. This Knowledge Script uses the ifconfig command to determine if any network interface card (NIC) on a computer with multiple network interfaces is down. If a network interface is detected down, AppManager raises an event.

If the computer where you run this Knowledge Script has only one network interface card and that interface card is down or unplugged, the event cannot be relayed to the QDB until the card is back in service. Therefore, only run this script on computers with multiple network interface cards.

On Solaris, the UNIX agent must run as root or as a user with root-level authority to retrieve counters associated with the UX Networking performance object. Before running this Knowledge Script, configure the agent to run as root or as a user with root‑level authority through the sudo configuration file.

4.30.1 Resource Object

Network Interface icon

4.30.2 Default Schedule

The default interval for this script is Every 5 minutes.

4.30.3 Setting Parameter Values

Set the following parameters as needed:

Description

How to Set It

General Settings

Interfaces to be excluded (comma-separated)

Enter the interfaces you want to exclude from the list of interfaces owned by root. Use a comma with no spaces to separate interface names.

Event severity for internal failure

Set the event severity level, from 1 to 40, to indicate the importance of an event in which this job experienced an internal error. The default is 5.

Event detail format

Set the format for the Event detail. HTML Table is the default.

Enable debugging (y/n)

Set to y to enable debugging. The default is n.

Event Settings

 

Event if network interface is down?

Select Yes to raise an event if a network interface is detected down. The default is Yes.

Consolidate events for all network interfaces?

Select Yes to consolidate events for all network interfaces. The default is unselected.

Raise event for undiscovered network interface

Select Yes to raise an event for undiscovered network interface. The default is unselected.

Add command output in detail event message?

Select Yes to add command output in the detail event message. The default is unselected.

Event severity level

Set the event severity level, from 1 to 40, to indicate the importance of the event. The default severity level is 20.

Consider the status Running as UP? (available on solaris)

Select Yes to consider the status Running as UP? The default is unselected.

This parameter is for Solaris only.

Data Collection

 

Collect data?

Select Yes to collect data for charts and reports. If set to Yes, the script returns a value of 100 if the network interface is up and 0 if the network interface is down. The default is unselected.

4.30.4 Example of How this Script Is Used

If you run this Knowledge Script on a computer with multiple network interface cards and at least one of them is available and allows the NetIQ UNIX agent to communicate with the management server, an event is raised if any of the network interface cards goes down. In response to the event, you can configure this Knowledge script to run a managed client (MC) action to attempt to bring the NIC back online using the ifconfig command and the Action_UXCommand Knowledge Script.

You might also want to use this Knowledge Script in conjunction with other Knowledge Scripts, such as NetInterfacesConnectivity and PingMachine to fine-tune your troubleshooting.

NOTE:The NetInterfacesDown Knowledge Script does not alert you if all network interfaces are on computer are down until after network communication is restored. The Knowledge Script job still raises the event, but stores the event in the UNIX agent’s local repository until communication with the management server resumes.