Default language.

Runtime Environment node

A Runtime Environment node represents an instance of a runtime environment on a Host, for example a Java Virtual Machine or a .NET runtime. Where possible, versions of Runtime Environments are retrieved and stored. They are created, maintained and destroyed by patterns. Runtime Environment nodes always have a relationship to the Pattern node corresponding to their maintaining pattern.

Why a Runtime Environment and not an SI?

Software Instances represent pieces of software running on a host. A Runtime Environment represents something supporting running software. For example, Weblogic is represented by an SI, and Java by a Runtime Environment node. However, it is still important to keep track of the supporting Runtime Environments and their versions as some might require updates.

Runtime Environment lifecycle

The lifecycle of a Runtime Environment 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 Runtime Environment and the logic contained in the pattern itself. In all cases, if a pattern is deleted, the Runtime Environment nodes it is maintaining are immediately destroyed (as are all other nodes it might be maintaining).

Creation/update

If a pattern triggers on a Directly Discovered Data node, such as a Discovered Process node, it might choose whether to specify keys for the Runtime Environment nodes it creates and maintains. If a key is specified then the decision whether to create a new Runtime Environment node or to update an existing one depends on the key. If a Runtime Environment node with the specified key exists, that node is updated, even if the node was previously maintained by a different pattern. In this case, the pattern takes over as the maintainer of the Runtime Environment. If a node with the specified key does not exist, a new Runtime Environment node is created. In both cases, the Runtime Environment node is linked to the pattern with a maintainer relationship.

If a key for the Runtime Environment node is not specified by the pattern, the system creates or updates a group Runtime Environment with an automatically generated key. The key is based upon the key of the Host upon which the Runtime Environment is running, the specified type of the Runtime Environment and, optionally, a key group that can be used to separate the nodes into a number of groups. The count attribute is set to the number of instances in the group identified in the collection of Directly Discovered Data. Each time the host is scanned, the count attribute is changed to represent the number of instances seen in that scan.

Removal

A Runtime Environment node can be destroyed either manually or automatically.

To remove a Runtime Environment node manually, find the necessary Runtime Environment, select it in the list and pick Destroy from the Actions list.

Automatic removal happens according to the following scenario.
The age_count attribute of the Runtime Environment node contains information about when the Runtime Environment node was last confirmed by its maintaining pattern. If the age_count is positive, it represents the number of consecutive scans of the Host node in which the Runtime Environment was confirmed. If the age_count is negative, it represents the number of consecutive scans in which the Runtime Environment node was not confirmed. The last_update_success and last_update_failure attributes contain the date and time at which the Runtime Environment node was last confirmed, and not confirmed, respectively.

The default aging strategy only applies to Runtime Environment nodes created from patterns triggering on the following node kinds and maintaining the Runtime Environments:

  • DiscoveredProcess
  • DiscoveredService
  • DiscoveredSoftware

If the Runtime Environment node is triggered on anything else, for example, a discovered file, then aging must be implemented in the pattern using a removal block.

If the pattern does not have a removal block, Runtime Environment nodes are removed using an aging strategy based on the age_count and last_update_success attributes. The default aging parameters are the same as for a Software-Instance-node, that is, if a Runtime Environment node has not been seen for at least 7 scans, over a period of at least 10 days, it is destroyed. The parameters can be changed in the options, see Configuring-model-maintenance-settings for more information.

If the pattern maintaining a node does have a removal block, the block can override the default aging scheme to destroy its nodes either earlier or later than normal. For TKU patterns, refer to the documentation accompanying each pattern for details of special removal behavior.

Regardless of the presence or absence of a removal block in the pattern, if the Host corresponding to a DDD-triggered Runtime Environment node is destroyed, the Runtime Environment node is immediately destroyed (see How nodes get removed).

Runtime Environment nodes currently represent Java or .NET. The different technologies and discovery techniques lead to the following differences in their removal:

  • Java is grouped by command line; it has aging behavior like any grouped Software Instance.
  • .NET is based on package information, so it has authoritative removal.

It is possible for other triggers to be used. If any other trigger is used, BMC Discovery has no automatic removal behavior. Patterns must be used to explicitly destroy any Runtime Environment nodes created as a result of other triggers.

