VirtualMachine node

A VirtualMachine node represents a VM container running on a Host or in the Cloud.  A single node may represent an elastic group of virtual machines.

Virtual machines no longer modeled by Software Instance nodes in BMC Discovery 11.2 and later

In versions of BMC Discovery before 11.2, Software Instance nodes were used to represent virtual machines. In BMC Discovery 11.2, they are now modeled using a Virtual Machine node which makes it easier to find and relate VMs to their containers and Hosts.

The following section describes the scenarios in which a VirtualMachine node is created or removed. DDD nodes are never updated.

VirtualMachine node lifecycle

The following section describes the scenarios in which a VirtualMachine node is created or removed.

Creation

The lifecycle of a VirtualMachine node depends upon the details of the pattern that maintains it. This is determined by a combination of the pattern trigger condition, whether the pattern specifies an explicit key for the Virtual Machine and the logic contained in the pattern itself. In all cases, if a pattern is deleted, the VirtualMachine nodes it is maintaining are immediately removed (as are all other nodes it might be maintaining).

Patterns can trigger on a Directly Discovered Data node, see Directly Discovered Data Trigger. They can also trigger or on the creation or modification of other VirtualMachine nodes.

A VirtualMachine node is created by the cloud patterns when a cloud scan takes place.

Removal

VirtualMachine nodes created as a result of Virtual Machine triggers are removed using the Cascade removal type; when the triggering VirtualMachine node is removed, the removal is cascaded to the higher-level VirtualMachine node. See Cascade Removal.

The VirtualMachine node can not be automatically removed, by default. If the node is removed, then all the content underneath is also destroyed. 

To remove a VirtualMachine node manually, find the necessary Virtual Machine, select it in the list and pick Destroy from the Actions list. 

VirtualMachine node attributes

The attributes of a VirtualMachine node are as described in the following table below:

 

UI Name
Attribute name and Type

Description

Not displayed in UI
key string

Globally unique key

Name
name string

Name of the Virtual Machine

Short Name
short_name string

Short name of the Virtual Machine

Type
type string

Type of the Virtual Machine

Instance Count
count int

Number of instances grouped together

Instance
instance string

The product's own name for this instance

VM Type
vm_type string

The type of VM technology used by this instance of a virtual machine

VM Name
vm_name string

The name of the virtual machine

VM UUID
vm_uuid string

The UUID of the virtual machine

VM Guest OS
vm_guest_os string

The guest operating system of the virtual machine

Publisher
publisher string

The publisher of the Virtual Machine software. Only populated in cases that a Pattern identifies products from more than one publisher. This information is normally found in the Pattern node's publishers attribute.

Product Name
product string

The product name. Only populated in cases that a Pattern identifies more than one product. This information is normally found in the Pattern node's products attribute.

Full Version
version string

Full-resolution version

Product Version
product_version string

Version publicised by the vendor

Release
release string

Release number

Edition
edition string

Edition

Service Pack
service_pack string

Service pack

Build
build string

Build number

Patch
patch string

Patch level

Revision
revision string

Revision

Not displayed in UI
age_count int

The number of consecutive successful (positive) or failed (negative) times the Virtual Machine has been seen during host scans

Not displayed in UI
last_update_success date

The time at which a scan was last successfully associated with this Virtual Machine

Not displayed in UI
last_update_failure date

The time at which a scan associated with this Virtual Machine failed

Not displayed in UI
_explicit_removal _string

Pattern that has taken over removal in place of standard removal

Cloud Hosted
cloud boolean

When set, this flag indicates that the VM runs directly on a cloud service

Cloud Class
cloud_class string

Vendor classification of cloud VM

Public IP Address
public_ip_addr string

Public IP address of cloud VM

Private IP Address
private_ip_addr string

Private IP address of cloud VM

Public IP Addresses
public_ip_addrs list:string

Public IP addresses of cloud elastic group

Private IP Addresses
private_ip_addrs list:string

Private IP addresses of cloud elastic group

Elastic Group
elastic boolean

VM represents an elastic group

Minimum Size
minimum_size int

