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 and relationships 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
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

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
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 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 Packages	InferredElement: Inference: Associate: DiscoveredPackages	Discovered Packages 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 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 Packages	InferredElement: Inference: Contributor: DiscoveredPackages	Discovered Packages 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 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
Software Support Details	ElementWithDetail: SupportDetail: SoftwareDetail: SupportDetail	Software Support Details for this Runtime Environment