mainNodeDetails

The mainNodeDetails view provides a consolidated set of data on all network devices.

The following table describes the mainNodeDetails view. The type, constraints, and description are automatically inherited, where appropriate, from the tables to which the fields belong.

Table 1. mainNodeDetails view
Column name Description Containing table
altitude

Vertical height above World Geodetic System WGS84 datum surface (EGM96) at the particular geographical location.

geographicLocation
altitudeUnits
Units to use for the altitude.
  • 0 – Meters
  • 1 – Kilometers
  • 2 – Centimeters
  • 3 - Feet
  • 4 – Yards
  • 5 - Miles
  • 6 - Inches
geographicLocation
className

The name of a class of devices. The master className field is in the entityClass table.

chassis
classType

The type of device or type of class.

entityClass
description

Textual description of the entity.

entityData
displayLabel

Human-readable name to be displayed adjacent to this entity in a topology map and in the Network Views tabular layout.

entityData
domainMgrId The ID for the domain to which this device belongs. domainMgr
domainName The name of the domain to which this device belongs. domainMgr
entPhysicalDescr

A textual description of physical entity. This object must contain a string which identifies the manufacturer's name for the physical entity. The value must be set to a distinct value for each version or model of the physical entity.

chassis
entPhysicalVendorType

An indication of the vendor-specific hardware type of the physical entity.

chassis
entityId Unique ID for each entity across all domains. entityData
entityName

Name of the entity. This field must be unique for all entities within a given domain.

entityData
ipAddress
The IP address through which this entity was discovered and will be monitored.
Note: For non-IP entities, such as layer 1 optical devices, this field is null.
chassis

In the chassis table, this field is called accessIpAddress.

ipForwarding
Indication of whether this entity is acting as an IP gateway in respect to the forwarding of datagrams received by this entity but not addressed to this entity. IP gateways forward datagrams, whereas IP hosts do not, unless the source is routed through the host. Takes one of the following values:
  • forwarding
  • not-forwarding
chassis
latitude

Measurement of latitude for this entity. This is the angular distance (north and south) from the equator on the earth's surface; for example, 78.838753. The value of this attribute is determined based on World Geodetic System WGS84 standard.

geographicLocation
locationDescription

Free-format textual description of location

geographicLocation
locationId

The location identifier by which the location is know to the end-user.

geographicLocation
longitude

Measurement of longitude for this entity. This is the angular distance (east and west) from the prime meridian on the earth's surface; for example, 35.832636. The value of this attribute is determined based on World Geodetic System WGS84 standard.

geographicLocation
manual

Indicates whether this entity was discovered as part of the discovery process or was manually added.

entityData
serialNumber

The serial number of the entity.

chassis
sysContact

The textual identification of the contact person for this managed node, and information on how to contact this person. If no contact information is known, the value is the zero-length string.

chassis
sysDescr

A textual description of the entity. This value must include the full name and version identification of the system hardware type, software operating-system, and networking software.

chassis
sysLocation

The physical location of this node, for example telephone closet, 3rd floor. If the location is unknown, the value is the zero-length string.

chassis
sysName

An administratively-assigned name for this managed node. By convention, this is the fully-qualified domain name of the node. If the name is unknown, the value is the zero-length string.

chassis
sysObjectId

The vendor's authoritative identification of the network management subsystem contained in the entity.

chassis
sysServices
A value that indicates the set of services that this entity potentially offers. The value is a sum that initially takes the value zero. Then, for each layer, L, in the range 1 through 7, that this node performs transactions for, 2 raised to (L - 1) is added to the sum. For example, a node that performs only routing functions would have a value of 4 (2^(3-1)). A node that is a host offering application services would have a value of 72 (2^(4-1) + 2^(7-1)). For the Internet suite of protocols, values should be calculated accordingly:
  • Layer 1: Physical, for example repeaters)
  • Layer 2: Datalink or subnetwork, for example bridges
  • Layer 3: Internet, for example supports IP
  • Layer 4: End-to-end, for example supports TCP
  • Layer 7: Applications, for example supports the SMTP
For systems including OSI protocols, layers 5 and 6 can also be considered.
chassis
sysUpTime

The time (in hundredths of a second) since the network management portion of the system was last reinitialized.

chassis
timeZoneOffset

Offset of local time from UTC in format UTC-HH:MM or UTC+HH:MM; for example, UTC+10:30, UTC-6:00.

geographicLocation