Minimum size of the elastic group

Maximum Size
maximum_size int

Maximum size of the elastic group

Current Size
current_size int

Current size of the elastic group

Elastic Group Members
members list:string

Identifiers of the elastic group members

Tags
tag_set dictionary

Tag or tags applied to the virtual machine, as returned from the vCenter server.
Discovery of tags from vCenter was introduced in the November 2019 TKU.


 

VirtualMachine node relationships

The relationships of a VirtualMachine node are as described in the following table:

UI NameRelationshipDescription

Host

VirtualMachine:
RunningSoftware:
HostedSoftware:
Host:
Host

Host on which this VM is running.

Cloud Service

VirtualMachine:
RunningSoftware:
HostedSoftware:
Host:
CloudService

Cloud Service on which this VM is running.

MFPart

VirtualMachine:
RunningSoftware:
HostedSoftware:
Host:
MFPart

MFPart on which this VM is running.

Maintaining Pattern

VirtualMachine:
Element:
Maintainer:
Pattern:
Pattern

Pattern that is maintaining this VM.

Software Support Details

VirtualMachine:
ElementWithDetail:
SupportDetail:
SoftwareDetail:
SupportDetail

Software Support Detail related to this VM.

Contained Virtual Host

VirtualMachine:
HostContainer:
HostContainment:
ContainedHost:
Host

Virtual Host provided by this VM.

Contained MFPart

VirtualMachine:
HostContainer:
HostContainment:
ContainedHost:
MFPart

MFPart provided by this VM.

Depended Upon By

VirtualMachine:
DependedUpon:
Dependency:
Dependant:
Detail

Detail depending upon this VM.

Depends On

VirtualMachine:
Dependant:
Dependency:
DependedUpon:
Detail

Detail depended upon by this VM.

Details

VirtualMachine:
ElementWithDetail:
Detail:
Detail:
Detail

Details of this VM.

Collections

VirtualMachine:
Member:
Collection:
Collection:
Collection

A collection which this VM is a member of.

Administrative Collections

VirtualMachine:
Member:
Collection:
Collection:
AdminCollection

An administrative collection which this VM is a member of.

Managed by Software Instance

VirtualMachine:
ManagedElement:
Management:
Manager:
SoftwareInstance

Software Instances that manage this VM.

Primary processes

VirtualMachine:
InferredElement:
Inference:
Primary:
DiscoveredProcess

Discovered process from which the existence of this VM was inferred.

Contributor processes

VirtualMachine:
InferredElement:
Inference:
Contributor:
DiscoveredProcess

Discovered process from which one or more attributes of this VM were inferred.

Associated processes

VirtualMachine:
InferredElement:
Inference:
Associate:
DiscoveredProcess

Discovered process related in some way to this VM.

Associated services

VirtualMachine:
InferredElement:
Inference:
Associate:
DiscoveredService

Discovered service related in some way to this VM.

Not displayed in UI

VirtualMachine:
InferredElement:
Inference:
Contributor:
Package

Package from which one or more attributes of this VM were inferred.

Associated packages

VirtualMachine:
InferredElement:
Inference:
Associate:
Package

Package related in some way to this VM.

Not displayed in UI

VirtualMachine:
InferredElement:
Inference:
Contributor:
Host

Host from which one or more attributes of this VM were inferred.

Not displayed in UI

VirtualMachine:
InferredElement:
Inference:
Associate:
Host

Host related in some way to this VM.

Not displayed in UI

VirtualMachine:
InferredElement:
Inference:
Primary:
DiscoveredFile

Discovered file from which the existence of this VM was inferred.

Not displayed in UI

VirtualMachine:
InferredElement:
Inference:
Contributor:
DiscoveredFile

Discovered file from which one or more attributes of this VM were inferred.

Associated files

VirtualMachine:
InferredElement:
Inference:
Associate:
DiscoveredFile

Discovered file related in some way to this VM.

Primary software

VirtualMachine:
InferredElement:
Inference:
Primary:
DiscoveredSoftware

Discovered software from which the existence of this VM was inferred.

