Network Host

Network Host device driver permits Iotellect Server to access a single IP network host for monitoring its status and various services/applications running on it. The following table presents available services, their global settings, configuration properties and monitoring results (presented as device settings):

Monitoring Service

Configuration Properties

Monitoring Results

Operations

Ping

Ping Settings

Ping Results

Ping Operations

SNMP

SNMP Polling Settings

SNMP Results

SNMP Operations

Generic TCP

Generic TCP Service Settings

Generic TCP Results


Generic UDP

Generic UDP Service Settings

Generic UDP Results


HTTP

HTTP Settings

HTTP Results

HTTP Operations

DNS

DNS Settings

DNS Results


POP3

POP3 Settings

POP3 Results


IMAP

IMAP Server Settings

IMAP Results


SMTP

SMTP Server Settings

SMTP Results


E-mail Round-Trip

E-mail Round-Trip Settings

E-mail Round-Trip Results


FTP

FTP Server Settings

FTP Results

FTP Operations

Traceroute

Traceroute Settings

Traceroute Results


SSH

SSH Settings

SSH Results

SSH Operations

DHCP

DHCP Settings

DHCP Results


LDAP

LDAP Settings

LDAP Results


Radius

Radius Settings

Radius Results


WMI

WMI Settings

Refer to Device Settings section in WMI chapter

WMI Operations

Network Device Discovery

Network Host driver supports device discovery. Discovery is the process of scanning a number of IP network hosts, finding available services/applications, and creating device accounts for them.

The comprehensive description of network discovery is available in Iotellect Network Manager documentation.

Driver Information

Driver Plugin ID:

com.tibbo.linkserver.plugin.device.ip

Global Settings

Global configuration of the Network Host device driver provides the following settings:

Configuration

This setting configures server-side services offered by the network host driver to allow managing device configurations:

  • Enable FTP Server at Startup. Controls whether a Iotellect Server hosts an internal FTP server.
  • FTP Port Number. Port listened by an internal FTP server.
  • Enable SSH Server at Startup. Controls whether a Iotellect Server hosts an internal SSH server.
  • SSH Port Number. Port listened by an internal SSH server.
  • Enable TFTP Server at Startup. Controls whether a Iotellect Server hosts an internal TFTP server.
  • TFTP Port Number. Port listened by an internal TFTP server.

Read Configuration Scripts

This table configures Expect scripts that are used to backup device configurations. Each row describes:

  • Script Name. This name is used to refer the script, e.g. from a configuration backup sequence.
  • Script. Table defining the script itself, e.g. what data to send to a device and what to expect in reply.

Write Configuration Scripts

This table configures Expect scripts that are used to restore device configurations. Each row describes:

  • Script Name. This name is used to refer the script, e.g. from a configuration restore sequence.
  • Script. Table defining the script itself, e.g. what data to send to a device and what to expect in reply.

Configuration Scripts

This table configures scripts that are used to modify device configuration or execute control actions. Each script has the following properties:

  • Script Name. This name is used to refer the script.
  • Description. Detailed description of script purpose.
  • Type. Script (i.e. an expect script ) or Parameterizer (method of sending a single dynamically constructed command to the device)
  • Script. Table defining the script itself (if Type is set to Script), e.g. what data to send to a device and what to expect in reply.
  • Parameterizer. Text of parameterizer source data defining script input parameters format and method of dynamically constructing a command to be sent to the device. See Parameterization Engine for details.

User Level Settings

None defined.

Device Account Properties

Network Host driver properties define configuration parameters used by Iotellect Network Manager to monitor corresponding network host. Most of the properties present settings of services supported by Network Host driver. They are presented in the Configuration Properties column of Network Host Services table.

Other Device properties are:

  • Host Address (address) property. It specifies IP Address or Host Name of the network host to be monitored.
  • Connection Status Expressions (connectionStatusExpressions) property. It defines how each service affects the online status of the whole network host.

Device Assets

IP host assets are divided in two root groups: SNMP assets and WMI assets:

  • If SNMP service is enabled, one asset is created for every SNMP MIB file supported by the device. Supported MIB files are detected automatically by polling the SNMP agent.
  • If WMI service is enabled, one asset is created for every available WMI class.

Device Settings

Network Host device settings are:

  • Host status
  • Monitoring results for services enabled on this network host.

Refer to Monitoring Results column of Network Host Services table.

Device Operations

Refer to Operations column of Network Host Services table.

Device Events

Network hosts can generate two different types of events: Service Outages (described below) and SNMP Notifications (described in SNMP device driver chapter).

Service Outage

This event is generated by a service once if goes back "online" after a certain period of downtime.

Event Name

outage

Permissions

Accessible at User permission level

Records

1

The outage event has the following format:

Field Name

Field Type

Notes

service

String

Service that was down.

start

Date

Outage start date and time.

duration

Long

Outage duration in seconds

reason

String

Outage reason.

Connection Handling

The Network Host driver has a configurable Online/Offline status detection policy. This helps to bring the device account offline if a certain service experiences a user-defined operability problem.

The status detection configuration is performed through the Connection Status Expressions table. Each line of this table describes a service or custom formula that affects online status of the network host device. The table has three fields:

  • Comment. This field is a human-readable description of the table record.
  • Enabled Expression. An expression that defines whether the record is "active", i.e. really affects device status. The expression should return a Boolean value (true/false). If it returns false, the record is deemed disabled and doesn't affect connection status of the network host.
  • Connection Status Expression. An expression that defines current "connection status" of the service, i.e. whether the service is available and has no errors. This expression should return a Boolean value (true/false) or null. If it returns true or false, the corresponding service is deemed online or offline respectively. If the expression returns null, the connection status of the service is considered unknown.

The Connection Status Expressions table is analyzed in the end of every synchronization cycle. Records those Enabled Expression return false are skipped. After that, connection status of the network host is calculated upon Connection Status Expression result of remaining records:

  • If at least one Connection Status Expression returns null, the connection status of the network host is deemed Unknown
  • Otherwise if at least one Connection Status Expression returns false, the network host is deemed Offline
  • Otherwise the network host is deemed Online

This example shows how to modify the HTTP service configuration to bring the network host offline if an HTTP reply code is not 200 (Successful):

  • Comment: HTTP
  • Enabled Expression: {httpSettings$enabled}
  • Connection Status Expression: hasVariable({.:}, 'http') && {http$successful} && {http$replyCode} != 200

Statuses of individual services may be checked using Configure Device action.

Synchronization Details

Network Host driver uses synchronization procedures of particular services enabled for the monitored device. Refer to the appropriate service subsection for detailed synchronization descriptions.

Was this page helpful?