This documentation supports the 21.05 (12.2) version of BMC Discovery.To view an earlier version of the product, select the version from the Product version menu.

Network Device node

The Network Device node represents a network device such as a switch or router. Network Device information is discovered using SNMP. Alternatively, device information could be manually imported.

Related topic

Troubleshooting-network-device-scan-failures

Network Device node lifecycle

The following section describes the scenarios in which Network Device nodes are created, updated or destroyed.

Creation of discovered Network Devices

Discovered Network Device nodes are created in exactly the same way as Host nodes.

Info

Network Device nodes created using the pattern language, for example stacked switches and access points, do not have a related Discovery Access node.

Creation of imported Network Devices

Network Device nodes are created in the datastore when an import script is run, for example the Edge Switch import tool.

A new Network Device node is created if there is no node representing a switch with that name in the datastore.

Update of discovered Network Devices

Network Device nodes are updated in exactly the same way as Host nodes.

Update of imported Network Devices

A Network Device node is updated in the datastore when an import script is run, for example the CiscoWorks tool. The primary key for a Network Device node is the name. Network Device nodes are updated if a switch in the input data has the same name.

Removal of discovered Network Devices

Network Device nodes are removed in exactly the same way as Host nodes.

Removal of imported Network Devices

A Network Device node can be destroyed from the datastore by user intervention through the User Interface. If a switch is destroyed from the input data, and the import tool is run, the existing Network Device node representing that switch remains in the datastore.

There is an option on the Edge Switch import tool to destroy any existing Network Device nodes that are not included in the new import.

Network Device node attributes

The attributes on a Network Device node are as described in the following table:

UI name
Attribute Name and Type

Description

Name
name : string

Name of device.

Model
model : string

Model of device.

Product ID
product_id : string

Product id.

Vendor
vendor : string

Vendor of device.

System Name
sysname : string

System name.

System Object ID
sysobjectid : string

System object id.

Serial ID
serial : string

Serial id.

Capability IDs
__capability_ids : list:int

Capability type ids of device.

Capability
capability_types : list:string

Capability types of device.

Device Type
device_type : string

DEPRECATED - use attribute Type
Type of device

Type
type : string

Type of device.

OS Type
os_type : string

Operating system type.

OS Class
os_class : string

Operating system class.

OS Version
os_version : string

Operating system version.

OS Vendor
os_vendor : string

Operating system vendor.

Firmware Version
firmware_version : string

Firmware version.

Testing Status
testing_status : string

Device testing status.

Virtual
virtual : boolean

Flag if the device is virtual.

Nexus VDC ID
nexus_vdc_id : string

Cisco Nexus VDC ID.

Stack
stack : boolean

Flag indicating if this device is stack.

Stack Master
stack_master : boolean

Flag indicating if this physical device is a stack master.

Not displayed in UI
__all_ip_addrs : list:string

Internal attribute to aid searching Network Devices by IP address, these may include IPs from ports, the device and scanned IPs and no specific behaviour of this field should be relied upon.

Not displayed in UI
__all_dns_names : list:string

Internal attribute to aid searching Network Devices by name.

Not displayed in UI
__cdp_device_id : string

Internal attribute to store SNMP CDP device id.

Not displayed in UI
age_count : int

The number of consecutive successful (positive) or failed (negative) accesses, from any endpoint.

Not displayed in UI
last_access_success : string

The time at which a scan was last successfully associated with this Network Device

Not displayed in UI
last_update_failure : date

The time at which a scan associated with this Network Device failed.

Not displayed in UI
last_access_response : string

Response from last attempt to access NetworkDevice.

Not displayed in UI
no_response_count : int

Number of no responses since last success.

Not displayed in UI
access_failure_count : int

Number of access failures since last success.

Not displayed in UI
new_endpoint_identity_count : int

Number of access where endpoint reports different device.

Last successful CMDB sync
last_cmdb_sync_success : date

The time at which this Network Device was last successfully synchronized into the CMDB.

Last failed CMDB sync
last_cmdb_sync_failure : date

The time at which an attempt to synchronize this Network Device into the CMDB failed.

CMDB sync duration
last_cmdb_sync_duration : float

The time in seconds spent performing the last CMDB synchronization of this Network Device.

CMDB CI count
last_cmdb_sync_ci_count : int

The number of CIs corresponding to this Network Device at the last CMDB synchronization.

CMDB Relationship count
last_cmdb_sync_rel_count : int

The number of relationships between CIs corresponding to this Network Device at the last CMDB synchronization.

Scope
scope : string

Distinguish overlapping address spaces.

Key
key : string

Globally unique key.

Name
name : string

Primary name.

Short Name
short_name : string

Short name.

Description
description : string

Description of the element.

URL
url : string

URL for information about the element.

Business Continuity Critical
business_continuity_critical : boolean

If true, element is critical to operation of the business.

Supported by 3rd Party
third_party_support : boolean

True if the element is supported by a third party.

Synonyms
synonyms : list:string

Other names for the element.

Network Device node relationships

The relationships on a Network Device node are as described in the following table: 

Destination

Relationship

Description

Discovery Access

InferredElement:
Inference:
Associate:
DiscoveryAccess

DiscoveryAccess for this Network Device.

Discovery Access Failure

InferredElement:
AccessFailure:
DiscoveryAccess:
DiscoveryAccess