Attributes of the RuntimeEnvironment node

The attributes of the RuntimeEnvironment node are described in the following table:

UI Name
Attribute Name and Type		Description 
Name
name : string 		Name of the Runtime Environment
Short Name
short_name : string 		Short name of the Runtime Environment
Type
type : string 		Type of the Runtime Environment
Instance Count
count : int 		Number of instances grouped together
Not shown in UI
#key : string 		Globally unique key
Publisher
publisher : string 		The publisher of the Runtime Environment. 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
In Container
in_container : boolean 		Indicates the Runtime Environment is in a container
Container ID
container_id : string 		Container ID
PID
pid : int 		Container Process ID
Not shown in UI
__age_count : int 		The number of consecutive successful 
Not shown in UI
__last_update_success : date 		The time at which a scan was last successfully associated with this Runtime Environment
Not shown in UI
__last_update_failure : date 		The time at which a scan associated with this Runtime Environment failed
Not shown in UI
__explicit_removal : string		Pattern that has taken over removal in place of standard removal

Relationships of the RuntimeEnvironment node

The relationships of the RuntimeEnvironment node are described in the following table:

UI Name Relationship Description 
Clusters Depending Upon This DependedUpon:
Dependency:
Dependant:
Cluster 		Clusters that depend on this Runtime Environment
Contained Software Instances Depending Upon This DependedUpon:
Dependency:
Dependant:
ContainedSoftwareInstance 		Contained Software Instances that depend on this Runtime Environment
Databases Depending Upon This DependedUpon:
Dependency:
Dependant:
Database 		Databases that depend on this Runtime Environment
Details Depending Upon This DependedUpon:
Dependency:
Dependant:
Detail 		Details that depend on this Runtime Environment
Software Clusters Depending Upon This DependedUpon:
Dependency:
Dependant:
SoftwareCluster 		Software Clusters that depend on this Runtime Environment
Software Components Depending Upon This DependedUpon:
Dependency:
Dependant:
SoftwareComponent 		Software Components that depend on this Runtime Environment
Software Containers Depending Upon This DependedUpon:
Dependency:
Dependant:
SoftwareContainer 		Software Containers that depend on this Runtime Environment
Software Instances Depending Upon This DependedUpon:
Dependency:
Dependant:
SoftwareInstance 		Software Instances that depend on this Runtime Environment
Software Pods Depending Upon This DependedUpon:
Dependency:
Dependant:
SoftwarePod 		Software Pods that depend on this Runtime Environment
Virtual Machines Depending Upon This DependedUpon:
Dependency:
Dependant:
VirtualMachine 		Virtual Machines that depend on this Runtime Environment
Details ElementWithDetail:
Detail:
Detail:
Detail 		Details belonging to this Runtime Environment
Hardware Details ElementWithDetail:
Detail:
Detail:
HardwareDetail 		Hardware Details belonging to this Runtime Environment
Cloud Service RunningSoftware:
HostedSoftware:
Host:
CloudService 		Cloud Service on which this Runtime Environment is running
Cluster RunningSoftware:
HostedSoftware:
Host:
Cluster 		Cluster on which this Runtime Environment is running
Host RunningSoftware:
HostedSoftware:
Host:
Host 		Host on which this Runtime Environment is running
MF Part RunningSoftware:
HostedSoftware:
Host:
MFPart 		MF Part on which this Runtime Environment is running
Network Device RunningSoftware:
HostedSoftware:
Host:
NetworkDevice 		Network Device on which this Runtime Environment is running
Associated Business Applications InferredElement:
Inference:
Associate:
BusinessApplicationInstance 		Business Applications associated in some way with this Runtime Environment
Associated Contained Software Instances InferredElement:
Inference:
Associate:
ContainedSoftwareInstance 		Contained Software Instances associated in some way with this Runtime Environment
Associated Discovered API Results InferredElement:
Inference:
Associate:
DiscoveredAPIResult 		Discovered API Results associated in some way with this Runtime Environment
Associated Discovered Command Results InferredElement:
Inference:
Associate:
DiscoveredCommandResult 		Discovered Command Results associated in some way with this Runtime Environment
Associated Discovered DNS Details InferredElement:
Inference:
Associate:
DiscoveredDNSDetail 		Discovered DNS Details associated in some way with this Runtime Environment
Associated Discovered Directory Entries InferredElement:
Inference:
Associate:
DiscoveredDirectoryEntry 		Discovered Directory Entries associated in some way with this Runtime Environment
Associated Discovered Files InferredElement:
Inference:
Associate:
DiscoveredFile 		Discovered Files associated in some way with this Runtime Environment
Associated Listening Ports InferredElement:
Inference:
Associate:
DiscoveredListeningPort 		Listening Ports associated in some way with this Runtime Environment
Associated Network Connections InferredElement:
Inference:
Associate:
DiscoveredNetworkConnection 		Network Connections associated in some way with this Runtime Environment
Associated Discovered Package Lists InferredElement:
Inference:
Associate:
DiscoveredPackages 		Discovered Package Lists associated in some way with this Runtime Environment
Associated Discovered Processes InferredElement:
Inference:
Associate:
DiscoveredProcess 		Discovered Processes associated in some way with this Runtime Environment
Associated Discovered Registry Entries InferredElement:
Inference:
Associate:
DiscoveredRegistryEntry 		Discovered Registry Entries associated in some way with this Runtime Environment
Associated Discovered Registry Values InferredElement:
Inference:
Associate:
DiscoveredRegistryValue 		Discovered Registry Values associated in some way with this Runtime Environment
Associated Discovered SNMP Values InferredElement:
Inference:
Associate:
DiscoveredSNMP 		Discovered SNMP Values associated in some way with this Runtime Environment
Associated Discovered SNMP Table Rows InferredElement:
Inference:
Associate:
DiscoveredSNMPRow 		Discovered SNMP Table Rows associated in some way with this Runtime Environment
Associated Discovered Services InferredElement:
Inference:
Associate:
DiscoveredService 		Discovered Services associated in some way with this Runtime Environment
Associated Discovered Software InferredElement:
Inference:
Associate:
DiscoveredSoftware 		Discovered Software associated in some way with this Runtime Environment
Associated Discovered Virtual Machines InferredElement:
Inference:
Associate:
DiscoveredVirtualMachine 		Discovered Virtual Machines associated in some way with this Runtime Environment
Associated Discovered WBEM Associators Results InferredElement:
Inference:
Associate:
DiscoveredWBEMAssociatorsResult 		Discovered WBEM Associators Results associated in some way with this Runtime Environment
Associated Discovered WBEM Instances InferredElement:
Inference:
Associate:
DiscoveredWBEMInstance 		Discovered WBEM Instances associated in some way with this Runtime Environment
Associated Discovered WBEM Query Results InferredElement:
Inference:
Associate:
DiscoveredWBEMQueryResult 		Discovered WBEM Query Results associated in some way with this Runtime Environment
Associated Discovered WMI Query Results InferredElement:
Inference:
Associate:
DiscoveredWMI 		Discovered WMI Query Results associated in some way with this Runtime Environment
Associated Hardware Details InferredElement:
Inference:
Associate:
HardwareDetail 		Hardware Details associated in some way with this Runtime Environment
Associated Hosts InferredElement:
Inference:
Associate:
Host 		Hosts associated in some way with this Runtime Environment
Associated Packages InferredElement:
Inference:
Associate:
Package 		Packages associated in some way with this Runtime Environment
Associated Software Components InferredElement:
Inference:
Associate:
SoftwareComponent 		Software Components associated in some way with this Runtime Environment
Associated Software Containers InferredElement:
Inference:
Associate:
SoftwareContainer 		Software Containers associated in some way with this Runtime Environment
Associated Software Instances InferredElement:
Inference:
Associate:
SoftwareInstance 		Software Instances associated in some way with this Runtime Environment
Contributor Business Applications InferredElement:
Inference:
Contributor:
BusinessApplicationInstance 		Business Applications contributing to this Runtime Environment's attributes
Contributor Business Services InferredElement:
Inference:
Contributor:
BusinessService 		Business Services contributing to this Runtime Environment's attributes
Contributor Technical Services InferredElement:
Inference:
Contributor:
TechnicalService 		Technical Services contributing to this Runtime Environment's attributes
Contributor Contained Software Instances InferredElement:
Inference:
Contributor:
ContainedSoftwareInstance 		Contained Software Instances contributing to this Runtime Environment's attributes
Contributor Discovered API Results InferredElement:
Inference:
Contributor:
DiscoveredAPIResult 		Discovered API Results contributing to this Runtime Environment's attributes
Contributor Discovered Command Results InferredElement:
Inference:
Contributor:
DiscoveredCommandResult 		Discovered Command Results contributing to this Runtime Environment's attributes
Contributor Discovered DNS Details InferredElement:
Inference:
Contributor:
DiscoveredDNSDetail 		Discovered DNS Details contributing to this Runtime Environment's attributes
Contributor Discovered Directory Entries InferredElement:
Inference:
Contributor:
DiscoveredDirectoryEntry 		Discovered Directory Entries contributing to this Runtime Environment's attributes
Contributor Discovered FQDNs InferredElement:
Inference:
Contributor:
DiscoveredFQDN 		Discovered FQDNs contributing to this Runtime Environment's attributes
Contributor Discovered Files InferredElement:
Inference:
Contributor:
DiscoveredFile 		Discovered Files contributing to this Runtime Environment's attributes
Contributor Listening Ports InferredElement:
Inference:
Contributor:
DiscoveredListeningPort 		Listening Ports contributing to this Runtime Environment's attributes
Contributor Network Connections InferredElement:
Inference:
Contributor:
DiscoveredNetworkConnection 		Network Connections contributing to this Runtime Environment's attributes
Contributor Discovered Package Lists InferredElement:
Inference:
Contributor:
DiscoveredPackages 		Discovered Package Lists contributing to this Runtime Environment's attributes
Contributor Discovered Patches InferredElement:
Inference:
Contributor:
DiscoveredPatches 		Discovered Patches contributing to this Runtime Environment's attributes
Contributor Discovered Processes InferredElement:
Inference:
Contributor:
DiscoveredProcess 		Discovered Processes contributing to this Runtime Environment's attributes
Contributor Discovered Registry Entries InferredElement:
Inference:
Contributor:
DiscoveredRegistryEntry 		Discovered Registry Entries contributing to this Runtime Environment's attributes
Contributor Discovered Registry Values InferredElement:
Inference:
Contributor:
DiscoveredRegistryValue 		Discovered Registry Values contributing to this Runtime Environment's attributes
Contributor Discovered SNMP Values InferredElement:
Inference:
Contributor:
DiscoveredSNMP 		Discovered SNMP Values contributing to this Runtime Environment's attributes
Contributor Discovered SNMP Table Rows InferredElement:
Inference:
Contributor:
DiscoveredSNMPRow 		Discovered SNMP Table Rows contributing to this Runtime Environment's attributes
Contributor Discovered Services InferredElement:
Inference:
Contributor:
DiscoveredService 		Discovered Services contributing to this Runtime Environment's attributes
Contributor Discovered Software InferredElement:
Inference:
Contributor:
DiscoveredSoftware 		Discovered Software contributing to this Runtime Environment's attributes
Contributor Discovered Virtual Machines InferredElement:
Inference:
Contributor:
DiscoveredVirtualMachine 		Discovered Virtual Machines contributing to this Runtime Environment's attributes
Contributor Discovered WBEM Associators Results InferredElement:
Inference:
Contributor:
DiscoveredWBEMAssociatorsResult 		Discovered WBEM Associators Results contributing to this Runtime Environment's attributes
Contributor Discovered WBEM Instances InferredElement:
Inference:
Contributor:
DiscoveredWBEMInstance 		Discovered WBEM Instances contributing to this Runtime Environment's attributes
Contributor Discovered WBEM Query Results InferredElement:
Inference:
Contributor:
DiscoveredWBEMQueryResult 		Discovered WBEM Query Results contributing to this Runtime Environment's attributes
Contributor Discovered WMI Query Results InferredElement:
Inference:
Contributor:
DiscoveredWMI 		Discovered WMI Query Results contributing to this Runtime Environment's attributes
Contributor Hosts InferredElement:
Inference:
Contributor:
Host 		Hosts contributing to this Runtime Environment's attributes
Contributor MF Parts InferredElement:
Inference:
Contributor:
MFPart 		MF Parts contributing to this Runtime Environment's attributes
Contributor Packages InferredElement:
Inference:
Contributor:
Package 		Packages contributing to this Runtime Environment's attributes
Contributor Patterns InferredElement:
Inference:
Contributor:
Pattern 		Patterns contributing to this Runtime Environment's attributes
Contributor Software Components InferredElement:
Inference:
Contributor:
SoftwareComponent 		Software Components contributing to this Runtime Environment's attributes
Contributor Software Containers InferredElement:
Inference:
Contributor:
SoftwareContainer 		Software Containers contributing to this Runtime Environment's attributes
Contributor Software Instances InferredElement:
Inference:
Contributor:
SoftwareInstance 		Software Instances contributing to this Runtime Environment's attributes
Primary Business Application InferredElement:
Inference:
Primary:
BusinessApplicationInstance 		Business Application from which the existence of this Runtime Environment was inferred
Primary Business Service InferredElement:
Inference:
Primary:
BusinessService 		Business Service from which the existence of this Runtime Environment was inferred
Primary Technical Service InferredElement:
Inference:
Primary:
TechnicalService 		Technical Service from which the existence of this Runtime Environment was inferred
Primary Container InferredElement:
Inference:
Primary:
ContainerInfo 		Container from which the existence of this Runtime Environment was inferred
Primary Contained Software Instance InferredElement:
Inference:
Primary:
ContainedSoftwareInstance 		Contained Software Instance from which the existence of this Runtime Environment was inferred
Primary Device Info InferredElement:
Inference:
Primary:
DeviceInfo 		Device Info from which the existence of this Runtime Environment was inferred
Primary Discovered Application Component InferredElement:
Inference:
Primary:
DiscoveredApplicationComponent 		Discovered Application Component from which the existence of this Runtime Environment was inferred
Primary Discovered Cloud API Result List InferredElement:
Inference:
Primary:
DiscoveredCloudAPIResultList 		Discovered Cloud API Result List from which the existence of this Runtime Environment was inferred
Primary Discovered Coupling Facility InferredElement:
Inference:
Primary:
DiscoveredCouplingFacility 		Discovered Coupling Facility from which the existence of this Runtime Environment was inferred
Primary Discovered Database InferredElement:
Inference:
Primary:
DiscoveredDatabase 		Discovered Database from which the existence of this Runtime Environment was inferred
Primary Discovered Database Detail InferredElement:
Inference:
Primary:
DiscoveredDatabaseDetail 		Discovered Database Detail from which the existence of this Runtime Environment was inferred
Primary Discovered Directory Entry InferredElement:
Inference:
Primary:
DiscoveredDirectoryEntry 		Discovered Directory Entry from which the existence of this Runtime Environment was inferred
Primary Discovered Disk Drive InferredElement:
Inference:
Primary:
DiscoveredDiskDrive 		Discovered Disk Drive from which the existence of this Runtime Environment was inferred
Primary Discovered File InferredElement:
Inference:
Primary:
DiscoveredFile 		Discovered File from which the existence of this Runtime Environment was inferred
Primary Discovered File System InferredElement:
Inference:
Primary:
DiscoveredFileSystem 		Discovered File System from which the existence of this Runtime Environment was inferred
Primary Discovered HBA InferredElement:
Inference:
Primary:
DiscoveredHBA 		Discovered HBA from which the existence of this Runtime Environment was inferred
Primary Discovered IP Address InferredElement:
Inference:
Primary:
DiscoveredIPAddress 		Discovered IP Address from which the existence of this Runtime Environment was inferred
Primary Listening Port InferredElement:
Inference:
Primary:
DiscoveredListeningPort 		Listening Port from which the existence of this Runtime Environment was inferred
Primary Discovered MFPart InferredElement:
Inference:
Primary:
DiscoveredMFPart 		Discovered MFPart from which the existence of this Runtime Environment was inferred
Primary Discovered MQ Detail InferredElement:
Inference:
Primary:
DiscoveredMQDetail 		Discovered MQ Detail from which the existence of this Runtime Environment was inferred
Primary Discovered Mainframe InferredElement:
Inference:
Primary:
DiscoveredMainframe 		Discovered Mainframe from which the existence of this Runtime Environment was inferred
Primary Discovered Mainframe View Result InferredElement:
Inference:
Primary:
DiscoveredMainframeViewResult 		Discovered Mainframe View Result from which the existence of this Runtime Environment was inferred
Primary Discovered Network Interface InferredElement:
Inference:
Primary:
DiscoveredNetworkInterface 		Discovered Network Interface from which the existence of this Runtime Environment was inferred
Primary Discovered Process InferredElement:
Inference:
Primary:
DiscoveredProcess 		Discovered Process from which the existence of this Runtime Environment was inferred
Primary Discovered Program InferredElement:
Inference:
Primary:
DiscoveredProgram 		Discovered Program from which the existence of this Runtime Environment was inferred
Primary Discovered Registry Entry InferredElement:
Inference:
Primary:
DiscoveredRegistryEntry 		Discovered Registry Entry from which the existence of this Runtime Environment was inferred
Primary Discovered Service InferredElement:
Inference:
Primary:
DiscoveredService 		Discovered Service from which the existence of this Runtime Environment was inferred
Primary Discovered Software InferredElement:
Inference:
Primary:
DiscoveredSoftware 		Discovered Software from which the existence of this Runtime Environment was inferred
Primary Discovered Storage Subsystem InferredElement:
Inference:
Primary:
DiscoveredStorageSubsystem 		Discovered Storage Subsystem from which the existence of this Runtime Environment was inferred
Primary Discovered Sysplex InferredElement:
Inference:
Primary:
DiscoveredSysplex 		Discovered Sysplex from which the existence of this Runtime Environment was inferred
Primary Discovered Tape Drive InferredElement:
Inference:
Primary:
DiscoveredTapeDrive 		Discovered Tape Drive from which the existence of this Runtime Environment was inferred
Primary Discovered Transaction InferredElement:
Inference:
Primary:
DiscoveredTransaction 		Discovered Transaction from which the existence of this Runtime Environment was inferred
Primary Discovered Virtual Machine InferredElement:
Inference:
Primary:
DiscoveredVirtualMachine 		Discovered Virtual Machine from which the existence of this Runtime Environment was inferred
Primary Host Info InferredElement:
Inference:
Primary:
HostInfo 		Host Info from which the existence of this Runtime Environment was inferred
Primary MF Part InferredElement:
Inference:
Primary:
MFPart 		MF Part from which the existence of this Runtime Environment was inferred
Primary Network Connection List InferredElement:
Inference:
Primary:
NetworkConnectionList 		Network Connection List from which the existence of this Runtime Environment was inferred
Primary Software Component InferredElement:
Inference:
Primary:
SoftwareComponent 		Software Component from which the existence of this Runtime Environment was inferred
Primary Software Container InferredElement:
Inference:
Primary:
SoftwareContainer 		Software Container from which the existence of this Runtime Environment was inferred
Primary Software Instance InferredElement:
Inference:
Primary:
SoftwareInstance 		Software Instance from which the existence of this Runtime Environment was inferred
Maintaining Pattern Element:
Maintainer:
Pattern:
Pattern 		Pattern maintaining this Runtime Environment
Containing Business Application ContainedSoftware:
SoftwareContainment:
SoftwareContainer:
BusinessApplicationInstance 		Containing Business Application
Containing Business Service ContainedSoftware:
SoftwareContainment:
SoftwareContainer:
BusinessService 		Containing Business Service
Containing Technical Service ContainedSoftware:
SoftwareContainment:
SoftwareContainer:
TechnicalService 		Containing Technical Service
Containing Software Container ContainedSoftware:
SoftwareContainment:
SoftwareContainer:
SoftwareContainer 		Containing Software Container
Software Support Details ElementWithDetail:
SupportDetail:
SoftwareDetail:
SupportDetail 		Software Support Details for this Runtime Environment

 

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