Contributor software

VirtualMachine:
InferredElement:
Inference:
Contributor:
DiscoveredSoftware

Discovered software from which one or more attributes of this VM were inferred.

Associated discovered software

VirtualMachine:
InferredElement:
Inference:
Associate:
DiscoveredSoftware

Discovered software related in some way to this VM.

Not displayed in UI

VirtualMachine:
InferredElement:
Inference:
Contributor:
DiscoveredCommandResult

Discovered command result from which one or more attributes of this VM were inferred.

Associated command results

VirtualMachine:
InferredElement:
Inference:
Associate:
DiscoveredCommandResult

Discovered command result related in some way to this VM.

Not displayed in UI

VirtualMachine:
InferredElement:
Inference:
Contributor:
DiscoveredRegistryValue

Discovered Windows Registry value from which one or more attributes of this VM were inferred.

Associated registry values

VirtualMachine:
InferredElement:
Inference:
Associate:
DiscoveredRegistryValue

Discovered Windows Registry value related in some way to this VM.

Not displayed in UI

VirtualMachine:
InferredElement:
Inference:
Contributor:
DiscoveredWMI

Discovered WMI query result from which one or more attributes of this VM were inferred.

Associated WMI values

VirtualMachine:
InferredElement:
Inference:
Associate:
DiscoveredWMI

Discovered WMI query result related in some way to this VM.

Not displayed in UI

VirtualMachine:
InferredElement:
Inference:
Contributor:
DiscoveredWBEMInstance

Discovered WBEM instance from which one or more attributes of this VM were inferred.

Associated WBEM instances

VirtualMachine:
InferredElement:
Inference:
Associate:
DiscoveredWBEMInstance

Discovered WBEM instance related in some way to this VM.

Not displayed in UI

VirtualMachine:
InferredElement:
Inference:
Contributor:
DiscoveredWBEMQueryResult

Discovered WBEM result from which one or more attributes of this VM were inferred.

Associated WBEM query results

VirtualMachine:
InferredElement:
Inference:
Associate:
DiscoveredWBEMQueryResult

Discovered WBEM result related in some way to this VM.

Not displayed in UI

VirtualMachine:
InferredElement:
Inference:
Contributor:
DiscoveredWBEMAssociatorsResult

Discovered WBEM association from which one or more attributes of this VM were inferred.

Associated associators results

VirtualMachine:
InferredElement:
Inference:
Associate:
DiscoveredWBEMAssociatorsResult

Discovered WBEM association related in some way to this VM.

Not displayed in UI

VirtualMachine:
InferredElement:
Inference:
Contributor:
DiscoveredAPIResult

Discovered API call result from which one or more attributes of this VM were inferred.

Associated API call results

VirtualMachine:
InferredElement:
Inference:
Associate:
DiscoveredAPIResult

Discovered API call result related in some way to this VM.

Not displayed in UI

VirtualMachine:
InferredElement:
Inference:
Contributor:
DiscoveredVirtualMachine

Discovered VM result from which one or more attributes of this VM were inferred.

Associated VM results

VirtualMachine:
InferredElement:
Inference:
Associate:
DiscoveredVirtualMachine

Discovered VM result related in some way to this VM.

Not displayed in UI

VirtualMachine:
InferredElement:
Inference:
Contributor:
Pattern

Pattern from which one or more attributes of this VM were inferred.

Not displayed in UI

VirtualMachine:
InferredElement:
Inference:
Contributor:
DiscoveredDNSDetail

Resolved DNS details from which one or more attributes of this VM were inferred.

Associated DNS details

VirtualMachine:
InferredElement:
Inference:
Associate:
DiscoveredDNSDetail

Resolved DNS details related in some way to this VM.

VirtualMachine node expressions

The expressions on a VirtualMachine node are as described in the following table:

Name

Expression

Description

Contained Host vhost_link : nodeLink(#HostContainer:HostContainment:ContainedHost:, #HostContainer:HostContainment:ContainedHost:.name)Link to virtual host
Was this page helpful? Yes No Submitting... Thank you

Comments