The failed access for an endpoint.

Discovery Access Optimization

InferredElement:
AccessOptimization:
DiscoveryAccess:
DiscoveryAccess

The optimized access for an endpoint.

Containing VM

ContainedHost:
HostContainment:
HostContainer:
VirtualMachine

Software container for this virtual Network Device.

Not displayed in UI

InferredElement:
Inference:
Primary:
DeviceInfo

DeviceInfo of this Network Device.

Endpoint Used To Be Identified As

Next:
EndpointIdentity:
Previous:
NetworkDevice

Previous Network Device Identity.

Endpoint Now Identified As

Previous:
EndpointIdentity:
Next:
NetworkDevice

Next Network Device Identity.

Endpoint Used To Be Identified As

Next:
EndpointIdentity:
Previous:
Host

Previous Host Identity.

Endpoint Now Identified As

Previous:
EndpointIdentity:
Next:
Host

Next Host Identity.

Endpoint Used To Be Identified As

Next:
EndpointIdentity:
Previous:
Mainframe

Previous Mainframe Identity.

Endpoint Now Identified As

Previous:
EndpointIdentity:
Next:
Mainframe

Next Mainframe Identity.

Endpoint Used To Be Identified As

Next:
EndpointIdentity:
Previous:
Printer

Previous Printer Identity.

Endpoint Now Identified As

Previous:
EndpointIdentity:
Next:
Printer

Next Printer Identity.

Endpoint Used To Be Identified As

Next:
EndpointIdentity:
Previous:
SNMPManagedDevice

Previous SNMP Managed Device Identity.

Endpoint Now Identified As

Previous: 
EndpointIdentity: 
Next: 
SNMPManagedDevice

Next SNMP Managed Device Identity.

Endpoint Used To Be Identified As

Next:
EndpointIdentity:
Previous:
StorageDevice

Previous Storage Device Identity.

Endpoint Now Identified As

Previous:
EndpointIdentity:
Next:
StorageDevice

Next Storage Device Identity.

Chosen Endpoint

Device:
ChosenEndpoint:
Endpoint:
Endpoint

Endpoint used to discover this NetworkDevice.

Network Interfaces

DeviceWithInterface:
DeviceInterface:
InterfaceOfDevice:
NetworkInterface

Network interfaces of this Network Device.

Network Interfaces of the Stack Member

DeviceWithInterface:
DeviceInterface:
InterfaceOfStack:
NetworkInterface

Network interfaces of this Stack Member.

IPv4 Addresses

DeviceWithAddress:
DeviceAddress:
IPv4Address:
IPAddress

IPv4 addresses of this Network Device.

IPv6 Addresses

DeviceWithAddress:
DeviceAddress:
IPv6Address:
IPAddress

IPv6 addresses of this Network Device.

Fibre Channel Ports

DeviceWithInterface:
DeviceInterface:
InterfaceOfDevice:
FibreChannelPort

FC ports of this NetworkDevice.

Load Balancer

NetworkDevice:
NetworkService:
NetworkService:
LoadBalancerInstance

Load Balancer instance.

Hardware Container

ContainedHost:
HostContainment:
HostContainer:
HardwareContainer

Hardware container of which this is a member.

Host Container

ContainedHost:
HostContainment:
HostContainer:
HostContainer

Host container of which this is a member.

Network Device in Stack

Stack:
DeviceStack:
StackMember:
NetworkDevice

Network Device that is the member of the Stack.

Stack of Network Devices

StackMember:
DeviceStack:
Stack:
NetworkDevice

Network Device that represents Stack of Network Devices.

Managed Hardware Containers

Manager:
Management:
ManagedElement:
HardwareContainer

Hardware Container that this Network Device manages.

Managed Host Containers

Manager:
Management:
ManagedElement:
HostContainer

Host Container that this Network Device manages.

Details

ElementWithDetail:
Detail:
Detail:
Detail

Details of this Network Device.

Support Detail

ElementWithDetail:
SupportDetail:
HardwareDetail:
SupportDetail

Hardware Support Detail related to this Network Device.

OS Support Details

ElementWithDetail:
SupportDetail:
OSDetail:
SupportDetail

OS Support Detail related to this Network Device

Subnets

DeviceOnSubnet:
DeviceSubnet:
Subnet:
Subnet

The Subnets that this Network Device connects to.

Not displayed in UI

AttachmentContainer:
Attachment:
Attachment:
Attachment

A file attached to this element.

Status

ElementInCategory:
ElementCategory:
Category:
LifecycleStatus

The lifecycle status of this element.

Recovery Time

ElementInCategory:
ElementCategory:
Category:
RecoveryTime

The recovery time specified for this element.

Family

ElementInCategory:
ElementCategory:
Category:
Family

Family of this element.

Organizational Unit

OwnedItem:
Ownership:
Owner:
OrganisationalUnit

The Organizational Unit that this element belongs to.

Location

ElementInLocation:
Location:
Location:
Location

Location of this element.

Support Manager

OwnedItem:
Ownership:
SupportOwner:
Person

The person or owner responsible for the support of this element.

Business Owner

OwnedItem:
Ownership:
BusinessOwner:
Person

The person or owner responsible for this element from a business perspective.

IT Owner

OwnedItem:
Ownership:
ITOwner:
Person

The person or owner responsible for this element from an IT perspective.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*